nmh-workers
[Top] [All Lists]

Re: [Nmh-workers] Starting the final call for features for 1.7

2016-09-28 10:39:59
Hi

Paul wrote:
Lyndon wrote:
As David mentioned, splitting the documentation out from the code is
a recipe for disaster.  It's not going to happen.

nobody said the local man pages would go away, and nobody said the
online copy of documentation would be the only copy.

Right.  This would be an addition to the normal packaging of the man
pages.

I think times when it would be useful to have the man pages rendered on
the web include

    Prospective users seeing the nmh-intro(7) page without installing,
    and the list of man pages and their apropos lines to flesh out
    what's available.

    When some fool of a user still running Ubuntu 10.10 turns up with a
    suggestion and can be pointed at documentation of it already
    implemented.  (I'm Arch Linux now.  Never out of date again.)

    Answering user's questions.  Fragments of man pages can be quoted in
    emails, but if there's mid-page anchors available then it can be
    nicer to point at it with context, or attribute the quote with the
    URL.

    Google indexing man page content on the nmh site.

Third parties already provide some of this, e.g.
https://manned.org/browse/debian-jessie/nmh/1.6-2, but it's not what
visitors to http://www.nongnu.org/nmh/ see.

-- 
Cheers, Ralph.
https://plus.google.com/+RalphCorderoy

_______________________________________________
Nmh-workers mailing list
Nmh-workers(_at_)nongnu(_dot_)org
https://lists.nongnu.org/mailman/listinfo/nmh-workers

<Prev in Thread] Current Thread [Next in Thread>