Artem Manchenkov

Specifications as the better way of software development

What if your API specification could write 80% of your code for you? Learn how a spec-first approach unblocks teams and accelerates development from day one.

Specifications as the better way of software development
#1about 4 minutes

Understanding specifications in software development

Specifications are detailed descriptions of how to make something, with common examples in software including design documents, UML diagrams, and OpenAPI.

#2about 12 minutes

Contrasting the ideal spec-first workflow with reality

The ideal specification-first approach enables parallel development, but the common code-first reality creates inconsistencies, blocked engineers, and high maintenance costs.

#3about 7 minutes

Generating code from specifications with modern tooling

Instead of generating specs from code, tools like go-swagger, openapi-generator, and AsyncAPI can generate server stubs, models, and tests directly from a specification file.

#4about 3 minutes

Applying the specification-first mindset beyond APIs

The specification-driven approach can be extended to define and generate code for metrics, storage access, search APIs, and data contracts.

#5about 4 minutes

Q&A on specifications, legacy systems, and tooling

The speaker answers questions on why tools favor code-first, how to introduce specifications to legacy systems, and the best specification languages.

Related jobs
Jobs that call for the skills explored in this talk.

Matching moments

An overview of the modern software architecture workshop
03:03 MIN

An overview of the modern software architecture workshop

Mastering Modern Architecture - Oliver Sturm

Write specifications first to improve public API design
03:48 MIN

Write specifications first to improve public API design

TDD for Vue.js Developers

Using OpenAPI specifications for automated code generation
04:48 MIN

Using OpenAPI specifications for automated code generation

OpenAPI meets OpenAI

Generating consistent SDKs and docs from OpenAPI specs
03:15 MIN

Generating consistent SDKs and docs from OpenAPI specs

API‑First: How Twilio Designs for Developers - Justin Kitagawa (Twilio)

The role and limitations of API specifications
07:03 MIN

The role and limitations of API specifications

Lessons from Our API Past: Evolving to a Resilient API Future

Moving to a spec-centric model with AI
03:40 MIN

Moving to a spec-centric model with AI

The Power of Prompting with AI Native Development - Simon Maple

Adopting a contract-first API development approach
03:18 MIN

Adopting a contract-first API development approach

Enabling automated 1-click customer deployments with built-in quality and security

Improving API design with documentation-driven development
03:56 MIN

Improving API design with documentation-driven development

WeAreDevelopers LIVE – From JavaScript to WebAssembly, High-Performance Charting and More

Featured Partners

Related Videos

See all videos
Using code generation for test automation – the fancy way40:16

Using code generation for test automation – the fancy way

Roman Alexis Anastasini

The Great API Debate: REST, GraphQL, or gRPC?28:16

The Great API Debate: REST, GraphQL, or gRPC?

Alexis Yushin

Awful APIs: A History Lesson in Industry Mistakes and Mishaps28:55

Awful APIs: A History Lesson in Industry Mistakes and Mishaps

James Seconde

Lessons from Our API Past: Evolving to a Resilient API Future29:30

Lessons from Our API Past: Evolving to a Resilient API Future

Yousaf Nabi

Building APIs in the AI Era32:28

Building APIs in the AI Era

Hugo Guerrero

OpenAPI meets OpenAI29:50

OpenAPI meets OpenAI

Christopher Walles

API = Some REST and HTTP, right? RIGHT?!27:25

API = Some REST and HTTP, right? RIGHT?!

Rustam Mehmandarov

REST in Peace? What does the API protocol of the future look like? Or do we have it already?20:29

REST in Peace? What does the API protocol of the future look like? Or do we have it already?

Simon Auer

Related Articles

View all articles
DC
Daniel Cranney
Why Attend a Developer Event?
Modern software engineering moves too fast for documentation alone. Attending a world-class event is about shifting from tactical execution to strategic leadership. Skill Diversification: Break out of your specific tech stack to see how the industry...
Why Attend a Developer Event?

From learning to earning

Jobs that call for the skills explored in this talk.

Software Engineer

Software Engineer

Code Healers LLC
Hinesville, United States of America

Remote
€40-50K
Intermediate
Senior
PHP
.NET
React
+2
Software Developer

Software Developer

Code Healers LLC
Hinesville, United States of America

Remote
€25-35K
Intermediate
React
Python
JavaScript
+2
Solution Architect

Solution Architect

ING
Amsterdam, Netherlands

Senior
Java
Solution Architecture
Business Process Management (BPM)