Re: The State of Publishing Documentation in Fedora

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



On Feb 12, 2015, at 8:38 PM, Brian (bex) Exelbierd <bex@xxxxxxxxx> wrote:

> 
> On Feb 12, 2015, at 12:06 AM, Jeff Fearn <jfearn@xxxxxxxxxx> 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

Attachment: signature.asc
Description: Message signed with OpenPGP using GPGMail

-- 
docs mailing list
docs@xxxxxxxxxxxxxxxxxxxxxxx
To unsubscribe:
https://admin.fedoraproject.org/mailman/listinfo/docs

[Index of Archives]     [Fedora Users]     [Fedora Desktop]     [Red Hat 9]     [Yosemite News]     [KDE Users]

  Powered by Linux