[Bf-docboard] Support grant for documentation project

[Greg Zaal]

Hey Narayan,

I don't think there has been an official "call" yet, though we'd be more
than happy for you to help :) Check out
http://blender.org/documentation/contribute if you haven't already.

It's neither a completely new manual, nor a re-write. It's just moving to a
better system, and making sure all the docs are up to date. Francesco and
Campbell did a talk about the project at the Blender Conference a few
months ago: http://youtu.be/OLQGGbiKfSs

It's mostly a Reference Manual, though most pages should have some kind of
'Usage' section describing a typical way to use that feature, a sort of
mini-tutorial. I don't think long tutorials showing how to do specific
things is a target for the manual, that sort of thing is better suited to
external sites/forums/literature. I see the manual mostly as a formal and
comprehensive reference of all the features and options, describing what
they do and where they are intended to be used.

Cheers,
Greg

PS: Thanks for the support guys! :)


On 11 December 2014 at 04:51, Raindrops From Sky <
raindrops.fromsky at gmail.com> wrote:
>
> Great!
>
> Did I miss a call for help-writers? I'd be interested to join and assist
> in this project.
>
> Is this a completely new User Manual, or a re-write of the wiki?
>
> Also, a few years ago, there was a discussion about splitting the body of
> knowledge in three interlinked parts:
> (a) Reference Manual (screen-by-screen explanation about what each control
> does)
> (b) User Manual (graded lessons on how to use Blender, with background
> theory wherever needed)
> (c) Tutorials
>
> Is that context, the present wiki is more of (a).
> Will the new manual cover everything, or will it be part (b)?
>
> Regards,
> Narayan
>
> On Wed, Dec 10, 2014 at 1:09 AM, <me at rogerwickes.com> wrote:
>
>> Awesome news. I look forward to getting back into authoring.
>>
>> On 2014-11-30 10:47, Jonathan Williamson wrote:
>> > Great news!
>> >
>> > On Sunday, November 30, 2014, Ton Roosendaal <ton at blender.org> wrote:
>> >
>> >> Hi all,
>> >>
>> >> Blender Foundation will support Greg Zaal to help us for 3 months
>> >> part-time on getting the new user manual up and running. He will do
>> >> cleaning work, fix up essential parts himself, coordinate
>> >> documentors and help to ensure that this whole new system is a
>> >> pleasant and usable experience for other documentors as well.
>> >>
>> >> Greg is a great guy and awesome writer, I look forward to see how
>> >> it turns out!
>> >>
>> >> Note: this grant will get paid from general (non dev fund)
>> >> donations. BF gets sufficient in to have more documentation grants
>> >> next year as well. But let's first see how this goes.
>> >>
>> >> Thanks,
>> >>
>> >> -Ton-
>> >>
>> >> --------------------------------------------------------
>> >> Ton Roosendaal  -  ton at blender.org   -   www.blender.org [1]
>> >> Chairman Blender Foundation - Producer Blender Institute
>> >> Entrepotdok 57A  -  1018AD Amsterdam  -  The Netherlands
>> >>
>> >> _______________________________________________
>> >> Bf-docboard mailing list
>> >> Bf-docboard at blender.org
>> >> http://lists.blender.org/mailman/listinfo/bf-docboard [2]
>> >
>> > --
>> >
>> > Jonathan Williamson
>> > http://cgcookie.com [3]
>> >
>> >
>> > Links:
>> > ------
>> > [1] http://www.blender.org
>> > [2] http://lists.blender.org/mailman/listinfo/bf-docboard
>> > [3] http://cgcookie.com
>> >
>> > _______________________________________________
>> > 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/20141213/90750b3b/attachment.htm