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 +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 +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

Upcoming sessions on this topic

Open session

World Congress 2026 North America

September 24, 2026 · 11:40–12:10

Tech Leaders Stage

Rethinking Developer Tools for the Agent Era

Han Wang, Sam Bhagwat, Ben Haefele, Ignacio Riesgo

Han Wang
Sam Bhagwat
Ben Haefele
Ignacio Riesgo
Open session

World Congress 2026 North America

September 24, 2026 · 14:10–14:40

Stage 4

Agentic Drift: keeping pace with your agents

John Coghlan

Senior Director, Developer Advocacy at GitLab

John Coghlan
Open session

World Congress 2026 North America

September 23, 2026 · 13:15–15:15

Stage 9

DeepAgents: Build Multi-Agent AI Systems That Actually Work

Anagha Rumade, Anjana Umapathy, Apoorva Jaiswal

Anagha Rumade
Anjana Umapathy
Apoorva Jaiswal
Open session

World Congress 2026 North America

September 24, 2026 · 13:30–15:30

Stage 8

The Developer's Guide to an Agentic Git Forge

Lizzie Siegle, Evis Drenova

Lizzie Siegle
Evis Drenova
Open session

World Congress 2026 North America

September 25, 2026 · 13:30–14:00

Stage 6

The Autonomous Pull Request: Let Agents Ship Without Surrendering Control

Sam Jarvinen

Senior Solutions Engineer, GitHub

Sam Jarvinen
Open session

World Congress 2026 North America

September 24, 2026 · 16:10–16:40

Stage 1

Closing the autonomous software development loop

Justin Halsall, Scott Voigt

Justin Halsall
Scott Voigt

Related videos

Your Docs Are Now AI Infrastructure (Treat Them Like It) thumbnail
9:29
World Congress 2026 Europe • 2 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 • 2 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 • almost 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 • 2 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 • 2 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.