I'm an aspiring Python ML engineer and most of the time I encounter Google Material docs (if that's the thing) which is somewhat consistent throughout Google products, readthedocs.io and Flask-ish docs, though I don't know what the origin is, but hope you got the idea.<p>All of them are ok in terms of usability after spending some time, and generally they aren't shy of spitting out poorly navigatable mesh of classes, methods and examples. But recently I stumbled upon spaCy [1] docs, and this just blew me away.
For example, progress bar acting as scrollbar, but placed more conveniently, easily distinguishable class headers, the separate column for code snippets, wonderful method signature overview.<p>I thought it would be a nice idea to share well executed docs, and any hacker could've been pick up something for their docs or grasp what makes one comfortable to use.<p>[1] https://spacy.io/api/dependencyparser
You can easily achieve same with:<p><a href="https://vuepress.vuejs.org/guide/#how-it-works" rel="nofollow">https://vuepress.vuejs.org/guide/#how-it-works</a><p><a href="https://docsify.js.org/#/" rel="nofollow">https://docsify.js.org/#/</a><p>(or thousands of similar generators..)<p>The docs are based on markdown<p><a href="https://github.com/explosion/spaCy/tree/master/website/docs" rel="nofollow">https://github.com/explosion/spaCy/tree/master/website/docs</a>