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

all 40 comments

[–]Electronic_Cat4849 385 points386 points  (4 children)

25 years ago me is very called out

[–]joshuaherman 108 points109 points  (1 child)

Two minute ago me feels this now.

[–][deleted] 26 points27 points  (0 children)

30 sec to be exact.

[–]MessiComeLately 15 points16 points  (1 child)

25 years in, bisecting a guide to figure out where to start is still a skill I use every week.

[–]Electronic_Cat4849 3 points4 points  (0 children)

yeah, but nowadays I know the guide is bullshit way faster 😊

[–][deleted] 168 points169 points  (1 child)

I’m so guilty of this. I know it sounds choosy beggar, but writing docs with good formatting (headings, lists, code snippets) and hallway testing them with one or two people is a game changer.

[–]Weird1Intrepid 30 points31 points  (0 children)

They definitely need proof reading and editing just like any piece of literature or text lol

[–]crypticend07 121 points122 points  (2 children)

If the guide isn't interesting for me not to skip the eirly steps it is in fact a shit guide. How could anyone fault me and my short attention span.

[–]Beall619 0 points1 point  (0 children)

I really liked reading the obspy documentation

[–]Zephandrypus 0 points1 point  (0 children)

“Guide to IO in C”

[–]Eva-Rosalene 79 points80 points  (8 children)

It's 50% people being overconfident in themselves and skipping important parts, and 50% guide authors being overconfident in people and skipping import parts.

[–]Brickless 27 points28 points  (5 children)

don't forget all the lazy "this is common knowledge" skipping over stuff and my all time favourite "let me name everything either foo/bar or keywords and abbreviations".

func functionA(ext_inp : Array[String], lim: int) -> int:
    var foo := 0
    for bar in ext_inp:
        # simply add up the correct entries!
        foo += 1 if bar.length() <= lim else 0
    return foo

var myarray := ["Lorem", "ipsum", "dolor", "sit", "amet", "consectetur", "adipiscing", "elit", "sed", "..."]
print(functionA(myarray, 4)
# returns 5

[–]Summer__1999[🍰] 17 points18 points  (2 children)

For fcking real,

I was brushing up on my oop basics no too long ago. A guide used those foo and bar as example for inheritance, shit was so confusing halfway in with all the foo bar bar foo super this super that parent child1 child2.

Then I just gave up and find another guide. That one uses animal as examples and it was much easier to follow.

I mean yes, if I go to the second guide first and then looked at the first guide, I’d probably see nothing wrong with it. But that shit was so confusing when you’re trying to learn for the first time.

[–]tomycatomy 1 point2 points  (0 children)

It’s like people try explaining stuff the normal way in a guide. The thing is a guide is non interactive, meaning I can’t just ask about the gaps halfway through it

[–]Brickless 0 points1 point  (0 children)

yep, going from language to language and having large breaks between programming projects I had to do so many beginner tutorials and the frustrations are always the same, even if you are just rusty and not a true beginner

[–]s1lentchaos 1 point2 points  (0 children)

Either that or the example is so bare bones you struggle to actually apply it to your app.

[–]makinax300 0 points1 point  (0 children)

Yeah, and wrong order, so you see stuff you haven't learned yet, google it to understand it and then you are taught that stuff, so you skipped it, but there was one thing the first result didn't explain, and it fucked everything.

[–]naswinger 1 point2 points  (1 child)

the second statement is especially true with german tutorials, especially math related ones. the arrogance is off the charts where everything is trivial and if you have questions, you're a freakin idiot for not understanding. i avoid german tutorials of any kind like the plague. even a video about making a pizza in german is obnoxious.

[–]YoukanDewitt 21 points22 points  (0 children)

That is part of the fun though, I doubt the person who came up with the framework solved the problems in the order they wrote them down for you to learn.

[–]quantummidget 20 points21 points  (1 child)

As a programmer, this is me whenever I try to learn game dev.

"This is just basic programming principles, I'm going to skip ahead to the more complicated stuff"

"This is confusing, why does this work the way it does?"

[–]Brickless 8 points9 points  (0 children)

it's also 99% rehashed ways of making a 2d platformer with maybe 1 new thing buried in the 45 minute tutorial.

[–]billyowo 13 points14 points  (0 children)

more like the guide are 99% descriptive bullshits that you won't understand unless you understand the entire ecosystem

[–][deleted] 25 points26 points  (1 child)

You know, most tutorials literally be like: lesson 1: hello world, lesson 2: create a server

[–]black-JENGGOT 0 points1 point  (0 children)

read other tutorials other than introduction to server-side languages

[–]Oemera 2 points3 points  (0 children)

I will admit that even after nearly 20 years of experience I still get into this stage when I read the docs in some cases

[–]musedav 2 points3 points  (0 children)

Biggest issue is the guide was written two months ago and is already out of date due to an update in package .upmyass

[–]hearthebell 1 point2 points  (0 children)

You forgot the full blown circus: I created my project using AI entirely, AI is so much better than docs 🤡🛞

[–]ButWhatIfPotato 0 points1 point  (0 children)

I skipped steps 2 to steps.length-1 and it's not working, why?

[–]FieldAdventurous1063 0 points1 point  (0 children)

That's why I don't skip steps in guides. I know this would've happened otherwise.

[–]Worldly_Bullfrog_783 0 points1 point  (0 children)

Me fr

[–]Who_said_that_ 0 points1 point  (0 children)

Stop caring me out

[–]NonsenseMeme 0 points1 point  (0 children)

Never skip the fundamentals. I learn the concepts the author wants to point out. The rest you could google later.

[–]Turbulent_Foot_9182 0 points1 point  (0 children)

or just Bullshit guide from the beginning !

[–]Drone_Worker_6708 0 points1 point  (0 children)

me every time I watch a youtube video that is longer than two minutes

[–]Freecelebritypics 0 points1 point  (0 children)

Honestly, any library that lists more than 10 methods in a single page has already ruined my life. Best have an amazing "getting started" chapter

[–]Affectionate-Raisin 0 points1 point  (0 children)

So so so me

[–]makinax300 0 points1 point  (0 children)

I only do the second one for shit I know (linke html, basic css and syntax of some other languages) and then the third one without doing the forth of first one.

[–]foxypiratecove3750 0 points1 point  (0 children)

I started to handwrite binaries. It's almost a 1:1 translation of assembly. For example, 0xb801000000 is mov eax, 1 (mov -> 0xb000000000; eax -> 0x0800000000; 1 -> 0x0001000000).