[CentOS-devel] Regarding GSoC project : Documentation Toolchain

On Sat, May 30, 2015 at 1:04 AM, kunaal jain <kunaalus at gmail.com> wrote:
> The typical workflow might look like this:
>
> 1. Author writes content in markdown language.
> 2. Makes a pull request on github.

Is this github.com or, a git instance off CentOS infrastructure?

> 3. Corresponding to the pull request a issue is created on bugzilla.
> 4. CentOS staff can either review the article on github pull request, or on
> bugzilla.

I would recommend using one tool for handle inbound and review. Having
2 tools that need to be kept synchronized would add overhead that you
don't want to deal with. Also, it has the effect of puzzling
contributors.

> 5. Comments are two way synced.
> 6. At each point the article can be viewed on bugzilla, using an extension
> we propose to make.
> 7. After many iterations of commenting, and improving, article is finally
> accepted.

Have you considered review workflow tools like Gerrit?

> 8. Staff tags it, and pushes to git.centos.org.
> 9. Using git.centos.org, new website is generated and pushed.

'Website' or, is the content rendered from the version control (g.c.o)
and pushed live?




-- 
sankarshan mukhopadhyay
<https://about.me/sankarshan.mukhopadhyay>