#14912: UniqueRepresentation tutorial could use more love
------------------------------+--------------------------------------------
    Reporter:  darij          |            Owner:
        Type:  defect         |           Status:  new
    Priority:  major          |        Milestone:
   Component:  documentation  |         Keywords:  documentation, structure
   Merged in:                 |          Authors:
   Reviewers:                 |  Report Upstream:  N/A
 Work issues:                 |           Branch:
Dependencies:                 |         Stopgaps:
------------------------------+--------------------------------------------
 Sadly not my love, unless someone teaches me enough of the stuff that I
 understand it myself.

 http://www.sagemath.org/doc/reference/misc/sage/misc/classcall_metaclass.html

 One thing that should be added is some explanation of the difference
 between {{{__classcall__}}} and {{{__classcall_private__}}}.

 Also there seems to be a typo:

 {{{
 The UniqueRepresentation and UniqueFactory classes provide two alternative
 implementations of this design pattern. Both implementations have their
 own merits. UniqueRepresentation is very easy to use: a class just needs
 to derive from it, or make sure some of its super classes does. Also, it
 groups together the class and the factory in a single gadget; in the
 example above, one would want to do:
 }}}

 I think it's UniqueFactory, not UniqueRepresentation, which is easy to use
 etc.

--
Ticket URL: <http://trac.sagemath.org/ticket/14912>
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/groups/opt_out.


Reply via email to