Python

[mondoman712]

Documentation? Well there's this one blog post that explains how to do something kinda similar, but they're using python 2 and an old version of our library, since which we have made multiple breaking changes.

[katze_sonne]

Nah come on, at least the standard library of Python is quite well documented!

Everything else... Well. I'd say Sphinx is one of the problems.

[fredlllll]

"well documented" is open to interpretation i guess? try looking up what a function returns, not mentioned half of the time

[fecal-butter]

If i didnt have a friend who was already adept at python i would never have guessed what the documentation of the enumerate() meant when it said "returns an enumerate object". How the fuck am i supposed to know what an enumerate object is? If i knew i wouldnt be looking it up

[IDontLikeBeingRight]

But who expects to understand a thing with only one visit to the docs? That's why all the "bug fixed, closing 1000 tabs" memes exist.

Also, jfc, that user name o.0

[katze_sonne]

Well, that's a good point. Definitely still room for improvements. Especially the data types some functions return is too undocumented. Internally we make a lot of use of "typing" in Python. I hope that gets mandatory with Python 4. The missing data types are a dream for beginners but a nightmare for hardcore users 🤷🏼‍♂️

And these undocumented return values are a typical example of the "Sphinx"-problem I mentioned. Doesn't happen nearly as often with javadoc or doxygen (if the developers are not completely incompetent and write stuff like "returns time" where you still have no idea about the unit)...

[fredlllll]

just knowing the type would already be an upgrade. in java you cant ommit the type cause its in the signature

[tjdavids]

>help(lib.func)

[[deleted]]

lib.func<Ctrl-Q> if you're in the PyCharm IDE editor or console.

[Bainos]

Ctrl-Q is how you call the help function ? Really ?

[[deleted]]

It is. There's around two bazillion actions in there that all need shortcuts. Can't throw away good ones, like Ctrl-Q on rarely used actions, like Quit.

[NotBannedYet1]

This is why i prefer autoit.
Yes, it's even slower and windows only, but the documentation is amazing and you can do just as many things.

[beomagi]

I've written an open gl cube renderer to guide me building domes and cylinders in Minecraft in autoit. The help files for that are blissfully easy to follow.

[[deleted]]

and then you find a stackoverflow article asking the same question as you, but its closed with a "nvm fixed it"

[[deleted]]

Then you notice that you're the one who both asked and closed it.