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