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

Thorsten Leemhuis fedora at leemhuis.info
Tue Jun 12 16:32:18 UTC 2007


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?




More information about the fedora-advisory-board mailing list