<div dir="ltr">No, I would rather keep things simple and don't think these are needed.<div>We already have a good index structure which serves the same purpose.</div></div><div class="gmail_extra"><br><div class="gmail_quote">On Thu, Dec 7, 2017 at 10:17 AM, Tobias Heinke <span dir="ltr"><<a href="mailto:heinke.tobias@t-online.de" target="_blank">heinke.tobias@t-online.de</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<div text="#000000" bgcolor="#FFFFFF">
<p>Hi all,</p>
<p>I removed the overviews from the manual <span class="m_5998802239890107836phui-tag-view m_5998802239890107836phui-tag-type-shade m_5998802239890107836phui-tag-indigo m_5998802239890107836phui-tag-slim m_5998802239890107836phui-tag-shade m_5998802239890107836phui-tag-border-none"><span class="m_5998802239890107836phui-tag-core">(rBM3885 - </span></span><span class="m_5998802239890107836phui-tag-view m_5998802239890107836phui-tag-type-shade m_5998802239890107836phui-tag-indigo m_5998802239890107836phui-tag-slim m_5998802239890107836phui-tag-shade m_5998802239890107836phui-tag-border-none"><span class="m_5998802239890107836phui-tag-core"><span class="m_5998802239890107836phui-tag-view m_5998802239890107836phui-tag-type-shade m_5998802239890107836phui-tag-indigo m_5998802239890107836phui-tag-slim m_5998802239890107836phui-tag-shade m_5998802239890107836phui-tag-border-none"><span class="m_5998802239890107836phui-tag-core">rBM3900).<br>
These are links, commonly on intro pages, to the
subsections of the chapter and a brief ~2 sentence
summary.<br>
(last remaining: <a class="m_5998802239890107836moz-txt-link-freetext" href="https://docs.blender.org/manual/en/dev/editors/3dview/object/types.html" target="_blank">https://docs.blender.org/<wbr>manual/en/dev/editors/3dview/<wbr>object/types.html</a>).<br>
</span></span></span></span><span class="m_5998802239890107836phui-tag-view m_5998802239890107836phui-tag-type-shade m_5998802239890107836phui-tag-indigo m_5998802239890107836phui-tag-slim m_5998802239890107836phui-tag-shade m_5998802239890107836phui-tag-border-none"><span class="m_5998802239890107836phui-tag-core"><span class="m_5998802239890107836phui-tag-view m_5998802239890107836phui-tag-type-shade m_5998802239890107836phui-tag-indigo m_5998802239890107836phui-tag-slim m_5998802239890107836phui-tag-shade m_5998802239890107836phui-tag-border-none"><span class="m_5998802239890107836phui-tag-core">I guess </span></span></span></span><span class="m_5998802239890107836phui-tag-view m_5998802239890107836phui-tag-type-shade m_5998802239890107836phui-tag-indigo m_5998802239890107836phui-tag-slim m_5998802239890107836phui-tag-shade m_5998802239890107836phui-tag-border-none"><span class="m_5998802239890107836phui-tag-core"><span class="m_5998802239890107836phui-tag-view m_5998802239890107836phui-tag-type-shade m_5998802239890107836phui-tag-indigo m_5998802239890107836phui-tag-slim m_5998802239890107836phui-tag-shade m_5998802239890107836phui-tag-border-none"><span class="m_5998802239890107836phui-tag-core"></span></span></span></span><span class="m_5998802239890107836phui-tag-view m_5998802239890107836phui-tag-type-shade m_5998802239890107836phui-tag-indigo m_5998802239890107836phui-tag-slim m_5998802239890107836phui-tag-shade m_5998802239890107836phui-tag-border-none"><span class="m_5998802239890107836phui-tag-core"><span class="m_5998802239890107836phui-tag-view m_5998802239890107836phui-tag-type-shade m_5998802239890107836phui-tag-indigo m_5998802239890107836phui-tag-slim m_5998802239890107836phui-tag-shade m_5998802239890107836phui-tag-border-none"><span class="m_5998802239890107836phui-tag-core">these </span></span></span></span><span class="m_5998802239890107836phui-tag-view m_5998802239890107836phui-tag-type-shade m_5998802239890107836phui-tag-indigo m_5998802239890107836phui-tag-slim m_5998802239890107836phui-tag-shade m_5998802239890107836phui-tag-border-none"><span class="m_5998802239890107836phui-tag-core"><span class="m_5998802239890107836phui-tag-view m_5998802239890107836phui-tag-type-shade m_5998802239890107836phui-tag-indigo m_5998802239890107836phui-tag-slim m_5998802239890107836phui-tag-shade m_5998802239890107836phui-tag-border-none"><span class="m_5998802239890107836phui-tag-core">where</span></span></span></span><span class="m_5998802239890107836phui-tag-view m_5998802239890107836phui-tag-type-shade m_5998802239890107836phui-tag-indigo m_5998802239890107836phui-tag-slim m_5998802239890107836phui-tag-shade m_5998802239890107836phui-tag-border-none"><span class="m_5998802239890107836phui-tag-core"><span class="m_5998802239890107836phui-tag-view m_5998802239890107836phui-tag-type-shade m_5998802239890107836phui-tag-indigo m_5998802239890107836phui-tag-slim m_5998802239890107836phui-tag-shade m_5998802239890107836phui-tag-border-none"><span class="m_5998802239890107836phui-tag-core"> </span></span></span></span><span class="m_5998802239890107836phui-tag-view m_5998802239890107836phui-tag-type-shade m_5998802239890107836phui-tag-indigo m_5998802239890107836phui-tag-slim m_5998802239890107836phui-tag-shade m_5998802239890107836phui-tag-border-none"><span class="m_5998802239890107836phui-tag-core"><span class="m_5998802239890107836phui-tag-view m_5998802239890107836phui-tag-type-shade m_5998802239890107836phui-tag-indigo m_5998802239890107836phui-tag-slim m_5998802239890107836phui-tag-shade m_5998802239890107836phui-tag-border-none"><span class="m_5998802239890107836phui-tag-core">originally created because the wiki
has no TOCs, so pages had to be linked manually.</span></span></span></span></p>
<p><span class="m_5998802239890107836phui-tag-view m_5998802239890107836phui-tag-type-shade m_5998802239890107836phui-tag-indigo m_5998802239890107836phui-tag-slim m_5998802239890107836phui-tag-shade m_5998802239890107836phui-tag-border-none"><span class="m_5998802239890107836phui-tag-core"><span class="m_5998802239890107836phui-tag-view m_5998802239890107836phui-tag-type-shade m_5998802239890107836phui-tag-indigo m_5998802239890107836phui-tag-slim m_5998802239890107836phui-tag-shade m_5998802239890107836phui-tag-border-none"><span class="m_5998802239890107836phui-tag-core">The reason for removing them was:<br>
Duplicated content: every page should start with a summary
anyway, so merging these together could raise the quality.<br>
Additional work to keep them up-to-date: which was
confirmed by missing summaries or even whole items.</span></span></span></span></p>
<p><span class="m_5998802239890107836phui-tag-view m_5998802239890107836phui-tag-type-shade m_5998802239890107836phui-tag-indigo m_5998802239890107836phui-tag-slim m_5998802239890107836phui-tag-shade m_5998802239890107836phui-tag-border-none"><span class="m_5998802239890107836phui-tag-core"><span class="m_5998802239890107836phui-tag-view m_5998802239890107836phui-tag-type-shade m_5998802239890107836phui-tag-indigo m_5998802239890107836phui-tag-slim m_5998802239890107836phui-tag-shade m_5998802239890107836phui-tag-border-none"><span class="m_5998802239890107836phui-tag-core">The question is if we should add
them back in, but this time automatically generating them
with a script.<br>
Almost all it would take it to do is copy the first
sentences of a page. This can be achieved in different
ways:</span></span></span></span></p>
<p><span class="m_5998802239890107836phui-tag-view m_5998802239890107836phui-tag-type-shade m_5998802239890107836phui-tag-indigo m_5998802239890107836phui-tag-slim m_5998802239890107836phui-tag-shade m_5998802239890107836phui-tag-border-none"><span class="m_5998802239890107836phui-tag-core"><span class="m_5998802239890107836phui-tag-view m_5998802239890107836phui-tag-type-shade m_5998802239890107836phui-tag-indigo m_5998802239890107836phui-tag-slim m_5998802239890107836phui-tag-shade m_5998802239890107836phui-tag-border-none"><span class="m_5998802239890107836phui-tag-core">1. The build-in include:</span></span></span></span><br>
<span class="m_5998802239890107836phui-tag-view m_5998802239890107836phui-tag-type-shade m_5998802239890107836phui-tag-indigo m_5998802239890107836phui-tag-slim m_5998802239890107836phui-tag-shade m_5998802239890107836phui-tag-border-none"><span class="m_5998802239890107836phui-tag-core"><span class="m_5998802239890107836phui-tag-view m_5998802239890107836phui-tag-type-shade m_5998802239890107836phui-tag-indigo m_5998802239890107836phui-tag-slim m_5998802239890107836phui-tag-shade m_5998802239890107836phui-tag-border-none"><span class="m_5998802239890107836phui-tag-core">Would need either to be line based
or with comment marks (.. copy from here). I didn't
actually tried it.</span><span class="m_5998802239890107836phui-tag-core"><br>
</span></span></span></span><span class="m_5998802239890107836phui-tag-view m_5998802239890107836phui-tag-type-shade m_5998802239890107836phui-tag-indigo m_5998802239890107836phui-tag-slim m_5998802239890107836phui-tag-shade m_5998802239890107836phui-tag-border-none"><span class="m_5998802239890107836phui-tag-core"><span class="m_5998802239890107836phui-tag-view m_5998802239890107836phui-tag-type-shade m_5998802239890107836phui-tag-indigo m_5998802239890107836phui-tag-slim m_5998802239890107836phui-tag-shade m_5998802239890107836phui-tag-border-none"><span class="m_5998802239890107836phui-tag-core">con: marks in the text or breaks
easily, without a way to check it<br>
pro: full-automatic</span></span></span></span></p>
<p><span class="m_5998802239890107836phui-tag-view m_5998802239890107836phui-tag-type-shade m_5998802239890107836phui-tag-indigo m_5998802239890107836phui-tag-slim m_5998802239890107836phui-tag-shade m_5998802239890107836phui-tag-border-none"><span class="m_5998802239890107836phui-tag-core"><span class="m_5998802239890107836phui-tag-view m_5998802239890107836phui-tag-type-shade m_5998802239890107836phui-tag-indigo m_5998802239890107836phui-tag-slim m_5998802239890107836phui-tag-shade m_5998802239890107836phui-tag-border-none"><span class="m_5998802239890107836phui-tag-core">2. Custom extension: nope<br>
</span></span></span></span></p>
<p><span class="m_5998802239890107836phui-tag-view m_5998802239890107836phui-tag-type-shade m_5998802239890107836phui-tag-indigo m_5998802239890107836phui-tag-slim m_5998802239890107836phui-tag-shade m_5998802239890107836phui-tag-border-none"><span class="m_5998802239890107836phui-tag-core"><span class="m_5998802239890107836phui-tag-view m_5998802239890107836phui-tag-type-shade m_5998802239890107836phui-tag-indigo m_5998802239890107836phui-tag-slim m_5998802239890107836phui-tag-shade m_5998802239890107836phui-tag-border-none"><span class="m_5998802239890107836phui-tag-core">3. A custom script:<br>
I think the most intuitive way is to select per sentence.<br>
con: "e.g. " or any other dot space could breaks it. semi-</span></span></span></span><span class="m_5998802239890107836phui-tag-view m_5998802239890107836phui-tag-type-shade m_5998802239890107836phui-tag-indigo m_5998802239890107836phui-tag-slim m_5998802239890107836phui-tag-shade m_5998802239890107836phui-tag-border-none"><span class="m_5998802239890107836phui-tag-core"><span class="m_5998802239890107836phui-tag-view m_5998802239890107836phui-tag-type-shade m_5998802239890107836phui-tag-indigo m_5998802239890107836phui-tag-slim m_5998802239890107836phui-tag-shade m_5998802239890107836phui-tag-border-none"><span class="m_5998802239890107836phui-tag-core">automatic<br>
pro: easy to check (diff), line wraps<br>
</span></span></span></span></p>
<p><span class="m_5998802239890107836phui-tag-view m_5998802239890107836phui-tag-type-shade m_5998802239890107836phui-tag-indigo m_5998802239890107836phui-tag-slim m_5998802239890107836phui-tag-shade m_5998802239890107836phui-tag-border-none"><span class="m_5998802239890107836phui-tag-core"><span class="m_5998802239890107836phui-tag-view m_5998802239890107836phui-tag-type-shade m_5998802239890107836phui-tag-indigo m_5998802239890107836phui-tag-slim m_5998802239890107836phui-tag-shade m_5998802239890107836phui-tag-border-none"><span class="m_5998802239890107836phui-tag-core">I quickly created a proof of
concept.<br>
The overview on the intro page (physics in this case)
would be generated based on a pseudo directive:</span></span></span></span></p>
<p><span class="m_5998802239890107836phui-tag-view m_5998802239890107836phui-tag-type-shade m_5998802239890107836phui-tag-indigo m_5998802239890107836phui-tag-slim m_5998802239890107836phui-tag-shade m_5998802239890107836phui-tag-border-none"><span class="m_5998802239890107836phui-tag-core"><span class="m_5998802239890107836phui-tag-view m_5998802239890107836phui-tag-type-shade m_5998802239890107836phui-tag-indigo m_5998802239890107836phui-tag-slim m_5998802239890107836phui-tag-shade m_5998802239890107836phui-tag-border-none"><span class="m_5998802239890107836phui-tag-core"> .. overview<br>
particles/introduction: 2<br>
collision: 0<br>
fluid/introduction: 2<br>
soft_body/introduction: 1</span></span></span></span></p>
<p><span class="m_5998802239890107836phui-tag-view m_5998802239890107836phui-tag-type-shade m_5998802239890107836phui-tag-indigo m_5998802239890107836phui-tag-slim m_5998802239890107836phui-tag-shade m_5998802239890107836phui-tag-border-none"><span class="m_5998802239890107836phui-tag-core"><span class="m_5998802239890107836phui-tag-view m_5998802239890107836phui-tag-type-shade m_5998802239890107836phui-tag-indigo m_5998802239890107836phui-tag-slim m_5998802239890107836phui-tag-shade m_5998802239890107836phui-tag-border-none"><span class="m_5998802239890107836phui-tag-core">It is composed out of the relative
path and the number of sentences to copy. It is stored on
the page as a comment for future generations :)<br>
</span></span></span></span></p>
<p><span class="m_5998802239890107836phui-tag-view m_5998802239890107836phui-tag-type-shade m_5998802239890107836phui-tag-indigo m_5998802239890107836phui-tag-slim m_5998802239890107836phui-tag-shade m_5998802239890107836phui-tag-border-none"><span class="m_5998802239890107836phui-tag-core"><span class="m_5998802239890107836phui-tag-view m_5998802239890107836phui-tag-type-shade m_5998802239890107836phui-tag-indigo m_5998802239890107836phui-tag-slim m_5998802239890107836phui-tag-shade m_5998802239890107836phui-tag-border-none"><span class="m_5998802239890107836phui-tag-core">Here is the current raw output of
the script:</span></span></span></span></p>
<p><span class="m_5998802239890107836phui-tag-view m_5998802239890107836phui-tag-type-shade m_5998802239890107836phui-tag-indigo m_5998802239890107836phui-tag-slim m_5998802239890107836phui-tag-shade m_5998802239890107836phui-tag-border-none"><span class="m_5998802239890107836phui-tag-core"><span class="m_5998802239890107836phui-tag-view m_5998802239890107836phui-tag-type-shade m_5998802239890107836phui-tag-indigo m_5998802239890107836phui-tag-slim m_5998802239890107836phui-tag-shade m_5998802239890107836phui-tag-border-none"><span class="m_5998802239890107836phui-tag-core">particles<br>
Particles are lots of items emitted from mesh objects,
typically in the thousands. Each particle can be a point
of light or a mesh, and be joined or dynamic. <br>
collision<br>
<br>
fluid<br>
Fluid physics are used to simulate physical properties of
liquids especially water. While creating a scene in
Blender, certain objects can be marked to participate in
the fluid simulation.<br>
<br>
soft body<br>
A Soft Body in general, is a simulation of a soft or rigid
deformable object. <br>
</span></span></span></span></p>
<p><span class="m_5998802239890107836phui-tag-view m_5998802239890107836phui-tag-type-shade m_5998802239890107836phui-tag-indigo m_5998802239890107836phui-tag-slim m_5998802239890107836phui-tag-shade m_5998802239890107836phui-tag-border-none"><span class="m_5998802239890107836phui-tag-core"><span class="m_5998802239890107836phui-tag-view m_5998802239890107836phui-tag-type-shade m_5998802239890107836phui-tag-indigo m_5998802239890107836phui-tag-slim m_5998802239890107836phui-tag-shade m_5998802239890107836phui-tag-border-none"><span class="m_5998802239890107836phui-tag-core">>The output could </span></span></span></span><span class="m_5998802239890107836phui-tag-view m_5998802239890107836phui-tag-type-shade m_5998802239890107836phui-tag-indigo m_5998802239890107836phui-tag-slim m_5998802239890107836phui-tag-shade m_5998802239890107836phui-tag-border-none"><span class="m_5998802239890107836phui-tag-core"><span class="m_5998802239890107836phui-tag-view m_5998802239890107836phui-tag-type-shade m_5998802239890107836phui-tag-indigo m_5998802239890107836phui-tag-slim m_5998802239890107836phui-tag-shade m_5998802239890107836phui-tag-border-none"><span class="m_5998802239890107836phui-tag-core"></span></span></span></span><span class="m_5998802239890107836phui-tag-view m_5998802239890107836phui-tag-type-shade m_5998802239890107836phui-tag-indigo m_5998802239890107836phui-tag-slim m_5998802239890107836phui-tag-shade m_5998802239890107836phui-tag-border-none"><span class="m_5998802239890107836phui-tag-core"><span class="m_5998802239890107836phui-tag-view m_5998802239890107836phui-tag-type-shade m_5998802239890107836phui-tag-indigo m_5998802239890107836phui-tag-slim m_5998802239890107836phui-tag-shade m_5998802239890107836phui-tag-border-none"><span class="m_5998802239890107836phui-tag-core">then </span></span></span></span><span class="m_5998802239890107836phui-tag-view m_5998802239890107836phui-tag-type-shade m_5998802239890107836phui-tag-indigo m_5998802239890107836phui-tag-slim m_5998802239890107836phui-tag-shade m_5998802239890107836phui-tag-border-none"><span class="m_5998802239890107836phui-tag-core"><span class="m_5998802239890107836phui-tag-view m_5998802239890107836phui-tag-type-shade m_5998802239890107836phui-tag-indigo m_5998802239890107836phui-tag-slim m_5998802239890107836phui-tag-shade m_5998802239890107836phui-tag-border-none"><span class="m_5998802239890107836phui-tag-core">be </span></span></span></span><span class="m_5998802239890107836phui-tag-view m_5998802239890107836phui-tag-type-shade m_5998802239890107836phui-tag-indigo m_5998802239890107836phui-tag-slim m_5998802239890107836phui-tag-shade m_5998802239890107836phui-tag-border-none"><span class="m_5998802239890107836phui-tag-core"><span class="m_5998802239890107836phui-tag-view m_5998802239890107836phui-tag-type-shade m_5998802239890107836phui-tag-indigo m_5998802239890107836phui-tag-slim m_5998802239890107836phui-tag-shade m_5998802239890107836phui-tag-border-none"><span class="m_5998802239890107836phui-tag-core">appended </span></span></span></span><span class="m_5998802239890107836phui-tag-view m_5998802239890107836phui-tag-type-shade m_5998802239890107836phui-tag-indigo m_5998802239890107836phui-tag-slim m_5998802239890107836phui-tag-shade m_5998802239890107836phui-tag-border-none"><span class="m_5998802239890107836phui-tag-core"><span class="m_5998802239890107836phui-tag-view m_5998802239890107836phui-tag-type-shade m_5998802239890107836phui-tag-indigo m_5998802239890107836phui-tag-slim m_5998802239890107836phui-tag-shade m_5998802239890107836phui-tag-border-none"><span class="m_5998802239890107836phui-tag-core">formatted as normal RST syntax.<br>
The directive can be compared with index's toc to detect
modifications.</span></span></span></span></p>
<p><span class="m_5998802239890107836phui-tag-view m_5998802239890107836phui-tag-type-shade m_5998802239890107836phui-tag-indigo m_5998802239890107836phui-tag-slim m_5998802239890107836phui-tag-shade m_5998802239890107836phui-tag-border-none"><span class="m_5998802239890107836phui-tag-core"><span class="m_5998802239890107836phui-tag-view m_5998802239890107836phui-tag-type-shade m_5998802239890107836phui-tag-indigo m_5998802239890107836phui-tag-slim m_5998802239890107836phui-tag-shade m_5998802239890107836phui-tag-border-none"><span class="m_5998802239890107836phui-tag-core">Regards,<br>
Tobias<br>
</span></span></span></span></p>
<p><span class="m_5998802239890107836phui-tag-view m_5998802239890107836phui-tag-type-shade m_5998802239890107836phui-tag-indigo m_5998802239890107836phui-tag-slim m_5998802239890107836phui-tag-shade m_5998802239890107836phui-tag-border-none"><span class="m_5998802239890107836phui-tag-core"><span class="m_5998802239890107836phui-tag-view m_5998802239890107836phui-tag-type-shade m_5998802239890107836phui-tag-indigo m_5998802239890107836phui-tag-slim m_5998802239890107836phui-tag-shade m_5998802239890107836phui-tag-border-none"><span class="m_5998802239890107836phui-tag-core"><br>
</span></span></span></span></p>
<p><span class="m_5998802239890107836phui-tag-view m_5998802239890107836phui-tag-type-shade m_5998802239890107836phui-tag-indigo m_5998802239890107836phui-tag-slim m_5998802239890107836phui-tag-shade m_5998802239890107836phui-tag-border-none"><span class="m_5998802239890107836phui-tag-core"><span class="m_5998802239890107836phui-tag-view m_5998802239890107836phui-tag-type-shade m_5998802239890107836phui-tag-indigo m_5998802239890107836phui-tag-slim m_5998802239890107836phui-tag-shade m_5998802239890107836phui-tag-border-none"><span class="m_5998802239890107836phui-tag-core"><br>
</span></span></span></span></p>
<p><span class="m_5998802239890107836phui-tag-view m_5998802239890107836phui-tag-type-shade m_5998802239890107836phui-tag-indigo m_5998802239890107836phui-tag-slim m_5998802239890107836phui-tag-shade m_5998802239890107836phui-tag-border-none"><span class="m_5998802239890107836phui-tag-core"><span class="m_5998802239890107836phui-tag-view m_5998802239890107836phui-tag-type-shade m_5998802239890107836phui-tag-indigo m_5998802239890107836phui-tag-slim m_5998802239890107836phui-tag-shade m_5998802239890107836phui-tag-border-none"><span class="m_5998802239890107836phui-tag-core"><br>
</span></span></span></span></p>
</div>
<br>______________________________<wbr>_________________<br>
Bf-docboard mailing list<br>
<a href="mailto:Bf-docboard@blender.org">Bf-docboard@blender.org</a><br>
<a href="https://lists.blender.org/mailman/listinfo/bf-docboard" rel="noreferrer" target="_blank">https://lists.blender.org/<wbr>mailman/listinfo/bf-docboard</a><br>
<br></blockquote></div><br><br clear="all"><div><br></div>-- <br><div class="gmail_signature" data-smartmail="gmail_signature"><div dir="ltr"><span style="color:rgb(153,153,153)"><span style="color:rgb(0,0,0)">Aaron Carlisle</span><br></span><div><span style="color:rgb(153,153,153)"><br>Picture taker | Bit cruncher | Pixel pusher | Document writer | Artist<br></span></div><div><span style="color:rgb(153,153,153)">Project administrator for the Blender 3D Documentation Project</span></div></div></div>
</div>