reorganize schema section

[Remi-Gau]

For the schema, there is one obscure link in the website that points to the README of the schema. I think this README should either be made WAY more obvious. Note that a more user friendly rendering of this README is available on the BIDS schema tools RTD. In the spirit of avoiding having information scattered Another option would be to render file as part of the spec itself around this page. @effigies what do you think?

• from Reorganize the standard section of the website #518

[effigies]

The README in the spec website is just an accident of mkdocs rendering any markdown it finds. It is intended to be descriptive and not at all make statements that we need to retain backwards compatibility, so it would probably be better to remove it from the specification website, if mkdocs allows us to exclude files.

[effigies]

Sorry, just realized this is the website. Yes, if we're linking to the README, we should switch to the bidsschematools RTD.

[Remi-Gau]

you can exclude files

see for example

bids-website/mkdocs.yml

Line 81 in 2cf8af9

exclude_docs: |

[Remi-Gau]

by the way would it not be better to render this schema page (https://bidsschematools.readthedocs.io/en/latest/description.html) in the bids spec website rather than on the doc of bidschematools

cannot remember the rationale for rendering it there