Those interested in documentation might want to look at few tickets.
1) Nathann is making an automatic index of functions better, see
http://trac.sagemath.org/ticket/19061 . (But somebody should review #19067
before that will continue. It is short.)
2) There is a discussion about guide to writing docstrings:
http://trac.sagemath.org/ticket/19041 . For example do we want to *always*
have INPUT and OUTPUT section, even if the function returns nothing and
have no arguments?
3) And then it is still open if the index of functions can be written from
user perspective, or from implementation perspective:
http://trac.sagemath.org/ticket/18534 . My suggestion one is adding
functions from categories to index of posets.py. Suggestion two is add an
index of functions ta categories of poset and finite poset and add a link
to them. Suggestion three is to make a kind of introduction to finite
posets and put index there.
* * *
4) Do others feel that Sage is like a big house with tresures hidden in
the corridors - without map to found those?
--
Jori Mäntysalo
