doc(compile): add Long-description sections and tests for --validate and --watch#45295

pelikhan with Copilot wants to merge 2 commits into

maingithub/gh-aw:mainfrom

copilot/document-cli-flagsgithub/gh-aw:copilot/document-cli-flagsCopy head branch name to clipboard