[yt-dev] Website redesign feedback

Sat Sep 21 09:32:43 PDT 2013

On Sat, Sep 21, 2013 at 12:30 PM, Cameron Hummels <chummels at gmail.com> wrote:
> All of the links to the docs on the page link to yt-project.org/doc instead
> of yt-project.org/docs.  I forked and cloned and started making the
> necessary changes, but it seems like recently the doc hierarchy structure
> has changed slightly on the yt-project.org site.  Where once the latest
> stable version of the docs was simply: yt-project.org/docs/ , it is now at
> yt-project.org/docs/2.5 (along with 2.4, 2.3, dev, etc).

/doc/ has been a symlink to the latest version for a couple years; one
part of this is to avoid having to update links everywhere, although
when linking to many specific subpages it's usually better to link to
the version.  /docs/XX has the builds for each one.

>
> I like this new organization better, as it makes old docs accessible, but it
> leaves us in a slight bind.  Rather than tie ourselves into hard links to
> pages from that version on the website (like linking the 2.5 install page,
> or the 2.5 help page, or whatever), which will each need to be changed at
> every new stable release, would it be possible to just have a symbolic link
> in the yt-project.org/docs directory called latest_stable that points to the
> latest stable version directory?  That way, all of the hard links on the
> webpage can just point to that link and won't need to be changed at every
> new release.

I think that's what /doc/ is ...

