docs: lead with post-start hooks instead of post-create#733
Merged
Conversation
Reorders documentation to recommend post-start (background) as the default choice, with post-create (blocking) for when something must complete before post-start hooks or --execute run. Changes: - Hook types table: post-start listed first - Section order: ### post-start before ### post-create - Comparison section: renamed to "post-start vs post-create" - post-start example: now includes copy + server (background tasks) - post-create example: now shows install + env (things post-start depends on) - wt step copy-ignored: Setup section uses post-start Co-Authored-By: Claude <noreply@anthropic.com>
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
1 participant
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.
Summary
Reorders documentation to recommend
post-start(background) as the default choice for hooks, withpost-create(blocking) reserved for when something must complete beforepost-starthooks or--executerun.post-startlisted first### post-startbefore### post-createpost-startexample: now showscopy+server(background tasks)post-createexample: now showsinstall+env(things post-start depends on)post-createdescription: "Tasks that must complete beforepost-starthooks or--executerun"wt step copy-ignored: Setup section and description updated to usepost-startTest plan
wt hook --helpshows correct ordering and exampleswt step copy-ignored --helpshows updated guidance🤖 Generated with Claude Code