Re: Discussion - issues with Fedora Join - solutions/ideas and TODOs?

[Ankur Sinha]

<snip>>
> > > https://docs.fedoraproject.org/en-
> > >
> > > US/Fedora_Draft_Documentation/0.1/html/RPM_Guide/index.html
> >
> > You see the work draft somewhere, it should tell you that this
>
> isn't
> > finished.
>
> of course, but it still contains maybe useful information (although i
> wouldn't use it much)

Yea, but so will thousands of blog posts on the subject ;)
> > > http://rpm5.org/docs/rpm-guide.pdf
> >
> > This is general rpm info - not specific to Fedora.
>
> of course, but still related/useful to packaging imho. (especially,
> because its the most comprehensive document about rpm, i think)

Honestly, one rarely needs this - in all my years as a package
maintainer I may have looked at this maybe 4 times..
> <snip>
>
> well ideally, we would just have a few documents with up-to-date
> information, like:
>
> one general, up-to-date document about packaging in fedora, which
> links
> e.g. to  http://rpm5.org/docs/rpm-guide.pdf%C2%A0and%C2%A0 the language
> specific
> guide.

Yea, but in the case of packaging, the wiki pages are up to date and
pretty much official. If there's something you can't find in
Category:Packaging, it's going to be an extremely rare one off and then
you shoot an e-mail to the devel list.
> At least that is my opionion on "great documentation" :) Maybe (i'm
> honestly not sure if i will have time for that) i can help with that
> in the future.

The wiki can be improved, yes - there's so much disorganised
information there that it often takes a while to find things if you
don't know the general region :/

Again, if you have specific ideas to improve things, I can pass them on
to the right people :)