Re: [hypermail] config options documentation

From: Peter C. McCluskey <pcm_at_rahul.net_at_hypermail-project.org>
Date: Thu, 15 Mar 2001 11:51:49 -0800 (PST)
Message-Id: <20010315195149.4323B1D9E_at_foxtrot.rahul.net>

 crispen_at_hiwaay.net ("Rev. Bob 'Bob' Crispen") writes:
>I maintain several lists at work, and the greatest help would be to
>arrange the .hmrc file so that it has the options that will almost
>certainly change for every list right at the top. E.g., archive name
>string and archive directory. Immediately afterward, put the list
>archive owner's email and anything else which might be site-specific,
>followed by the remaining parameters which are likely to remain
>constant over all the lists maintained on a site.

 This would probably make it easier for experienced users to use it as a reference, at the cost of making it harder for newbies to find options when they don't know what's available. This seems like a bad tradeoff for the .html files, where I can add navigation links that can probably get experienced users to the right place quickly. For the man page, I'm uncertain - maybe it's futile to try to make it easy to navigate all the options, and we should direct newbies to the .html files (maybe shortening the descriptions of the rarely used options to one line each in the man page)?

---

Peter McCluskey | Fed up with democracy's problems? Examine Futarchy: http://www.rahul.net/pcm | http://hanson.gmu.edu/futarchy.pdf or .ps Received on Thu 15 Mar 2001 09:55:32 PM GMT