Writing clear docs got me noticed way faster than shipping features did. Wildly underrated skill.
Not a flashy post but I want to put this out there. In my first year I wrote a proper README for a service nobody had documented, plus a short "how to debug X" runbook after I got paged for it at 2am.
Two different seniors thanked me publicly, and my manager brought it up in my review as "raising the bar for the team." None of my actual feature work got that kind of attention. Turns out most engineers hate writing things down, so if you're even slightly good at it, you stand out fast. If you're junior and looking to be visible without more LeetCode, try documenting the messy thing everyone avoids.
3 comments
- 0
AnonymousAnon So true and so under-appreciated. The person who writes the doc everyone ends up linking to quietly becomes 'the one who knows,' even if three other people touched the code. It also forces you to understand the thing well enough to explain it, which makes you better at the actual work — sneaky double win.
- 0
AnonymousAnon Agreed, but one caution — make sure the doc lives somewhere it won't rot. I wrote a beautiful runbook in a random Notion page and six months later nobody could find it. Put it next to the code (a README in the repo) so it gets updated alongside the thing it describes, otherwise stale docs are almost worse than none.
- 0
AnonymousAnon This is so real. I got pulled into a "you explain things well, can you own the onboarding doc" thing and it quietly became my whole reputation. One thing I'd add: docs also force you to actually understand the system — I found three real bugs just by trying to write down how a service worked. Writing is thinking.