WeAreDevelopers Logo WeAreDevelopers
Sign in
For You LIVE
World Congress 2026 Europe - Virtual Stage • Jul 2, 2026 • Session details

Living Documentation That Can't Die

Roman Liukevich

Stale documentation is actively breaking your AI coding agents by feeding them outdated instructions. Discover how a unified docs-as-code approach transforms passive guidelines into active IDE warnings.

Pause
Mute Enter Fullscreen
#1 about 2 min

Why scattered knowledge bases lead to stale documentation

Spreading documentation across multiple platforms prevents teams from knowing where the actual source of truth resides.

#2 about 3 min

The persistent gap between AI code agents and documentation

AI assistants integrated into the IDE still lack awareness of external documentation platforms like Confluence or Notion.

#3 about 2 min

Relocating documentation to the main codebase repository

Placing documentation in the same repository as code allows AI agents to read and rely on accurate context.

#4 about 5 min

Evaluating documentation folders versus Git submodules and wikis

Teams must choose between the friction of pull requests in a docs folder or the manual syncing of a separate wiki repository.

#5 about 2 min

Generating and syncing documentation automatically with AI

Configuring AI agents to read and update documentation files during code changes prevents knowledge from falling out of sync.

#6 about 1 min

Managing agent token consumption with an index file

Creating a simple index document helps AI agents selectively read relevant files instead of consuming entire documentation folders.

#7 about 1 min

Validating code style and rules against documentation

Agents can automatically check any code file against documented standards during the review and onboarding processes.

#8 about 2 min

Converting architectural guidelines into custom lint rules

Transforming lengthy lists of architectural rules into hard linting constraints ensures compliance without relying on human memory.

#9 about 4 min

Operating a unified documentation system day to day

Integrating code, documentation, and AI agents into a single automated loop drastically reduces the cost of keeping information current.

Matching moments

1:09 min

The emergent readers of software documentation

Emil Sorensen Emil Sorensen · World Congress 2026 Europe

4:08 min

Transitioning documentation from human readers to AI agents

Edvin Teskeredzic Edvin Teskeredzic · World Congress 2026 Europe

2:09 min

Assessing the limitations of generating documentation directly from codebases

Chris Heilmann Chris Heilmann +2 · LIVE

3:38 min

Adopting documentation-led specification for optimal agent code generation

Lee Stott · Coffee With Developers

2:55 min

Enhancing AI agents with trusted documentation and logical restraints

Chris Heilmann Chris Heilmann +2 · LIVE

2:22 min

Orchestrating local developer environments with AI tools

Angie Jones Angie Jones · World Congress 2025

More from World Congress 2026 Europe - Virtual Stage

One Does Not Simply Make Architecture Decisions Alone thumbnail
36:15
2 months ago

One Does Not Simply Make Architecture Decisions Alone

Vladas Diržys

From Black Box to Glass Box : Bedrock AgentCore Observability thumbnail
21:15
3 months ago

From Black Box to Glass Box : Bedrock AgentCore Observability

Yasemin Aktürk

Leading in Rhythm: How Women Make Better Decisions with Biological Intelligence thumbnail
30:41
3 months ago

Leading in Rhythm: How Women Make Better Decisions with Biological Intelligence

Julia Grosse

Better Together: Leveraging Your Observability Tools as a SIEM thumbnail
39:06
3 months ago

Better Together: Leveraging Your Observability Tools as a SIEM

Mathias Palmersheim

ChatGPT Apps: From Chat to Checkout thumbnail
30:29
3 months ago

ChatGPT Apps: From Chat to Checkout

Aaron Koivunen

Interior Decorating (TypeScript Decorators) thumbnail
29:22
3 months ago

Interior Decorating (TypeScript Decorators)

Michael Dowden

Related videos

Your Docs Are Now AI Infrastructure (Treat Them Like It) thumbnail
9:29
World Congress 2026 Europe • 3 months ago

Your Docs Are Now AI Infrastructure (Treat Them Like It)

Emil Sorensen

Making Documentation AI-Ready: Preparing Your Docs for the LLM Era thumbnail
27:16
World Congress 2026 Europe • 3 months ago

Making Documentation AI-Ready: Preparing Your Docs for the LLM Era

Edvin Teskeredzic

Technical Documentation - How Can I Write Them Better and Why Should I Care? thumbnail
31:23
World Congress 2023 • about 3 years ago

Technical Documentation - How Can I Write Them Better and Why Should I Care?

Hila Fish

Continuous Documentation for Your Code thumbnail
20:19
World Congress 2023 • almost 3 years ago

Continuous Documentation for Your Code

Anastasiia Tymoshchuk

When Agents Meet Legacy: Never Change a Running System thumbnail
28:57
World Congress 2026 Europe • 3 months ago

When Agents Meet Legacy: Never Change a Running System

Michael Friedrich

Code Is Cheap. Software Isn’t. thumbnail
29:55
World Congress 2026 Europe • 3 months ago

Code Is Cheap. Software Isn’t.

Markus Eisele

Related articles

From learning to earning

Jobs that call for the skills explored in this talk.