[Python-de] Bessere Doku für collections.Counter

Andreas Jung lists at zopyx.com
Fr Jan 30 09:30:44 CET 2015


-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Thomas Güttler wrote:
> 
> Am 28.01.2015 um 21:22 schrieb Andreas Jung:
>> Was soll an der Doku verkehrt sein?
> 
> Ich komme mit der Doku zurecht. Ich nutze Python seit 14 Jahren.
> 
> Wenn ich Neulingen in unserer Firma die Doku zeige, und wir die
> zusammen anschauen. Dann merke ich, dass die Doku von Counter nicht
> intuitiv und sofort verstanden wird.
> 
> Sicherlich kann man es nicht allen Recht machen. Aber ganz
> allgemein, sollte die Doku primär für Neulinge leicht verständlich
> sein. Oder?
> 
> Danach können gerne die trickreichen Sonderfälle erläutert werden.
> 
> Die Übergabe einer Zeichenkette, die dann als Liste behandelt wird,
> ist für Neulinge eher verwirrend.
> 
> Gruß, Thomas
> 

Und was lernen wir aus dieser Diskussion? Entweder nichts oder
dass man zur Python Dokumentation selber beitragen sollte, wenn etwas
nicht stimmt.


- -- 
Regards
Andreas Jung
andreas at andreas-jung.com
about.me/andreasjung
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.11 (Darwin)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/

iQGUBAEBAgAGBQJUy0E0AAoJEADcfz7u4AZjRVQLv1xB2LKK1n/akOtIjSJTOCIy
9zN+H1VQrRkTZ3FZOm9pgLQC0wfg9Pzumyd+Rok34PMnGyjFjmiRYg2DHsTHbCht
m43goqZLWwoPyOU7/osb3DXndnWD6DOrBVHg1Wsd7dn65CCpH6OmQfkMy0jDH2VR
v3QXvdsRX0C1S8Wkx+cBlc6AXKvveUZHgLuix5AD07f8InAkBg1/r9APNnu95LrV
skXIEs2UWj/GIP4zjwDP4z864lBPiC3W9B4fzjw8pPvBIqpvQatiBOIRape9QBYr
jBRobHB9KkouJTXxwJRolmbhjYurM00Kz55423mRm8XIMK4/o9PXuC0H33K6y/nS
ylUGYAqPAYnCe6lozSozbQyoFOhhrQ8A7s7nfwH5vEEM7UausF6WMr1ldYwBbg99
5uLYtauj1nrw81XK6cxkCBcKw8QoqJkTiRknMo8qu+vKBgzeoNpmvUDXKW8/rlEO
0soOfcB0pvkfE1zZ7GsjVw1Sa+q64lg=
=yePz
-----END PGP SIGNATURE-----


Mehr Informationen über die Mailingliste python-de