[yt-dev] Older versions of the docs

John ZuHone jzuhone at gmail.com
Wed Aug 12 14:58:16 PDT 2015


+1

This all sounds great to me!

> On Aug 12, 2015, at 5:51 PM, Kenza Arraki <karraki at gmail.com> wrote:
> 
> PR to keep only 3 doc versions in the website dropdown tools:
> https://bitbucket.org/yt_analysis/website/pull-requests/86/simplify-doc-versions-in-the-dropdown/diff <https://bitbucket.org/yt_analysis/website/pull-requests/86/simplify-doc-versions-in-the-dropdown/diff>
> 
> Between this and Kacper's awesome robot deflections I think users will have a better experience.
> Any other suggestions?
> 
> -Kenza
> 
> 
> 
> On Tue, Aug 11, 2015 at 12:11 PM Nathan Goldbaum <nathan12343 at gmail.com <mailto:nathan12343 at gmail.com>> wrote:
> I had to ping one of the admins at readthedocs, but yt.readthedocs.org <http://yt.readthedocs.org/> is now fully no more. It turns out that Matt deleted it months ago, but readthedocs left some files behind so it was still visible.
> 
> Kacper also created this pull request, which should improve google search results soonish, hopefully:
> 
> https://bitbucket.org/yt_analysis/yt/pull-requests/1693/docs-add-canonical-link-for-documentation/diff#comment-None <https://bitbucket.org/yt_analysis/yt/pull-requests/1693/docs-add-canonical-link-for-documentation/diff#comment-None>
> 
> On Fri, Aug 7, 2015 at 9:39 PM, Cameron Hummels <chummels at gmail.com <mailto:chummels at gmail.com>> wrote:
> I agree with Kenza that this is a problem, and I like the suggestion given by Kacper.  By default, most people will be looking at dev or stable, and potentially the difference between dev and stable should be minimal with frequent releases.  I think sending people to dev is the way to go, but maybe making a clear note on the docs homepage that this is for "dev" or for "stable" or for "2.x", although that might be difficult to do with releases from dev to stable.
> 
> Cameron
> 
> On Fri, Aug 7, 2015 at 12:53 PM, Kacper Kowalik <xarthisius.kk at gmail.com <mailto:xarthisius.kk at gmail.com>> wrote:
> On 08/07/2015 02:47 PM, Matthew Turk wrote:
> > Hi Kenza,
> >
> > I'm not an expert on "Search Engine Optimization" but we may be able
> > to provide hints to google on these things.  We can also more clearly
> > identify the current version on the website, too.
> 
> I think we may:
> 
>  1) disable robot access to docs/* (keep only doc/)
>  2) use <link href="http://yt-project.org/doc/ <http://yt-project.org/doc/>" rel="canonical" /> in
> headers for all versions
> 
> Cheers,
> Kacper
> 
> > -Matt
> >
> > On Fri, Aug 7, 2015 at 2:46 PM, Kenza Arraki <karraki at gmail.com <mailto:karraki at gmail.com>> wrote:
> >> Does anyone have ideas on how we can encourage people to use the appropriate
> >> version of the docs?
> >>
> >> There are two issues that I see:
> >>  - New users may not understand that there are different doc versions, so
> >> they may look at the wrong version for information
> >>  - Google indexing previous doc versions
> >>
> >> Best,
> >> Kenza
> >>
> >> --
> >> ---------------
> >> Kenza Arraki
> >>
> >> _______________________________________________
> >> yt-dev mailing list
> >> yt-dev at lists.spacepope.org <mailto:yt-dev at lists.spacepope.org>
> >> http://lists.spacepope.org/listinfo.cgi/yt-dev-spacepope.org <http://lists.spacepope.org/listinfo.cgi/yt-dev-spacepope.org>
> >>
> > _______________________________________________
> > yt-dev mailing list
> > yt-dev at lists.spacepope.org <mailto:yt-dev at lists.spacepope.org>
> > http://lists.spacepope.org/listinfo.cgi/yt-dev-spacepope.org <http://lists.spacepope.org/listinfo.cgi/yt-dev-spacepope.org>
> >
> 
> 
> 
> _______________________________________________
> yt-dev mailing list
> yt-dev at lists.spacepope.org <mailto:yt-dev at lists.spacepope.org>
> http://lists.spacepope.org/listinfo.cgi/yt-dev-spacepope.org <http://lists.spacepope.org/listinfo.cgi/yt-dev-spacepope.org>
> 
> 
> 
> 
> -- 
> Cameron Hummels
> NSF Postdoctoral Fellow
> Department of Astronomy
> California Institute of Technology
> http://chummels.org <http://chummels.org/>
> 
> _______________________________________________
> yt-dev mailing list
> yt-dev at lists.spacepope.org <mailto:yt-dev at lists.spacepope.org>
> http://lists.spacepope.org/listinfo.cgi/yt-dev-spacepope.org <http://lists.spacepope.org/listinfo.cgi/yt-dev-spacepope.org>
> 
> 
> _______________________________________________
> yt-dev mailing list
> yt-dev at lists.spacepope.org <mailto:yt-dev at lists.spacepope.org>
> http://lists.spacepope.org/listinfo.cgi/yt-dev-spacepope.org <http://lists.spacepope.org/listinfo.cgi/yt-dev-spacepope.org>
> -- 
> 
> Kenza Arraki
> _______________________________________________
> yt-dev mailing list
> yt-dev at lists.spacepope.org
> http://lists.spacepope.org/listinfo.cgi/yt-dev-spacepope.org

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.spacepope.org/pipermail/yt-dev-spacepope.org/attachments/20150812/369658fa/attachment.html>


More information about the yt-dev mailing list