<br><br><div class="gmail_quote">On Wed, Mar 30, 2011 at 12:38 PM, Glyph Lefkowitz <span dir="ltr">&lt;<a href="mailto:glyph@twistedmatrix.com">glyph@twistedmatrix.com</a>&gt;</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;">
<div style="word-wrap: break-word;"><div class="im"><br><div><div>On Mar 29, 2011, at 3:10 AM, Albert Brandl wrote:</div><br><blockquote type="cite"><div>On Mon, Mar 28, 2011 at 09:27:04AM -0400, Tom Davis wrote:<br><blockquote type="cite">
<br></blockquote><blockquote type="cite">It&#39;s great to have everything indexed on one page with easy drill-down <br></blockquote><blockquote type="cite">into specific sections. It becomes really obvious where the hierarchy <br>
</blockquote><blockquote type="cite">can be optimized and how we can logically go about breaking up the <br></blockquote><blockquote type="cite">various sections.<br></blockquote><br>This is right. But I was confused by the fact that the first-level items <br>
in the list (&quot;Twisted Conch Documentation&quot;, &quot;Twisted Core Documentation&quot;, <br>etc.) link to pages that _again_ present links to the second-level items.<br>Adding to my confusion was the fact that the links on the main page have<br>
different names from the ones on the subpages.<br></div></blockquote></div><br></div><div>You&#39;re absolutely right.  The organization is a total mess.  But here&#39;s the surprise: the organization is not <i>new</i> :).  This is the exact same organization that the documentation has had for years.  The difference is that you can see it now, and notice that it&#39;s a problem, rather than just search for a document that you want, find that one document outside of the navigation structure, and ignore the rest of the docs (which is what most people do now).  I think that&#39;s a very good thing.</div>
<div><br></div><div>For example: both &lt;<a href="http://twistedmatrix.com/documents/10.2.0/" target="_blank">http://twistedmatrix.com/documents/10.2.0/</a>&gt; and &lt;<a href="http://twistedmatrix.com/%7Eglyph/sphinx-preview-11.0pre1/" target="_blank">http://twistedmatrix.com/~glyph/sphinx-preview-11.0pre1/</a>&gt; have a &quot;conch&quot; link.  And as you can see when you follow that link, &lt;<a href="http://twistedmatrix.com/documents/10.2.0/conch/" target="_blank">http://twistedmatrix.com/documents/10.2.0/conch/</a>&gt; looks a lot like  &lt;<a href="http://twistedmatrix.com/%7Eglyph/sphinx-preview-11.0pre1/projects/conch/index.html" target="_blank">http://twistedmatrix.com/~glyph/sphinx-preview-11.0pre1/projects/conch/index.html</a>&gt;.</div>
<div><br></div><div>This issue will be probably be fixed after the migration.  That is, I would certainly be happy if it were fixed before, or at any time really, but fixing it probably requires some tweaks to release infrastructure that would better be put off until we&#39;ve deleted most of that part of the release infrastructure.  The important point is that it should <i>stop</i> the migration from happening, since the results are actually better now than they were, just more noticeable.</div>
<div><br></div><div>At any rate: thanks for the feedback, it&#39;s appreciated!</div><div><br></div><font color="#888888"><div>-glyph</div></font></div><br></blockquote></div><br>Er, you mean it should _not_ stop the migration from happening?<br>
<br>Kevin Horn<br>