FDP docs process - round 2

[Paul W. Frields]

On Mon, 2004-08-16 at 09:50, Karsten Wade wrote:
> As detailed in
> https://bugzilla.redhat.com/bugzilla/show_bug.cgi?id=129993.
> 
> Please read and comment; main discussion on the list, I think, since
> this is a pretty important document for all of us to agree upon.
> 
> [snarf_from_bz129993]
[...snip...]

I think we need a short statement at <http://fedora.redhat.com/docs/>
that states:

"If you think a specific piece of documentation is needed, enter a
request for enhancement (RFE) in Bugzilla. Look over the
_current_list_of_bugs_[1] first to be sure your request is not already
in progress. If it is not, _enter_a_new_RFE_bug_[2] and it will enter
the queue."

...or something to that effect.

([1] & [2] can duplicate the links at the Docs Project page. )

This came up today as I look over fedora-devel-list and see that there
is a great deal of confusion starting to arise over the way Arjan is
preparing the kernel RPM these days. Bear with me while I describe the
problem for those on this list who may not read that one.

Case in point, kernel-sourcecode has been dropped in favor of having the
user simply download kernel-<version>.src.rpm. He indicates there will
be documentation about how to use this for building new kernels from
scratch. This process will be very different from the old one, and the
FDP should probably get in on (or maybe just above) the ground floor WRT
producing it.

I tried to put myself in the mindset of someone who wanted to ask for
docs, but didn't know where to start. I think many people who might
helpfully be entering RFE's for us are not making it down to the bottom
of the FDP page at <http://fedora.redhat.com/projects/docs/>, and don't
understand what those links are for. In addition, the fact that the
entire first section of the FDP page would lead fast readers to believe
that no resources exist on that page for them, unless they want to do
some writing themselves.

A very short statement on what a non-writer can do, at the gateway most
users will likely enter, would go a long way; we want to encourage even
small contributions from people who aren't able to make large ones.

This is in Karsten's FDP docs process thread because it also is oriented
toward people who want to be FDP contributors, as opposed to Joe User
(or even Sally Developer), who may simply want to ask that we consider
writing a certain doc. This is not to say that case needs to be in the
FDP process guide, but certainly we should be considering it to make the
Fedora home page more usable.

Unless anyone has objections, I'll Bugzilla this as a RFE of the
<http://fedora.redhat.com/docs/> page... and I'll likely RFE the kernel
situation too.

-- 
Paul W. Frields, RHCE