[Bsod-mentors] Guidelines

[Ton Roosendaal]

Hi,

>  So I want to get the guidelines for this up and online by Wednesday  
> this week so we really need to finalise our plans.

You mean; wednesday is the "GO!"? Ok, the sooner the better :)

> First, we need to settle on the theme for the project.  From  
> everything I've seen in our emails, I'm leaning towards the second  
> option we had, Blender since 2.3, as a supplement to the manual.

I've not yet read all the forum feedback, but I've noticed there's  
quite some pretty good recent wiki addition about new features too. It  
might be not easy for authors to write on ten topics something unique  
here (without re-using existing docs).
What could help is that we hint people it doesn't have to a be dry  
technical description of 'how it works', but it can also be a practical  
guide of how to apply features in a complete project, i.e. a good  
tutorial (with loadsa pics) going step by step over the creation  
process.

We can also just allow both 'themes'. Introduction courses to Blender  
are always welcome.

> Something that we definitely need to lock down is what we are  
> considering as a suitable amount of documentation.   Myself, and Ton  
> discussed making this equivalent to a chapter of print.  So around  
> 20-25 pages of text, then inclusion of images.

25 pages including images is fine too; images on print resolution of  
course, not like wiki where screenies can take up a full page! :)
People might know tutorials as published in 3d magazines (3d world).  
Using this 'comic book' style step-by-step tutorials is very labour  
intensive, and doing 25 pages then would be a bit too much.

> I'm also thinking that whilst one week should be sufficient for the  
> writing of the docs themselves, students are going to need more time  
> to do the images for the docs, since i think this will be a major time  
> consumer.

"Students"? I hope that's an error! :)
Typically, you do images and docs in one run... especially when you  
decide to go the tutorial way. Remember these french tutorials I  
showed?

-Ton-

>
>  Anyway, any other issues please bring them up so i can include them  
> in my draft guidelines.
>
>  Tim
> _______________________________________________
> Bsod-mentors mailing list
> Bsod-mentors at blender.org
> http://projects.blender.org/mailman/listinfo/bsod-mentors
>
------------------------------------------------------------------------ 
--
Ton Roosendaal  Blender Foundation ton at blender.org  
http://www.blender.org