<div dir="ltr"><br><div class="gmail_extra">Would start with the note that the basic project is complete. I would be releasing the prototype on a separate thread. But for the discussion sake the workflow will look like this :</div><div class="gmail_extra">Authors contribute content in markdown format, on github.</div><div class="gmail_extra">The pull request created gets mirrored to pagure thus saving dependency on github.</div><div class="gmail_extra">Also the PR content is built using CI to preview how it looks.</div><div class="gmail_extra">The PR is two way synced between the platforms, so that individual can use pagure or github.</div><div class="gmail_extra">Once staff approves the post, website is built and deployed.</div><div class="gmail_extra"><br></div><div class="gmail_extra"><div class="gmail_quote">On Thu, Jul 30, 2015 at 8:55 PM, Karsten Wade <span dir="ltr"><<a href="mailto:kwade@redhat.com" target="_blank">kwade@redhat.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">-----BEGIN PGP SIGNED MESSAGE-----<br>
Hash: SHA1<br>
<br>
There have been some questions about how the GSoC project interacts<br>
with the existing documentation work that happens around the wiki.<br>
<br>
Let's get all the open questions in to this thread and discuss them.<br>
<br>
Lei, Kunaal -- What other open questions do we have?<br></blockquote><div><br></div><div>From my experience till now, CentOS community is little doubtful about the project. We continued project still, now that we have done the basics, would be great if CentOS tests it, and gives us suggestions. </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<br>
Anyone else with open questions?<br>
<br>
The GSoC project is supposed to be additive to what we do -- an<br>
additional way to get new contributions submitted, reviewed, and ready<br>
for publishing.<br>
<br></blockquote><div>Exactly. Proving an alternate and user friendly medium.</div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
Where things are published is still an open question for this group<br>
(centos-docs) to decide.<br></blockquote><div><br></div><div>Agreed. Maybe a new site containing user curated how to do contents. CentOS doesnt have to officially endorse the content in this way.</div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<br>
The toolchain basically takes submissions in common markup formats<br>
made via GitHub. It puts them in a queue for an editorial team to<br>
review. When ready, the tool can publish or make content ready for<br>
publishing.<br></blockquote><div><br></div><div>In simple words yes :) </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<br>
The content could be new articles, or repurposed content from e.g.<br>
blogs (with appropriate open licensing.) There is a lot of content out<br>
there about how to do things with CentOS, but most of the original<br>
authors aren't going to go through the process of requesting a wiki<br>
account and publishing here.<br>
<br></blockquote><div>That was the initial motivation you gave to us. </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
For where to publish from the toolchain, if we want to keep all docs<br>
in the wiki, we should plan to have the tool output to MoinMoin wiki<br>
syntax so that one of the existing editors can copy/paste in to an<br>
existing or new wiki article. This wiki publishing would work for<br>
shorter form content.<br></blockquote><div><br></div><div>Not sure about this. It adds a human effort in the toolchain. </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<br>
So the new tool could be a way for people to submit edits to existing<br>
wiki articles without having to get a wiki account. </blockquote><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<br>
Some open questions:<br>
<br>
* Who can/wants to be on the editorial board?<br>
* Where do we want to publish longer documents?<br>
<br>
For example, if we had the sources for one of the RHEL documents in<br>
Git, it would be straightforward to modify that document for CentOS,<br>
and even add to it, via this new toolchain.<br></blockquote><div><br></div><div>Agreed. </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<br>
Would we want to put that in to a series of wiki articles? Or publish<br>
it directly to <a href="http://centos.org/docs" rel="noreferrer" target="_blank">centos.org/docs</a> in HTML and PDF format?<br>
<br>
Regards,<br>
<br>
- - Karsten<br>
- --<br>
Karsten 'quaid' Wade .^\ CentOS Doer of Stuff<br>
<a href="http://TheOpenSourceWay.org" rel="noreferrer" target="_blank">http://TheOpenSourceWay.org</a> \ <a href="http://community.redhat.com" rel="noreferrer" target="_blank">http://community.redhat.com</a><br>
@quaid (<a href="http://identi.ca/twitter/IRC" rel="noreferrer" target="_blank">identi.ca/twitter/IRC</a>) \v' gpg: AD0E0C41<br>
<br>
-----BEGIN PGP SIGNATURE-----<br>
Version: GnuPG v2.0.22 (GNU/Linux)<br>
<br>
iEYEARECAAYFAlW6QfUACgkQ2ZIOBq0ODEE2mgCfdVVwHfQvVAJlKMMhHAiMxaM0<br>
UwEAoIGEgCSZKB2DdCIzD/CwLousTW6R<br>
=l4+O<br>
-----END PGP SIGNATURE-----<br>
_______________________________________________<br>
CentOS-docs mailing list<br>
<a href="mailto:CentOS-docs@centos.org">CentOS-docs@centos.org</a><br>
<a href="http://lists.centos.org/mailman/listinfo/centos-docs" rel="noreferrer" target="_blank">http://lists.centos.org/mailman/listinfo/centos-docs</a><br>
</blockquote></div><div><br></div>-- <br><div class="gmail_signature"><div dir="ltr"><div><div dir="ltr"><span style="font-size:12.8000001907349px">Regards,</span><div>Kunaal Jain</div></div></div></div></div>
</div></div>