Hacker Newsnew | past | comments | ask | show | jobs | submitlogin

Well, it is meant for Marines. Hence also the wide margins, so that even after perfect binding and trimming there's still plenty of space for making notes with a half-eaten crayon.

Joking aside, lots of military manuals share the trait of introducing their subject matter well, in order to ensure that whoever's using the material has at least a reasonably strong basis in the "what" and "why" as well as the "how" - I suppose ideally that's something that'd be covered in training, but also that manual authors don't assume they are writing for an audience that is guaranteed to have been trained. The result is often a supremely useful resource in whatever subject it treats.

Frankly, I can think of worse models for the technical documentation we as software engineers produce...



I started using their template for writing a mini ops manual as a read-only-friday project, and it's still in use and the format became the business's standard for other documentation. feels nice when I see a new hire reading it.

Also, I like the cookies. https://quartermaster.army.mil/jccoe/publications/recipes/se...




Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: