<div dir="ltr"><div class="gmail_extra">replying with feedback on the proposal and on some things that I currently think could be improved.</div><div class="gmail_extra"><br></div><div class="gmail_extra"><b>tl;dr:</b></div><div class="gmail_extra">- I would start by focusing on more introductory sections and hold on other big restructurings for whenever is a good timing. Doing the &#39;Editors&#39; would be big.</div><div class="gmail_extra">- We need to speed up on having a platform for better communication and task management</div><div class="gmail_extra">- I would not do an &#39;Advanced&#39; section.</div><div class="gmail_extra">- I would not put any videos</div><div class="gmail_extra"><br></div><div class="gmail_extra"><br></div><div class="gmail_extra">I would maintain a &#39;Getting Started&#39; as is now, and not replace it with the current &#39;Basics&#39; section (or did you @gaia mean only change the title?) ,</div><div class="gmail_extra"><b>&#39;Introduction&#39;</b> - keep</div><div class="gmail_extra"><b>&#39;Installation&#39;</b> - keep, but do a really big cleanup, put the <b>&#39;Troubleshooting&#39;</b> here too, also trimmed</div><div class="gmail_extra"><br></div><div class="gmail_extra">Then the mess starts, I don&#39;t really like videos as they are harder to keep up to date, and to internationalize. I don&#39;t oppose either, if we define a good infrastructure to support videos, and</div><div class="gmail_extra"> if they are not many.<br></div><div class="gmail_extra">I think that they should not replace text, so with or without video:</div><div class="gmail_extra"><br></div><div class="gmail_extra"><b>&#39;Preferences&#39;</b> - right after installation. this can have both a &#39;setting up blender for the first time&#39;, with &#39;do you have numpad? 3button mouse?..&#39; simple stuff, and a full reference even though users won&#39;t understand some of the 3d space manipulation nuances. otherwise, this can go after basics.</div><div class="gmail_extra">The internationalization of the UI sould be mentioned as soon as possible for users who are following translated manuals.</div><div class="gmail_extra"><br></div><div class="gmail_extra"><b>&#39;Interface&#39; </b>explaining windows/editors, splitting, etc and how to get around, then</div><div class="gmail_extra"><br></div><div class="gmail_extra"><b>&#39;Basics&#39;</b> - with:</div><div class="gmail_extra">  - setting the default scene,</div><div class="gmail_extra">  - mentioning preferences (if not mentioned before)</div><div class="gmail_extra">  - help system</div><div class="gmail_extra">  - quick rendering. also say we have different render engines</div><div class="gmail_extra">  - quick whatever so that people can just get around before delving deeper on anything</div><div class="gmail_extra">  - take screenshot and screencast away from this section</div><div class="gmail_extra"><br></div><div class="gmail_extra"><b>&#39;3D Interaction&#39;</b> - this section currently looks quite complicated and not very well encapsulated. </div><div class="gmail_extra"><br></div><div class="gmail_extra"><b>&#39;Data System&#39;</b> - I would put this very early, not in advanced, so that people understand quickly what are objects, and datablocks, users, fake users and that data with no users gets deleted, how linking and appending works. The philosophy of scenes and worlds, and the outliner. I really think this is part of the basics, not advanced.</div><div class="gmail_extra"><br></div><div class="gmail_extra"><br></div><div class="gmail_extra">All the other sections and generic structure:</div><div class="gmail_extra"><br></div><div class="gmail_extra">As for the <b>Editors</b> organization, I have mixed feelings about it. it is ever a complex subject.</div><div class="gmail_extra">I do agree with having a reference per editor.</div><div class="gmail_extra">About the structure, some editor pages fit nicely inside other sections (eg. outliner in data system, python console in scripting, 3d view in 3d interaction..). Some are generic or fit in multiple sections, like &#39;properties&#39;</div><div class="gmail_extra">So, have a list of editors, or the editors inside more or less subjectively appropriate sections?</div><div class="gmail_extra">I would propose, mentioning the editors inside wherever it makes sense, with workflow guided explanations, and have a section &#39;Editors&#39; with all of them to be used as reference.<br></div><div class="gmail_extra">This is quite a big restructure, though, and dangerous to have information repeated, I would hold off on it for now.</div><div class="gmail_extra"><br></div><div class="gmail_extra">The whole manual probably needs a review to support better the fact that there are multiple render engines. I see that &#39;blender internal&#39; &#39;cycles&#39; and &#39;freestyle&#39; are not easy to spot in the current structure.</div><div class="gmail_extra">These were lvl1 chapters in the wiki, why was this changed?</div><div class="gmail_extra"><br></div><div class="gmail_extra"><b>&#39;World&#39; </b>- the stars feature doesn&#39;t exist anymore.. so.. trim and include this in rendering?</div><div class="gmail_extra">Modeling, Modifiers, Rigging, Constraints, Animation, Materials, Textures, Rendering, Compositing</div><div class="gmail_extra"><br></div><div class="gmail_extra"><b>&#39;Glossary&#39;</b> are we using that? do we intend to?</div><div class="gmail_extra"><br></div><div class="gmail_extra"><br></div><div class="gmail_extra">I would avoid calling &#39;advanced&#39; to anything. It really depends on the background of the user. for some rigging is advanced, for others it&#39;s exactly what they want to read and having it on an &#39;advanced&#39; section, makes it look like that&#39;s not a normal use case for Blender. same for &#39;physics&#39; or &#39;motion tracking&#39; or anything really.</div><div class="gmail_extra">Putting &#39;Extending Blender&#39; in advanced, will scare users from scripting.</div><div class="gmail_extra">&#39;Data Systems&#39;, imho should be after &#39;basics&#39;, and &#39;Game Engine&#39; is also not advanced (more like unsupported, but it shouldn&#39;t be more advanced than MT or video editing).</div><div class="gmail_extra"><br></div><div class="gmail_extra"><br></div><div class="gmail_extra">@gaia if going forward with the Editors, would you be available to do it?</div><div class="gmail_extra">If you are motivated to do it now, I say &#39;don&#39;t hold off and go for it!&#39;</div><div class="gmail_extra">Even if you don&#39;t have the knowledge for all the editors, it would be good to have something more. But not being easy to deal with structuring, data duplication and massive reviewing of sections, I just meant that it is a lot of trouble when there are a lot of other high priority things that are easier to tackle first.</div><div class="gmail_extra"><br></div><div class="gmail_extra">cheers!</div><div class="gmail_extra">Inês Almeida / brita_</div><div class="gmail_extra"><br></div></div>