[lopsa-discuss] books about technical writing

2009-12-30 Thread Yves Dorfsman
Hi, I find myself doing more and more writing in my different contracts. I'm fairly happy with the documents I produce, and so my do my customers since they keep coming back, but I'm sure there is space for improvement. I've just started googling for good books on the subject, but there doesn'

Re: [lopsa-discuss] books about technical writing

2009-12-30 Thread Brent Chapman
On Wed, Dec 30, 2009 at 2:38 PM, Yves Dorfsman wrote: > > Hi, > > I find myself doing more and more writing in my different contracts. I'm > fairly happy with the documents I produce, and so my do my customers since > they keep coming back, but I'm sure there is space for improvement. > > I've ju

Re: [lopsa-discuss] books about technical writing

2009-12-30 Thread Jesse Trucks
Yves, My favorite work on the topic is actually a presentation (and at one point an invited talk at LISA apparently) done by Steven Levine (then of SGI, currently of RH, IIRC) called "Why the Documentation Sucks and What You Can Do About It." The presentation is available online at: http://www.us

Re: [lopsa-discuss] books about technical writing

2009-12-30 Thread Aleksey Tsalolikhin
Hi, Yves. I recommend "Documentation Writing for System Administrators" by Mark C. Langston. http://www.sage.usenix.org/pubs/11_documenting/11_documenting.html The quality and quantity of my own documentation, and my confidence in it, all went up using this booklet. Best, -at __

[lopsa-discuss] I am checking for interest in a "Learning Cfengine 3" book

2009-12-30 Thread Aleksey Tsalolikhin
Hi. Could you please write me directly (I'll summarize) if you'd be interested in purchasing a "Learning Cfengine 3" book -- an introduction to automating system administration with Cfengine 3, with lots of working examples. Happy New Year, Aleksey Tsalolikhin ___