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

Mon Mar 16 20:14:59 UTC 2015
Jason Brooks <jbrooks at redhat.com>


----- Original Message -----
> From: "Karsten Wade" <kwade at redhat.com>
> To: centos-docs at centos.org
> Sent: Monday, March 16, 2015 12:44:47 PM
> Subject: Re: [CentOS-docs] Docs strategy and tactics [RFC]
> 
> -----BEGIN PGP SIGNED MESSAGE-----
> Hash: SHA1
> 
> 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.
> 
> I don't see a reason to move away from the wiki as a
> contributor-focused area, for example. It self-organizes fairly well,
> and when people need to write something easily-enough at a centos.org
> domain it lets folks do that fairly well. But I'm picking a
> fairly-small focus area (docs for contributors), as we'll have to add
> people to the wiki, curate the content a bit, etc.
> 
> This is why I'm thinking the short-form how-to-do-stuff-on-CentOS is a
> chance to break away from the wiki with a new, lower-barriers toolset
> and process without having to deal with "should we wiki or should we not?"

If there's some overlap between git and wiki, it'll give us a chance
to see which works better. I much prefer git to wiki personally.

The wiki is fine if it's clear who "owns" a page, but when it comes
to collaboration, I don't think the wiki stands up. Forking and
pull requests are very freeing, and the wiki provides for neither.

Maybe I'm not aware of the places where the centos wiki is 
really rocking, docswise.

Jason




> 
> - - Karsten
> - --
> Karsten 'quaid' Wade        .^\          CentOS Doer of Stuff
> http://TheOpenSourceWay.org    \  http://community.redhat.com
> @quaid (identi.ca/twitter/IRC)  \v'             gpg: AD0E0C41
> -----BEGIN PGP SIGNATURE-----
> Version: GnuPG v1
> 
> iEYEARECAAYFAlUHMq8ACgkQ2ZIOBq0ODEFVLQCgxmiVkcnoBLfF59UTDkwIeGX3
> nxEAoMuNEdj/piEQ8VmSO6smbFNHUNYF
> =6zZE
> -----END PGP SIGNATURE-----
> _______________________________________________
> CentOS-docs mailing list
> CentOS-docs at centos.org
> http://lists.centos.org/mailman/listinfo/centos-docs
>