News for hackers. Stuff that matters.
Re:Reading with a pencil by nimbius on Tuesday September 04, 2018 @08:04AM (#17908404)
as an engine mechanic, I find this article horrifying for technical manuals in a shop. If i need the clearances for ecotec engine valves, I dont want to see some crayon-eating technicians doodles in the margins. I also dont want to see some shade-tree greybeards corrections and musings about how "this is how it was done back in my day."

This is why we keep notes at our workstations, not in our reference bookshelf.

Re:Reading with a pencil by icc97 on Tuesday September 04, 2018 @10:06AM (#17909114)
I bow to your experience, but I can see how technical manuals similar to recipe books could definitely benefit from notes that say "this did/didn't work because...". If you've got rubbish colleagues, then yes you've got a problem, but also you could have an excellent record from the old master that just retired.

You could keep notes as separate pages in the book, but having the notes in context does appear to have the potential to enhance a manual rather than ruin it.