The State of Publishing Documentation in Fedora

[Brian (bex) Exelbierd]

On Feb 12, 2015, at 8:38 PM, Brian (bex) Exelbierd <bex at pobox.com> wrote:

> 
> 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.

I’ve done a bit more reading and found that a lot of information is at http://doc.php.net/tutorial/

They work in docbook and have their own docbook processing engine.  I don’t know that it is perfect, but is may be worth reading up on their processes.

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/728fabd4/attachment.sig>