Hacker News Reader

> Fixing up man pages is something that non-technical volunteers could help with

Another problem with that is that most tools used in this process are made with technical users in mind. A lot of people can expand documentation, but sending manpages patches in a bug tracker is a technical step.

View on HN

If one was so non-technical as to be incapable of using diff and a bug tracker, perhaps they shouldn't be writing manpages.

Sure, they probably shouldn't be creating man pages. But they could be great at copy editing and polishing existing man pages.

Or they could be expert translators.

So it's a shame that man pages are not as good as they could be.

There are other forms of documentation, but it'd be nice if man pages were the best the could possibly be.

Reply on news.ycombinator.com