choo121600 opened a new pull request, #183:
URL: https://github.com/apache/airflow-steward/pull/183
## Summary
This PR adds `docs/setup/unadopt.md`, the adopter-facing counterpart to
`install-recipes.md`, documenting how to remove `apache-steward` from a
repository previously adopted via `/setup-steward adopt`.
While the underlying unadoption behavior already exists via `/setup-steward
unadopt` (`.claude/skills/setup-steward/unadopt.md`), it is not currently
discoverable through public documentation.
This PR addresses that gap by introducing a clear, self-service entry point
for safely detaching the framework, including configuration, hooks, and
residual artifacts.
In open-source tooling, a well-defined unadoption process improves
operational safety by ensuring users can fully and deterministically remove
framework-managed state without relying on internal implementation knowledge.
## What’s covered
### Invocation & safety controls
- `/setup-steward unadopt`
- `--purge-overrides`, `dry-run` support
- Confirmation prompt and safeguards, including explicit user confirmation
### State handling (preserved vs removed)
**Preserved by default:**
- `.apache-steward-overrides/`
- Non-framework symlinks
- Hooks containing additional user-defined logic
**Cleanup targets:**
- Symlinks pointing to framework snapshot paths
- Overlapping `.gitignore` entries
- Post-checkout hooks with framework-only logic
- External (outside-repo) state, with guidance for manual cleanup
## Re-adoption
Pointers are included back to `install-recipes.md` for re-adopting the
framework if needed.
## Test plan
- `docs/setup/README.md` renders with the new entry in the documentation
index
- All intra-document links in `unadopt.md` resolve correctly:
- `install-recipes.md`
- `.claude/skills/setup-steward/unadopt.md`
- `adopt.md`
- Doctoc table of contents matches headings in `unadopt.md`
- This change is documentation-only and does not modify runtime behavior or
CLI implementation
--
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]
