#11251: Add todo extension to Sphinx
-----------------------------+----------------------------------------------
Reporter: hivert | Owner: hivert
Type: enhancement | Status: positive_review
Priority: major | Milestone: sage-4.7.2
Component: documentation | Keywords: todo sphinx days30
Work_issues: | Upstream: N/A
Reviewer: John Palmieri | Author: Florent Hivert
Merged: | Dependencies:
-----------------------------+----------------------------------------------
Comment(by jhpalmieri):
Replying to [comment:19 leif]:
> Maybe I misunderstood the intent, but is there a way to omit the TODOs
from "production" documentation?
>
> (I thought they were only for "internal" use, i.e. invisible to an
"ordinary" user, as opposed to a developer working on the documentation,
similar to `\note{}` of LaTeX's "beamer" class.)
I understood this markup is used to mark places where the code needs
improvement, not the documentation. Also, as you know, with Sage the
distinction between users and developers is intentionally blurred.
--
Ticket URL: <http://trac.sagemath.org/sage_trac/ticket/11251#comment:21>
Sage <http://www.sagemath.org>
Sage: Creating a Viable Open Source Alternative to Magma, Maple, Mathematica,
and MATLAB
--
You received this message because you are subscribed to the Google Groups
"sage-trac" group.
To post to this group, send email to [email protected].
To unsubscribe from this group, send email to
[email protected].
For more options, visit this group at
http://groups.google.com/group/sage-trac?hl=en.
