On Mon, Nov 25, 2013 at 04:19:03PM +0100, Petr Kovar wrote:
Hi all,
I would like to see these best practices covered in our Fedora formal
documentation, hosted on
docs.fedoraproject.org. Currently, there are
different HOWTOs and guides on the Fedora wiki, some of them are outdated,
some are not, so instead having a single guide that would merge content from
those wiki documents is something I would like to focus on.
I'm not certain if this would work well. I do agree that the various
places that you can find the documentation is confusing. However, I think
that putting something under docs.fp.o will just lead to:
http://xkcd.com/927/
Right now we have a standard location for official Packaging Guidelines...
the Packaging: namespace on the wiki. These other sources of information on
the wiki have grown up because packagers want to have something that they
can modify very quickly and easily. docs.fp.o will be less quick to modify
than documents in the Packaging: namespace so I fear we wouldn't be able to
replace the proliferation of individual wiki documents and just end up
adding another location where people could look for information that may or
may not be up-to-date and may or may not conflict with the currently
approved Guidelines.
-Toshio