Slightly improve documentation navigation #13906
Merged
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Description
This PR tries to improve navigation in the documentation in two ways.
First, it adds a link to the tutorials on the first Handbook index page. If you do not know the tutorials exist it is tricky to find in the left navigation, so adding a link at the start helps for those looking to learn and jump in.
Secondly, it moves the automated documentation for data, packages, and components lower in the table of contents so it does not push down links that are likely more valuable when starting out. This gives a better hierarchy for the links to people learning towards the top, and the reference which likely someone will be looking specifically for towards the bottom.
There is investigation and efforts to improve the side navigation to be collapsible, which is the larger work to improve navigation, but this PR should help slightly.
Types of changes
Documentation.