Paul W. Frields wrote:
> On Tue, 2006-12-12 at 05:36 -0800, Tommy Reynolds wrote:
>> Uttered "Paul W. Frields" <stickster(a)gmail.com>, spake thus:
>>
>>> On Mon, 2006-12-11 at 12:52 +0530, Rahul Sundaram wrote:
>>>> Vladimir Kosovac wrote:
>>>>> I have couple of sandboxed pages ready for your review/input at:
>>>>>
http://fedoraproject.org/wiki/wiki/VladimirKosovac/StylingPage/WorkPage
>>>> For example, if I am doing web services administration, I would expect
>>>> to learn about system-config-httpd in that section along with the Apache
>>>> configuration details.
>>> That's an excellent point Rahul makes -- that our documentation should
>>> be largely task-based. Relevant material should be lumped together
>>> where possible and logical.
>> Agree emphatically.
>>
>> What I detest is "feature-oriented" documentation that mostly walks
>> around the buttons and menus of a GUI, or is an elaborated bullet
>> list of each separate feature (even if the elaboration runs to pages
>> or chapters). I'm as guilty as anyone about doing this ("My name
>> is Tommy. Chorus: Hi, Tommy!") but I'm recovering ;-)
Am I understanding these suggestions well if I then say that tables on
the intro page are redundant. To me, they look just like the stuff we
want to avoid - feature listing for GUI tools - although more obscure.
Scrap them, then?
Like I said, that kind of information is better for reference when you
do want to know a complete listing of the system configuration tools.
Move it as a addendum.
Rahul