<div dir="ltr"><div><div>Hey everyone,<br><br></div>Why is it that we have both an <b>index.rst</b> and an <b>introduction.rst</b>? The differences:<br><br></div>Index:<br><ul><li>What you see when clicking on a chapter in the navigation bar</li><li>What is shown when entering the chapter folder as the URL (e.g. <a href="http://blender.org/manual/render/">blender.org/manual/render/</a> takes you to index.html in that folder)</li><li>Only contains the table-of-contents, no other text (usually)<br></li></ul><p>Introduction:</p><ul><li>Provides a brief explanation on what is covered in that chapter/folder.</li><li>Is always the top-most item in the index&#39;s table-of-contents.</li></ul><p>To me it seems like we should put all the helpful introductory explanations inside the index.rst, since that&#39;s what people will be looking at most. Currently if I want to read about (e.g.) modeling, I click on the chapter, and then I have to click again on the introduction in the ToC. Once I&#39;ve read that, I have to then go back to the index and see where to continue reading.</p><p>Additionally, some introduction pages are written as a sort of index page anyway (e.g. <a href="http://gregzaal.com/manual/modifiers/introduction.html#modify">modifiers</a>)<br></p><p>I&#39;d like to propose that we put the introductory text on the index page by doing one of the following:</p><ul><li>Delete introduction.rst and just move that text to the top/bottom of the index page.</li><li>Keep introduction.rst, but make it hidden in the ToC - then add `<span style="font-family:monospace,monospace">.. include:: introduction.rst</span>` at the top/bottom of the index to insert the contents of the introduction file in there.</li></ul><p>I tried out the second method here: <a href="http://gregzaal.com/manual/render/cycles">http://gregzaal.com/manual/render/cycles</a> - the RST source for that is: <a href="http://www.pasteall.org/56903">http://www.pasteall.org/56903</a></p><p>What do you guys think? Should we have intro text in the index page? And if so, should we delete introduction.rst or simply include it?</p><p>Cheers,<br>Greg<br></p></div>