[TUHS] man-page style

[Noel Hunt]

Surely then, your remarks are a more damning
assessment of the Linux manuals, in that the
terrible state of the documentation is now a
result of 'professionals'.


On Sun, Nov 18, 2018 at 5:21 AM Kurt H Maier <khm at sciops.net> wrote:

> On Sat, Nov 17, 2018 at 11:14:53AM -0700, arnold at skeeve.com wrote:
> >
> > The man page authors / tech writers at Sun were paid to write man
> > pages, and learned / were taught how to do it well. The Linux stuff is
> > done by volunteers.  You're comparing apples and oranges.
>
> How do we kill this meme?  Linux is open to contribution by volunteers
> but the overwhelming majority of the work done on the OS for *at least*
> the last ten years has been by professionals who are paid to work on
> Linux.  Pretending otherwise is disingenuous, and anyway I'm not sure
> why the OS that powers pacemakers and self-driving car research gets to
> be held to a lower standard.
>
> khm
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://minnie.tuhs.org/pipermail/tuhs/attachments/20181118/1dda5901/attachment.html>