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.

d

Saby Company

Saby Company
Delebio, Italy

Junior
Java
Node.js

Matching moments

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

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

Understanding the problem of API schema fatigue
03:03 MIN

Understanding the problem of API schema fatigue

tRPC: API schemas are pure overhead

Why clear product specifications are crucial for AI development
06:33 MIN

Why clear product specifications are crucial for AI development

Transforming Software Development: The Role of AI and Developer Tools

Applying docs-first design to create better APIs
01:18 MIN

Applying docs-first design to create better APIs

Diving into Developer Experience

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

Building APIs in the AI Era32:28

Building APIs in the AI Era

Hugo Guerrero

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

OpenAPI meets OpenAI29:50

OpenAPI meets OpenAI

Christopher Walles

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

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

Alexis Yushin

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

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

Rustam Mehmandarov

The QUEST for Better Software23:44

The QUEST for Better Software

Richard Bown

Related Articles

View all articles
AP
Anto Pranjić
11 Tips to Make The Most Out of Your First World Congress 
The world’s most awesome event for developers is taking place in less than a month! It’s been far too long since the last time we met in person, but that’s only going to make this year’s WeAreDevelopers World Congress a truly special experience. Conf...
11 Tips to Make The Most Out of Your First World Congress 
BB
Benedikt Bischof
How we Build The Software of Tomorrow
Welcome to this issue of the WeAreDevelopers Live Talk series. This article recaps an interesting talk by Thomas Dohmke who introduced us to the future of AI – coding.This is how Thomas describes himself:I am the CEO of GitHub and drive the company’s...
How we Build The Software of Tomorrow

From learning to earning

Jobs that call for the skills explored in this talk.