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.

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, interestsREST An architectural style for designing networked applications. REST uses HTTP methods (GET, POST, PUT, DELETE) to perform operations on resources identified by URLs., and ideas. I often worried this approach meant sacrificing depth for breadth, leaving me moving slowly in many directions rather than swiftly in one.

Application Programming Interfaces, or APIsAPI 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., are an essential component of modern software development. APIsAPI 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. allow different software systems to interact with each other, facilitating the exchange of data and functionality between them. However, while APIsAPI 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. have become ubiquitous in modern software development, their documentation often leaves much to be desired.

Every PM should have an angle - a specific area of depth that makes them genuinely useful. I think of these as the 5Ds:

• Design - Can shape user experience, run research, translate insights into interfaces
• Development - Understands technical constraints, can collaborate deeply with engineers, knows what's actually hard
• Delivery - Masters of getting things out the door, managing scope, unblocking teams
• Domain - Deep expertise in a specific vertical (fintech, health, logistics)
• Data - Can define metrics, run experiments, make decisions grounded in evidence