• nosurprises@lemm.ee
    link
    fedilink
    English
    arrow-up
    1
    arrow-down
    16
    ·
    1 year ago

    You can't read code, can you? You need some simplified text explanation of what it does. And a programming language higher than assembler is already a set of simplified text instructions. Why are you even participating in this discussion?

    • Demonen@lemmy.ml
      link
      fedilink
      arrow-up
      8
      ·
      1 year ago

      The comments are not for what, they are for why.

      The documentation is a summary of the code, a quick guide to the software to more easily find your way to what you need to work with.

      Are you saying that when you work with some random library, you skip their documentation and go directly to the source code? That's absurd. If you do it that way, you're wasting so much time!

      • li10@feddit.uk
        link
        fedilink
        English
        arrow-up
        7
        ·
        1 year ago

        They sound like a great person to work with, “it’s not my fault for lack of documentation, it’s your fault for being an idiot”