Today I realised the problem with semver is Hyrum’s Law.
The problem with semver is Hyrum’s Law
2
Tag Archives: api
LibreOffice 7.3 API Documentation
So I’m off to read the LibreOffice 7.3 API Documentation. Supported macro languages include a form of BASIC and a form of JavaScript. Gonna try JavaScript… my goal is to generate the ASCII tables for my book, programmatically, as it were.
Principles & Best practices of REST API Design
Some thinking points for service design: Principles & Best practices of REST API Design.
Recent articles
So via r/programming today: Modern storage is plenty fast. It is the APIs that are bad. and Anti-Patterns When Building Container Images.
And via lobsters: How Does NTP Work? and The curse of scalable technology.
How To Design A Good API and Why it Matters
Today I watched: How To Design A Good API and Why it Matters. Good talk. Favourite quote:
Inheritance violates encapsulation
Oh, and I followed on with: A Brief, Opinionated History of the API wherein (t=28:14) Bloch says it’s an API if you can answer yes to both of these:
- Does it provide a set of operations defined by their inputs and outputs?
- Does it admit reimplementation without compromising its users?
Documenting APIs: A guide for technical writers and engineers
Today I discovered: Documenting APIs: A guide for technical writers and engineers.
REST API doco
Some tools for API documentation: Say Goodbye to Manual Documentation with these 6 tools.
Public APIs
This via r/programming today: A collective list of free APIs for use in software and web development.
Recommended Pagination for APIs
This via r/programming today: Recommended Pagination for APIs. Keyset pagination is an approach I’ve seen recommended a fair bit lately…
Write code that is easy to delete, not easy to extend
Today via Lobsters: Write code that is easy to delete, not easy to extend. I think I like programmingisterrible.com.