Re: Docs strategy and tactics [RFC]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 




----- Original Message -----
> From: "Karsten Wade" <kwade@xxxxxxxxxx>
> To: centos-docs@xxxxxxxxxx
> Sent: Monday, March 16, 2015 12:44:47 PM
> Subject: Re:  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@xxxxxxxxxx
> http://lists.centos.org/mailman/listinfo/centos-docs
> 
_______________________________________________
CentOS-docs mailing list
CentOS-docs@xxxxxxxxxx
http://lists.centos.org/mailman/listinfo/centos-docs




[Index of Archives]     [CentOS]     [CentOS Announce]     [CentOS Users]     [CentOS Virtualization]     [Linux Media]     [Asterisk]     [Netdev]     [X.org]     [Xfree86]     [Linux USB]     [Project Hail Cloud Computing]

  Powered by Linux