On 11/04/16 21:11, Akemi Yagi wrote: > On Mon, Apr 11, 2016 at 10:37 AM, Karsten Wade <kwade@xxxxxxxxxx> wrote: >> -----BEGIN PGP SIGNED MESSAGE----- >> Hash: SHA1 >> >> On 04/11/2016 09:18 AM, Jim Perrin wrote: >>> What are the thoughts or concerns about this sort of workflow >>> change? >> >> Any chance Moin Moin can store wiki source in git and sync >> automatically with a central git repository? >> >> It would provide another pathway to suggest edits to the wiki without >> requiring wiki edit permissions. >> >> For new documentation, e.g. layered project content from SIGs or >> upstream documentation sources, I would think we'd want to skip a >> conversion to/from Moin Moin and instead work directly in the sources >> from upstream. Eases merging upstream, etc. Last Summer's GSoC >> students implemented such a workflow. > > I agree with providing another pathway. More specifically, I am > against moving entirely away from the current way of editing the wiki. > > Going for the git environment has its own merits as already mentioned, > but at the same time it would deter some people. Not everyone is > particularly fond of (or familiar with) git. I would not be surprised > if some of the existing wiki authors stop contributing if the direct > edit is no longer an option. > > Akemi That's what I fear too. A wiki is something that has to be edited live, and be quick/fast. Git-based doc is probably something more formalized and for tech writers having to maintain an "official" doc. I (in the past) had a look at http://www.mkdocs.org/ for this (and so all the .md can be in a public git repo that people can submit PR to) While personally I don't mind switching to something using git in the workflow, I'm wondering if such tool shouldn't be used instead to target "official" docs under centos.org/docs and not the wiki. (both can be complementary) just my 0.02$ -- Fabian Arrotin The CentOS Project | http://www.centos.org gpg key: 56BEC54E | twitter: @arrfab
Attachment:
signature.asc
Description: OpenPGP digital signature
_______________________________________________ CentOS-docs mailing list CentOS-docs@xxxxxxxxxx https://lists.centos.org/mailman/listinfo/centos-docs
