Looks nice imo. It could also be used as basic guideline for bf-docboard-es wiki review.<br><br>Thanks!<br><br>myHTC<br><br>----- Reply message -----<br>De: &quot;mindrones&quot; &lt;mindrones@gmail.com&gt;<br>Fecha: vie., dic. 30, 2011 16:44<br>Asunto: [Bf-docboard] Manual Reviewing Workflow and Wiki Team<br>Para: &quot;Blender Documentation Project&quot; &lt;bf-docboard@blender.org&gt;<br><br>Hi all.<br><br>Reviewing Workflow<br>===================<br><br>Finally I took some time to write down the new reviewing workflow,<br>that has been discussed at length in #blenderwiki:<br><br><a href="http://wiki.blender.org/index.php/Meta:Guides/Writer_Guide#Official_Manual_Review_Workflow">http://wiki.blender.org/index.php/Meta:Guides/Writer_Guide#Official_Manual_Review_Workflow</a><br><br>I need to modify a bit the templates to manage corner cases (for<br>example to keep track also of those people that won&#39;t respect the<br>guidelines, and to mark pages as &quot;up to date&quot;), but I think this will<br>be already much more efficient, and will help us to keep track.<br><br>Basically, the idea of a centralized Sandbox (Meta:Sandbox) is gone :)<br>That place is dead anyway, and it is much better to use our user pages<br>as personal sandboxes and when we&#39;re ready just share our content.<br>This is what developers do already in GSoC and in general code<br>documentation, and it just works (when pages are ok they get moved or<br>merged in the manual).<br><br>Everything gets tracked down in<br><a href="http://wiki.blender.org/index.php/Meta:Wiki_Tasks/Review_2.6_Manual.">http://wiki.blender.org/index.php/Meta:Wiki_Tasks/Review_2.6_Manual.</a><br><br>When users provide fixes linking their user pages in the relevant manual page:<br>- we see a &#39;X&#39; in the &quot;fixes&quot; column<br>- we review and give feedback to the user in his/her talk page (he<br>gets notified by mail)<br>- we or the user update the manual<br><br>The major benefit is that we can now examine the Release Notes and:<br>* if a page with the relevant content exists, but needs adjustment, we<br>can update the review template and:<br>** actively find people to fix/write pages<br>** wait for help from users<br>* if a page with the relevant content does not exist (think about<br>motion tracking before it was done), we can easily create that page in<br>the right place in the manual structure and use the review template to<br>mark it as empty, add notes etc, and find or wait for writers.<br><br><br>Wiki Team<br>=========<br><br>With this settled down, I think now we can establish a proper Wiki Team.<br><br><br>Reviewers<br>----------------<br><br>I think first of all we need a core of Reviewers.<br><br>IMO these people have to be:<br>* users, with proven experience in blender, actively following the development<br>* developers, active in documentation realm<br>Ideally it&#39;d be nice to have one or more reviewers and one developer<br>per section (modeling, rendering, etc)<br><br>These people should know well wiki syntax, templates and guidelines,<br>and have to:<br>* add new features in the review templates to &#39;keep the flow going&#39;<br>* accept/reject fixes from casual writers and make sure that people<br>respect the guidelines, deleting unapproved content.<br>* talk with developers to make sure content is ok and up to date.<br><br>Later on I&#39;ll mark each section of the manual with the relative Module<br>owner, using<br><a href="http://wiki.blender.org/index.php/Template:ModulesOwners">http://wiki.blender.org/index.php/Template:ModulesOwners</a><br>so that everybody can find the person that has developed the feature<br>explained in a certain page of the manual.<br><br><br>Writers<br>------------<br><br>The more we get, the better of course.<br>If they work in their own user pages, there&#39;s no risk they mess up the<br>manual somehow.<br>In my experience, there is a good amount of people starting to edit<br>the wiki while learning Blender (and mediawiki too): these would not<br>be ok as reviewers IMO, but very welcome as Writers, if they get<br>assistance/review from Reviewers.<br>With a good experience in wiki editing (and blender), Writers can<br>become Reviewers of course.<br><br>--<br><br>Regarding the big banner blocking people from editing the Manual: it<br>can be removed as soon as we&#39;ll have a proper Reviewers Team, I guess<br>we agree?<br><br>--<br><br>Also, we have discussed at length in #blenderwiki about using an<br>extension to enforce &quot;rights&quot; in wiki, and probably later we&#39;ll use<br>it, but meanwhile it would be nice to see that we can organize things<br>and keep them under control without protecting the whole manual.<br>I don&#39;t have a lot of time lately, but I&#39;d mail about this later in January.<br>Meanwhile, we can discuss and see if there are good ideas about how to<br>form a good Wiki Team.<br><br><br>Regards,<br>Luca<br>_______________________________________________<br>Bf-docboard mailing list<br>Bf-docboard@blender.org<br><a href="http://lists.blender.org/mailman/listinfo/bf-docboard">http://lists.blender.org/mailman/listinfo/bf-docboard</a><br><br><br><br>