5 ms·

> completely missing from any official documentation To be fair, most things are missing from the official documentation. When I learned kotlin, I read through

> completely missing from any official documentation To be fair, most things are missing from the official documentation. When I learned kotlin, I read through their official docs, and knew about most language features in a day. When I learned python, I constantly got surprised by things I hadn't seen come up in the docs. For instance decorators was (still is?) not mentioned at all in the official tutorial.

BoppreH 3y ago
Decorators seem to be documented now: https://docs.python.org/3/glossary.html#term-decorator https://docs.python.org/3/glossary.html#term-decorator https://docs.python.org/3/reference/compound_stmts.html#function https://docs.python.org/3/reference/compound_stmts.html#func...
- bragr 3y ago
  These have always been documented. Hit the version selector: https://docs.python.org/2.7/glossary.html#term-decorator https://docs.python.org/2.7/glossary.html#term-decorator
roelschroeven 3y ago
The tutorial is not supposed to cover all language features: "This tutorial does not attempt to be comprehensive and cover every single feature, or even every commonly used feature. Instead, it introduces many of Python’s most noteworthy features, and will give you a good idea of the language’s flavor and style." But then I don't know how you're supposed to learn the features that are not in the tutorial. You can have a look at the table of contents of the standard library documentation for modules that might interest you, but that doesn't cover language features. Those are documented in The Python Language Reference, but that document is not really suited for learning from. There are lots of websites and Youtube channels and so on, but you have to find them, and filter out the not-so-good ones which is not easy, especially for a beginner. I think there is room for some kind of official advanced tutorial to cover the gap.
fastasucan 3y ago
I agree. Wish Python could been better with the documentation. Its a bit absurd that things feel more clear and simple reading Rust documentation than Python documentation for me, given that Python actually is a lot more simple and clear (for me).

BoppreH 3y ago

Decorators seem to be documented now: https://docs.python.org/3/glossary.html#term-decorator https://docs.python.org/3/glossary.html#term-decorator https://docs.python.org/3/reference/compound_stmts.html#function https://docs.python.org/3/reference/compound_stmts.html#func...

bragr 3y ago
These have always been documented. Hit the version selector: https://docs.python.org/2.7/glossary.html#term-decorator https://docs.python.org/2.7/glossary.html#term-decorator

roelschroeven 3y ago

The tutorial is not supposed to cover all language features: "This tutorial does not attempt to be comprehensive and cover every single feature, or even every commonly used feature. Instead, it introduces many of Python’s most noteworthy features, and will give you a good idea of the language’s flavor and style." But then I don't know how you're supposed to learn the features that are not in the tutorial. You can have a look at the table of contents of the standard library documentation for modules that might interest you, but that doesn't cover language features. Those are documented in The Python Language Reference, but that document is not really suited for learning from. There are lots of websites and Youtube channels and so on, but you have to find them, and filter out the not-so-good ones which is not easy, especially for a beginner. I think there is room for some kind of official advanced tutorial to cover the gap.

fastasucan 3y ago

I agree. Wish Python could been better with the documentation. Its a bit absurd that things feel more clear and simple reading Rust documentation than Python documentation for me, given that Python actually is a lot more simple and clear (for me).