• evatronic@lemm.ee
    link
    fedilink
    English
    arrow-up
    52
    ·
    1 year ago

    This is terrible! What half-witted shit-for-brains monkey crapped this craptacular crapfest out?! I swear to Kaballah Monster, as soon as I figure out…

    git blame

    …oh.

  • Jo Miran@lemmy.ml
    link
    fedilink
    arrow-up
    34
    ·
    1 year ago

    I’ve been at this for almost thirty years. At this point, I’ve forgotten more than I have ever learned.

    • anotherandrew@lemmy.mixdown.ca
      link
      fedilink
      arrow-up
      2
      ·
      1 year ago

      Agreed except for the variables. You can pry the iterators i, j, k, the pointers p and q, and the temporary buffer buf, from my cold, dead hands.

      Short variable names increase code clarity, particularly when the functions employing them are concise and named appropriately. There’s not much worse than using something like sourcedata[databufferiterator] instead of src[i]. It reminds me of authors who think that big words make them sound more intelligent. Needing or advocating auto complete in IDEs is a symptom of this kind of code smell, IMO.

      Code should be clear and concise; it’s also why I fight for 8 character indentation; if your code is creeping across the screen it’s a damn good indication that the function might be too complex and should be broken up.

  • bleistift2@feddit.de
    link
    fedilink
    English
    arrow-up
    10
    ·
    1 year ago

    Clean code, extensive documentation, help files and readmes aren’t supposed to prevent you from forgetting how it works. I’m not sure what you’re trying to tell me with the second half of this meme.

  • M0ty@lemmy.world
    link
    fedilink
    arrow-up
    5
    ·
    1 year ago

    That’s the whole point of documentation, to know how it works AFTER you forget it

  • spez@sh.itjust.works
    link
    fedilink
    English
    arrow-up
    4
    ·
    1 year ago

    I have a repo with another repo inside it which was the one deployed. I forgot how all of it worked and wasted like 4 hours combined. Definetly gonna write docs from now on.