Re: [ovirt-users] [ovirt-devel] Lowering the bar for wiki contribution?

This is an OpenPGP/MIME signed message (RFC 4880 and 3156) --dqmIdtmeTimHDutWnSDmr5D33QGGuG2B8 Content-Type: multipart/mixed; boundary="EIXwtTdtuMoAf8JSMXfSSajJpI94AutSD"; protected-headers="v1" From: =?UTF-8?B?TWFyYyBEZXF1w6huZXMgKER1Y2sp?= <duck(a)redhat.com&gt; To: Martin Sivak <msivak(a)redhat.com&gt;, Nir Soffer <nsoffer(a)redhat.com&gt; Cc: Edward Haas <edwardh(a)redhat.com&gt;, devel <devel(a)ovirt.org&gt;, infra <infra(a)ovirt.org&gt;, users <users(a)ovirt.org&gt; Message-ID: <24cf31c6-0b1e-cf4c-6843-d44f63b5d4e4(a)redhat.com&gt; Subject: Re: [ovirt-devel] [ovirt-users] Lowering the bar for wiki contribution? References: <CAC_JqcnVfGeFm+xQmZU-QEbp57efphO3jhPw5rDqux7d0DCu9A(a)mail.gmail.com&gt; <CAP84NrtLshq30DJPmJ6==p2DThWokKqBetKpmhKFp+r-E2CVpw(a)mail.gmail.com&gt; <CAJ1JNOcxk-=Aodrc0gM7hdJi-N0nyn+vwTkbjyTEKMZNGZXZ3A(a)mail.gmail.com&gt; <CAC_Jqcnkqo3sGyBqc61zo7qN61ua0ZM1f1oTPkXHcH=L2_-HQg(a)mail.gmail.com&gt; <CAJVw3Ezs9bSn=OLyLRfkz=twJNn1LuzdAjbV0qTyvAcVS+KF2w(a)mail.gmail.com&gt; <CAC_Jqcku_hmpF25n4Ekrdsq4SzXRWsc0jGxbSeOyao3Snie4WQ(a)mail.gmail.com&gt; <CAGJrMmqKJAycawV91RDxGF5ERB3snt6s9PNtfjCPmsRO4619qA(a)mail.gmail.com&gt; <6e6f7b97-9d8d-1759-5dab-c64bba86de35(a)redhat.com&gt; <CAC_Jqcn6-OUKKDz2B=SF_aqwys9qrSQ+Zdhi5H8=8F_4De5Egg(a)mail.gmail.com&gt; <F6E943F2-E8A2-43A1-8EF0-F08EEC60A2D5(a)redhat.com&gt; <CALmkdFQM4XgtQ+opmBD9WiRQhv1puoOEj_Vn9dfS9OeSqrnyFQ(a)mail.gmail.com&gt; <CAF0zDV60iZZQFnbuPwCUzSGnvFY8xn1pCtq46d982xYvU_UaUw(a)mail.gmail.com&gt; <CAMRbyysJLOtWKXFX93zyyEcrDFaq+S=7x9Ek4GT3VXr-+zcjug(a)mail.gmail.com&gt; <CAF0zDV4RsA5ux3KOW2Tg+ZGWXR_3fhpVfWLKsnF1oryZ0F=PbQ(a)mail.gmail.com&gt; In-Reply-To: <CAF0zDV4RsA5ux3KOW2Tg+ZGWXR_3fhpVfWLKsnF1oryZ0F=PbQ(a)mail.gmail.com&gt; --EIXwtTdtuMoAf8JSMXfSSajJpI94AutSD Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Quack, On 06/21/2017 05:29 PM, Martin Sivak wrote: Well, the only feature which seem to be missing (at least for some people) is to comment alongside the pages, but you can still make reviews in PRs. I think these last few month there is more people around and it is more reactive, and there's much less lingering PRs. Also I have no idea about how promoting people to merge power is done. I think there is quite an unfair side of the story: if you're from RH then you can get admin rights on the spot but external contributors I guess don't guess this very easily. I didn't any procedure to apply for this. That's a very good point. A colleague working on OpenStack stuff was telling me this works much better to commit doc alongside doc in the same PR. Also the project promotion and technical docs would probably benefit from being separated, so that giving permissions to people would not affect the main portal and messaging if they just need to write on features/config/install/=E2=80=A6 Same. With GH and Gerrit using external auth I think anyone is able to contribu= te. So to come back to Markdown stuff. People in charge of messaging do not want an ugly portal, and even a simple one means a little bit of CSS. Also there are news/blog entries, so another feature which needs slightly more power. Also search is a nice feature too. So we're using Middleman, that's not perfect at all, version 3 is a failure, and we were looking at a new tool, Jekyll, and it's being tested on another project. Jekyll is the tool developed by GH and this rejoins Edward's proposal. Nevertheless I totally disagree about going to the bare minimum. If you want to get a clean, readable and coherent documentation you will still end-up having a few editorial rules, templates=E2=80=A6 to follow and yes= you need to get up to it and learn. With content of this size if anyone just decide to have his own flavor it will be a mess very soon. Also we already have piles of content so this means some work to migrate. Markdown is not a standard so depending on the generator you use the syntax may differ slightly. There's some custom Ruby code we need to get rid of too. So that's a real project and unfortunately the person who was working in this direction is no more in the project. Once I'm more acquainted to Jekyll and i still think this could be a nice replacement, then I'll try to get some time to help on this front. Anyway to get out of the current system we first need to remove all the custom Ruby code around Middleman and maybe other ugly things, so=E2=80=A6= patches are welcome! \_o< --EIXwtTdtuMoAf8JSMXfSSajJpI94AutSD-- --dqmIdtmeTimHDutWnSDmr5D33QGGuG2B8 Content-Type: application/pgp-signature; name="signature.asc" Content-Description: OpenPGP digital signature Content-Disposition: attachment; filename="signature.asc" --dqmIdtmeTimHDutWnSDmr5D33QGGuG2B8--