Hot take: Single page documentation is superior to documentation that spoon feeds three paragraphs at a time to you with prev/next pagers at the bottom.
1. Use command+f to search for things like you always do.
2. Easier to keyboard navigate.
3. Can still hyperlink to headers...
1. Use command+f to search for things like you always do.
2. Easier to keyboard navigate.
3. Can still hyperlink to headers...
4. Instantly gives you all of the docs "offline". Just keep a browser tab open or save the HTML or print to pdf.
5. From maintainer's standpoint, no need to sign up for some service that you (might have to) pay to index your search.
6. Search works in offline mode too because you don't need to connect to a service.
6. Search works in offline mode too because you don't need to connect to a service.
Of course there's challenges too like making a navigation system that can scale. Increasingly easy to solve with position:sticky though, and there are existing solutions.
