Repository navigation
Publish docs from an isolated worktree - #255
Merged
Merged
Conversation
Build the site locally, then replace the contents of the Netlify branch in a temporary worktree. This keeps the main checkout and its untracked files intact and lets checkout or push failures stop publication. Document the Netlify deployment branch in AGENTS.md.
Keep the Makefile target small and document how to deploy the generated site. Require a clean, current master before publishing so the Netlify branch reflects reviewed documentation. Preserve the isolated worktree and failure handling from the original change.
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
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What changed
make sitenow calls the documentedscripts/publish-site.sh. The script requires a clean, currentmaster, builds the Doctave site, and publishes through an isolated temporary worktree based on the currentnetlifybranch. It preserves the main checkout and untracked files, stops on fetch/build/commit/push errors, and skips a commit when generated content has not changed. The README explains how to use it.This also includes the two Netlify deployment notes added to
AGENTS.md.Verification
doctave build --releasecompleted successfully.sh -n scripts/publish-site.shandgit diff --checkpassed.sitepath, a non-masterbranch, tracked changes, and a stalemaster.This PR changes the publishing command only; it does not push site content to
netlify.