Public
- Public
- Network
- Groups
- Popular
- People

Conversation

Notices

Aral Balkan (aral@mastodon.ar.al)'s status on Wednesday, 25-Oct-2023 02:55:45 JST Aral Balkan
in reply to
- Adrian Cochrane
@alcinnz Self-documenting code aka “Odd, I’m sure this made sense a few months ago when I wrote it.”

In conversation about a year ago from mastodon.ar.al permalink
- Adrian Cochrane (alcinnz@floss.social)'s status on Wednesday, 25-Oct-2023 02:55:47 JST Adrian Cochrane
  
  JavaScript anti-pattern: self-documenting code - Go Make Things: https://gomakethings.com/javascript-anti-pattern-self-documenting-code/
  In conversation about a year ago permalink
  Attachments
  1. JavaScript anti-pattern: self-documenting code
    
    Recently, I’ve been thinking about few common anti-patterns I tend to see in professional JavaScript projects. Today, I wanted to talk about one of them: no docs. A lot of more seasoned developers have this obsessed with “self-documenting code.” And its true that if you write functions that do just one thing and follow logical naming conventions, what a piece of code does can often be pretty apparent. Looking at the addItemToCart() function below, I can pretty quickly determine that I pass in the ID of the item to add, and it updates the quantity of that item in the cart object.

Feeds