Re: dividing up the wiki?

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

 



On 08/22/2013 08:42 AM, Matthew Miller wrote:
> On Thu, Aug 22, 2013 at 11:24:26AM -0400, Jaroslav Reznik wrote:
>> So I'm ok making sure these use cases are divided somehow, but does it
>> have to be all on Wiki?
> 
> It doesn't have to be wiki, but there is a definite need for semi-polished
> user (again, broad sense of user) documentation with a lower bar to entry.
> If I see a typo or outdated information on the docs site, I might... file a
> bug, I guess? Probably just ignore it. Not obvious how to dive in.
> 
> Also, the documents all seem like of book-like. What about smaller howtos
> and quickstart guides? 

This may be an artifact of the level of involvement of the doc writers
from Red Hat, who think/work in the book format.

As it happens, when people come to help Docs, they typically want to
work on shorter how-to documents, not get involved in helping maintain a
300 page Deployment Guide. If we do work to highlight these type of
documents - make them front-page centric, different look/header to the
page to differentiate, etc. - we also make this sort of doc work more
attractive to people.

- Karsten
-- 
Karsten 'quaid' Wade
http://TheOpenSourceWay.org  .^\  http://community.redhat.com
@quaid (identi.ca/twitter/IRC)  \v'  gpg: AD0E0C41

Attachment: signature.asc
Description: OpenPGP digital signature

-- 
websites mailing list
websites@xxxxxxxxxxxxxxxxxxxxxxx
https://admin.fedoraproject.org/mailman/listinfo/websites

[Index of Archives]     [Fedora Users]     [Linux ARM]     [ARM Kernel]     [Older Fedora Users]     [Fedora Advisory Board]     [Fedora Security]     [Fedora Devel Java]     [Fedora Desktop]     [ATA RAID]     [Fedora Marketing]     [Fedora Mentors]     [Fedora Package Announce]     [Fedora Package Review]     [Fedora Music]     [Fedora Packaging]     [Centos]     [Fedora SELinux]     [Coolkey]     [Yum Users]     [Yosemite News]     [KDE Users]     [Fedora Art]     [Fedora Docs]     [Asterisk PBX]

  Powered by Linux