How to Improve Your Documentation with AI (CircleCI Chunk Tutorial)
AI coding assistants help you ship features fast, but documentation almost never keeps up. In this Ship Smarter session, we'll show you how CircleCI's Chunk autonomous CI/CD agent automatically analyzes your codebase, identifies documentation gaps, and opens a pull request with improvements. No manual writing required.
In this video:
- Why AI-assisted development makes documentation debt worse
- How Chunk works at the CI/CD layer to see your whole codebase at once
- Setting up Chunk on your CircleCI project in minutes
- Running the "Improve Documentation" preset and reviewing the results
- Writing targeted prompts for specific modules, READMEs, and audiences
Demo repo: https://circle.ci/4dirM79
Quick start guide: https://circle.ci/4cTrKCe
Tutorial: https://circle.ci/4d4AoN2
Try Chunk: https://circle.ci/42kUDkz
Get started with CircleCI: https://circle.ci/4upWSio
00:00 Why documentation always falls behind
01:13 What we're building today
01:20 Setup: Fork the demo repo
02:19 Connect your repo to CircleCI
04:06 Enable Chunk and select your AI model
04:54 Running the Improve Documentation preset
06:05 Reviewing Chunk's output
07:38 Reviewing the PR on GitHub
08:28 Writing more targeted prompts
09:02 Chunk + MCP server: the bigger picture
09:27 Wrap up + next steps