[Bf-docboard] Re: Blender education materials

[Tom M]

Hi Glen,

> It's pretty tricky as it is trying to write up-to-date
> documentation,

Now that everything is on the wiki

mediawiki.blender.org

That should become a lot easier.  Unfortuantely I think there is too
much overhead for making changes to the wiki (requires getting an
account and then requires getting added to a specific group).  This is
a potentially big barrier to individuals interested in making minor
corrections (for instance I visited two 3d sites that had wikis the
other day, one allowed anonymous edits, and thus I fixed a number of
grammatical and spelling errors (which was ironically on their page
requesting individuals to check their spelling and grammar, including
correcting the misspelling of grammar...) the other had a registration
process, and thus required more information and effort than I was
willing to exert.

> The practical upshot of this is that
> I write one document, but different people can quickly scan through it
> to get what they need, and can skip the areas that are not for them.
>
> I'm not saying that we should color code the documentation, but the
> benefits of whatever method we use should be the same.

>  We are not writing any more documentation, just modularizing it
> so that people can focus on what they really need to know, and then
> bypass all the fluff.

I fully agree, there should definitely be a clean seperation that
allows different views of the documentation to be useful for multiple
groups.

thanks for your reply,

Tom M.