dividing up the wiki?
Karsten 'quaid' Wade
kwade at redhat.com
Thu Aug 22 17:42:08 UTC 2013
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
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 255 bytes
Desc: OpenPGP digital signature
URL: <http://lists.fedoraproject.org/pipermail/websites/attachments/20130822/bdfda9ae/attachment.sig>
More information about the websites
mailing list