Skip to content

ci(docs): deploy Pages via artifact method (docs.yml → pages.yml) - #217

Merged
Naruto merged 1 commit into
developfrom
ci/docs-pages-artifact
Jul 10, 2026
Merged

Naruto merged 1 commit into
developfrom
ci/docs-pages-artifact

Conversation

@Naruto

@Naruto Naruto commented Jul 10, 2026

Copy link
Copy Markdown
Collaborator

No description provided.

Replace `mkdocs gh-deploy` (which pushes built HTML to a gh-pages branch)
with the GitHub Actions artifact deploy (upload-pages-artifact +
deploy-pages), matching SSPlayerForWeb / SSPlayerForRenPy. The workflow
file is renamed docs.yml -> pages.yml to match those repos as well.

- Drop contents:write; add pages:write + id-token:write
- Split into build + deploy jobs; PRs still validate with
  `mkdocs build --strict` but skip artifact upload / deploy
- Remove fetch-depth:0 and git-credential setup (only gh-deploy needed them)
- Only the MkDocs site/ output is served (no examples/demos to bundle)

Requires switching Settings > Pages > Source to "GitHub Actions" after merge.
@Naruto
Naruto merged commit cee1031 into develop Jul 10, 2026
2 of 4 checks passed
@Naruto
Naruto deleted the ci/docs-pages-artifact branch July 10, 2026 09:02
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant