[Gllug] Open source == 'Popular Computing'

[Nix]

On 20 Apr 2009, Joel Bernstein verbalised:
> Faced with a requirement to write docs, instead wrote a better  
> documentation system. To hold docs which still suck.

The Emacs docs don't suck.

The problem is that the vast majority of free software projects consider
that a bunch of halfassed man pages implementing a partial reference
manual is *enough* documentation. No, guys, you need a user manual too,
and you probably need a tutorial...

(in some cases these exist as web pages. Not in enough, and sometimes
upstream takes the demented approach of the netpbm maintainer and
provides reference manpages *as web pages* with a *horrible* replacement
man tool which runs lynx when you ask for a netpbm manpage, and an even
more appalling half-thought-out crock to preformat man pages if for some
unaccountable reason the 'manweb' wrapper isn't your idea of a good
documentation system. Thanks, but no thanks. Amazingly, this was pushed
as an *advance* over the pre-existing manpages in the netpbm release
which ditched those manpages wholesale and moved to the web
monstrosity.)
-- 
Gllug mailing list  -  Gllug at gllug.org.uk
http://lists.gllug.org.uk/mailman/listinfo/gllug