Hallo, collections.Counter ist eigentlich eine total simple und praktische Sache. Aber die Doku ist irgendwie nicht simple: https://docs.python.org/2/library/collections.html#collections.Counter Hat jemand eine Idee wie man die Doku verbessern könnte? Oder sehe ich das falsch und die Doku ist schon super (insbesondere aus dem Blickwinkel eines Anfängers)? Gruß, Thomas -- http://www.thomas-guettler.de/
Was soll an der Doku verkehrt sein? Regards Andreas Jung ----- Sorry for being brief - sent from a mobile device.
Am 28.01.2015 um 21:11 schrieb Thomas Güttler <guettliml@thomas-guettler.de>:
Hallo,
collections.Counter ist eigentlich eine total simple und praktische Sache.
Aber die Doku ist irgendwie nicht simple:
https://docs.python.org/2/library/collections.html#collections.Counter
Hat jemand eine Idee wie man die Doku verbessern könnte?
Oder sehe ich das falsch und die Doku ist schon super (insbesondere aus dem Blickwinkel eines Anfängers)?
Gruß, Thomas
-- http://www.thomas-guettler.de/ _______________________________________________ python-de maillist - python-de@python.org https://mail.python.org/mailman/listinfo/python-de
Am 28.01.2015 um 21:22 schrieb Andreas Jung:
Was soll an der Doku verkehrt sein?
Ich weiß auch nicht, was daran falsch ist, aber zumindest dieses Beispiel >>> c = Counter('gallahad') # a new counter from an iterable kann, wenn man sich nicht bewusst macht, dass Strings auch Iterables sind, flasche Vorstellungen über das Ergebnis provozieren. Dass da dieses rauskommt: >>> c.keys() dict_keys(['a', 'l', 'd', 'h', 'g']) hätte man evtl. auch zeigen sollen. Chris
Unsinnige Diskussion am falschen Platz. Es gibt keine perfekte Doku. Man kann es eh niemanden recht machen. Regards Andreas Jung ----- Sorry for being brief - sent from a mobile device.
Am 28.01.2015 um 22:09 schrieb Christopher Arndt <chris@chrisarndt.de>:
Am 28.01.2015 um 21:22 schrieb Andreas Jung: Was soll an der Doku verkehrt sein?
Ich weiß auch nicht, was daran falsch ist, aber zumindest dieses Beispiel
c = Counter('gallahad') # a new counter from an iterable
kann, wenn man sich nicht bewusst macht, dass Strings auch Iterables sind, flasche Vorstellungen über das Ergebnis provozieren. Dass da dieses rauskommt:
c.keys() dict_keys(['a', 'l', 'd', 'h', 'g'])
hätte man evtl. auch zeigen sollen.
Chris
_______________________________________________ python-de maillist - python-de@python.org https://mail.python.org/mailman/listinfo/python-de
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
-----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@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-----
participants (3)
-
Andreas Jung
-
Christopher Arndt
-
Thomas Güttler