Hi again,<div><br></div><div>Here is a working prototype of what the structure would look like (page may change as I update my local build):</div><div><br></div><div><a href="http://corvette.colorado.edu/~skillman/yt-docs/">http://corvette.colorado.edu/~skillman/yt-docs/</a></div>
<div><br></div><div>Comments would be greatly appreciated.</div><div><br></div><div>Sam<br><br><div class="gmail_quote">On Tue, Jul 10, 2012 at 12:14 PM, Sam Skillman <span dir="ltr"><<a href="mailto:samskillman@gmail.com" target="_blank">samskillman@gmail.com</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><span><span style="font-family:Arial;font-size:15px;vertical-align:baseline;white-space:pre-wrap">Hi all,</span><br><span style="font-family:Arial;font-size:15px;vertical-align:baseline;white-space:pre-wrap">We had a fairly good discussion in the docs hangout about how the structure of the docs might be improved. What we've come up with is a reorganization of the front page of </span><br>
<span style="font-family:Arial;font-size:15px;vertical-align:baseline;white-space:pre-wrap"><a href="http://yt-project.org/doc/index.html" target="_blank">http://yt-project.org/doc/index.html</a></span></span><div><span><font face="Arial"><span style="font-size:15px;white-space:pre-wrap"><br>
</span></font><span style="font-family:Arial;font-size:15px;vertical-align:baseline;white-space:pre-wrap">to have the Overview paragraph, followed by a table of contents entitled "User Guide.” This is what the structure would look like:</span></span></div>
<div><span><font face="Arial"><span style="font-size:15px;white-space:pre-wrap"><br></span></font><ul style="font-family:Times;font-size:medium;margin-top:0pt;margin-bottom:0pt"><li style="list-style-type:disc;font-size:15px;font-family:Arial;vertical-align:baseline">
<span style="vertical-align:baseline;white-space:pre-wrap">User Guide (See full Table of Contents → link to full, or toggle full/collapsed to 2? levels)</span></li><ul style="margin-top:0pt;margin-bottom:0pt"><li style="list-style-type:circle;font-size:15px;font-family:Arial;vertical-align:baseline">
<span style="vertical-align:baseline;white-space:pre-wrap">“Getting Started”</span></li><ul style="margin-top:0pt;margin-bottom:0pt"><li style="list-style-type:square;font-size:15px;font-family:Arial;vertical-align:baseline">
<span style="vertical-align:baseline;white-space:pre-wrap">Installing and updating yt</span></li><li style="list-style-type:square;font-size:15px;font-family:Arial;vertical-align:baseline"><span style="vertical-align:baseline;white-space:pre-wrap">Cookbook</span></li>
<li style="list-style-type:square;font-size:15px;font-family:Arial;vertical-align:baseline"><span style="vertical-align:baseline;white-space:pre-wrap">Field List</span></li><li style="list-style-type:square;font-size:15px;font-family:Arial;vertical-align:baseline">
<span style="vertical-align:baseline;white-space:pre-wrap">FAQ</span></li></ul><li style="list-style-type:circle;font-size:15px;font-family:Arial;vertical-align:baseline"><span style="vertical-align:baseline;white-space:pre-wrap">Analyzing Data</span></li>
<ul style="margin-top:0pt;margin-bottom:0pt"><li style="list-style-type:square;font-size:15px;font-family:Arial;vertical-align:baseline"><span style="vertical-align:baseline;white-space:pre-wrap">Loading Data</span></li>
<ul style="margin-top:0pt;margin-bottom:0pt">
<li style="list-style-type:disc;font-size:15px;font-family:Arial;vertical-align:baseline"><span style="vertical-align:baseline;white-space:pre-wrap">Enzo Data</span></li></ul><li style="list-style-type:square;font-size:15px;font-family:Arial;vertical-align:baseline">
<span style="vertical-align:baseline;white-space:pre-wrap">Using and Manipulating Objects and Fields</span></li><ul style="margin-top:0pt;margin-bottom:0pt"><li style="list-style-type:disc;font-size:15px;font-family:Arial;vertical-align:baseline">
<span style="vertical-align:baseline;white-space:pre-wrap">What Types of Fields are there?</span></li><li style="list-style-type:disc;font-size:15px;font-family:Arial;vertical-align:baseline"><span style="vertical-align:baseline;white-space:pre-wrap"></span></li>
</ul><li style="list-style-type:square;font-size:15px;font-family:Arial;vertical-align:baseline"><span style="vertical-align:baseline;white-space:pre-wrap">etc</span></li></ul><li style="list-style-type:circle;font-size:15px;font-family:Arial;vertical-align:baseline">
<span style="vertical-align:baseline;white-space:pre-wrap">Visualizing Data</span></li><ul style="margin-top:0pt;margin-bottom:0pt"><li style="list-style-type:square;font-size:15px;font-family:Arial;vertical-align:baseline">
<span style="vertical-align:baseline;white-space:pre-wrap">etc</span></li></ul><li style="list-style-type:circle;font-size:15px;font-family:Arial;vertical-align:baseline"><span style="vertical-align:baseline;white-space:pre-wrap">Advanced</span></li>
<li style="list-style-type:circle;font-size:15px;font-family:Arial;vertical-align:baseline"><span style="vertical-align:baseline;white-space:pre-wrap">Getting Involved</span></li></ul><li style="list-style-type:disc;font-size:15px;font-family:Arial;vertical-align:baseline">
<span style="vertical-align:baseline;white-space:pre-wrap">Other Versions:</span></li><ul style="margin-top:0pt;margin-bottom:0pt"><li style="list-style-type:circle;font-size:15px;font-family:Arial;vertical-align:baseline">
<span style="vertical-align:baseline;white-space:pre-wrap">Latest Docs Build</span></li><li style="list-style-type:circle;font-size:15px;font-family:Arial;vertical-align:baseline"><span style="vertical-align:baseline;white-space:pre-wrap">Current Release (2.4)</span></li>
<li style="list-style-type:circle;font-size:15px;font-family:Arial;vertical-align:baseline"><span style="vertical-align:baseline;white-space:pre-wrap"><a href="http://yt-project.org/docs/2.1" target="_blank">yt-project.org/docs/2.1</a></span></li>
<li style="list-style-type:circle;font-size:15px;font-family:Arial;vertical-align:baseline"><span style="vertical-align:baseline;white-space:pre-wrap"><a href="http://yt-project.org/docs/2.2" target="_blank">yt-project.org/docs/2.2</a></span></li>
<li style="list-style-type:circle;font-size:15px;font-family:Arial;vertical-align:baseline"><span style="vertical-align:baseline;white-space:pre-wrap"><a href="http://yt-project.org/docs/2.3" target="_blank">yt-project.org/docs/2.3</a></span></li>
<li style="list-style-type:circle;font-size:15px;font-family:Arial;vertical-align:baseline"><span style="vertical-align:baseline;white-space:pre-wrap"><a href="http://yt-project.org/docs/2.4" target="_blank">yt-project.org/docs/2.4</a></span></li>
</ul></ul><span style="font-family:Times;font-size:medium;font-weight:normal"><span style="font-size:15px;font-family:Arial;vertical-align:baseline;white-space:pre-wrap"></span></span><div style="font-family:Times;font-size:medium">
<span style="font-family:Times;font-size:medium;font-weight:normal"><br></span></div><div style="font-family:Times;font-size:medium"><span style="font-family:Times;font-size:medium;font-weight:normal">Here's a GDoc with this layout, as well as some responsibilities in pushing out 2.4:</span></div>
<div><font face="Times" size="3"><a href="https://docs.google.com/document/d/1gwqrzDbsqKz-V1J0HMcaptPcy0ETsmeVkWKzWIISCu0/edit" target="_blank">https://docs.google.com/document/d/1gwqrzDbsqKz-V1J0HMcaptPcy0ETsmeVkWKzWIISCu0/edit</a></font></div>
<br><span style="font-family:Arial;font-size:15px;vertical-align:baseline;white-space:pre-wrap">Sam, Britton, John Z., Nathan</span></span></div>
</blockquote></div><br></div>