On Wed, 2007-08-15 at 18:10 -0500, Dan Smith wrote: > Paul basically said that only one way should be documented. He appears > to be strongly opposed to the idea of documenting different ways of > doing things. That's a fairly inaccurate representation of what I said, so I think you may want to reread my earlier post to get the gist of it. Let me requote myself here for accuracy: "The right way to do things is not to show a slew of solutions and let the user pick. The user has already consulted documentation because they don't know how to pick; it's the job of the core documentation to give the simplest and most efficient solution. This doesn't mean there can't be auxiliary documentation about many solutions; there are many examples of good docs that do just that. But before doing any documentation in that realm, we need a stronger core docs set." That statement is actually not far removed at all from what Karsten said. > Sorry, without Paul's comment to compare it to, I'm > guessing. I presume > you mean his comments that we want to document the default > installed > applications before we branch into non-defaults also available > for > Fedora. My comment above is that the reason we don't have the > default > camera stuff well covered is a lack of resources. Whoever is > working on > the User Guide decides what are the priorities for > coverage. If there > isn't a person or time to get to cameras, it is not in that > guide. > > > As for default install that I'm not as sure of. I have never used the > default install. The core documentation, at least inasmuch as guides for beginners are involved, should concern itself precisely with the default installation. That is, in fact, what a beginner would logically install, having no basis for making any other choices. [...snip...] > Part of the problem with not having enough writers on the > project is the > task list is incomplete. > > This sounds like a good place to review the task list. I've noticed > quite a few missing areas such as text processing. I'd suggest taking > one section a week and building a task list from a concencious on the > list. Start this thread then, sounds good to me. [...snip...] -- Paul W. Frields, RHCE http://paul.frields.org/ gpg fingerprint: 3DA6 A0AC 6D58 FEC4 0233 5906 ACDB C937 BD11 3717 Fedora Project: http://fedoraproject.org/wiki/PaulWFrields irc.freenode.net: stickster @ #fedora-docs, #fedora-devel, #fredlug
Attachment:
signature.asc
Description: This is a digitally signed message part
-- fedora-docs-list mailing list fedora-docs-list@xxxxxxxxxx To unsubscribe: https://www.redhat.com/mailman/listinfo/fedora-docs-list
