Skip to content

Commit 72c3aa9

Browse files
authored
fix(ci): add OpenAPI spec download to GitHub Pages build (#494)
## Summary - The GitHub Pages deploy workflow (`hugo.yaml`) was missing the `./hack/download_openapi.sh` step before `hugo --gc --minify` - This caused the REST API reference page for v1.2 (and any future versions) to have no `api.json` in production, since v1.2+ rely on build-time download rather than a committed file - Netlify deploy previews were unaffected — `netlify.toml` already includes this step ## Test plan - [ ] Verify Netlify deploy preview shows the v1.2 REST API page at `/docs/v1.2/cozystack-api/rest/` - [ ] After merge, verify production GitHub Pages serves `/docs/v1.2/cozystack-api/api.json` <!-- This is an auto-generated comment: release notes by coderabbit.ai --> ## Summary by CodeRabbit * **Chores** * Enhanced the build pipeline to automatically retrieve and include the latest API specifications during documentation generation, ensuring generated documentation reflects current technical standards. <!-- end of auto-generated comment: release notes by coderabbit.ai -->
2 parents cbea500 + 1bb42db commit 72c3aa9

1 file changed

Lines changed: 4 additions & 0 deletions

File tree

.github/workflows/hugo.yaml

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -50,6 +50,10 @@ jobs:
5050
uses: actions/configure-pages@v4
5151
- name: Install Node.js dependencies
5252
run: "[[ -f package-lock.json || -f npm-shrinkwrap.json ]] && npm ci || true"
53+
- name: Download OpenAPI specs
54+
run: ./hack/download_openapi.sh
55+
env:
56+
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
5357
- name: Build with Hugo
5458
env:
5559
# For maximum backward compatibility with Hugo modules

0 commit comments

Comments
 (0)