>
> If that is done, I can go ahead and make all of the relevant doc link
> changes in the website.
>
> Let me know what you think.
>
> Cameron
>
>
> On Fri, Sep 20, 2013 at 12:39 PM, Cameron Hummels <chummels at gmail.com>
> wrote:
>>
>> I realize that, I just figured it might be nice to choose one upload site
>> and stick with it so that all of the movies were in a single place.  It
>> seemed to me that vimeo had a cleaner interface, and there are already lots
>> of yt-themed videos uploaded, but i'm open to whatever.
>>
>>
>> On Fri, Sep 20, 2013 at 11:02 AM, Matthew Turk <matthewturk at gmail.com>
>> wrote:
>>>
>>> For what it's worth, the ytanalysis user on YouTube (which currently
>>> has the world's ugliest page) can curate playlists, which also can
>>> embed.
>>>
>>> On Fri, Sep 20, 2013 at 12:46 PM, Cameron Hummels <chummels at gmail.com>
>>> wrote:
>>> > +1 on vimeo embeds.  It would also be good if people submitted the
>>> > vimeo
>>> > embeds to the yt group on vimeo.
>>> >
>>> >
>>> > On Fri, Sep 20, 2013 at 9:43 AM, Britton Smith <brittonsmith at gmail.com>
>>> > wrote:
>>> >>
>>> >> That sounds cool to me.  I think vimeo or youtube embeds would be
>>> >> enough.
>>> >> Does anyone have any objections to having movies in the gallery?
>>> >>
>>> >>
>>> >> On Fri, Sep 20, 2013 at 5:38 PM, Nathan Goldbaum
>>> >> <nathan12343 at gmail.com>
>>> >> wrote:
>>> >>>
>>> >>> Youtube or vimeo embeds would be straightforward.  Embedding raw
>>> >>> videos
>>> >>> using a video tag would also work but there might be codec/browser
>>> >>> compatibility issues.
>>> >>>
>>> >>>
>>> >>> On Friday, September 20, 2013, Britton Smith wrote:
>>> >>>>
>>> >>>> I just want to respond to Cameron's question about the gallery.  I
>>> >>>> don't
>>> >>>> think it should have to be in a published paper, but I would like it
>>> >>>> to
>>> >>>> highlight as much of yt's analysis functionality as possible.  There
>>> >>>> is
>>> >>>> often the temptation too fill it with a bunch of gorgeous renders,
>>> >>>> which are
>>> >>>> really impressive, but don't really give anyone the impression that
>>> >>>> yt is
>>> >>>> used for quantitative analysis.  The only real bar I was hoping for
>>> >>>> submissions is that they be something that was used in some sort of
>>> >>>> professional context.  This could be a paper, but also a talk, press
>>> >>>> release, outreach material, or anything that was actual used for a
>>> >>>> purpose
>>> >>>> other than just making something that's pretty.  In that sense, the
>>> >>>> gallery
>>> >>>> is basically a place to show off the niche that yt is serving in the
>>> >>>> real
>>> >>>> world.  Maybe this could even include embedded movies.  Would that
>>> >>>> be
>>> >>>> possible?
>>> >>>>
>>> >>>> Everyone, please contribute!
>>> >>>>
>>> >>>> Britton
>>> >>>>
>>> >>>>
>>> >>>> On Fri, Sep 20, 2013 at 5:03 PM, Matthew Turk
>>> >>>> <matthewturk at gmail.com>
>>> >>>> wrote:
>>> >>>>
>>> >>>> Hi all,
>>> >>>>
>>> >>>> I've updated based on, I think, all of the suggestions (except the
>>> >>>> facebook button, which somebody else needs to get the code for and
>>> >>>> send me) and updated both the deployment and the PR.  Nathan fixed
>>> >>>> the
>>> >>>> images on the carousel, and I can't take credit for that.  :)
>>> >>>>
>>> >>>> Any other feedback?
>>> >>>>
>>> >>>> -Matt
>>> >>>>
>>> >>>> On Thu, Sep 19, 2013 at 9:51 PM, Cameron Hummels
>>> >>>> <chummels at gmail.com>
>>> >>>> wrote:
>>> >>>> > Oh, and the "yt-project" link in the upper left of the header does
>>> >>>> > not
>>> >>>> > link
>>> >>>> > to anything.  it might be good to have that link to Home.  In
>>> >>>> > fact,
>>> >>>> > you
>>> >>>> > might be able to do away with the Home link if you were to do
>>> >>>> > this.
>>> >>>> >
>>> >>>> >
>>> >>>> > On Thu, Sep 19, 2013 at 6:49 PM, Cameron Hummels
>>> >>>> > <chummels at gmail.com>
>>> >>>> > wrote:
>>> >>>> >>
>>> >>>> >> I think it would be useful to have a link to both the stable docs
>>> >>>> >> as
>>> >>>> >> well
>>> >>>> >> as the dev docs, if that's an option.  Even with the increased
>>> >>>> >> frequency of
>>> >>>> >> releases, there is still some lag time between dev docs getting
>>> >>>> >> pulled into
>>> >>>> >> the stable.
>>> >>>> >>
>>> >>>> >> Under the community page, the last link on the Sharing Scripts
>>> >>>> >> header
>>> >>>> >> has
>>> >>>> >> a typo: pastebine.
>>> >>>> >>
>>> >>>> >> Under the development page, there is a word missing in the second
>>> >>>> >> sentence: "...the development branch, the and even this website."
>>> >>>> >>
>>> >>>> >> I think the gallery is a great idea--now we just have to populate
>>> >>>> >> it.
>>> >>>> >> Is
>>> >>>> >> the idea to show off published work?  Does it have to be
>>> >>>> >> published?
>>> >>>> >> Also, I
>>> >>>> >> think we should have people submit both a thumbprint (400x400 as
>>> >>>> >> is
>>> >>>> >> done) as
>>> >>>> >> well as a full-res image which is linked through the thumbprint.
>>> >>>> >> Or
>>> >>>> >> perhaps
>>> >>>> >> it's enough that the paper is linked?
>>> >>>> >>
>>> >>>> >> So we'll also have another gallery in the docs with images shown
>>> >>>> >> as
>>> >>>> >> well
>>> >>>> >> as the cookbook recipes which created them (a la matplotlib)?  I
>>> >>>> >> think that
>>> >>>> >> would be useful.
>>> >>>> >>
>>> >>>> >> Overall, I think the page looks good.
>>> >>>> >>
>>> >>>> >>
>>> >>>> >> On Thu, Sep 19, 2013 at 6:35 PM, Geoffrey So <gsiisg at gmail.com>
>>> >>>> >> wrote:
>>> >>>> >>>
>>> >>>> >>> "Ah, I agree about the doc link; not sure about the other two.
>>> >>>> >>> What
>>> >>>> >>> about
>>> >>>> >>> switching blog to being under Quick Links and replacing it with
>>> >>>> >>> a
>>> >>>> >>> link to
>>> >>>> >>> the latest stable docs? I don't think a search box will quite
>>> >>>> >>> work
>>> >>>> >>> on the
>>> >>>> >>> toolbar."
>>> >>>> >>>
>>> >>>> >>> - Doc would be my first choice, too.  Search is within the doc
>>> >>>> >>> so it
>>> >>>> >>> would be just one step away, and usually I wouldn't know what to
>>> >>>> >>> search for
>>> >>>> >>> until after I looked at the Docs, so not having search at the
>>> >>>> >>> beginning is
>>> >>>> >>> fine.
>>> >>>> >>>
>>> >>>> >>> "Where should the colors be changed? I do want to brighten the
>>> >>>> >>> text
>>> >>>> >>> a
>>> >>>> >>> bit, but can you suggest other places?"
>>> >>>> >>>
>>> >>>> >>> - I just thought the color template of the Docs looks pretty
>>> >>>> >>> nice,
>>> >>>> >>> kind
>>> >>>> >>> of similar to python/numpy etc, but I also understand the need
>>> >>>> >>> for
>>> >>>> >>> the black
>>> >>>> >>> background since we're doing astro, but some addition of bright
>>> >>>> >>> colors would
>>> >>>> >>> help "lighten" the mood (pun intended), so maybe use a brighter
>>> >>>> >>> shade of
>>> >>>> >>> grey for the text, and/or color coded section label.  But I also
>>> >>>> >>> noticed my
>>> >>>> >>> laptop brightness wasn't turned all the way up, so at max
>>> >>>> >>> brightness
>>> >>>> >>> it is
>>> >>>> >>> not as gloomy as I thought before.
>>> >>>> >>>
>>> >>>> >>> From
>>> >>>> >>> G.S.
>>> >>>> >>>
>>> >>>> >>>
>>> >>>> >>> On Fri, Sep 20, 2013 at 9:25 AM, Matthew Turk
>>> >>>> >>> <matthewturk at gmail.com>
>>> >>>> >>> wrote:
>>> >>>> >>>>
>>> >>>> >>>> Hi Geoffrey,
>>> >>>> >>>>
>>> >>>> >>>> On Sep 19, 2013 9:06 PM, "Geoffrey So" <gsiisg at gmail.com>
>>> >>>> >>>> wrote:
>>> >>>> >>>> >
>>> >>>> >>>> > These are just personal preference:
>>> >>>> >>>> >
>>> >>>> >>>> > I usually use the yt website to
>>> >>>
>>> >>>
>>> >>> _______________________________________________
>>> >>> 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
>>> >>
>>> >
>>> >
>>> >
>>> > --
>>> > 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
>>
>>
>>
>>
>> --
>> Cameron Hummels
>> Postdoctoral Researcher
>> Steward Observatory
>> University of Arizona
>> http://chummels.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
>