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

Mon Mar 16 20:42:06 UTC 2015
Dave Neary <dneary at redhat.com>

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.

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