• 7 Posts
  • 390 Comments
Joined 2 years ago
cake
Cake day: June 12th, 2023

help-circle
  • Later on, I learned that an excess of comments is actually not considered a good practice.

    Pointless or uninformative comments are not good, regardless of the quantity.

    Useful and informative comments are always good, regardless of the quantity.

    I learned that comments might be a code smell indicating that the code is not very clear.

    When I’m looking at someone else’s code, I want to see extensive, descriptive comments.

    Good code should be so clear, that it doesn’t need comments.

    That hits me like something a teacher tells you in a coding class that turns out to be nonsense when you get to the real world.

    I’m not sure how others do it.

    As I’m coding, the comments form part of my plan. I write the comments before the code. As I discover I’ve made incorrect assumptions or poor decisions, I correct the comments with the new plan, then correct the code to match the updated comments.

    As a final step in coding, when I feel it is complete, I’ll review comments to determine what should remain to help future me if I ever have to dig into it again.

    Variable names should be reasonably memorable and make contextual sense, but that’s it. That’s what they exist for. Don’t overload the purpose of anything I’m the code.





  • My oldest has no children and works fully remote.

    When the pandemic started, his company decided to have everyone work from home. They very quickly discovered that they were just as productive, and the owner decided it made sense to dump their office space.

    A group of employees decided to go on vacation together, while still working. Since they are all remote, they didn’t actually have to work from home. They got an Airbnb with good Internet, worked during the day, and saw the sites and had fun together after work.

    If you’re remote and you miss that sense of community, reach out to your coworkers and ask them if they want to hang out after work. It’s possible they don’t and you’ll be disappointed. It’s also possible that they feel the same way but didn’t know they could do something about it.

    Either you’ll be the hero that saved everyone from their solitary existence, or you’ll have to accept that they don’t want to hang out with you.