<div dir="ltr">I'd be in for that as well: an NYC documentation sprint.</div><div class="gmail_extra"><br><br><div class="gmail_quote">On Sat, Aug 17, 2013 at 11:16 AM, Cameron Hummels <span dir="ltr"><<a href="mailto:chummels@gmail.com" target="_blank">chummels@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 dir="ltr">That sounds great to me! I'll happily be the doc steward. I like the idea of small local sprints. It's too bad I didn't go to the AGORA thing this weekend, as we could do one there. Oh well. But yes, October/November sounds like a great time to do this. Perhaps we can do one the next time I come to NYC too.<span class="HOEnZb"><font color="#888888"><div>
<br></div><div>Cameron</div></font></span></div><div class="HOEnZb"><div class="h5"><div class="gmail_extra"><br><br><div class="gmail_quote">On Sat, Aug 17, 2013 at 5:46 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 Cameron et al,<br>
<br>
This is a very good idea. Cameron, I think you would be well-suited<br>
to being a documentation steward for yt -- not in terms of *writing*<br>
it, but helping to ensure that the coverage remains high and that<br>
features aren't simply forgotten about as they are submitted.<br>
<br>
As for a sprint, I would be very keen to have one, and at the time<br>
when development switches over would be a perfect one. Since there's<br>
some clustering of yt devs recently, what we could try for is<br>
semi-remote sprints. Anybody that wanted to come to Columbia, I'd buy<br>
pizza for and we could all write in the same room. Interested<br>
participants that are clustered at other institutions could work<br>
together, too, and the groups could meet over IRC/Hangouts.<br>
<br>
But yes, let's aim for this. Perhaps sometime in October or November?<br>
Or is that too soon?<br>
<br>
-Matt<br>
<div><div><br>
On Fri, Aug 16, 2013 at 6:23 PM, Cameron Hummels <<a href="mailto:chummels@gmail.com" target="_blank">chummels@gmail.com</a>> wrote:<br>
> Hey peeps,<br>
><br>
> After talking with Matt at some length about the yt documentation, we<br>
> thought it might be a good idea to have a documentation sprint in a few<br>
> months when we've moved over to yt 3.0 as the focus of our development. The<br>
> docs in general are good, but there are some gaps here and there with some<br>
> functionality not present in the documentation. I'm not proposing an entire<br>
> (or even partial) rewrite of the docs, as I think that would be<br>
> counterproductive. I'm simply thinking we could fill in the holes to make<br>
> sure all of the cool stuff in yt is written up so people know how to use it.<br>
><br>
> Now, I know doc writing is not often fun, but I think this could be really<br>
> beneficial to our user base, and actually cut down on the amount of time we<br>
> have to respond to new users on the mailing list and irc (as well as making<br>
> it easier for people to use yt).<br>
><br>
> What I'm asking from you is if you encounter something that you don't think<br>
> is well documented in the formal docs (not simply the docstrings), could you<br>
> take a moment to create a bitbucket issue about it? You don't even have to<br>
> fix it then, just note it, so we know where to work when we do the sprint in<br>
> a few months.<br>
><br>
> Anyone else have any other ideas about this?<br>
><br>
> Cameron<br>
><br>
> --<br>
> Cameron Hummels<br>
> Postdoctoral Researcher<br>
> Steward Observatory<br>
> University of Arizona<br>
> <a href="http://chummels.org" target="_blank">http://chummels.org</a><br>
><br>
</div></div><div><div>> _______________________________________________<br>
> yt-dev mailing list<br>
> <a href="mailto:yt-dev@lists.spacepope.org" target="_blank">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>
_______________________________________________<br>
yt-dev mailing list<br>
<a href="mailto:yt-dev@lists.spacepope.org" target="_blank">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><br clear="all"><div><br></div>-- <br>Cameron Hummels<div>Postdoctoral Researcher</div><div>Steward Observatory</div><div>University of Arizona</div><div><a href="http://chummels.org" target="_blank">http://chummels.org</a></div>
</div>
</div></div><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></blockquote></div><br></div>