Questions for all programmers willing to help a beginner

user1 bqz69 at telia.com
Tue Apr 27 22:40:40 UTC 2010


 
> Writing good code and writing good docs are two very different things
> and a lot of people are good in just one of them.
> 
> A real good programmer writes code that makes others wanting to write
> docs for it ;-)

Well, I am the author of www.minihowto.org and I have almost never been 
looking into the code when writing documentation, as I do not understand 
very much code.

So, the programmer should at least write enough documentation about how a 
program works, in order for somebody else to write the documentation.

I have met a few programs I have had to give up using because of lack of 
documentation, and when one do not know how to use a program, how should 
one then be able to write documentation.

This is a very important subject I find, even some home appliances are 
very difficult to use because of lack of good short documentation.

 






More information about the ubuntu-users mailing list