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
--
You received this message because you are subscribed to the Google Groups
"sage-devel" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to sage-devel+unsubscr...@googlegroups.com.
To post to this group, send email to sage-devel@googlegroups.com.
Visit this group at https://groups.google.com/group/sage-devel.
For more options, visit https://groups.google.com/d/optout.
