SDFormat Specification website should be updated automatically

[azeey]

Desired behavior

The specifications on http://sdformat.org/spec should be updated automatically when changes are made to the spec files in the source.

Alternatives considered

Implementation suggestion

Additional context

[jwnimmer-tri]

In the meantime, could you point to the code that generates those pages? I assume there is code somewhere that converts these files into the HTML documentation, but I haven't been able to find it yet after a few minutes of searching. I'd like to try running it locally on the latest spec (spec 1.11 isn't on the website yet).

[azeey]

Unfortunately, the code that does that is currently in a private repo. But I'll go ahead and update the website.

[azeey]

I've updated the website.

[jwnimmer-tri]

Bigger picture -- Drake implements a subset of the full specification. We have a goal of publishing the "Drake fork" of that documentation (on the Drake website), based on our subset. If the docs-generating code is provided soon as open-source, then we'd probably choose to run the same tooling. If not, then we'll implement a new html-docs-from-schema tool ourselves, local to Drake.

[azeey]

The plan is to convert the website to use a static site generator. At that point, the spec->html generation code will also be open-source. As @EricCousineau-TRI probably recalls, this was on our todo list, but we didn't have time to get to it. I hope we'll have it done this year, but I don't have a more solid timeline.