seriously

A few reflections on last year.

“Freedom is not the absence of commitments, but the ability to choose – and commit myself to – what is best for me.” — Paulo Coelho

As part of the annual API the Docs Dev Portal Awards, my team spoke to our reimagining of Codat's documentation and wider developer experience.

Prioritization has a structural problem. If every piece of work competes in the same backlog, large, high-impact projects will always beat small improvements. That's usually the right outcome for each decision, but the wrong outcome for the product over time.

Minor bugs, inconsistent spacing, awkward copy, and other small flaws rarely become important enough to win on their own. So they linger.

I decided to make 2023 my year of reading. These are a few of my recent reads.

Follow me on Goodreads.

I recently read The Other Wind by Ursula K. Le Guin. It strikes a perfect balance between the mundane aspects of real, believable human lives and exciting high magic and wonder, reminiscent of "Lord of the Rings" and other classic fantasies.

Have you ever tried to create a language from scratch? I began creating one for fun a while ago, and I've been trying to teach it to ChatGPT,. Langaf is a fictional language that is similar to English and uses a base twelve counting system.

I've long embraced generalism—dipping into different disciplines, interests, and ideas. I often worried this approach meant sacrificing depth for breadth, leaving me moving slowly in many directions rather than swiftly in one.

Documenting how an APIAPI (Application Programming Interface). A set of rules and protocols that allows different software applications to communicate with each other. APIs define the methods and data formats that applications can use to request and exchange information. works is easy. Documenting what you can do with it is the hard part, and it's the part that actually matters.