readthedocs changes October 7 2024 about dart HOT 7 CLOSED

turned on addons and built readthedocs-test
https://docs.dart.ucar.edu/en/readthedocs-test/
seems fine. Edit (ish)

Flyout menu location is not great

Order of versions is incorrect in the menu

Switched off notification for 'latest'. 'latest' and 'stable' are the same for DART.

using SemVer order, better but backwards. Toggling flyout sorting does not seem to make a difference.

from dart.

@ann-norcio @c-merchant @Benjamin-Gunn
If you get a chance can you have a click around https://docs.dart.ucar.edu/en/readthedocs-test/
Readthedocs are updating how they build the documentation so it would be good to catch any weirdness before the Oct 7th switchover.

from dart.

having the add on seems to break the search on the 'lastest' docs. bummer.

from dart.

switched off the addons for now and rebuilt 'latest'

from dart.

Noticed the same things Helen pointed out while clicking around https://docs.dart.ucar.edu/en/readthedocs-test/

• The versions are not listed in the correct order on the flyout menu
• Formatting of the table here is off, but it's also that way in the 'latest' version

from dart.

note on redirects.

old versions of the docs have README.html
The flyout links are index.html

If you redirect from as specific version /en/vX/ -> /en/vX/README.html
you can use the flyout menu from new to old, but not old new.

from dart.

general one way and specific back fixes the old doc flyout 404

Note delete these if the redirects cause problems

from dart.