Automatically generating documentation is a dream come true for developers looking to focus on the code instead of copywriting. It’s also a dream for end users, who get documentation that’s up-to-date and reliable.
Posts Tagged: tooling
APIs drive DevOps in every meaning of the word. With that being said, we often look at APIs only in one light – we view them as a product rather than what they are, which is a core enabling system for the modern code infrastructure. Read more
GraphQL is a powerful solution for many users. Having the ability to determine the data returned and the format it’s returned great makes for a robust system, delivering excellent user experience and unmatchable data exchange. That said, GraphQL is not entirely perfect out of the box. Read more
We walkthrough using APIcurio, an API design editor supporting OpenAPI Spec.Having a thoroughly documented, machine-readable API is considered top of the line development. However, creating a consistent format for the API and documentation is challenging with no outside guidance or structure. Read more
Testing is often considered to be a secondary consideration at the end of the development lifecycle. The common thought is that APIs are tested after they are built, and that any issues found should be addressed during these later stages. While this is certainly a method that can deliver a finished product, utilizing testing in such a manner is missing some major benefits of earlier testing. Read more