<div class="gmail_quote">On Mon, Jul 16, 2012 at 9:34 PM, Matthew Turk <span dir="ltr"><<a href="mailto:matthewturk@gmail.com" target="_blank">matthewturk@gmail.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">

<div class="im">On Mon, Jul 16, 2012 at 8:04 PM, Nathan Goldbaum <<a href="mailto:goldbaum@ucolick.org">goldbaum@ucolick.org</a>> wrote:<br>
> Hi all,<br>
><br>
> I've managed to fix most of the sphinx errors our docs build produces.  I<br>
> still get the a few warnings, but I think we can safely ignore most of them.<br>
<br>
</div>Thanks for doing this!<br>
<div class="im"><br>
><br>
> There are still a few errors that touch parts of the docs I didn't write,<br>
> specifically:<br>
><br>
> yt-doc/source/advanced/creating_frontend.rst:: WARNING: document isn't<br>
> included in any toctree<br>
> yt-doc/source/advanced/reason_architecture.rst:: WARNING: document isn't<br>
> included in any toctree<br>
> yt-doc/source/visualizing/simulated_observations.rst:: WARNING: document<br>
> isn't included in any toctree<br>
> yt-doc/source/workshop.rst:: WARNING: document isn't included in any toctree<br>
><br>
> The errors imply that these four files aren't accessible by navigating<br>
> through the docs.  Does anyone know how should these sections be integrated<br>
> into the rest of the docs?<br>
<br>
</div>Two of these, workshop.rst and reason_architecture, need to be<br>
integrated.  Workshop is actually linked I believe, but for some<br>
reason was not added to the toctree.  Sam?<br></blockquote><div><br></div><div>I wasn't sure if the workshop videos belonged in the User Guide.  I'm okay with either way, since they still appear at the top.  I guess for consistency could you add the link to after the "Asking for Help" section?<br>

</div><div><br></div><div>As for reason_achitecture, it looks like it just needs to be added to:</div><div>yt-doc/source/advanced/index.html</div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">


The other two are not completed yet, but will also not be completed<br>
before 2.4.  Please don't remove them.<br>
<div class="im"><br>
><br>
> I also get several errors complaining about missing images from the<br>
> cookbook.  Are the images not included in the repository for a reason?<br>
<br>
</div>Yes, there are a lot, and they are huge.  They also change with higher<br>
frequency than I would like for static images that would be checked<br>
in.<br>
<div class="im"><br>
> Is<br>
> there a helper script somewhere to generate the images?  If so, I'll look<br>
> into integrating it into the build process.<br></div></blockquote><div><br></div><div>I don't know how necessary building this into the build process is in the short term.  Let's put this on the docket for later, but not focus on it for now.</div>

<div><br></div><div>Sam</div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div class="im">
</div>It's still in process.  There is an older helper script, in the<br>
cookbook repository, but Britton and I are actively working on<br>
changing the recipe system and to update all of the cookbook recipes.<br>
This means adding new recipes (which John ZuHone is also working on),<br>
changing them to use the workshop data, streamlining the build, and<br>
also splitting the advanced recipes into a somewhat different<br>
interface.<br>
<br>
I am on vacation this week and was occupied all of last week and have<br>
not had time to focus on this.  I can spend a small amount of time<br>
focused on this tomorrow night through Thursday afternoon while I am<br>
off-vacation and at SciPy 2012.<br>
<br>
-Matt<br>
<div class="HOEnZb"><div class="h5"><br>
><br>
> -Nathan<br>
> _______________________________________________<br>
> yt-dev mailing list<br>
> <a href="mailto:yt-dev@lists.spacepope.org">yt-dev@lists.spacepope.org</a><br>
> <a href="http://lists.spacepope.org/listinfo.cgi/yt-dev-spacepope.org" target="_blank">http://lists.spacepope.org/listinfo.cgi/yt-dev-spacepope.org</a><br>
_______________________________________________<br>
yt-dev mailing list<br>
<a href="mailto:yt-dev@lists.spacepope.org">yt-dev@lists.spacepope.org</a><br>
<a href="http://lists.spacepope.org/listinfo.cgi/yt-dev-spacepope.org" target="_blank">http://lists.spacepope.org/listinfo.cgi/yt-dev-spacepope.org</a><br>
</div></div></blockquote></div><br>