Runbook: Fix Markdown Linting

Purpose: Fix markdown linting errors in documentation files Owner: Development Team Last Updated: 2025-10-17 Frequency: Before releases, when CI lint workflow fails

Overview

This runbook provides procedures for fixing markdown linting errors using markdownlint-cli2. Our CI/CD runs markdown linting on all *.md files, and errors will block merges to main.

Script Reference: ../../scripts/lint-markdown.sh

Expected duration: 5-10 minutes for most fixes (auto-fix handles ~95% of errors)

Prerequisites

Required Tools