• mindbleach
    link
    fedilink
    arrow-up
    3
    ·
    11 months ago

    I could spit venom over tutorials going ‘here’s each word you type, with narrative guidance for where it goes!’ instead of showing a complete snapshot to copy-paste. You are providing… an example. Don’t make people jump through their asses just to get there! The goal is understanding what this witchcraft does, not solving a puzzle to construct the syntax that’s equally mysterious to newbies.

    There’s a particular kind of bullshit obstacle that bucks people straight into apathy. If someone wants to keep their discipline mysterious and exclusive - there is no better moat than a seventeen-step installation, setup, and type-in process, where an entire hour of parsing technobabble can be diverted into harsh computer-says-no rejection at every step.

    People: we are coders. We’re all broken the same way. Be quietly condescending, in delivering the functional minimum start. Lean over and push the buttons for us, if that’s an option. You know damn well step one can be the shallow end and step two can be the Marianas trench, so long as the first step works.

    We’ll happily gaze into the Stygian depths in glass-eyed terror, as many times as it takes to comprehend the barest outline of that abyssal well of knowledge, if we can keep paddling back and forth from whatever baby-ass Hello World does one neat thing.