The State of Publishing Documentation in Fedora

[Brian (bex) Exelbierd]

On Feb 12, 2015, at 12:06 AM, Jeff Fearn <jfearn at redhat.com> wrote:

> Which means you can also consider switching to a real CMS like medai wiki, moin moin, etc.

A wiki has a lot of appeal when it comes to reduced friction for infrequent or drive-by contributors.  However, it is my experience and belief that if you don’t have a strong community wiki-garderners it falls apart quickly.  If we want to go in this direction, I would encourage us to adopt the approach of the php manual (as I understand it).  Non-core maintainers add notes to pages.  Those notes are periodically reviewed and incorporated into the main manual.  At that point the notes disappear.  I don’t work with that project, but I’d love to know more about how their process works if someone knows.

regards,

bex

-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 496 bytes
Desc: Message signed with OpenPGP using GPGMail
URL: <http://lists.fedoraproject.org/pipermail/docs/attachments/20150212/9286d0e0/attachment.sig>