[Bf-docboard] 2.5 Wiki Changes

Mon Jun 13 23:10:25 CEST 2011

I totally understand your points. That's why I emailed the docboard. I felt
this needed to be discussed. If some one came and made changes, I would be
okay if they were logical, but yeah, if they were drastic, there should be
some discussion.

I see what you are saying about the order of materials, textures and rigging
animation. I had felt that lighting and rendering should maybe go together,
then I put materials and textures with those. I was looking at Maya's help
docs, and they have shading/textures/lighting/render all grouped under a
rendering section. But I haven't looked at docs for any other programs. Of
course, I guess the order of chapters is probably less important the order
of the contents in the chapters.

I think the sections that need the most organizational consideration are
modeling, animation, and rendering. I personally had felt that the mesh tool
sections were too awkwardly separated, so I divided them into four new
sections: transform/deform, add and divide, merge/remove, and separate. It
also seemed to me that the Object section should go before section on object
manipulation, and objects encompass non-editable things as well, that don't
really belong in the modeling section.

For the rendering section, I reordered the pages to: using the camera,
setting the rendering quality, and then options for outputting renders. The
animation section was difficult. I removed all pages referring to IPOs, and
tried grouping pages by their editor window.

How is the cross-linking going to work? Will the 2.4 pages just have links
to their respective 2.5 page, or is it something more complicated?

On Mon, Jun 13, 2011 at 3:37 AM, mindrones <mindrones at gmail.com> wrote:

> Hi Jared,
>
> I think it's ok if you keep working in the sandbox and when you think
> you are done you add some little text below each chapter to explain what
> you have done and why.
>
> For example roght now the 2.5 manual has materials and textures after
> rigging and the animation. That's disputable. IMO usually people start
> with static scenes, adding materials (colors, you know :) and after some
> expertise they start to rig and add constraints etc.
> I have to admit that I've been thinking at that approach many times, but
> I'm convinced that this kind of changes have to be discussed here.
>
> If you want to merge pages or write new ones, again make new pages in
> the sandbox.
>
> Bastien has done the same months ago and though it's been hard, it has
> given its fruits and now the manual is more mature than before, at least
> in my opinion.
>
> If we really let the manual open for such changes, then go figure if
> suddenly a "Jared2" comes and start to change all your changes again,
> what would you think?
>
> Probably you would say, hey let's discuss first! :)
>
> Laters,
> Luca
>
>
>
>
>
> On 06/13/2011 06:54 AM, Jared Reisweber wrote:
> > Okay. Yeah, that's what I was afraid of. I got a little excited. I'll
> > copy over the current state of the manual to Meta:Sandbox, then revert
> > the manual back to look like the Doc:Manual/earlier Doc:2.5/Manual index.
> >
> > The sandbox link is:
> > http://wiki.blender.org/index.php/Meta:Sandbox/Doc:2.5/Manual_Proposal
> >
> > The 2.5 index had considerable differences from the 2.4 index already
> > when I started, so its hard to judge what I should put back and
> > add/remove. I changed it back a little bit. Do you want me to straight
> > up just revert it back to the version before I messed with it, or make
> > it look like the 2.4 index? Bleh, now I'm really confused. heh.
> >
> > Some of the changes I made were necessary, as many topics were missing
> > completely, and many 2.5 features are very different from their 2.4
> > counterparts, such as the animation system.
> >
> > Other changes were made to consolidate very short pages together. Also,
> > some features from 2.4 were rearranged in 2.5's interface, lending
> > themselves to be grouped differently in the manual. For example,
> > consider the Output Panel, and the Format Panel in 2.4's render
> > settings. These have changed considerably in 2.5, as far as
> > organization. The manual should reflect this new grouping and workflow,
> > which why many of my changes seemed logical.
> >
> > The pages are still there for the most part, they just have been grouped
> > a little differently, and some have been added. It probably looks more
> > changed than it actually is. Most of the changes have more to do with
> > the usability of manual itself than the changes to Blender in 2.5, in my
> > opinion.
> >
> > On Sun, Jun 12, 2011 at 10:22 PM, mindrones <mindrones at gmail.com
> > <mailto:mindrones at gmail.com>> wrote:
> >
> >     Hey Jared,
> >
> >     I've been looking with more attention at the 2.5 manual index and
> WOW..
> >     I have to say that you are making it diverging quite a lot from the
> >     official manual index...
> >
> >     As stated in the orange banner up there, the idea is to update the
> >     official manual pages for 2.5 changes, while what you are doing is
> too
> >     much drastic in my opinion.
> >
> >     Personally I'd prefer you to revert your changes in Doc:2.5/Manual
> and
> >     prepare a sandbox page where you propose these structural changes
> here,
> >     so that everybody can discuss. Otherwise crosslinking will be
> impossible
> >     and really it will be very hard to compare the changes against 2.4
> >     manual.
> >
> >     I don't really think blender 2.5 is so much different from 2.4 to
> >     justify all these structural changes in the manual.
> >
> >
> >     Regards,
> >     Luca
> >
> >     _____________________________
> >
> >     http://www.mindrones.com
> >     _______________________________________________
> >     Bf-docboard mailing list
> >     Bf-docboard at blender.org <mailto: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
>
>
> --
>
> Regards,
> Luca
>
> _____________________________
>
> http://www.mindrones.com
> _______________________________________________
> 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/20110613/28bdc7b1/attachment.htm 