[Bf-docboard] Fade's pages

Wed Sep 19 16:54:44 CEST 2012

Hi Fade,

http://wiki.blender.org/index.php/User:Fade/Doc:2.6/Manual/3D_interaction/Navigating/3D_View

Good use of templates.

Two comments:
1. It might be good to have another line before major section breaks (with
a horizontal line) to better mark the separation.

2.  There are a few places with large empty spaces where words don't flow
nicely around pictures.  For example, the pictures captioned with:
Demonstration of camera view.
A 3D viewport’s View menu.

I don't know if there is a good fix to this currently.

Overall, a very good page.  I don't think either of the comments would
prevent it from going live.   So go ahead.

My feeling is that for tackling the backlog with sprints, the job is not to
catch every last possible error, but to come up with general standards and
ensure that contributors generally conform to it.  I'm confident after
reviewing this page that your work meets that high standard, so if nobody
objects, I would recommend that
1.  You push live any pages that don't involve structural changes to wiki.
2.  If you have specific questions for a given page, post it here for
discussion.
3.  You consider yourself to have "reviewless contrib rights" going forward
(again posting here any time you are uncertain or encounter technical
difficulties.)

kesten

On Sun, Sep 9, 2012 at 5:00 AM, <bf-docboard-request at blender.org> wrote:

