←back to thread

417 points Bogdanp | 1 comments | | HN request time: 0.209s | source
Show context
harimau777 ◴[] No.45538265[source]
Please don't follow this advice! The best thing about old school Python was that I could reliably pull up the documentation for a library and it would clearly list the arguments and return values for each function.

Now when I look at the documentation for many JavaScript, and even Python, libraries it's just examples. That's great if I'm trying to just throw something together as quickly as possible, but not if I need to fix a problem or actually learn the library.

Also having examples is fine, but they should be considered a bonus; not documentation.

replies(12): >>45538587 #>>45539170 #>>45539306 #>>45539666 #>>45540462 #>>45540652 #>>45540922 #>>45541159 #>>45542376 #>>45543780 #>>45544276 #>>45544287 #
OptionOfT ◴[] No.45540922[source]
The annoying part about Python is that searching for the python docs is hard.

E.g. "Python rstrip" (without quotes) in DuckDuckGo does not lead me to the Python docs on page 1.

replies(3): >>45541907 #>>45547635 #>>45549830 #
1718627440 ◴[] No.45547635[source]
help(str.rstrip) in a Python shell? Who needs online docs? In case I want them I also have them offline in Devhelp.

Am I uncommon in that I search for the website/domain I intend to read first and then look for the specific page?

replies(1): >>45548088 #
1. porridgeraisin ◴[] No.45548088[source]
> am I uncommon

I think so!