Artem Manchenkov
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
13:32 MIN
Adopting a contract-first API development approach
Enabling automated 1-click customer deployments with built-in quality and security
29:47 MIN
Why clear product specifications are crucial for AI development
Transforming Software Development: The Role of AI and Developer Tools
14:44 MIN
Applying docs-first design to create better APIs
Diving into Developer Experience
33:22 MIN
Write specifications first to improve public API design
TDD for Vue.js Developers
00:07 MIN
Using OpenAPI specifications for automated code generation
OpenAPI meets OpenAI
06:56 MIN
Creating a framework for small teams to achieve big things
Coffee with Developers: David Heinemeier Hansson
12:33 MIN
The role and limitations of API specifications
Lessons from Our API Past: Evolving to a Resilient API Future
03:41 MIN
Why learning about new APIs benefits developers
Explore new web features before everyone else
Featured Partners
Related Videos
40:16Using code generation for test automation – the fancy way
Roman Alexis Anastasini
28:16The Great API Debate: REST, GraphQL, or gRPC?
Alexis Yushin
28:55Awful APIs: A History Lesson in Industry Mistakes and Mishaps
James Seconde
29:30Lessons from Our API Past: Evolving to a Resilient API Future
Yousaf Nabi
32:28Building APIs in the AI Era
Hugo Guerrero
29:50OpenAPI meets OpenAI
Christopher Walles
27:25API = Some REST and HTTP, right? RIGHT?!
Rustam Mehmandarov
25:25"I will remember that" and other lies - Why documentation matters and it makes your apps better
Luise Freese
Related Articles
View all articles
From learning to earning
Jobs that call for the skills explored in this talk.
![Senior Software Engineer [TypeScript] (Prisma Postgres)](https://wearedevelopers.imgix.net/company/283ba9dbbab3649de02b9b49e6284fd9/cover/oKWz2s90Z218LE8pFthP.png?w=400&ar=3.55&fit=crop&crop=entropy&auto=compress,format)
Senior Software Engineer [TypeScript] (Prisma Postgres)
Prisma
Remote
Senior
Node.js
TypeScript
PostgreSQL
Tech Lead (m/f/d) - Berlin
Patronus Group
Berlin, Germany
Senior
Kotlin
Spring Boot
Amazon Web Services (AWS)
Software Engineer
tree-IT GmbH
Bad Neustadt an der Saale, Germany
€54-80K
Intermediate
Senior
Java
TypeScript
Spring Boot
Senior Machine Learning Engineer (f/m/d)
MARKT-PILOT GmbH
Stuttgart, Germany
Remote
€75-90K
Senior
Python
Docker
Machine Learning
Lead Full-Stack Engineer
Hubert Burda Media
München, Germany
€80-95K
Intermediate
Senior
React
Vue.js
Node.js
MongoDB
+1