Re: Admin Guide / Accounts - call for feedback

[Rahul Sundaram <sundaram fedoraproject org>]

Vladimir Kosovac wrote:
> Paul W. Frields wrote:
> > On Tue, 2006-12-12 at 05:36 -0800, Tommy Reynolds wrote:
> > > Uttered "Paul W. Frields" <stickster 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