Skip to content

docs(dev): document uninstall cleanup checklist in repair.rst - #15706

Open
whoalin1 wants to merge 1 commit into
nextcloud:masterfrom
whoalin1:docs-uninstall-cleanup-repair
Open

whoalin1 wants to merge 1 commit into
nextcloud:masterfrom
whoalin1:docs-uninstall-cleanup-repair

Conversation

@whoalin1

@whoalin1 whoalin1 commented Oct 6, 2026 •

Copy link
Copy Markdown

Summary

repair.rst documented the uninstall repair-step type but not what apps should remove, even though the app guidelines require cleanup on uninstall and correct downgrade handling.

  • Add a short uninstall checklist: app config, user preferences, background jobs, appdata files, and optional database tables.
  • Note that uninstall also runs on disable, so destructive drops should stay optional / opt-in.
  • Note that migrations are not rolled back on downgrade; restore from backup if an older app version must be reinstalled after schema changes.

Closes #15685

Test plan

  • Sphinx build of the developer manual succeeds for the repair page
  • New Cleaning up on uninstall section lists the checklist items from the issue
  • Downgrade note states migrations are not rolled back
  • Cross-ref to app-store publishing guidelines resolves

AI disclosure

This PR was drafted with the help of AI coding assistants (Cursor agents / LLM-based tools), including the description. I am responsible for it and happy to rework anything that doesn't fit.

All commits carry an Assisted-by: Cursor:grok-4.7 trailer.

Assisted-by: Cursor:grok-4.7
Signed-off-by: whoalin1 <[email protected]>
@whoalin1
whoalin1 force-pushed the docs-uninstall-cleanup-repair branch from f6bf922 to f288442 Compare October 9, 2026 14:13

This branch has not been deployed

No deployments
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.

Developer manual: what to clean up on uninstall in repair.rst

1 participant