696
Bill is a pro grammer (sh.itjust.works)
submitted 2 years ago by to c/programmer_humor@programming.dev
95 comments fedilink hide all child comments
 
you are viewing a single comment's thread
view the rest of the comments
[–] 29 points 2 years ago (2 children)

That's like saying a book's synopsis shouldn't exist because you can just read the whole book. Sometimes comments can save you a lot of time and point you in the right direction.

  • permalink
  • fedilink
  • source
  • parent
  • hideshow 4 child comments
    •
  • [–] 2 points 2 years ago (1 child)

    Nah, it's not, code is modular (IME should be kinda tree-structured), a book is linear.

    So the API should be in your analogy the synopsis. And I haven't said, that there shouldn't be any comments. E.g. doc-comments above functions, explaining the use-cases and showing examples are good practice.

  • permalink
  • fedilink
  • source
  • parent
  • hideshow 2 child comments
    •