* docs: show the page title above the TOC for generated pages.
Signed-off-by: Peter Jausovec <peter.jausovec@solo.io>
* lint: remove leading 0
Signed-off-by: Peter Jausovec <peter.jausovec@solo.io>
* docs: show Parameters as the first element in TOC for gen-pages
Signed-off-by: Peter Jausovec <peter.jausovec@solo.io>
---------
Signed-off-by: Peter Jausovec <peter.jausovec@solo.io>
- Add missing ARIA annotations on the See Also entry in the right-hand TOC
- Add missing ARIA annotations on the FAQ pages, and switch from a UL to an OL
list for the questions in order to get rid of the bullets.
- Increase the constrast for links, per LightHouse analysis.
- Add support for disabling syntax coloring in example text blocks. This
can be controlled from the menu.
- Make better use of html semantic elements to help
search & screen readers.
- Add or improve ARIA annotations for accessibility
- Improve print-time formatting.
- Prevent See Also sections from showing up on index pages.
- Clean up and simplify some JavaScript & CSS.
- Set a height for the idea and warning icons in order to prevent
screen flicker when loading pages with these icons.
- Add <github_file> <github_blob> and <github_tree> to make it simpler to link to the right
place on GitHub.
- Use these new sequences throughout the docs.
- Also, fix bad HTML generated for the TOC in certain cirsumstances.
- Fix extra blank line inserted at the bottom of indented code blocks.
- Make "See also" show up in the TOC.
- When inlining the TOC at the top of a page, surround it with a pair of <hr> tags to get a line on the screen
- Fix rendering bug with TOC when specific characters showed up in section titles.
- Fix extra indent in the TOC in certain cases.
- Rename "See Also" to "See also" to follow our naming guidelines.
I didn't realize the Hugo's TOC support features only work for markdown files.
Since our reference pages are HTML, none of these were getting TOCs. I now roll
my own TOC functionality in that case, to bring up back TOCs for our reference
pages.
Peter Jausovec
Bartosz Wojcicki
Martin Taillefer
mtail