Hello,
> I get that a lot from people I talk to. That is why having more "generalist"
> documentation that's like a mid-level map, and making it very easy to find on
> the website is critical. However, it takes people to write such
> documentation.
A nice first step could be some help to review 19061 [1]. With this,
all it takes to add a function to a (sorted) thematic index in the
module's doc is a "@doc_index('name of the index')" decorator before
the function's name. Makes it much easier to have a better-quality
documentation.
> It doesn't help that http://doc.sagemath.org/ (the main link people click
> with "documentation" on the website) is now almost totally useless, compared
> to http://www.sagemath.org/help.html .
I mentionned it to Harald, as I think that what we had before:
http://doc.sagemath.org/html/en/website/index.html
is a *much* better index than what we have now:
http://doc.sagemath.org/
I will not exhaust myself if nobody else cares, but if some agree with
me we may get to convince him.
Nathann
P.S.: note that we currently do not use the 'website' document (whose
link is given above) anywhere.
[1] http://trac.sagemath.org/ticket/19061
--
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 [email protected].
To post to this group, send email to [email protected].
Visit this group at http://groups.google.com/group/sage-devel.
For more options, visit https://groups.google.com/d/optout.
