better documentation (was: Re: governance, fesco, board, etc.)

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

 



On 12.06.2007 18:10, Rex Dieter wrote:
> Ralf Corsepius wrote:
> 
>> * bodhi, koji are immature, semi-functional, semi-cooked pieces of SW
>> which still have to prove their longevity, but so far don't do anything
>> but introducing bureaucracy and are almost strangling former FE.
> 
> But "good enough" to get the job done *now*.
> Could you provide constructive suggestions(1) on how to make things better?

Better documentation. A step by step guide: "how to update a Fedora
package for dummies after the merge" or "The way of a package update:
from cvs commit over koji and bodi into the proper repo". Linked on
http://fedoraproject.org/wiki/PackageMaintainers please.

Lack of proper documentation (¹) is the root problem of those techniques
afaics and is responsible for most of the confusion and frustration
about the merge.

Example: today a long term contributor that started in the the fedora.us
days and did some important stuff for Fedora in the past years send me a
mail with round about this text "HELP! I need to get a package updated
in Fedora 7 and I don't know how to do that". That IMHO shows that
something seriously is wrong (²).

CU
thl


(¹) -- some tools like koji even have documentation, but how to use them
is not written down properly

(²) -- go to http://fedoraproject.org/wiki/PackageMaintainers yourself;
do you find a document on that page that describes how to update a
package for Fedora 7?

_______________________________________________
fedora-advisory-board mailing list
fedora-advisory-board@xxxxxxxxxx
http://www.redhat.com/mailman/listinfo/fedora-advisory-board

[Index of Archives]     [Fedora Users]     [Fedora Outreach]     [Fedora Desktop]     [Fedora KDE]     [KDE Users]     [Fedora SELinux]     [Yosemite Forum]     [Linux Audio Users]

  Powered by Linux