"AI-driven security and spec-first IDEs are revolutionizing software development. Tools like Defender for Cloud and GitHub Advanced Security offer runtime insights, while spec-first tools like Kiro and Spec Kit embed security into code from the start. Faster remediation, better security, and a shift from code-first to intent-first development. #AIInnovation #DevSecOps #SpecFirst #CodeSecurity #SoftwareEngineering"

https://saysomething.hashnode.dev/ai-driven-security-spec-first-development-reshaping-secure-software

From Vibes to Version Control: How Amazons ‘Kiro’ Turns AI Coding Sparks into Shipping Software

A builder’s field guide to vibe coding, Kiro’s spec‑first agents, and what it takes to ship with confidence in 2025. There’s a certain 2 a.m. quiet when the cursor blinks like a metronome, asking for…

Medium

I've finally got to publish the fourth API newsletter: https://www.bitoff.org/the-api-dispatch-4/

The topic is Language-Oriented Approach to API Development from @smizell, something more developers should know about.

#TheApiDispatch #SpecFirst #TypeSpec #smithy

The API Dispatch #4: Design-first doesn't have to be OpenAPI Spec first

The June installment of a monthly ‘newsletter’ about APIs. This issue focuses on The Language-Oriented Approach to API development, along with TypeSpec, Smithy, and ALPS.

Moonwalk - 2025 update - OpenAPI Initiative

Moonwalk is a Special Interest Group (SIG) focused on evolving the OpenAPI Specification. Work on OpenAPI 4.0 continues in 2025.

OpenAPI Initiative

I am working on adding "coverage" to the openapi_first rubygem.

This can be used to see if you have tested all requests/responses in your OpenAPI API description.

Please check it out. Any feedback on this would be greatly appreciated: https://github.com/ahx/openapi_first/tree/coverage?tab=readme-ov-file#test-coverage

#openapi #specfirst #apifirst #ruby #rack

GitHub - ahx/openapi_first: openapi_first is a Ruby gem for request / response validation and contract-testing against an OpenAPI API description. It makes APIFirst easy and reliable.

openapi_first is a Ruby gem for request / response validation and contract-testing against an OpenAPI API description. It makes APIFirst easy and reliable. - ahx/openapi_first

GitHub

"In short, APIs are how businesses speak to one another. Breaking this oath with a poor integration experience is a surefire way to reduce your business potential. By utilizing a source of truth and baking a specification-first approach into your API development and documentation practices, you more clearly communicate changes, reducing the possibility of broken clients and promoting forward compatibility. Great API products must be well-described, easy to understand, and predictable in the long run.

In the end, the business effects of specification-driven development are manifold. Whether you're building RESTful, GraphQL, or event-driven partner services, having reliable API documentation is important to compete in the digital economy. This consistency equates to a better partner experience, leading to stickier partners and less customer churn. By enabling smoother integrations and reducing frustration, spec-first documentation directly contributes to partner retention and loyalty, which ultimately drives revenue growth."

https://bump.sh/blog/how-spec-first-api-documentation-aids-partner-integration

#APIs #APIDocumentation #TechnicalWriting #SpecFirst #SoftwareDocumentation #Docs #DeveloperExperience #DocsAsCode

How Spec-First API Documentation Aids Partner Integration · Bump.sh

Partner APIs are far more common than public-facing APIs. Yet, inaccessible documentation for these APIs is often a big barrier to partner success. In fact, nearly 40% of developers say inconsistent docs are their biggest roadblock when it comes to API integration, found the 2024 State of the API Report. Pain points around API documentation can cause miscommunications, errors, and time delays.

Fellow #golang people, how do you generate Go client and server skeletons from #OpenAPI specs in your projects?

I’m currently using https://github.com/oapi-codegen/oapi-codegen but I’m eager to learn about alternatives.

I also know https://github.com/OpenAPITools/openapi-generator.

#SpecFirst #SpecDriven

GitHub - oapi-codegen/oapi-codegen: Generate Go client and server boilerplate from OpenAPI 3 specifications

Generate Go client and server boilerplate from OpenAPI 3 specifications - oapi-codegen/oapi-codegen

GitHub

Navigating OpenAPI, TypeSpec, and API-Drift in the "Post-OpenAPI Era"

https://netapinotes.com/navigating-openapi-typespec-and-api-drift-in-the-post-openapi-era/

"In a perfect world as an API program lead, I would like to see a run-time comparison, per request, between what the API is doing and what it purports to do." -- #MatthewReinbold

#api360 #APIFirst #specFirst #typeSpec

Navigating OpenAPI, TypeSpec, and API-Drift in the "Post-OpenAPI Era"

Net API Notes for 2024/09/12, Issue 244

Net API Notes