News for hackers. Stuff that matters.
Re:How often do people copy and paste from Stack Overflow? by erinan on Monday April 19, 2021 @07:02PM (#26868825)
That's me with Python... For some reason I find the documentation extremely cumbersome to navigate and parse. It's just so wordy and dense. And there are barely any examples - which is what I'm usually looking for instead of having to read a whole paragraph.

The Elixir documentation on the other hand is succinct and always features basic examples for every function. It's a joy to work with.

Re:How often do people copy and paste from Stack Overflow? by sergiomattei on Monday April 19, 2021 @07:15PM (#26868910)
As a slightly opposing take, Django has the highest-quality and most comprehensive documentation I've ever seen for a web framework... Or open source project, for that matter.

Not very related to the parent comment, but just an interesting note.

Re:How often do people copy and paste from Stack Overflow? by gtm1260 on Tuesday April 20, 2021 @12:37AM (#26870728)
I agree, Django docs put Flask to shame! Flask in general is more intuitive I guess, but the docs are not as good as they could be.
Re:How often do people copy and paste from Stack Overflow? by ashton314 on Tuesday April 20, 2021 @03:46AM (#26871820)
+1 for Elixir’s documentation. José Valim knew what he was doing when he made docs so easy and pleasant to create and view.

I always love it when a programming language has their docs available off-line and easily accessible. I grew up on Perl without an internet connection (or a GUI for that matter) so I got very used to the perldoc command. That is now the standard I expect. Elixir is one of the few languages that exceeds this bar imo.

Re:How often do people copy and paste from Stack Overflow? by anitil on Monday April 19, 2021 @08:52PM (#26869562)
I've been playing with the ast module in Python lately, and the documentation actually says to go look at someone else's documentation because it's better, which is a refreshing take.

Official Documentation: https://docs.python.org/3/library/ast.html

Green Tree Snakes: https://greentreesnakes.readthedocs.io/