HACKER Q&A
📣 kartoshechka

The most pleasant code documentation you've ever worked with


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.

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.

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.

[1] https://spacy.io/api/dependencyparser


  👤 nwrk Accepted Answer ✓
You can easily achieve same with:

https://vuepress.vuejs.org/guide/#how-it-works

https://docsify.js.org/#/

(or thousands of similar generators..)

The docs are based on markdown

https://github.com/explosion/spaCy/tree/master/website/docs