5 ms·
Ask HN: What open source projects have great documentation?
There was a great thread a couple of weeks ago on with tips on writing documentation that devs love: https://news.ycombinator.com/item?id=31945863
A lot of commenters on that thread mentioned DigitalOcean as an example of great docs for a product.
Does anyone have examples of great docs / user guides for open source projects? I'd like to study well done open source docs and learn more about what can be added to the docs to make them more useful for devs.
- tra3 4y agoEmacs documentation is a first class citizen. You can hit C-h-f to look up any function, or, C-h-k to see what a key is bound to (and then follow links to functions). I recently submitted a package to MELPA (an emacs package repo) and part of the process was cleaning up the doc strings in the code to ensure that they fit the standard.
- zzo38computer 4y agoIn my opinion, SQLite has good documentation, and so does the Fossil version control system. (Unfortunately, a lot of modern software lacks documentation, making it difficult to use. Do not assume that the user interface is understandable. If you do not include comprehensive documentation, then it will not be understandable.)
- jjgreen 4y agoZMQ: it's almost worth using the library for the documentation alone, fabulous. https://zeromq.org/get-started/ https://zeromq.org/get-started/
- MrPowers 4y agoI personally like the Polars docs because they have a detailed user guide that makes it so easy to get started with the project: https://pola-rs.github.io/polars-book/user-guide/ https://pola-rs.github.io/polars-book/user-guide/
- PaulHoule 4y agoPython.
- dragonwriter 4y agoPython, Postgres, SQLite
- commandersaki 4y agohttps://bearssl.org/ https://bearssl.org/
- mikewarot 4y agoNOT great documentation - Lazarus/Free Pascal It's all docstrings type stuff, and very incomplete
- hoofhearted 4y agoVueJS - Evan You wrote VueJS and the docs with the idea that you could pick it up and be coding an app over a weekend. Laravel - Build an end to end complete full stack application. You can incorporate just about every boilerplate feature you can think of by just following the docs. Gitlab - Open and complete docs on source management, and the Gitlab product. But also very easy to understand docs on different aspects of running a software business, including style guides, and messages from executives.
- hlesesne 4y agoCERNs openstack documentation. https://clouddocs.web.cern.ch/ https://clouddocs.web.cern.ch/
- punk_ihaq 4y agohttps://docs.streamlit.io https://docs.streamlit.io https://spacy.io/ https://spacy.io/
- _0xdd 4y agoOpenBSD. The documentation is second to none.
- atmosx 4y agoGentoo and FreeBSD. https://www.gentoo.org/get-started/ https://www.gentoo.org/get-started/ https://www.freebsd.org/docs/ https://www.freebsd.org/docs/
- xcubic 4y agoNo mentions to django?
- adammarples 4y agoSpacy had actual runnable code examples throughout, directly in the browser
- leejoramo 4y agoSvelte’s tutorial, docs and REPL are among the best both at introducing the technology and giving depth. The REPL is used in through out to teach the basics and allow the community to link to working solutions when answering questions in forums across the internet. https://svelte.dev/tutorial/basics https://svelte.dev/tutorial/basics