Automatically Validate Your Documentation: How We Built a Tutorial Validator

TutorialValidator is an open-source, AI-powered tool that automatically verifies whether software tutorials work end-to-end. It operates as a three-stage pipeline: an Analyst that scrapes tutorial pages and builds a structured test plan, an Executor that runs commands, edits files, and checks HTTP responses in a clean environment, and a Reporter that summarizes results. Originally built to validate ABP Framework tutorials, it supports any publicly accessible tutorial and can run in Docker or local mode. It integrates with OpenAI, Azure OpenAI, and compatible endpoints, and supports developer personas (junior, mid, senior) to catch different classes of documentation issues. The modular architecture makes it easy to extend with new step types, AI providers, or reporting integrations.