> Linear and limiting<p>When I'm trying to learn something that is not short and simple, linear is good.<p>Far too often when someone tries to present a long and complex subject via HTML, they don't provide an easy way to go through the entire thing in an order that is pedagogically sound.<p>It doesn't <i>have</i> to be that way...but it usually is. I'm not sure why.<p>Instead, they provide each page with a sidebar that links to other pages, turning the whole collection into a directed graph of pages full of dead ends and regions that have no links to other regions.<p>You reach some page where the sidebar links to X, Y, and Z, which are all things that depend on what you learned on that page and you are now ready to learn. If you follow the X link, you may end up learning all about X but may never again see the links to Y and Z unless you remember that a dozen pages back you saw them and purposefully seek them out. It's very easy to not even realize that you missed a whole major subtopic.<p>In a linear format, such as an actual book, a PDF, an EPUB, or even a plain text file, the author or editor makes a decision on how X, Y, and Z should be ordered. Maybe they decide X, followed by Y, followed by Z. Maybe they decide X, then Y, then things that depend on both X and Y, then Z, then things the use X, Y, and Z.<p>Different authors might pick a different ordering, but they point is they have to choose something. Whatever they choose, you just keep turning the page and you'll hit it all.<p>For a big subject, maybe you don't want to hit it all. I've seen math books address this by having a list or diagram in the front giving you alternate orders to go through a subset of the book if you just want to learn just a subset of the subject.<p>In theory, HTML should be great for this, especially HTML with JavaScript. You could have a page that lets you select from different learning paths, and then the JavaScript would put "Next" and "Previous" buttons on each page that take you through all the pages on your selected learning path. You could still have the sidebar links, but if you follow one the JavaScript could add a "Return to Learning Path" button so you can always get back on track.<p>But until more HTML authors put in the effort to provide a linear path through the material that books/PDF/EPUB/text formats force their authors to provide, PDF and to a lesser extend EPUB will remain the best option for most people trying to learn a long and complex subject online.<p>(I give PDF the nod over EPUB because most EPUBs do not have mathematical notation that looks as good as it does in PDF. I don't know if this is a technical limitation of EPUB itself, or of the EPUB readers I've used, or of the authoring tools used to create the EPUBs, or simply the authors didn't know how to do it right).<p>A good example of HTML authors putting in the effort is "The Feynman Lectures on Physics" online edition [1]. That shows you can make a website that presents a long and complex technical subject that works as well as a book or PDF, yet adjusts well to a variety of different screen sizes.<p>[1] <a href="https://www.feynmanlectures.caltech.edu/" rel="nofollow">https://www.feynmanlectures.caltech.edu/</a>