jchong9 opened a new pull request, #443:
URL: https://github.com/apache/superset-kubernetes-operator/pull/443
## Summary
<!--
Required. A paragraph explaining what this PR does and why. A reviewer should
understand the motivation and scope from this section alone, without reading
the diff.
-->
Replaces MkDocs with Zensical for building and serving the project
documentation. Since Zensical does not provide a deployment command, the GitHub
Actions workflow now publishes the generated site to gh-pages using Git
worktrees and non-force pushes with rebase/retry handling for concurrent
deployments.
The existing documentation structure and configuration remain unchanged,
preparing the project for planned documentation versioning work.
Related issue: #436
## Details
<!--
Optional. Implementation notes, design decisions, or a bullet list of
individual
changes for smaller PRs. For larger PRs, use a structured summary covering
the
key decisions and their rationale. Delete this section if the summary is
sufficient.
-->
- Replaces the MkDocs dependency with Zensical.
- Updates the Makefile documentation targets:
* make docs-serve
* make docs-build
- Updates the documentation workflow to:
1. Build the site with Zensical.
2. Copy the generated site into a temporary gh-pages worktree.
3. Commit and push without --force.
4. Rebase and retry when another deployment updates gh-pages.
- Regenerates the hash-pinned documentation requirements.
- Updates the development setup guide to reference Zensical.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
