[Python-ideas] Add an UML class diagram to the collections.abc module documentation
pylang3 at gmail.com
Sat Dec 30 17:23:06 EST 2017
+1 on adding these diagrams to the docs. It's great to visualize where the
special methods are implemented.
On Sat, Dec 30, 2017 at 4:17 PM, Terry Reedy <tjreedy at udel.edu> wrote:
> On 12/30/2017 11:11 AM, Yahya Abou 'Imran via Python-ideas wrote:
>> We can find very usefull class diagramm to understand the hierarchy of
>> the builtin Collection abstract class and interface in java.
>> Some examples:
>> But when I search about python's ABC, The more detailed I can find are
>> those from the book of Luciano Ramalho Fluent Python:
>> (I think they're done with pyreverse of pylint)
>> They are fine, but I think we could provide some other more detailed in
>> this page:
>> The table could be difficult to understand, a diagram help visualize
>> I've began working on it with plantuml and pyreverse, I'm joining to this
>> mail what I've done so far so you can tell me what you think.
> We have a few .png files in the docs. Yours look like the beginning of
> perhaps 2 nice additions.
> A. Width restrictions suggest making the async branches a separate diagram.
> B. Be consistent on placement of inherited versus added methods. Always
> list inherited first? Different fonts, as suggested, might be good.
> C. After discussion here, and revision, open a doc enhancement issue on
> Terry Jan Reedy
> Python-ideas mailing list
> Python-ideas at python.org
> Code of Conduct: http://python.org/psf/codeofconduct/
-------------- next part --------------
An HTML attachment was scrubbed...
More information about the Python-ideas