Writing Well
Prev
Next

Chapter 3. Writing Well

Some things to think about when writing documentation

How many times have you attempted to read a man page, and given up in frustration — all the facts are there, but the writing is too dry and technical for you to make sense of them? We want to avoid this with the documentation you're writing.

It's difficult to avoid the very dry, choppy style we're all too familiar with, but do try to make the writing flow and keep it user-friendly. Try to be as friendly as you can manage without being patronizing, and without sacrificing clarity or detail.

Things you should consider:

Prev
Next
Home


Would you like to comment or contribute an update to this page?
Send feedback to the TDE Development Team