> Send Bf-docboard mailing list submissions to
>         bf-docboard at blender.org
>
> To subscribe or unsubscribe via the World Wide Web, visit
>         http://lists.blender.org/mailman/listinfo/bf-docboard
> or, via email, send a message with subject or body 'help' to
>         bf-docboard-request at blender.org
>
> You can reach the person managing the list at
>         bf-docboard-owner at blender.org
>
> When replying, please edit your Subject line so it is more specific
> than "Re: Contents of Bf-docboard digest..."
>
>
> Today's Topics:
>
>    1. Re: wiki scrum #1 (Ton Roosendaal) (Jim Tucker)
>    2. wiki scrum sunday and assignment #2 (Kesten Broughton)
>    3. Re: wiki scrum #1 (Fade)
>
>
> ----------------------------------------------------------------------
>
> Message: 1
> Date: Sat, 8 Sep 2012 12:29:06 +0100
> From: Jim Tucker <jim.tucker at live.co.uk>
> Subject: Re: [Bf-docboard] wiki scrum #1 (Ton Roosendaal)
> To: <bf-docboard at blender.org>
> Message-ID: <COL112-W621ECAE17B97BB5FDA74D5A0AE0 at phx.gbl>
> Content-Type: text/plain; charset="iso-8859-1"
>
>
> Hi All,
> I agree wholeheartedly with Ton's proposal, assuming all the named
> participants agree.
>
> I hope this will soon get the 2.6 manual into good shape - I will do all I
> can to help.
>
> Jim Tucker ("sculptorjim")
>
>
>
> -------------- next part --------------
> An HTML attachment was scrubbed...
> URL:
> http://lists.blender.org/pipermail/bf-docboard/attachments/20120908/0765618a/attachment.html
>
> ------------------------------
>
> Message: 2
> Date: Sat, 8 Sep 2012 09:59:47 -0500
> From: Kesten Broughton <solarmobiletrailers at gmail.com>
> Subject: [Bf-docboard] wiki scrum sunday and assignment #2
> To: Blender Documentation Project <bf-docboard at blender.org>
> Message-ID:
>         <CAO2fFsVs1HnCMf7ikkq7om90JOuA=Atebxuq=
> 0M0kXRnatGk5w at mail.gmail.com>
> Content-Type: text/plain; charset="windows-1252"
>
> Hi all,
>
> Many production houses still use blender 2.49 as it is the most stable and
> well documented version of blender. That is, they are willing to give up
> all the fancy new gadgets of blender 2.6x for good documentation. We've got
> hundreds of thousands of blender users (and wannabe users) out there dying
> for better documentation.
>
> So...Let's get er done.
>
>
>  Next wiki scrum on IRC channel #blenderwiki is Sunday, 1700 CEST (1500
> UTC).   Please submit your review (by posting a link to it on this list) or
> give a status update before or during the IRC chat.  You should have
> contacted the author of the page and be in discussion about the review.  If
> the author can't be contacted, feel free to make the changes to the
> assigned page yourself.
>
>
> *Wiki-Admin:*  Ton has named 3 of 5 positions to our mini-board.  Any other
> nominations or volunteers to join?
>
>
>  *About reviewing pages where you aren't an expert on content.*
>
> This isn't necessarily a bad thing. 99% of the readers of this page will
> also not be an expert. In fact, it may be preferable. Of course, you can't
> be expected to catch errors for incompleteness, but you should be on the
> lookout for conformance to existing wiki style, and the ease with which any
> instructions can be followed.
>
> *Would a picture be helpful/necessary
>
> *Are there missing qualifiers to instructions:
>
>    **check if it works in Edit and Object modes, Game Engine and Render
> Engine settings
>
> * Is the visual layout well organized into headers, sections and
> subsections (using ==, ** and ##'s etc)
>
> * Are there any specific issues to platform (mac/windows/linux) that need
> to be flagged
>
> * Have they followed the wiki
> styleguide<http://wiki.blender.org/index.php/Meta:Guides/Style_Guide
> >regarding
> button templates, images
>
> (note my wiki-markup use of black bullets '*' and white-circle sub-bullets
> '**' here :)
>
>
>  The review doesn't have to leave the page perfect, just like wikipedia, we
> should welcome improvements with something like
>
>
>  ****************"Welcome Edits from Public" Box**********************
>
> If you are confident about a change to this page being made, go ahead. If
> you are less sure, make your suggestions in the discussion page. Either
> way, someone will be alerted so your changes and they can be reverted or
> improved as necessary. To keep an eye on this page yourself, make sure you
> mark the checkbox at by the ?submit? button after editing.
>
> ****************************************************************
>
>
>  For the sprints, don't worry about major issues like weather or not
> content should be split into two pages or other structural issues. Log it
> somewhere, either on the associated Discussion page or on the reviews page
> (by adding the {{review..}} to the top of the page. We really just need a
> quick pass/fail.
>
> If you are having any troubles with your assignment, please post here.
>
>  If the page has a 2.4 or otherwise outdated version *and* a newly revised
> version, your review is of the new version. Feel free, however, to make
> comparisons to the older page and comment on how the new is improved or
> deficient relative to the old.
>
>
>  *A note on the sprint schedule*: I'm going to suggest that we try
> releasing new sprint challenges every 4ish days to start (on wednesdays and
> sundays) for those who are chomping at the bit. If you prefer a weekly
> cycle, then just commit to that, and consider the next sprint as a preview
> until you are ready to tackle it. To summarize, sprints will be released on
> a 4 day schedule, but reviewers can execute on either a 4 day or 7 day
> schedule.
>
>
>  *Points!* I forgot to say, we will eventually have a proper point system
> like on stackoverflow and other sites. An assignment is 50 points on the 1
> week schedule, 60 points for 4 day completion.
>
>
>  *Assignment #1 Bonus: Embrace Blenderartists.org (10 points)*
>
> Do some searching on blenderartists.org for your review topics. You can
> restrict a google search to a specific site by including site:
> blenderartists.org plus your search terms. You should notice that all
> results are then from blenderartists.org. For example, if i search ?site:
> blenderartists.org particles? I get a whole page of good hits for threads
> like this<
> http://blenderartists.org/forum/forumdisplay.php?42-Particles-and-Simulations
> >.
> You can glean from the posts, what issues are important to users and
> what
> the major stumbling blocks are. If your review is for a new page or
> contains major changes, comment on the thread with a link to it in the post
> as soon as your reviewed page is moved to the 2.6 wiki.
>
>
>  *Sprint #2 Assignment : Tackling stubs for non-existing pages*
>
> Some pages don't exist yet (they either existed in 2.4 and haven't been
> ported, or were added by developers as stubs for new features. What a pain
> for users to search for a topic and click on a result that says ?sorry,
> this page doesn't exist?. Sprint #2 will tackle stubs. Assignments released
> tomorrow.
>
>
>  see you tommorow on IRC
>
> --
>
> Kesten Broughton
> President and Technology Director,
> Solar Mobile Trailers
> kesten at solarmobiletrailers.com
> www.sunfarmkitchens.ca <http://www.sunfarmkitchens.ca>
> 512 701 4209
> -------------- next part --------------
> An HTML attachment was scrubbed...
> URL:
> http://lists.blender.org/pipermail/bf-docboard/attachments/20120908/f49244a0/attachment-0001.htm
>
> ------------------------------
>
> Message: 3
> Date: Mon, 10 Sep 2012 00:28:23 +1000
> From: Fade <fade_docboard_blender at ymail.com>
> Subject: Re: [Bf-docboard] wiki scrum #1
> To: Blender Documentation Project <bf-docboard at blender.org>
> Message-ID: <504CA787.9020408 at ymail.com>
> Content-Type: text/plain; charset="iso-8859-1"
>
> The first few are probably where I just corrected what was listed in the
> review box at the top of the page. I went back and had a look at the
> Window System page
> (
> http://wiki.blender.org/index.php/User:Fade/Doc:2.6/Manual/Interface/Window_system
> )
> and went about adding more icons.
>
> ---Icon library---
> I started adding things to the Icon library as I made corrections to the
> above page. I went with any icon or image that would be consistent and
> just picked the default state for the moment. I found it very useful to
> have the file name listed as text on the page for copying and pasting
> into the wiki code but if someone has a better idea or better way to
> format the page, go nuts and change it.
>
> Regards
> Fade
>
> On 09/06/12 23:55, amdbcg wrote:
> > @Fade :  I did a brief look at the first few on your review list . I
> > will try to post my notes / edits sometime tomorrow on the wiki about
> > some of the small revisions.
> > The most noticeable thing on all the pages was that there were not
> > enough icons. If I were a new user, I would probably not immediately
> > know where all  the buttons were located.
> > tl;dr: pages including the word *"button" *or *"click on X"* need
> > small*icons* */pictures* to indicate which button to press visually.
> > Perhaps one of us could create a "library of button icons" page that
> > people could link/ add to?
> > Overall, it's good progress I look forward to reviewing.
> > -amdbcg
> > On 9/6/2012 4:43 PM, Fade wrote:
> >> Hi Kesten,
> >>
> >>
> http://wiki.blender.org/index.php/User:Fade/Doc:2.6/Manual/3D_interaction/Navigating/Camera_View
> >>
> >>
> http://wiki.blender.org/index.php/User:Fade/Doc:2.6/Manual/3D_interaction/Transform_Control/Manipulators
> >>
> >>
> http://wiki.blender.org/index.php/User:Fade/Doc:2.6/Manual/3D_interaction/Transform_Control/Axis_Locking
> >>
> >> Everything awaiting review is listed on my user page.
> >> http://wiki.blender.org/index.php/User:Fade
> >>
> >> Cheers
> >> Fade
> >>
> >> On 09/06/12 15:35, Kesten Broughton wrote:
> >>>
> >>> Author: Fade
> >>>
> >>> *Many on
> >>> *http://wiki.blender.org/index.php/Meta:Wiki_Tasks/Review_2.6_Manual
> >>>
> >>> Fade: can you point to some particular pages you have authored so we
> >>> can pick of a few.
> >>>
> >>>
> >>> _______________________________________________
> >>> 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
> >
> >
> >
> > _______________________________________________
> > Bf-docboard mailing list
> > Bf-docboard at blender.org
> > http://lists.blender.org/mailman/listinfo/bf-docboard
>
> -------------- next part --------------
> An HTML attachment was scrubbed...
> URL:
> http://lists.blender.org/pipermail/bf-docboard/attachments/20120910/c99213f5/attachment-0001.htm
>
> ------------------------------
>
> _______________________________________________
> Bf-docboard mailing list
> Bf-docboard at blender.org
> http://lists.blender.org/mailman/listinfo/bf-docboard
>
>
> End of Bf-docboard Digest, Vol 91, Issue 9
> ******************************************
>

-- 

Kesten Broughton
President and Technology Director,
Solar Mobile Trailers
kesten at solarmobiletrailers.com
www.sunfarmkitchens.ca <http://www.sunfarmkitchens.ca>
512 701 4209
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.blender.org/pipermail/bf-docboard/attachments/20120919/55993189/attachment.htm 