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.

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

"I will remember that" and other lies - Why documentation matters and it makes your apps better25:25

"I will remember that" and other lies - Why documentation matters and it makes your apps better

Luise Freese

From learning to earning

Jobs that call for the skills explored in this talk.

Rust and GoLang

Rust and GoLang

NHe4a GmbH
Karlsruhe, Germany

Remote
€55-65K
Intermediate
Senior
Go
Rust
Angular Developer

Angular Developer

Picnic Technologies B.V.
Amsterdam, Netherlands

Intermediate
Senior
RxJS
Angular
TypeScript