#17932: Ref: add various missing modules to r/misc
-------------------------------------+-------------------------------------
       Reporter:  mmezzarobba        |        Owner:
           Type:  enhancement        |       Status:  needs_work
       Priority:  major              |    Milestone:  sage-6.6
      Component:  documentation      |   Resolution:
       Keywords:                     |    Merged in:
        Authors:  Marc Mezzarobba    |    Reviewers:  Julien Puydt
Report Upstream:  N/A                |  Work issues:
         Branch:  u/mmezzarobba      |       Commit:
  /ref-misc                          |  b3a614559f2ced32540a8c24750c3d845770b799
   Dependencies:                     |     Stopgaps:
-------------------------------------+-------------------------------------
Changes (by jdemeyer):

 * status:  needs_review => needs_work


Comment:

 Why did you add `sage/databases/sql_db` here, there is also a database
 section in the reference manual?

 `sage/misc/superseded` occurs twice.

 Then there is a separate section about lazy stuff, so all lazy stuff
 should go in there.

 The `AUTHORS` blocks should be formatted like
 [http://www.sagemath.org/doc/developer/coding_basics.html#headings-of-
 sage-library-code-files].

 You should only use `::` to show code blocks, not for example here
 {{{
     Databases are constructed via a triple indexed dictionary called a
     skeleton. A skeleton should be constructed to fit the following
 format::

     - skeleton -- a triple-indexed dictionary
 }}}

 Finally: `db.py` is completely deprecated and shouldn't be in the manual.
 `refcount.pyx` and `file_to_worksheet.py` don't really do anything, are
 unused and should probably be removed completely.

--
Ticket URL: <http://trac.sagemath.org/ticket/17932#comment:11>
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 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-trac.
For more options, visit https://groups.google.com/d/optout.

Reply via email to