<div dir="ltr">Thanks, Kacper. I'll look at trying to get all of the cookbook recipes to work.<div><br></div><div>I would request (and it sounds like some of the responses I've gotten here suggest support of this) that we have the 3.0 docs fully up to date before we release 3.0 to the public. Because I have limited experience with 3.0 (I only started using it this week), I do not know if I'm the one who should lead any kind of documentation effort to bring the 3.0 docs up to speed with the state of the code, but I think that it should happen. This is not a criticism of the current state of things--just a request for future actions.</div>
<div><br></div><div>Cameron</div></div><div class="gmail_extra"><br><br><div class="gmail_quote">On Fri, Dec 13, 2013 at 10:34 AM, Kacper Kowalik <span dir="ltr"><<a href="mailto:xarthisius.kk@gmail.com" target="_blank">xarthisius.kk@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 13.12.2013 16:37, Cameron Hummels wrote:<br>
> Sounds good, but I guess I don't understand why the 3.0 docs aren't yet<br>
> buildable. I can build them locally. The only thing that prevented me<br>
> from doing this is that I had to pip install the new bootstrap theme in<br>
> order for them to not fail. Is this what you mean, Kacper?<br>
<br>
</div>Nope, I guess you only build part of them, like sphinx-build && make<br>
html. Additionally there are cookbook recipes that need to be run in<br>
order to get all images, runipy etc. First error that jenkins encounters is:<br>
<br>
Exception: Traceback (most recent call last):<br>
File "helper_scripts/run_recipes.py", line 33, in run_receipe<br>
File<br>
"/tmp/jenkins/workspace/yt-docs-3.0/source/cookbook/streamlines_isocontour.py",<br>
line 11, in <module><br>
streamlines = Streamlines(pf,pos,'x-velocity', 'y-velocity',<br>
'z-velocity', length=1.0)<br>
File<br>
"/tmp/jenkins/workspace/yt-docs-3.0/yt-3.0/yt/visualization/streamlines.py",<br>
line 103, in __init__<br>
log_fields=[False,False,False])<br>
TypeError: __init__() got an unexpected keyword argument 'log_fields'<br>
<br>
Cheers,<br>
Kacper<br>
<div class="HOEnZb"><div class="h5"><br>
> I understand not wanting to have out of date docs available to the user<br>
> base, but i'd love to get something up so people can document new changes<br>
> to the code as they make them. Let me know if you need help on this, Matt.<br>
><br>
> Cameron<br>
><br>
><br>
> On Fri, Dec 13, 2013 at 6:42 AM, Matthew Turk <<a href="mailto:matthewturk@gmail.com">matthewturk@gmail.com</a>> wrote:<br>
><br>
>> Hi Cameron,<br>
>><br>
>> Thanks for taking this on! I think that we should definitely push up<br>
>> some 3.0 docs (which it sounds like Kacper is working on) but I'm not<br>
>> sure that we should link them *until* they are mostly up to date.<br>
>> Fortunately the cookbook process and the IPython Notebook process<br>
>> won't pass until they are, so that's good.<br>
>><br>
>> Once the AGORA telecon is over today I should be able to spend some<br>
>> time hitting the easy changes to the docs that should bring them<br>
>> mostly up to speed. One thing we'll need to do with 3.0 that we<br>
>> haven't in the past is emphasize much more strongly the developer<br>
>> aspects, as some areas of the code -- while cleaner -- are different<br>
>> in some key ways.<br>
>><br>
>> -MAtt<br>
>><br>
>> On Thu, Dec 12, 2013 at 6:34 PM, Cameron Hummels <<a href="mailto:chummels@gmail.com">chummels@gmail.com</a>><br>
>> wrote:<br>
>>> Hello everyone,<br>
>>><br>
>>> Now that the bulk of the development is moving over to the yt-3.0<br>
>> branch, I<br>
>>> propose we have the yt-3.0 docs available on the website. Right now, a<br>
>>> yt-3.0 branch exists in the yt-doc repository, but there are very minor<br>
>>> changes in it relative to the yt 2.x documentation. Unfortunately,<br>
>> there is<br>
>>> no public way to view these documentations aside from downloading the<br>
>>> repository and building locally. I think by putting the 3.0 docs on the<br>
>>> webpage, it will make it more likely that people contribute docs when<br>
>> they<br>
>>> contribute new code changes, whereas if we wait too long, the codebase<br>
>> may<br>
>>> get considerably out of sync with the docs.<br>
>>><br>
>>> I think this will only require a slight change to the buildbot targets by<br>
>>> Kacper. What do people think?<br>
>>><br>
>>> Cameron<br>
>>><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>
>>> _______________________________________________<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>
>> _______________________________________________<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>
><br>
><br>
><br>
><br>
><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>
<br>
<br>
</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><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>