Tutorial: How is it kept up-to-date?

[Joachim Durchholz]

I'm talking about this:
http://docs.sympy.org/dev-py3k/tutorial/tutorial.en.html

It doesn't seem to get updated (it's still referencing SymPy 0.5.12 and
code.google.com), and I'm not finding sources for it anywhere.

[Aaron Meurer]

We should probably remove the dev-py3k docs. I don't think they have
been updated in a long time.

Aaron Meurer

> --
> You received this message because you are subscribed to the Google Groups
> "sympy" group.
> To unsubscribe from this group and stop receiving emails from it, send an
> email to sympy+un...@googlegroups.com.
> To post to this group, send email to sy...@googlegroups.com.
> Visit this group at http://groups.google.com/group/sympy.
> To view this discussion on the web visit
> https://groups.google.com/d/msgid/sympy/5585FB85.3000405%40durchholz.org.
> For more options, visit https://groups.google.com/d/optout.

[Francesco Bonazzi]

On Sunday, 21 June 2015 04:14:11 UTC+2, Aaron Meurer wrote:

We should probably remove the dev-py3k docs. I don't think they have
been updated in a long time.

Maybe it's better to put a 301 status code for a while, before removing them. In this way, google will probably correctly update the search results URLs.

https://en.wikipedia.org/wiki/HTTP_301

By the way, when looking for SymPy's documentation on google, there are often results from past versions of SymPy, instead of latest. Does anyone know how to tell Google to update the links?

[Joachim Durchholz]

Am 21.06.2015 um 18:48 schrieb Francesco Bonazzi:
>
> On Sunday, 21 June 2015 04:14:11 UTC+2, Aaron Meurer wrote:
>>
>> We should probably remove the dev-py3k docs. I don't think they have
>> been updated in a long time.
>>
>>
> Maybe it's better to put a 301 status code for a while, before removing
> them. In this way, google will probably correctly update the search results
> URLs.

Sort-of. It's hard to predict what Google will do. That's intentional,
Google needs to stay ahead of link spammers to stay useful to the
general public.

> https://en.wikipedia.org/wiki/HTTP_301
>
> By the way, when looking for SymPy's documentation on google, there are
> often results from past versions of SymPy, instead of latest. Does anyone
> know how to tell Google to update the links?

Google goes by how many links point to what page. As long as the old
pages have more and "more relevant" links pointing to them, they will
stay on top of the search results.

The best we can do is to update the old pages with a warning that the
page is deprecated, and with a link to the new page; this could also be
done for the dev-py3k docs.
As people start placing more links to the newer pages, the older ones
will start to drop on the results. However, they need to know that newer
pages exist, else they'll continue linking to the first that they found
in Google, further strengthening the old page's rank.

[Aaron Meurer]

Links ought to point to the "latest" urls, which will always point to
the latest docs. Unfortunately, we didn't use "latest" in old
versions, but rather the version itself in the url, so a lot of links
out there point to old versions.

Perhaps we should install Google Analytics into the docs so we can get
an idea of where links are coming from.

Aaron Meurer

> --
> You received this message because you are subscribed to the Google Groups
> "sympy" group.
> To unsubscribe from this group and stop receiving emails from it, send an
> email to sympy+un...@googlegroups.com.
> To post to this group, send email to sy...@googlegroups.com.
> Visit this group at http://groups.google.com/group/sympy.
> To view this discussion on the web visit

> https://groups.google.com/d/msgid/sympy/5586EEF4.7050103%40durchholz.org.

[Joachim Durchholz]

Am 21.06.2015 um 20:41 schrieb Aaron Meurer:
> Links ought to point to the "latest" urls, which will always point to
> the latest docs.

Both kinds of URLs have their uses.

"Latest" URLs are good for doing work with SymPy.

Version-specific URLs are good for finished work. Programs that are
coded against a specific versions of SymPy, papers citing SymPy results,
that kind of stuff.

I'd generate everything with version-specific URLs, and use an
additional set of "latest" URLs that are aliases of some specific version.

> Perhaps we should install Google Analytics into the docs so we can get
> an idea of where links are coming from.

Google Analytics intrudes on our visitors' privacy, I would avoid that
if possible.

If you have access to the http access log, pick one of the URLs that are
misplaced on the search results and scan the log for that URL; the
"referer" (sic) field tells you where the URL was linked from.