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