[CentOS-docs] Working Documentation Toolchain [GSoC]

Wed Aug 5 15:30:24 UTC 2015
Lei Yang <yltt1234512 at gmail.com>

Hi,

An update about the bug. The bug was due to our method to create new issue on Pagure. When creating a new issue using a new account, the program may encounter some problems. Now we have fixed the bug :)

Thank you very much for helping us find it!


Regards,
Lei

> 在 2015年8月4日,下午10:36,Dougal Matthews <dougal at dougalmatthews.com> 写道:
> 
> On 4 August 2015 at 14:21, kunaal jain <kunaalus at gmail.com <mailto:kunaalus at gmail.com>> wrote:
>> Hi,
>> 
>> The basic toolchain is up and running. I encourage community to test
>> this workflow once. It is an addition to the existing contributing
>> mediums.
>> 
>> Site: http://clown-olga-13325.bitballoon.com/
>> Contributing Docs repo : https://github.com/kunaaljain/test-centos-docs
>> 
>> ==AIM==
>> 
>> Initial Idea : http://wiki.centos.org/GSoC/2015/Ideas#docs-toolchain
>> 
>> The CentOS Project needs more short-form contributions of content that
>> focuses on how-to do things on top of a CentOS Linux installation,
>> with a method to push changes in to appropriate and related upstream
>> open source projects.
>> 
>> There is a lot of content scattered across the Internet on how to do
>> things with CentOS Linux. The goal of this toolchain is to make it
>> easy for people to contribute new, short-form content articles to the
>> Project with an ability to push them outward to relevant upstream
>> projects.
>> 
>> ==Workflow==
>> 
>> 1. The user authors content in markdown format and creates a pull
>> request on Github.
>> 2. The backend service mirrors the pull request to pagure and creates a issue.
>> 3. The doc is built and a link is provided to preview the doc.
>> 5. Staff reviews the docs, gives comments either on pagure or github
>> (two way synced)
>> 4. Once the staff approves the doc is built and doc site updated.
>> 
>> ==Infra==
>> 
>> 1. A backend server listing to Github and Pagure webhooks and mirroring content.
>> 2. A http site displaying the temporary docs.
>> 3. A pagure instance
>> 
>> ==Testing ==
>> 
>> 1. Fork the https://github.com/kunaaljain/test-centos-docs
>> 2. Add new content to docs folder in mardown language.
>> 3. Update the mkdocs.yml file and add the new file you just created
>> with appropriate heading.
>> 4. Create a pull request.
>> 5. Within 15-20 seconds, a comment will be made on pull request, with
>> the pagure link, which displaying various metadata.
>> 6. Once the staff approves, PR is merged and site updated at
>> http://clown-olga-13325.bitballoon.com/
> 
> 
> I don't have an account on Pagure, did it create one for me? How would I then
> access it? Looking at this:
> 
> https://pagure.io/user/d0ugal <https://pagure.io/user/d0ugal>
> _______________________________________________
> CentOS-docs mailing list
> CentOS-docs at centos.org <mailto:CentOS-docs at centos.org>
> http://lists.centos.org/mailman/listinfo/centos-docs <http://lists.centos.org/mailman/listinfo/centos-docs>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.centos.org/pipermail/centos-docs/attachments/20150805/3026129f/attachment-0003.html>