On 22/08/2008, at 10:35 AM, Mike Hansen wrote:

>
> Hello all,
>
> Carl Witty and I wrote a proposal for the use of the Sphinx
> documentation system in Sage.  It can be found at
> http://wiki.sagemath.org/SphinxSEP We'd appreciate any comments /
> questions / concerns that people have.

The documentation system I want to see is a centralised wiki.  It  
works like this:
help(var) gets you the [locally cached] copy of the documentation.

You read it and think "that documentation sucks" or "this needs a few  
more see-also-links", you click the "edit me" link and you get taken  
to the relevant web page and improve it for everyone.

I don't know how compatible or exclusive that is with sphinx.  But I  
reckon it would be a good way of obtaining user-centric documentation.

D


--~--~---------~--~----~------------~-------~--~----~
To post to this group, send email to sage-devel@googlegroups.com
To unsubscribe from this group, send email to [EMAIL PROTECTED]
For more options, visit this group at http://groups.google.com/group/sage-devel
URLs: http://www.sagemath.org
-~----------~----~----~----~------~----~------~--~---

Reply via email to