[yt-dev] Thoughts on docs theme?

j s oishi jsoishi at gmail.com
Fri Feb 22 08:50:07 PST 2013


I also agree with Sam: the workshop materials should be at the bottom.
Videos are great resources for certain kinds of in-depth learning, but
I think they're less useful to most documentation readers.  This has
the added bonus of putting the cookbook right in the middle!

j

On Fri, Feb 22, 2013 at 10:34 AM, Sam Skillman <samskillman at gmail.com> wrote:
> I'm +0 on that particular theme, mostly because I'm not a big fan of the
> dropdown site navigation.  I am +1 though on getting the information density
> up.  Also, would it be possible to move the workshop materials to the
> bottom?  I don't think most people want to view the videos, even though they
> are great resources to have.
>
>
> On Fri, Feb 22, 2013 at 8:28 AM, Cameron Hummels <chummels at gmail.com> wrote:
>>
>> +1.  I don't think there is a huge amount of urgency on getting this
>> perfect, but I think your suggestion is cleaner and easier to read.
>>
>>
>> On Fri, Feb 22, 2013 at 8:01 AM, Matthew Turk <matthewturk at gmail.com>
>> wrote:
>>>
>>> Hi all,
>>>
>>> I've been working on the docs a bit, and I was wondering if I could
>>> take a pulse of the group on the theme.  I think the fonts are a bit
>>> too big, and that poses a challenge to reading the docs.
>>>
>>> http://yt-project.org/docs/2.5/
>>>
>>> I have been experimenting with a couple other themes.  I uploaded the
>>> bootstrap theme here:
>>>
>>> http://yt-project.org/docs/dev/
>>>
>>> The logo and paragraph symbols aside, I think the fonts look a lot
>>> nicer here, easier to read, easier to skim, etc.
>>>
>>> Some particular pages:
>>>
>>> http://yt-project.org/docs/dev/cookbook/simple_plots.html
>>> http://yt-project.org/docs/2.5/cookbook/simple_plots.html
>>>
>>> [+-]1 on this theme?  I figure we could maybe make the navbar green to
>>> match the color.
>>>
>>> There are a bunch of other themes on pypi.python.org , if you search
>>> "sphinx."  I think I'm just unsatisfied with the information density
>>> and style of the current documentation, so anything could potentially
>>> be an improvement.
>>>
>>> -Matt
>>> _______________________________________________
>>> yt-dev mailing list
>>> yt-dev at lists.spacepope.org
>>> http://lists.spacepope.org/listinfo.cgi/yt-dev-spacepope.org
>>
>>
>>
>>
>> --
>> Cameron Hummels
>> Postdoctoral Researcher
>> Steward Observatory
>> University of Arizona
>> http://chummels.org
>>
>> _______________________________________________
>> yt-dev mailing list
>> yt-dev at lists.spacepope.org
>> http://lists.spacepope.org/listinfo.cgi/yt-dev-spacepope.org
>>
>
>
> _______________________________________________
> yt-dev mailing list
> yt-dev at lists.spacepope.org
> http://lists.spacepope.org/listinfo.cgi/yt-dev-spacepope.org
>



More information about the yt-dev mailing list