Reinventing Codat's docs and developer experience
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.
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.
You’re probably used to the ever-present idea of an MVP:
Create a product with the minimum set of features that are enough to satisfy early adopters and provide a basis for feedback and future development.
As a product manager, making decisions is a big part of the job. While we all want to make the right decision every time, sometimes things don't go as planned. It can be tempting to try to stick with a decision, even when it's not working, but I've learned that it's better to be able to reverse course and make a new decision.
A foundational part of product management, often overlooked, is understanding the nuanced difference between toys, tools, and products.
A solitary gull
arced over stone,
mimicked
by a white vessel
far above and away
which could not flap its wings.