News for hackers. Stuff that matters.
Re:Why I still don’t contribute to open source by leon_ on Wednesday May 04, 2011 @02:41AM (#2512993)
Also if you understand the project well enough to write documentation you have to have the ability to put yourself into a new user's position. Many people lack this ability and create just unusable docs.
Re:Why I still don’t contribute to open source by jwhite on Wednesday May 04, 2011 @04:07AM (#2513125)
Agreed. It's a hard skill even when you're trying consciously. One way to improve the situation is to actually give your draft documentation to a trusted user for feedback. I've been lucky enough to have an enthusiastic user in-house who has road-tested some of my documentation, and it's much better for the exercise.