Maybe the simplest solution for now is for more people to have privileges to rebuild the docs.  Then, it can be the responsibility of the last person to push a change to do it.  Every other solution seems like more work than anyone has time to put in right now.<br>
<br>Britton<br><div class="gmail_extra"><br><br><div class="gmail_quote">On Mon, Nov 19, 2012 at 11:12 AM, 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, Nov 19, 2012 at 11:09 AM, Stephen Skory <<a href="mailto:s@skory.us">s@skory.us</a>> wrote:<br>

>> Confluence is the slickest, and the Wiki in the past has gone out of<br>
>> date relatively quickly.  Any strong feelings on which I should start<br>
>> using as a dumping ground for information about 3.0 vs 2.x?<br>
><br>
> I hate to inflict pain, but I really think that sphinx/yt-doc is the<br>
> way to go. I think having diverging documentation trees is going to<br>
> cause more pain in the long run. Is there no way to automate the<br>
> (re)building of the sphinx docs (not the default public ones, of<br>
> course)?<br>
<br>
</div>The problem with rebuilding the sphinx documentation is that since it<br>
relies on introspection of a running yt session to do the automodule /<br>
autofunction documentation, we can't use solutions like ReadTheDocs.<br>
In principle, we could use ShiningPanda, but since it takes ten to<br>
fifteen minutes to build yt-doc, this could run out of credits<br>
quickly.  If you wanted to take on the project of migrating our entire<br>
hosting system to Amazon S3, we could probably make it work.  As it<br>
stands, the only non-dynamic content yt has is the pastebin.  That<br>
would have to stay at dreamhost for now, but we could move the main<br>
page, the docs, and so on, over to S3.<br>
<br>
So I think yes, it could be done, but I'm not willing to do it; I'm<br>
more than happy to turn this over to someone else, though.  And it's<br>
not clear to me that it would meet the need of an evolving design<br>
specification where multiple contributors commented; it would only<br>
meet the need of a single designer, which I don't think is necessarily<br>
the right solution.<br>
<br>
-Matt<br>
<div class="HOEnZb"><div class="h5"><br>
><br>
> --<br>
> Stephen Skory<br>
> <a href="mailto:s@skory.us">s@skory.us</a><br>
> <a href="http://stephenskory.com/" target="_blank">http://stephenskory.com/</a><br>
> <a href="tel:510.621.3687" value="+15106213687">510.621.3687</a> (google voice)<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></div>