Re: Reviewing spec file descriptions

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



On Wed, 2007-10-31 at 01:08 +0530, Rahul Sundaram wrote:
> Hi,
> 
> Each of the RPM packages in Fedora have descriptions in their spec files 
>   and while many of them are good, there are quite a few ones that are 
> vague and not descriptive enough.
>  
> I think the documentation team should look into this and maybe review 
> guidelines can include a sign-off from someone in the documentation team 
> to verify the quality of the descriptions.
> 
> This is also very good for new contributors to participate (along with 
> kbase.fedoraproject.org when it's launched) and help out without any 
> long term commitment involved.
> 
> Comments?

That's an idea that has been kicking around RH docs folks for a while,
but hasn't gone anywhere so far.  Seems like a great time to see it
through to completion!  

I agree with you, and also have had the experience of waiting for the
long haul to get a few lines changed in a RHEL package info.  By doing
it as part of an overall process, we are more likely to see real changes
made.

There are two basic ways:

1. New tooling + human process
2. Human process

We might be able to do number 2 without too much pain.  One question is,
how to get the change(s) committed to the package's SCM?  What role for
Bugzilla in this?

I can imagine good requirements but what tool can could fill them?
Something like Transifex for spec instead of PO/POT files. :)

- Karsten
-- 
Karsten Wade, Developer Community Mgr.
Dev Fu : http://developer.redhatmagazine.com
Fedora : http://quaid.fedorapeople.org
gpg key : AD0E0C41

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

[Index of Archives]     [Fedora Users]     [Fedora Desktop]     [Red Hat 9]     [Yosemite News]     [KDE Users]

  Powered by Linux