Ingo Steinke is a Berlin-based senior web developer focusing on front-end web development to create and improve websites and make the web more accessible, sustainable, and user-friendly.
Thanks for your post, and even more for the cover image. The cartoon cats are so powerful in their rage, they make even heavy vintage monitor fly into the air. The cool cat in the middle is the most modest, it only points one finger. Maybe it likes the one on the right, or it just looks cooler to keep one hand in the pocket. Hopefully it's not hiding anything dangerous.
Sometimes I code, always I write — A simple man making his way through the galaxy, writing as I go — 📚 Author of "Street-Smart Coding in the Age of AI": bit.ly/csarag-sscai
Location
Colombia 🇨🇴 (not Columbia)
Work
Content, Courses & Training for .NET teams — Helping teams to write maintainable & performant code
LOL! Thanks for stopping by Ingo. I've made the cartoons part of my visual brand here. Ooooh nice catch, I didn't realize he was hiding something hahahahah
Lack of documentation hits hardest when you’re new. You join a team, open the repo, and the only README says “TODO: add docs” 😅 It gets even worse when the person who wrote the code has already left the company and the senior dev is too busy to answer questions. So you just read the code and hope for the best.
The funny part is that once you finally figure it out, you become the person who should write the docs. Then a tight deadline comes along and the cycle starts again 😂
Sometimes I code, always I write — A simple man making his way through the galaxy, writing as I go — 📚 Author of "Street-Smart Coding in the Age of AI": bit.ly/csarag-sscai
Location
Colombia 🇨🇴 (not Columbia)
Work
Content, Courses & Training for .NET teams — Helping teams to write maintainable & performant code
You join a team, open the repo, and the only README says “TODO: add docs”
OMG! A nightmare for every new coder...When joining a new team, improving the docs (at least the installation instructions) is a good first step to learn the development process.
Freelance fullstack developer creating fast, modern, and refined applications. I focus on simplicity, performance, and real value for users. I also write tech-related articles here.
Caching and "must be a framework bug" are definitely at the top of my list, right up until git blame quietly reveals I wrote the broken line myself six months ago. 😅
My personal favorite progression during a late-afternoon debugging session is always:
"Staging is acting up again."
"It's definitely a stale CDN cache."
"Wait... I missed an await on line 42."
Super relatable list! Which one usually takes you the longest to admit was actually your own code?
Sometimes I code, always I write — A simple man making his way through the galaxy, writing as I go — 📚 Author of "Street-Smart Coding in the Age of AI": bit.ly/csarag-sscai
Location
Colombia 🇨🇴 (not Columbia)
Work
Content, Courses & Training for .NET teams — Helping teams to write maintainable & performant code
Ufff... #1 is a classic. Sometimes it's lacking, sometimes it reads like a reference instead of showing you a simple, working example. Many times, you have the example but it doesn't go deeper...
Oh, errr... #4 ... Uh. Yeah. That hurts. "I was still learning $lang when I wrote this. I should rewrite it with more convenient and modern idioms." It's a trap!
Sometimes I code, always I write — A simple man making his way through the galaxy, writing as I go — 📚 Author of "Street-Smart Coding in the Age of AI": bit.ly/csarag-sscai
Location
Colombia 🇨🇴 (not Columbia)
Work
Content, Courses & Training for .NET teams — Helping teams to write maintainable & performant code
The QA example makes me wonder whether two separate questions are getting collapsed: did this change introduce the bug, and should the team fix it now? Reproducing it on the previous release answers the first, but doesn't settle the second. A pre-existing issue can still block a release if the new feature exposes it to many more users. That seems more useful to discuss than whether QA was allowed to report it.
I just noticed one thing. People are easy to blame things that are hard to put accountability to (e.g. people who left, AI, or heck the world). I think it should be the other way around. If we took more accountability, fix, and learn from it, then why are we so afraid to take the fall? I think it links more closer to our own ego and pride. But... you know what, while typing this, I realized that a 2 minute embarrassment is negligible when compared to what you could become after (which, spoiler alert, much more stronger).
Sometimes I code, always I write — A simple man making his way through the galaxy, writing as I go — 📚 Author of "Street-Smart Coding in the Age of AI": bit.ly/csarag-sscai
Location
Colombia 🇨🇴 (not Columbia)
Work
Content, Courses & Training for .NET teams — Helping teams to write maintainable & performant code
You forgot one which is precious: -"from now on in this team we are going to mob program!"
And here I am can't focus if people talk at the same time or if there is an unpaid invoice on my table...
Sometimes I code, always I write — A simple man making his way through the galaxy, writing as I go — 📚 Author of "Street-Smart Coding in the Age of AI": bit.ly/csarag-sscai
Location
Colombia 🇨🇴 (not Columbia)
Work
Content, Courses & Training for .NET teams — Helping teams to write maintainable & performant code
Thanks for your post, and even more for the cover image. The cartoon cats are so powerful in their rage, they make even heavy vintage monitor fly into the air. The cool cat in the middle is the most modest, it only points one finger. Maybe it likes the one on the right, or it just looks cooler to keep one hand in the pocket. Hopefully it's not hiding anything dangerous.
LOL! Thanks for stopping by Ingo. I've made the cartoons part of my visual brand here. Ooooh nice catch, I didn't realize he was hiding something hahahahah
Lack of documentation hits hardest when you’re new. You join a team, open the repo, and the only README says “TODO: add docs” 😅 It gets even worse when the person who wrote the code has already left the company and the senior dev is too busy to answer questions. So you just read the code and hope for the best.
The funny part is that once you finally figure it out, you become the person who should write the docs. Then a tight deadline comes along and the cycle starts again 😂
OMG! A nightmare for every new coder...When joining a new team, improving the docs (at least the installation instructions) is a good first step to learn the development process.
Caching and "must be a framework bug" are definitely at the top of my list, right up until
git blamequietly reveals I wrote the broken line myself six months ago. 😅My personal favorite progression during a late-afternoon debugging session is always:
awaiton line 42."Super relatable list! Which one usually takes you the longest to admit was actually your own code?
It's always a caching issue :D
Ufff... #1 is a classic. Sometimes it's lacking, sometimes it reads like a reference instead of showing you a simple, working example. Many times, you have the example but it doesn't go deeper...
Oh, errr... #4 ... Uh. Yeah. That hurts. "I was still learning $lang when I wrote this. I should rewrite it with more convenient and modern idioms." It's a trap!
We all complain, but who likes to write docs in the first place?
"That's from the original implementation" one of my favorite lines these days I'm migrating a legacy VB app :P
The QA example makes me wonder whether two separate questions are getting collapsed: did this change introduce the bug, and should the team fix it now? Reproducing it on the previous release answers the first, but doesn't settle the second. A pre-existing issue can still block a release if the new feature exposes it to many more users. That seems more useful to discuss than whether QA was allowed to report it.
i do want to write docs i don't get why people keep complaining abt bad docs
I just noticed one thing. People are easy to blame things that are hard to put accountability to (e.g. people who left, AI, or heck the world). I think it should be the other way around. If we took more accountability, fix, and learn from it, then why are we so afraid to take the fall? I think it links more closer to our own ego and pride. But... you know what, while typing this, I realized that a 2 minute embarrassment is negligible when compared to what you could become after (which, spoiler alert, much more stronger).
Great observation!
You forgot one which is precious: -"from now on in this team we are going to mob program!"
And here I am can't focus if people talk at the same time or if there is an unpaid invoice on my table...
LOL! Classic one too.