Multiple versions of SageMath's documentation online

[Samuel Lelièvre]

This post is about the multiple versions of SageMath's documentation online

and the associated problems of its good indexing in search engines and of

people finding up-to-date vs obsolete information on sagemath.org.

It is split into three parts.

1. SageMath's reference manual

    currently doc.sagemath.org/html/en/reference

    vs formerly www.sagemath.org/doc/reference

   

2. A "combinat“ version of SageMath's reference manual

    at combinat.sagemath.org/doc/reference

3. SageMath's developer guide:

    up-to-date doc.sagemath.org/html/en/developer/

    vs outdated sagemath.org/git-developer-guide/

Now more detail about each part.

1. SageMath's reference manual

SageMath's reference manual for the latest public version

  - used to live at

      http://sagemath.org/doc/reference/

  - now lives at

      http://doc.sagemath.org/html/en/reference

and Google is having trouble reindexing.

Harald Schilly and Paul Masson are doing their best to sort this, see

  https://github.com/sagemath/website/issues/86 

2. SageMath's developer manual at combinat.sagemath.org/doc/reference

This sage-devel thread

  

  https://groups.google.com/d/topic/sage-devel/cCGobP2AgwM/discussion

is concerned with the fact that another version of SageMath's

reference manual also lives at

  http://combinat.sagemath.org/doc/reference

and that (given the trouble we are having in getting Google to properly

index the documentation at doc.sagemath.org), queries in Google search

give search engine results at combinat.sagemath.org/doc, rather than

at doc.sagemath.org.

In addition, it seems that the version of the documentation at

combinat.sagemath.org/doc corresponds to SageMath 6.3

, while SageMath is now at 7.3.

Combinat people,

- is there a use for hosting SageMath's documentation at

  combinat.sagemath.org/doc and should it be updated to 7.3?

- does this version have extra stuff from the combinat queue?

- who is in charge?

3. In another sage-devel post at

    https://groups.google.com/d/msg/sage-devel/6_rBQvKdGPo/I0MbKI5AAQAJ

an issue arises for SageMath's developer guide.

SageMath's developer guide now lives at

    doc.sagemath.org/html/en/developer/

but people keep stumbling on an outdated version living at

    sagemath.org/git-developer-guide/

which may have been put up there at the time of the migration

from mercurial to git (?).

Does anybody know how it got there, and how to remove it?

Best, Samuel

[Jori Mäntysalo]

On Thu, 11 Aug 2016, Samuel Lelièvre wrote:

> This post is about the multiple versions of SageMath's documentation online
> and the associated problems of its good indexing in search engines and of

> people finding up-to-date vs obsolete information on sagemath.org. - -

There are also local copies around the world. Should I put something to
robots.txt in http://sage-doc.sis.uta.fi ? Should even the sage package
contain a robots.txt?

--
Jori Mäntysalo