4 ms·
0mq is great; however, the 0mq Guide is the golden standard for technical documentation and one of the best tech writings there are.
by random3 6y ago
0mq is great; however, the 0mq Guide is the golden standard for technical documentation and one of the best tech writings there are.
- m101010 6y ago100% agree. I think what stood out to me the most was that it did explain a lot of the decision making. I feel like often other docs don't explain the decisions that did go into their software at all
- random3 6y agoThis is also what sets good code comments and code level API documentation apart - explaining the reasoning and intention for both implementation and for intended use. Essentially the why and how, not that what...
- lifthrasiir 6y agoMy only complaint with the guide so far was that it was historically presented as a single huge DokuWiki page with ambiguous heading structures (probably because the page was made of several other pages, each having top-level headings by its own). The current version looks much cleaner!
- endgame 6y agoEven more impressive is that Pieter put the same attention into documenting the 0mq community's social architecture, as well: https://hintjens.gitbooks.io/social-architecture/content/ https://hintjens.gitbooks.io/social-architecture/content/