Skip to content

Conversation

nptdat
Copy link
Collaborator

@nptdat nptdat commented Oct 23, 2025

Problem

  • Pushing static documents built by mkdocs raises error if the branch gh-pages exists

Cause

  • In github action, all of existing branches including gh-pages are not checkout.
  • So, mkdocs puts documents to the new gh-pages and push to github.
  • Github rejects the push to existing gh-pages

Solution

  • Simply checkout all existing branches in github action (build-doc.yaml)

Results

  • See the build-doc results in the 3 commits, including re-producing & fixing the problem.

@nptdat nptdat requested a review from a team as a code owner October 23, 2025 04:02
@nptdat nptdat merged commit a82532a into main Oct 23, 2025
2 checks passed
@nptdat nptdat deleted the fix/gh-action-build-doc branch October 23, 2025 04:12
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.

2 participants