[CentOS-docs] How GSoC project can fit in to CentOS Docs

Thu Jul 30 15:25:41 UTC 2015
Karsten Wade <kwade at redhat.com>

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

There have been some questions about how the GSoC project interacts
with the existing documentation work that happens around the wiki.

Let's get all the open questions in to this thread and discuss them.

Lei, Kunaal -- What other open questions do we have?

Anyone else with open questions?

The GSoC project is supposed to be additive to what we do -- an
additional way to get new contributions submitted, reviewed, and ready
for publishing.

Where things are published is still an open question for this group
(centos-docs) to decide.

The toolchain basically takes submissions in common markup formats
made via GitHub. It puts them in a queue for an editorial team to
review. When ready, the tool can publish or make content ready for
publishing.

The content could be new articles, or repurposed content from e.g.
blogs (with appropriate open licensing.) There is a lot of content out
there about how to do things with CentOS, but most of the original
authors aren't going to go through the process of requesting a wiki
account and publishing here.

For where to publish from the toolchain, if we want to keep all docs
in the wiki, we should plan to have the tool output to MoinMoin wiki
syntax so that one of the existing editors can copy/paste in to an
existing or new wiki article. This wiki publishing would work for
shorter form content.

So the new tool could be a way for people to submit edits to existing
wiki articles without having to get a wiki account.

Some open questions:

* Who can/wants to be on the editorial board?
* Where do we want to publish longer documents?

For example, if we had the sources for one of the RHEL documents in
Git, it would be straightforward to modify that document for CentOS,
and even add to it, via this new toolchain.

Would we want to put that in to a series of wiki articles? Or publish
it directly to centos.org/docs in HTML and PDF format?

Regards,

- - 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 v2.0.22 (GNU/Linux)

iEYEARECAAYFAlW6QfUACgkQ2ZIOBq0ODEE2mgCfdVVwHfQvVAJlKMMhHAiMxaM0
UwEAoIGEgCSZKB2DdCIzD/CwLousTW6R
=l4+O
-----END PGP SIGNATURE-----