You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@airflow.apache.org by "choo121600 (via GitHub)" <gi...@apache.org> on 2026/05/16 12:25:49 UTC
[PR] docs(setup-steward): add user-facing unadopt page [airflow-steward]
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: commits-unsubscribe@airflow.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] docs(setup): add user-facing unadopt page [airflow-steward]
Posted by "potiuk (via GitHub)" <gi...@apache.org>.
potiuk merged PR #183:
URL: https://github.com/apache/airflow-steward/pull/183
--
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: commits-unsubscribe@airflow.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org