Loading…
4
A friend said my code looked like alphabet soup and it made me start using comments
I was showing a pal my first Python script last week, a simple program that added up some numbers. He looked at it and said, 'This looks like alphabet soup, man. What does any of this do?' I realized I hadn't written a single comment. So now, for every 4 or 5 lines, I try to write a short note about what that part does. It only takes a second and it helps me remember my own work when I come back to it. It also made my code way easier for him to help me fix a bug. Do you have any other simple habits that make your code easier to read?
3 comments
Log in to join the discussion
Log In3 Comments
parkerm566mo ago
What about using better variable names?
7
jasond566mo ago
Better variable names aren't that big a deal.
8
kellyg145mo ago
Are you serious? Bad names make code impossible to read later. It's a huge deal for anyone who has to fix your mess.
1