<div dir="ltr">Adding infra which I forgot to add from the beginning <br></div><div class="gmail_extra"><br><div class="gmail_quote">On 7 January 2017 at 02:44, Jakub Niedermertl <span dir="ltr">&lt;<a href="mailto:jniederm@redhat.com" target="_blank">jniederm@redhat.com</a>&gt;</span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div class="HOEnZb"><div class="h5">On Wed, Jan 4, 2017 at 11:41 AM, Roy Golan &lt;<a href="mailto:rgolan@redhat.com">rgolan@redhat.com</a>&gt; wrote:<br>
&gt;<br>
&gt;<br>
&gt; On 4 January 2017 at 12:17, Maor Lipchuk &lt;<a href="mailto:mlipchuk@redhat.com">mlipchuk@redhat.com</a>&gt; wrote:<br>
&gt;&gt;<br>
&gt;&gt;<br>
&gt;&gt;<br>
&gt;&gt; On Wed, Jan 4, 2017 at 11:38 AM, Daniel Erez &lt;<a href="mailto:derez@redhat.com">derez@redhat.com</a>&gt; wrote:<br>
&gt;&gt;&gt;<br>
&gt;&gt;&gt;<br>
&gt;&gt;&gt;<br>
&gt;&gt;&gt; On Wed, Jan 4, 2017 at 9:57 AM, Roy Golan &lt;<a href="mailto:rgolan@redhat.com">rgolan@redhat.com</a>&gt; wrote:<br>
&gt;&gt;&gt;&gt;<br>
&gt;&gt;&gt;&gt; I&#39;m getting the feeling I&#39;m not alone in this, authoring and publishing<br>
&gt;&gt;&gt;&gt; a wiki page isn&#39;t as used to be for long time.<br>
&gt;&gt;&gt;&gt;<br>
&gt;&gt;&gt;&gt; I want to suggest a bit lighter workflow:<br>
&gt;&gt;&gt;&gt;<br>
&gt;&gt;&gt;&gt; 1.  Everyone can merge their page - (it&#39;s a wiki)<br>
&gt;&gt;&gt;&gt;   Same as with (public and open) code, no one has the motivation to<br>
&gt;&gt;&gt;&gt; publish a badly written<br>
&gt;&gt;&gt;&gt;   wiki page under their name. True, it can have an impact, but not as<br>
&gt;&gt;&gt;&gt; with broken code<br>
&gt;&gt;&gt;&gt;<br>
&gt;&gt;&gt;<br>
&gt;&gt;&gt; +1.<br>
&gt;&gt;&gt; Moreover, I think we shouldn&#39;t block any merging. Instead, wiki<br>
&gt;&gt;&gt; maintainers could act afterwards and revert when needed (Wikipedia style).<br>
&gt;&gt;&gt; Another issue is that (sadly) unlike mediawiki, we need to wait for wiki<br>
&gt;&gt;&gt; publish after a change. So I&#39;d suggest to build and publish the wiki at<br>
&gt;&gt;&gt; least once a day. Any way, I think we should make the workflow much more<br>
&gt;&gt;&gt; intuitive and pleasant like the previous wiki - i.e. much less restrictive<br>
&gt;&gt;&gt; than manipulating a code base.<br>
&gt;&gt;&gt;<br>
&gt;&gt;&gt;<br>
&gt;&gt;&gt;&gt;<br>
&gt;&gt;&gt;&gt; 2. Use Page-Status marker<br>
&gt;&gt;&gt;&gt;  The author first merges the draft. Its now out there and should be<br>
&gt;&gt;&gt;&gt; updated as time goes and its<br>
&gt;&gt;&gt;&gt;  status is DRAFT. Maintainers will come later and after review would<br>
&gt;&gt;&gt;&gt; change the status to<br>
&gt;&gt;&gt;&gt;  PUBLISH. That could be a header in on the page:<br>
&gt;&gt;&gt;&gt;  ---<br>
&gt;&gt;&gt;&gt;  page status: DRAFT/PUBLISH<br>
&gt;&gt;&gt;&gt;  ---<br>
&gt;&gt;&gt;&gt;<br>
&gt;&gt;&gt;&gt;  Simple I think, and should work.<br>
&gt;&gt;&gt;&gt;<br>
&gt;&gt;<br>
&gt;&gt;  +1<br>
&gt;&gt; The effort of maintaining the wiki today compare to how it used to be<br>
&gt;&gt; before is much more cumbersome and problematic.<br>
&gt;&gt; I think we can learn a lot from wikipedia workflow,<br>
&gt;&gt; It is a much more inviting process where anyone can change the content<br>
&gt;&gt; easily.<br>
&gt;&gt; I&#39;m not saying we should let any anonymous user change the wiki but even<br>
&gt;&gt; if we make it easier in house we can achieve much more informative reliable<br>
&gt;&gt; and updated wiki.<br>
&gt;&gt;<br>
&gt;<br>
&gt;<br>
&gt;<br>
&gt; I really think Github Pages is a perfect fit and an alternative to my first<br>
&gt; suggestion. see<br>
&gt; <a href="https://github.com/oVirt/ovirt-site/wiki/Why-aren&#39;t-we-using-this%3F" rel="noreferrer" target="_blank">https://github.com/oVirt/<wbr>ovirt-site/wiki/Why-aren&#39;t-we-<wbr>using-this%3F</a><br>
<br>
</div></div>+1<br>
Github wiki would allow us instant publishing, review after after<br>
publishing, it works purely in browser (no need for running local ruby<br>
server) and it&#39;s a service that doesn&#39;t require any maintenance form<br>
our side.<br>
<div class="HOEnZb"><div class="h5"><br>
&gt;&gt;&gt;&gt;<br>
&gt;&gt;&gt;&gt;<br>
&gt;&gt;&gt;&gt;<br>
&gt;&gt;&gt;&gt;<br>
&gt;&gt;&gt;&gt; ______________________________<wbr>_________________<br>
&gt;&gt;&gt;&gt; Devel mailing list<br>
&gt;&gt;&gt;&gt; <a href="mailto:Devel@ovirt.org">Devel@ovirt.org</a><br>
&gt;&gt;&gt;&gt; <a href="http://lists.ovirt.org/mailman/listinfo/devel" rel="noreferrer" target="_blank">http://lists.ovirt.org/<wbr>mailman/listinfo/devel</a><br>
&gt;&gt;&gt;<br>
&gt;&gt;&gt;<br>
&gt;&gt;&gt;<br>
&gt;&gt;&gt; ______________________________<wbr>_________________<br>
&gt;&gt;&gt; Users mailing list<br>
&gt;&gt;&gt; <a href="mailto:Users@ovirt.org">Users@ovirt.org</a><br>
&gt;&gt;&gt; <a href="http://lists.ovirt.org/mailman/listinfo/users" rel="noreferrer" target="_blank">http://lists.ovirt.org/<wbr>mailman/listinfo/users</a><br>
&gt;&gt;&gt;<br>
&gt;&gt;<br>
&gt;<br>
&gt;<br>
&gt; ______________________________<wbr>_________________<br>
&gt; Users mailing list<br>
&gt; <a href="mailto:Users@ovirt.org">Users@ovirt.org</a><br>
&gt; <a href="http://lists.ovirt.org/mailman/listinfo/users" rel="noreferrer" target="_blank">http://lists.ovirt.org/<wbr>mailman/listinfo/users</a><br>
&gt;<br>
</div></div></blockquote></div><br></div>