<div dir="ltr">+1.  I really like having the docs and the source in the same repository, for the reasons that you've listed.  Also, when I put yt on a new machine it makes it impossible for me to forget to also get the docs...  :-)<br>
</div><div class="gmail_extra"><br><br><div class="gmail_quote">On Fri, Jan 24, 2014 at 11:29 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">Hi all,<br>
<br>
A couple years ago we moved the docs into their own repository.  This<br>
was for two reasons:<br>
<br>
 1) We wanted to include more images, which bloated the repository size<br>
 2) There was a lot of churn at the time in the docs<br>
<br>
But, the docs are falling behind with 3.0.  And, more to the point,<br>
the fact that they live separate from the main repo means that the PRs<br>
are evaluated separately, they are updated separately, and if you want<br>
to write docs for functionality you have to figure out where to commit<br>
them, etc etc.  And the branching strategy is something of a mess, and<br>
on and on.  The size is less of a big deal than I think I thought it<br>
would be, and furthermore, with the IPython notebooks and recipes<br>
we're checking in way fewer static images than we were a few years<br>
ago.<br>
<br>
I'd like to propose that *in the 3.0 branch*, we move the docs back<br>
into the repository and start evaluating PRs there rather than in the<br>
separate yt-doc repository.  For modifications to the 2.x docs, we can<br>
continue with our current strategy, but for 3.0, I think we would<br>
benefit from tying the two a lot closer.  Plus, we probably want to<br>
encourage easier modification of the docs by people who check out the<br>
repo.  We're somewhat on our own for having a separate repo for docs.<br>
<br>
[+-][01] on this?<br>
<br>
If we get a reasonable quorum, and nobody really objects too strongly,<br>
I'll bring all the files in sometime in the next few days.<br>
<br>
-Matt<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>
</blockquote></div><br></div>