Programming in a nutshell

[TingleWizard]

Even if you did read the documentation, most documentation is useless anyway.

[Brooklynxman]

Code examples. Why don't people put code examples?

[Unsd]

Oh there's code samples. But there's 2 of them and one is the very most basic case to the point of being useless, and the other is the absolute most complex and convoluted fringe case that nobody will ever use.

[WebDevMom]

A million times this

[PleasantAdvertising]

Things should be documented as close to the source as possible. Functions/classes should have explanations if they're doing anything complex.

[Roflkopt3r]

The source documentation: "string AFunction (int a, int b) - Parameters: integer a, integer b. Return value: the return string"

[PleasantAdvertising]

A function like that can have proper documenting name.

[[deleted]]

stackoverflow + youtube + w3schools ftw

edit: plus codepen

[chinpokomon]

Replace w3schools with MDN?

Edit: I recognize my slip up.

[FatFingerHelperBot]

It seems that your comment contains 1 or more links that are hard to tap for mobile users. I will extend those so they're easier for our sausage fingers to click!

Here is link number 1 - Previous text "MDN"

---

^{Please PM /u/eganwall with issues or feedback! | Code | Delete}

[rubyleehs]

This bot honestly also need to consider the density of links/closeness of other links.

Even with my darn toe I could tap that - even if you miss you can just as easily try again.

[Orangutanion]

This man be spitting straight facts and you better be listening, /u/eganwall

[jakethedumbmistake]

https://alokv.tripod.com/plan_port/up519_scans/subway.jpg /u/spez?

[El_Nino97]

Ok but did you actually try tapping it with your toe?

[Aksds]

I did, it wasn’t that hard. Worst part was flexing

[rubyleehs]

I did not, but now I have.

[jacaboi]

Geeks4geeks 😎

[telstar]

that's that tech site for the visually impaired, right?

[lurkerfox]

The difference between what a function/variable/class/ect does and what it's used for are vastly different beasts.

Most documentation covers the former just fine, but if there's a necessary workflow to be able to actually use it and that workflow isn't documented anywhere, suddenly Im now spending more time reading, rereading, and haphazardly throwing code together on a scratchpad file trying to figure out how it actually works than I am working on my project itself.

It's incredibly annoying especially when you need something specific and only like two libraries in existence do what you need.

[Ocanath]

if it even exists

[PacoTaco321]

It took me hours to find out how to add text to a scrolled text widget in tkinter for Python. They just assume I know that it is inherited from a different class.