[CentOS-docs] Docs strategy and tactics [RFC]

Mon Mar 16 21:12:09 UTC 2015
Jason Brooks <jbrooks at redhat.com>


----- Original Message -----
> From: "Dave Neary" <dneary at redhat.com>
> To: "Mail list for wiki articles" <centos-docs at centos.org>
> Sent: Monday, March 16, 2015 1:42:06 PM
> Subject: Re: [CentOS-docs] Docs strategy and tactics [RFC]
> 
> Hi,
> 
> On 03/16/2015 03:44 PM, Karsten Wade wrote:
> > On 03/16/2015 11:33 AM, Jim Perrin wrote:
> >> My only question is, how do we determine what goes in the wiki vs
> >> what goes in git? The flow/format between the two is a bit
> >> different. Or is this development the first step in the transition
> >> away from the wiki to another medium?
> > 
> > That's a good question, and I don't have it answered. :) It has to do
> > with our intention/thinking as a group.
> 
> Providing feedback from another project where the website is backed by
> Git, and the workflow for user contributions is documented
> http://manageiq.org
> 
> At the foot of every page is a link "Edit this page on github" (eg:
> http://manageiq.org/documentation/ ).
> 
> It's been a while since I looked, but my experience was that there were
> very few clicks through to edit and PRs. Anecdotally, people didn't
> realise they could propose edits this way.
> 
> Prominent wiki-like controls are important to getting drive-by edits,
> and I am personally a fan of the in-place editing experience you get
> from a good wiki.

Good info. Different strokes, etc., only way to judge is
through results. Wikis are certainly a well-known sort of tool, 
if ppl don't realize they can make a change, they definitely won't.



> 
> Thanks,
> Dave.
> 
> --
> Dave Neary - NFV/SDN Community Strategy
> Open Source and Standards, Red Hat - http://community.redhat.com
> Ph: +1-978-399-2182 / Cell: +1-978-799-3338
> _______________________________________________
> CentOS-docs mailing list
> CentOS-docs at centos.org
> http://lists.centos.org/mailman/listinfo/centos-docs
>