On 2015-05-26 11:54 PM, Richard Chonak wrote:
I edited the GregorioTeX pages very little and have not gone through them much, but I do agree that this portion of the web site could be expanded greatly, so that it would include a complete API documentation, in effect: a list of all macros that can be invoked, with their arguments and functionalities.
Élie and I had a discussion about this at some point, and bounced around the idea of focusing the website on introductory information (installation, basic usage tutorial, etc.), leaving a full explanation of all the different functions for the detailed documentation elsewhere (this is turning out to be GregorioRef, sort of by default since we have it and are slowly adding to it). Basically, we didn't want to have to maintain too many things. The more that needs to be maintained, the less likely it is to get updated.
There was some talk (https://github.com/gregorio-project/gregorio/issues/103) about adopting some other form of documentation to make it possible to automatically extract the documentation from the source and keep a website upto date that way, but so far we haven't actually moved on that.
✝✝✝✝✝✝✝✝✝✝✝✝✝✝✝✝✝✝✝✝✝✝✝✝✝ Br. Samuel, OSB (R. Padraic Springuel) PAX ☧ ΧΡΙΣΤΟΣ _______________________________________________ Gregorio-devel mailing list [email protected] https://mail.gna.org/listinfo/gregorio-devel
