
<html><head><meta http-equiv="Content-Type" content="text/html charset=gb2312"></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;" class=""><div apple-content-edited="true" class=""><div style="color: rgb(0, 0, 0); letter-spacing: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px; word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;" class=""><div style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;" class="">Hi,<div class=""><br class=""></div><div class="">Thank you for your suggestion!</div><div class=""><br class=""></div><div class="">Our GSoC project is not very similar with a conventional doc toolchain. Its goal is to lower the barrier for new comers to contributor. Especially for those short-form how-to docs. Here is the original idea (<a href="http://wiki.centos.org/GSoC/2015/Ideas#docs-toolchain" class="">http://wiki.centos.org/GSoC/2015/Ideas#docs-toolchain</a>) for your reference.</div><div class=""><br class=""></div><div class="">Taking that into consideration, we think that we should make use of github as that’a a platform that almost all potential contributors are familiar with. We don’t want to involve many command line executions. So we suppose that users make PR on github. However, at the same time, we don’t want to fully rely on a third party service like github, so we choose to store the original git repo on git.c.o. Pull requests happen on github, and changes are synced back to git.c.o after reviewing. Finally the doc is built based on git.c.o. That’s the workflow.</div><div class=""><br class=""></div><div class="">To implement this, we need to integrate github and git.c.o. One of the steps is to provide a place where staff can review the changes and choose to accept the contribution. First we planed to use bugzilla, but in the discussion with Karsten and in the discussion on this list, we learned that using bugzilla will add extra burden to maintain it, so we might switch to <a href="http://bugs.centos.org" class="">bugs.centos.org</a>. Using which platform is still to be discussed, and we may have a meeting on #centos-devel.</div><div class=""><br class=""></div><div class="">Our project is aimed at short-form how-to docs and lowering the barrier, so conventional workflows might not work well in our project.</div><div class=""><br class=""></div><div class="">Thanks again for your suggestion.</div><div class=""><div class=""><br class=""></div><div class="">Regards,</div><div class="">Lei</div></div></div></div>

</div>

<br class=""><div style=""><blockquote type="cite" class=""><div class="">在 2015年6月5日，下午9:26，Sankarshan Mukhopadhyay <<a href="mailto:sankarshan.mukhopadhyay@gmail.com" class="">sankarshan.mukhopadhyay@gmail.com</a>> 写道：</div><br class="Apple-interchange-newline"><div class="">On Fri, Jun 5, 2015 at 6:49 PM, Lei Yang <<a href="mailto:yltt1234512@gmail.com" class="">yltt1234512@gmail.com</a>> wrote:<br class=""><blockquote type="cite" class="">Staff will do the review only on bugzilla, but we think some contributors<br class="">are only familiar with github, so we sync the comments between two<br class="">platforms, so contributors don’t need to leave github to finish the whole<br class="">process.<br class=""></blockquote><br class="">Allow me to change the context/track. Have you taken a look at<br class=""><<a href="https://wiki.openstack.org/wiki/Documentation/HowTo#Workflow" class="">https://wiki.openstack.org/wiki/Documentation/HowTo#Workflow</a>> ?<br class="">Reading this conversation it would seem that your proposal aims to<br class="">achieve similar goals even though you may not choose to opt for<br class="">similar tools.<br class=""><br class=""><br class="">-- <br class="">sankarshan mukhopadhyay<br class=""><<a href="https://about.me/sankarshan.mukhopadhyay" class="">https://about.me/sankarshan.mukhopadhyay</a>><br class="">_______________________________________________<br class="">CentOS-devel mailing list<br class=""><a href="mailto:CentOS-devel@centos.org" class="">CentOS-devel@centos.org</a><br class="">http://lists.centos.org/mailman/listinfo/centos-devel<br class=""></div></blockquote></div><br class=""></body></html>