Merge pull request #299 from flashcatcloud/docs/api-review-20260821 #5
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| name: Lint OpenAPI specs | |
| # Quality gate for the public API reference. Fails on undocumented schema | |
| # properties, epoch time fields without Unix/timestamp wording, string enums | |
| # whose values are not explained in the description, and operations without | |
| # request/response examples. See scripts/lint_openapi.py for the rules. | |
| on: | |
| pull_request: | |
| paths: | |
| - 'api-reference/*.json' | |
| - 'scripts/lint_openapi.py' | |
| - '.github/workflows/openapi-lint.yml' | |
| push: | |
| branches: [main] | |
| paths: | |
| - 'api-reference/*.json' | |
| - 'scripts/lint_openapi.py' | |
| - '.github/workflows/openapi-lint.yml' | |
| jobs: | |
| lint: | |
| runs-on: ubuntu-latest | |
| steps: | |
| - uses: actions/checkout@v7 | |
| - uses: actions/setup-python@v5 | |
| - name: Lint specs | |
| run: python3 scripts/lint_openapi.py |