Vladimir Kosovac wrote:
Paul W. Frields wrote:
On Tue, 2006-12-12 at 05:36 -0800, Tommy Reynolds wrote:
Uttered "Paul W. Frields" <stickster@xxxxxxxxx>, 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
--
fedora-docs-list mailing list
fedora-docs-list@xxxxxxxxxx
To unsubscribe:
https://www.redhat.com/mailman/listinfo/fedora-docs-list
