I have spent more time than I care to admit writing technical documentation for Aurelia 2. The docs at docs.aurelia.io have been through countless revisions, rewrites, restructures, and moments where I stared at the screen wondering if I had forgotten how to form sentences.
Writing code is hard. Writing about code in a way that helps other people write code is harder. Nobody prepares you for this.
The first thing you learn is that you do not actually understand the thing you are documenting. You think you do. You have used it, you have built things with it, you can explain it to a colleague at your desk.
This site has been around for almost 16 years now. Sixteen years. I started it when I was younger, dumber, and convinced I had opinions worth sharing. Turns out I was right about one of those things.
I never studied English. I do not have a degree in writing or journalism or communications. Maths was always my weakness. Give me numbers and my brain starts looking for the exit.
But writing? Writing came naturally. Not because I am especially talented, but because I have always had things I wanted to say and writing was the cheapest way to say them. No barrier to entry. Just words on a screen and a publish button.
I have spent a lot of years writing documentation, first for Aurelia 1 and more recently for Aurelia 2 at docs.aurelia.io. The scale taught me a few things that travel beyond any framework. Good docs are not marketing. Good docs help someone ship. That is the bar I write to.