The longer I work in technology, the less convinced I am that there's one right way to do things. These are a few ideas I've changed my mind about over the years. I'm sure this list will continue to grow.
None of these are universal truths. They're simply ideas that experience has reshaped for me.
Simplicity takes more work.
I used to think technical writing was about accuracy.
Now I think it's about clarity.
The most useful explanation is often the one that took the longest to write.
Not because the technology became simpler, but because someone spent the time to understand what actually mattered.
You don't need all the answers to contribute.
I used to think credibility came from knowing everything. It turns out asking good questions is often more valuable.
The best conversations I've had usually started with curiosity, not certainty.
Features aren't the story.
I used to focus on what products could do. Now I spend much more time thinking about what changes for the people using them.
Features matter. Outcomes are what people remember.
Community isn't about audience size.
Earlier in my career I measured success by attendance and engagement. Today I care much more about whether people feel comfortable contributing.
A smaller community where people participate is often more meaningful than a larger one where everyone stays quiet.
Documentation is never finished.
I used to think documentation was something you wrote once. Now I know it's a conversation. Every question someone asks is a chance to improve it.