Version switching for the Api docs section will be available soon. The url schema will also be changed, so that the manual and api are tracked under one version, which will allow more consistent linking between manual / api content without leaving the version subpath.
To be clear, the latest / v8.0.0 docs will only marginally change content wise, so we didn’t go with a fully blown syntax toggling feature due to time constraints and instead branched to two different doc versions instead.
To give more context on why we did this: Syntax shows up in the docs in very different markups and contexts (table cells, code blocks, api signature blocks,…) which means we’d need to spend a lot of time fine tuning the syntax convertion mechanism to be able to reliably change syntax dynamically (and we couldn’t really guarantee if every snippet transforms into a human readable form). The experience would probably be flaky, so we hope that for now ppl are willing to use the v8.0.0 section for their Reason needs until our IDE plugins are ready.
I think this should be good enough and will help us freeing up some of our time to work on other urgent features such as full doc search as well.
Hope this helps!