Re: HTML documentation for latest MusicXML version?

Hello Karim,

Thank you so much for this! 

I definitely want to get some documentation present for 4.0 so we can retire the 3.0 version. Ideally this would incorporate the extra material that is in the 3.0 spec, such as the tutorial, the musical examples, and the additional explanations.

It probably is time to write this up as an issue. We could then use that issue to collect some tooling alternatives such as xs3p / xsltproc, gitbook, and several other tools that specialize in either XSD-derived and/or GitHub-based specifications.

Best regards,

Michael Good
VP of MusicXML Technologies
MakeMusic, Inc.

> On Dec 6, 2020, at 1:09 PM, Karim Ratib <karim.ratib@gmail.com> wrote:
> 
> For what it's worth, I produced an HTML version of the MusicXML 3.1 XSD using a tool called xs3p and xsltproc. Although it's significantly simpler than the official (but obsolete) user manual, it has a number of advantages that I outline on a blog post at https://blog.karimratib.me/2020/12/06/document-musicxml.html <https://blog.karimratib.me/2020/12/06/document-musicxml.html>. The result is at https://blog.karimratib.me/musicxml.html <https://blog.karimratib.me/musicxml.html>.
> 
> If there's interest from the community here, we can enhance the XSLT transformation as needed, and automate the conversion process using a GitHub Action every time a change is made to musicxml.xsd. 
> 
> 
> On Fri, Nov 20, 2020 at 11:36 AM Karim Ratib <karim.ratib@gmail.com <mailto:karim.ratib@gmail.com>> wrote:
> I've been using https://usermanuals.musicxml.com/MusicXML/Content/MusicXMLReference.htm <https://usermanuals.musicxml.com/MusicXML/Content/MusicXMLReference.htm> as a browsable reference for MusicXML, but I notice it was last updated in 2015. Is there an up-to-date documentation site for version 3.1? https://w3c.github.io/musicxml/ <https://w3c.github.io/musicxml/> does not seem to include the full documentation - only changes.
> 
> If it's not available anywhere, and given some interest from the community, I'd be happy to engage in standing up a site generator for the latest version that can be kept updated with GitHub commits.
>