[Bsod-mentors] Re: Bsod-ideas and comments

[David Millet]

Hi Macouno,

Hopefully I give you good information here.  Timmeh or Ton, please let 
me know if I am out of line or wrong about any of this :)
> I'm wondering though, is it the general consensus that the end result will end up in 
> Wiki pages? Or is it an option to add something to the blender.org site? Or even 
> make it downloadable in one package?
>
> It might be a good idea to keep the resulting docs sepparate from the existing wiki 
> docs, since this is basicly going to be "official blender documentation"? Or is 
> everyone of the opinion that we should in fact try to fill gaps in the docs that are 
> already there?
>   
The wiki docs ARE the official blender documentation.  The license 
restrictions that we're requiring the authors to write under fit well 
into the blender wiki, as well.  Even if the documentation is written 
elsewhere, it will need to be written under the license restriction, 
which will then allow it to be copied to the blender wiki by anyone.  As 
for whether or not authors should try to fill in gaps in the Blender 
Manual on the wiki, that is up to them.  I imagine that most proposals 
will be to fill in portions of the 2.4 Blender Manual, but proposals to 
fill in blanks in other documentation, such as the Game Engine docs or 
the Go Pro! book on the blender wiki that I've barely touched, will be 
considered as well.  Writing for Noob to Pro is out of the question, 
since wikibooks.org has an incompatible license.
> I agree that we shouldn't overcomplicate submissions. People's writing styles and 
> skills will be represented in their submission synopsis.
>   
... yes and no.  People will write differently depending on the audience 
and the goal.  We should require a writing sample that reflects what 
they are proposing, whether it's something they've written previously 
and can copy & paste for us, or whether it's something they have to 
write on the spot.
> I think assigning a mentor to each author is a good idea, but I don't think there's so 
> much mentoring to be done that you'd need a 1 on 1 connection. Mentors can 
> handle multiple authors I'd say.
>   
Never having done this before, I would like to keep it simple for 
myself, personally.  I only want to mentor one person because I don't 
know how much mentoring will be required for that one person.  If I have 
to connect with multiple authors as they're writing, I'm afraid I might 
not be able to be as attentive as I would like.  On the other hand, if 
the author I'm mentoring is on the ball, I might not need to spend much 
time mentoring at all.  It's hard to say at this point, but to be safe, 
I'd like to mentor a single person, unless we're really tight on mentors.

spiderworm