Order of keys in the NWB source schemas of the NWB Format Specification documentation

[ehennestad]

Each of the sections in the NWB Specification Language documentation states a preferred order for specification keys of groups, datasets, attributes and links, i.e

The keys should be ordered as specified above for readability and consistency with the rest of the schema.

Full example:
https://schema-language.readthedocs.io/en/latest/description.html#groups

This ordering is not followed in the NWB Format Specification documentation, for each of the yaml insets in the Schema Sources chapter.

Example here:
https://nwb-schema.readthedocs.io/en/latest/format.html#sec-timeseries-src

Would be great if the same order could be followed in the documentation, as it makes the schemas much easier to read.

[rly]

Good point. I agree

[rly]

This is an issue for hdmf-docutils. I created an issue there. I think it is a pretty straightforward change. If you have time, it would be great if you could take a go at it! hdmf-dev/hdmf-docutils#91

[rly]

This is now resolved in the 2.9.0 release https://nwb-schema.readthedocs.io/en/latest/format.html#schema-sources