sdformat: Website schemas are old and URLs are not versioned?

gazebosim / sdformat

Simulation Description Format (SDFormat) parser and description files.

http://sdformat.org

Apache License 2.0

165 stars 92 forks source link

sdformat: Website schemas are old and URLs are not versioned? #545

Open EricCousineau-TRI opened 3 years ago

EricCousineau-TRI commented 3 years ago

Environment

N/A

Description

Expected behavior: Latest schemas are visible via a clearly versioned mechanism.
Actual behavior: Current schemas are old (e.g. http://sdformat.org/schemas/root.xsd), and are not versioned. Also, all remote assets that have cross-references require remote fetching. May inline.

Steps to reproduce

Output

N/A

EricCousineau-TRI commented 3 years ago

Per VC:

<?xml-model?> is the mechanism used in package.xml: http://xml-model.info/
Example usage of <?xml-model..?>: https://github.com/ros2/rcl/blob/3.1.2/rcl/package.xml#L2
Should document that it's not necessary on SDFormat (given complexity), but can help given other tooling (e.g. editors and online linting / auto-complete)

FirefoxMetzger commented 3 years ago

I ran into this issue today as well. In particular, not all files are present on the schema server. At the time of this writing, the following ones are missing: