Open Menu
AllLocalCommunitiesAbout
lotide
AllLocalCommunitiesAbout
Login

spaghett.

⁨170⁩ ⁨likes⁩

Submitted ⁨⁨1⁩ ⁨month⁩ ago⁩ by ⁨fossilesque@mander.xyz⁩ to ⁨science_memes@mander.xyz⁩

https://mander.xyz/pictrs/image/d3a769d0-adf8-4f8d-af48-a62e26549dcf.jpeg

source

Comments

Sort:hotnewtop
  • cronenthal@discuss.tchncs.de ⁨1⁩ ⁨month⁩ ago

    I’ve seen worse.

    source
  • Ephera@lemmy.ml ⁨1⁩ ⁨month⁩ ago

    Are other auto code documentation tools better? I always figure, it’s mostly a matter of leaving out the details to make it understandable. And that’s kind of a hard thing to find heuristics for.

    source
    • kattfisk@lemmy.dbzer0.com ⁨1⁩ ⁨month⁩ ago

      I’ve yet to see any that are of any use.

      A pet peeve of mine is documentation that describes how the code works. If I want to know that, I can just read it (perhaps assisted by an IDE or debugger).*

      What I need documented is why the code works like that. How is it intended to be used? What quirks and gotchas are there?

      *If the code is not readable it needs to be refactored, not documented.

      source