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.

Job ad Dark

SabIna compys

SabIna compys
Vienna, Austria

Remote
€20-100K
Intermediate
JavaScript
.NET
+1

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

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

Awful APIs: A History Lesson in Industry Mistakes and Mishaps

James Seconde

Building APIs in the AI Era32:28

Building APIs in the AI Era

Hugo Guerrero

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

Testing .NET applications a Tool box for every developer29:13

Testing .NET applications a Tool box for every developer

Alexandre Borges

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 
DC
Daniel Cranney
Why developer experience matters
With technology embedded in almost every aspect of life, and with developers building and maintaining these tools, it’s ensuring that developers operate in the digital world with speed and efficiency, if we are to see these same benefits in the offli...
Why developer experience matters

From learning to earning

Jobs that call for the skills explored in this talk.

Senior QA Engineer

Senior QA Engineer

CheckYeti
Vienna, Austria

Senior
Selenium
JavaScript
Manual Testing
Automated Testing
Frontend Developer

Frontend Developer

JO Media Software Solutions GmBh
Brunn am Gebirge, Austria

Senior
CSS
Angular
JavaScript
TypeScript