API style guides compared

Compare Haufe-Lexware, Zalando, and Google AIP against executable CI OpenAPI rules.

Enforcement capabilities

How static markdown guides compare with automated Pull Request validation.

CriteriaHaufe-Lexware Style GuideZalando GuidelinesGoogle AIPapi-design-principles
FormatStatic Markdown docsStatic docs (+ Zally server)Static AIP docs (+ proto linter)Handbook + zero-dependency Python CLI
OpenAPI JSON & YAMLNo validatorRequires Zally Java/DockerProtobuf/gRPC focusedBuilt-in JSON + YAML linter
GitHub Action + SARIFNoNoCustom setupBuilt-in action.yml + SARIF 2.1.0
Breaking Change DiffNoNobuf / proto onlyBuilt-in --diff base head
Browser ValidatorNoNoNoClient-side GitHub Pages UI