The Changelog: Software Development, Open Source HATEOAS corpus (Friends)
13 snips
Dec 8, 2023 Kris Brandow, a prominent software engineer known for his work in the Go community, discusses the intricacies of API design. He and Jerod explore what makes a good API, questioning why REST is often misapplied. They dive into the debate between GraphQL and REST, highlighting the significance of hypermedia and how it affects client-server interactions. Kris also shares insights on the evolution of these technologies, addressing common misconceptions and emphasizing the need for clarity and documentation in API development.
AI Snips
Chapters
Books
Transcript
Episode notes
Design In the Small
- Design programming-level APIs, even internal functions, for maintainability.
- Consider parameters, inputs, outputs, and types for long-term maintainability.
Parameter Count as Design Indicator
- Many parameters in a function suggest poor design or scope creep.
- Refactoring functions with excessive parameters improves code maintainability.
Go's Context Object
- Go's context object can hide parameters, obscuring function complexity.
- Kris Brandow prefers Go's explicitness for problem detection over parameter hiding.
