Support for Drupal 7 is ending on 5 January 2025—it’s time to migrate to Drupal 10! Learn about the many benefits of Drupal 10 and find migration tools in our resource center.
While the various hooks are documented on api.aegirproject.org, no "topic" is generated.
Example, this hook is detected by the api module:
http://api.aegirproject.org/api/Hostmaster/modules--hosting--hosting.api...
... but the group it is supposed to be in ("@addtogroup hooks") isn't:
http://api.aegirproject.org/api/Hostmaster/modules--hosting--hosting.api...
This makes the module harder to browse...
Comments
Comment #1
Steven Jones CreditAttribution: Steven Jones commentedYeah this is because we don't actually define that group anywhere at the moment, but core does define the group, so what I think we need to do is add a file that adds the group, but not add it to hostmaster/provision.
I.e. whomever is responsible for the api site needs to manually add the file to the directory of files that are scanned.
Comment #2
ergonlogicOkay, that would be me.
Does anyone have an example of what this file is supposed to look like? Is it just some @defgroups as per http://drupal.org/node/1354#groups?
I haven't found any @defgroups yet, but I'm guessing it should look something like this: http://drupalcode.org/project/documentation.git/tree/refs/heads/6.x-1.x:....
Why not add it to hostmaster/provision? If indeed not, then should I start an aegir_documentation project to host it? It seems to me that it still needs to be available via Git somewhere.
Comment #3
Steven Jones CreditAttribution: Steven Jones commentedI'm not sure what happens if you try to define two groups of the same name, which would happen if someone popped aegir and core into the same API site.
Comment #4
anarcat CreditAttribution: anarcat commentedI think we should create a new group for the frontend hooks. maybe called "hosting_hooks"?
I could write a blurb...
Comment #5
anarcat CreditAttribution: anarcat commentedSome other notes:
doxygen reference: http://drupal.org/node/1354
we would profit a lot from an index.php file: http://drupalcode.org/project/documentation.git/blob_plain/refs/heads/6....
Comment #6
anarcat CreditAttribution: anarcat commentedOkay, I just went crazy in there and documented a bunch of groups, things should be more readable now. I have also added a simple index page while I was there. Let's see how that looks after it gets regenerated on the API site! :)
Comment #7
anarcat CreditAttribution: anarcat commentedbtw, not being sure if the docs are generated from the 1.x or 2.x branch (that should be clarified, or we should have another site for 2.x?), I merged most of the docs back into the 1.x branch, hopefully not breaking anything...