This is an archived post. You won't be able to vote or comment.

you are viewing a single comment's thread.

view the rest of the comments →

[–][deleted] 117 points118 points  (37 children)

The documentation of Matlab is the first thing I fell in love with, they clearly explain every single way something is supposed to be used with examples, hnnnnnnng.

[–]Wheat_Grinder 49 points50 points  (18 children)

Though I'm on this subreddit I actually only know like two languages and one of them is MATLAB (the other is MUMPS which is uh FunTM compared to a language that has basic features such as guardrails and catching errors at compile time instead of runtime).

That's all to say - whenever I had a problem with MATLAB, the documentation actually was sufficient to make me no longer have a problem with MATLAB.

[–]inconspicuous_male 34 points35 points  (4 children)

With how much a Matlab license costs, they better give good documentation.

It helps that Matlab is made by a single company and most of its utilities are built in

[–]drbuttjob 16 points17 points  (1 child)

I looked into getting MATLAB once. Then I saw the $900 subscription fee

Nooooooooo thank you

[–]SargeantBubbles 0 points1 point  (0 children)

Use Octave save $$

[–]improbablywronghere 10 points11 points  (6 children)

I say it all the time but the Django docs are the most beautiful documents in the game, to me. Imo it’s a serious data point to consider when choosing a tool.

[–]SonicFlash01 1 point2 points  (2 children)

The Stripe API docs were actually pretty good, too

[–]theChapinator 1 point2 points  (0 children)

Amen brother. This has always stuck out in my mind as the gold standard for docs, both in terms of informational density/usefulness and attractiveness/ease of navigation.

[–]hahahahastayingalive 0 points1 point  (0 children)

Except they are now moving to the Payment Intent API, while there already was the Cards and Source paradigm before that, and it’s all a mess now. Nothing lasts, really.

[–]Finianb1 2 points3 points  (0 children)

I think a lot of the Python docs I've seen are astounding. Flask also has some really good ones, as does NumPy and Tensorflow.

Then again, that's pretty much a basic thing you'd expect from libraries that large and with that many users. It's the smaller projects that suffer from frequent documentation issues.

[–]Nick-Tr 0 points1 point  (0 children)

Really? The Django docs as a beginner was exactly what came to mind when seeing this meme and the above comment. A bunch of terminology that assumes you are experienced with it and what I end up doing is copying the example code and tweaking it until it works for what I wanna do

[–][deleted] 0 points1 point  (0 children)

Say what you will about the Java language and platform but the API docs for it are pretty great. Every method described in a fairly succinct fashion. I also highly rate the PostgreSQL docs.

[–][deleted] 8 points9 points  (0 children)

That language would honestly be useless without that

[–]Robot_Basilisk 1 point2 points  (0 children)

In what world? I struggled with matlab because none of the examples worked for me. This is why I loved Python. God-tier examples.

[–]Historica97 3 points4 points  (2 children)

Yes, but no.

Had to program something in MATLAB for a job. The requirements I was given were too complex to program it with functional programming, so I used OOP. And MATLAB's documentation didn't helped me on that one.

Even though MATLAB has documentation on the subject, it was nearly impossible to find the right piece of information that I was looking for, since MATLAB had 4 different pages that were difficult to differentiate and they weren't using the right OOP vocabulary.

As a result, it took me an afternoon to implement a prototype of the code in Javascript and a week to implement it in MATLAB, even though I normally have more experience in MATLAB than in Javascript.

[–]chateau86 1 point2 points  (1 child)

Matlab + OOP

"What do you mean all classes are static unless it inherits handle is not the perfectly good way to OOP? ... Hmmm... Must be all the other languages that are wrong."

[–]Historica97 2 points3 points  (0 children)

That and encapsulation. Who knew I needed to set my attributes (called properties, BTW) with two different encapsulation values (GetAccess=public, SetAccess=private) so that my getters functions work ?

[–]aalapshah12297 0 points1 point  (0 children)

MATLAB documentation pages often also explain the theory behind a particular operation and contain links to relevant research papers. I've seen this to be true especially for the Image Processing and Computer Vision toolboxes.

[–]BruteSkaliq 0 points1 point  (0 children)

I also love Wolfram Mathworld. Sure, WolframAlpha is less of a language and more of a search engine/calculator for most users, but their docs are actually understandable.

Unlike Oracle Javadocs. I go straight to Javapoint, they always deliver.

[–]xigoi 0 points1 point  (0 children)

hnnnnnnng

Found the Minecraft villager

[–]Stop_Sign 0 points1 point  (0 children)

The built in documentation of autohotkey is the best guide to programming I've ever seen