[Bf-docboard] wiki scrum #1

[Dan McGrath]

Hola \o

Seen a flurry of emails about all this and noticed my name :)

I am a bit busy mucking around with stuff lately, but I will take a
look at the chat logs at some point, for all the catch up stuff. But
worst case, I am "around" for any dire needs and can hop on irc in an
instant.

Anyways, thought I would check in and say hi :D


l8r o/


Dan

On Fri, Sep 7, 2012 at 10:11 AM, Ton Roosendaal <ton at blender.org> wrote:
> Hi Kesten,
>
> Thanks for the report, good to hear things are going forward.
>
> I'd like to propose to re-establish here a similar structure as we tried in past - and what we do for the developers; appoint and empower an admin board of 3 to 5 people.
>
> At least one of them will get wiki admin access rights on the server for maintenance and fixes, and get connected to the other blender.org admins.
>
> The other admins will typically not have to do a lot, but will help enforcing decisions (when the team has no consensis) and be an inspiring & positive force to make sure Blender's wiki keeps being cool to work on! The admins can also be representing wiki to other teams (to BF, at blender.org, conferences, etc).
>
> In no way this is meant as a special status, nor is it showing more appreciation as for the other volunteers; the roles are there to make sure everyone in the wiki team can function optimal.
>
> Based on current activity and what I've been advised, I propose:
>
> Admins:
> Kesten Broughton
> Brendon 'meta-androcto' Murphy
> Ivan 'greylica' Paulos Tomé
>
> Other tasks:
> Dan 'troubled' (lastname) can assist as system admin
> Francesco Siddi as graphics designer (skins, layout)
>
> This is a proposal, it can be a topic of the next wiki meeting. More or other candidates welcome!
>
> (BTW: Let's please always use real names in docs and mails, with nicks optional. Is much less confusing!)
>
> Thanks,
>
> -Ton-
>
> ------------------------------------------------------------------------
> Ton Roosendaal  Blender Foundation   ton at blender.org    www.blender.org
> Blender Institute   Entrepotdok 57A  1018AD Amsterdam   The Netherlands
>
> On 6 Sep, 2012, at 2:23, Kesten Broughton wrote:
>
>> Hi all,
>>
>> We had a good meeting on IRC #blenderwiki today.  Brecht posted the log earlier.
>> Next scrum will be Sunday morning/afternoon at the close of #blendercoders scrum (10 am CST?).
>>
>> First of all, a big thanks to the old guard of reviewers for getting a lot of the required infrastructure and procedures developed.  I hope there is no perception that we are undermining those efforts.  What we are here to do is come up with a workable temporary solution while we are in a situation of a large backlog of un-reviewed contributions and no experienced reviewers.
>>
>> We're not going to fix all problems at once.  Today's scrum was just to set some 1-week goals to get the ball rolling.
>>
>> We will be putting out a hit-list to docboard and blenderartists of a fraction of the un-reviewed pages each week.  First one will be published tomorrow for us to devour.
>> Post a link to your un-reviewed contribution to have it added to the hopper.
>>
>> Distilled from the IRC chat is a new trial procedure for contributing and reviewing:
>>
>> (a) small changes are allowed by anyone
>> (b) bigger changes are allowed when reviewed by one other wiki contributor (admin or not)
>>  b.1 New contributors/reviewers can start by creating an account.
>>  b.2 Terry Wallwork will hand-approve new accounts to avoid spam
>>  b.3 For big changes, a small fraction of pages can be reviewed to ensure basic style compliance.
>>      The rest of the pages can be pushed to the manual with a box saying "This page has not been reviewed.  Please help us make it better.  Do not use this page to copy style for new pages."
>>      with a link to style guide and how to get involved / in touch.
>>  b.4 If not admin, reviewer should at least have recently reviewed   Style Guidelines
>>      and are familiar with templates for formatting.  We will try to have everyone's first review
>>      re-reviewed to ensure consistency.
>>  b.5 Reviewers can use the Discussion tab to post review comments.  Post to docboard when your review is done for re-review :)
>>  b.6 We are going to try and organize a couple of week-long review-sprints to clear out the backlog.  If we aren't   making good progress by end of sept, then we'll have to open the doors to push live according to b.3.  Changes can be reverted through the History tab available when you are logged in.
>> (c) a few people pledge to look at recent changes and answer questions on bf-docdoard
>>  c.1 We'd like to work towards having head reviewers for each section to keep the workloads light.  However, it's not required.
>> So far we have Jim doing BGE, meta-androcto doing addons, brecht and myself at large.  We need at least another 4 core reviewers willing to contrib 2 hrs/wk at first  to make this fly.
>>
>>
>> Optional Reading:
>>
>> Fweeb mentioned that in addition to the style guide, we should have some templates of best practices to further promote a solid look-and-feel.
>> The current style-guide gives the form.  This new guide might be more focused on content, pedagogy etc.  I'd like to see a discussion on this get distilled and added as a link to the style-guide.  Some general suggestions I'd make:
>>
>> Use action phrases.  Assume the user is following along with blender.  Give activities that can be checked for results when possible.
>>
>> Get to the punchline as quickly as possible, with a picture or animation
>> Show what the user will be able to do.  Then go through the steps to get there.
>>
>> Aim your page at a beginner level.  This is especially important if you want your work reviewed quickly.  If you provide procedures with high level descriptions of how to do things without following it with the sequence of UI steps to get there, your reviewer may get stuck or give up.  Please provide a link to another part of the manual if it exists or supply the steps in detail yourself.
>>
>>
>> --
>>
>> Kesten Broughton
>> President and Technology Director,
>> Solar Mobile Trailers
>> kesten at solarmobiletrailers.com
>> www.sunfarmkitchens.ca
>> 512 701 4209
>>
>> _______________________________________________
>> Bf-docboard mailing list
>> Bf-docboard at blender.org
>> http://lists.blender.org/mailman/listinfo/bf-docboard
>
> _______________________________________________
> Bf-docboard mailing list
> Bf-docboard at blender.org
> http://lists.blender.org/mailman/listinfo/bf-docboard