Re:Ask HN: What programming/technical books do you wish exis...
by afarrell on Sunday October 26, 2014 @12:28PM
(#8511458)
I have yet to see a good long detailed but highly readable guide to writing documentation, especially one that explained how to test it for understandability.
[ Parent
| on HN ]
Re:Ask HN: What programming/technical books do you wish exis...
by theblueadept on Sunday October 26, 2014 @01:49PM
(#8511657)
You'd think/hope that a guide for that topic would be highly readable.
Re:Ask HN: What programming/technical books do you wish exis...
by afarrell on Monday October 27, 2014 @06:55PM
(#8518654)
I've seen lots of style guides, but most of them act like writing documentation and editing it are the same process. And so they will give advice on what not to do like "eliminate unnecessary words", but none on how to actually begin explaining the structure of a new codebase or an old one.