Andy Oram has written a nice article on Linux Documentation which is also a good read when thinking about how to document your own software...