+1e6<div><br></div><div>One other idea: we should make an effort to keep a changelog updated on a subpage of the docs.  Hopefully that will lower the potential barrier for doing releases.<span></span><br><br>On Friday, January 24, 2014, Matthew Turk <<a href="mailto:matthewturk@gmail.com">matthewturk@gmail.com</a>> 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="javascript:;" onclick="_e(event, 'cvml', '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>