abraunegg-onedrive/docs
abraunegg 19b050fa79
Improve --resync warning prompt for clarity and safer operation (#3562)
This update refines the --resync user warning prompt to provide clearer,
more accurate guidance on the behaviour and risks associated with performing a
resynchronisation operation.

Key improvements include:

Explicitly explaining that --resync deletes the client’s local state
database and rebuilds it entirely from the current OneDrive contents.

Accurately describing possible outcomes, including overwrite scenarios,
conflict-driven renames or duplications, increased upload/download activity,
and potential Microsoft Graph API throttling (HTTP 429).

Removing incorrect implications that local-only files may be deleted during
--resync (they will instead be uploaded, unless destructive cleanup modes
are explicitly used).

Strengthening safety guidance by recommending:

Maintaining a current backup of the sync_dir

Running the same command with --dry-run before executing a real --resync

Enabling use_recycle_bin so locally triggered online deletions are preserved

Improved formatting and readability for terminal output.

This change enhances user understanding, reduces the likelihood of accidental
data loss, and aligns runtime messaging with the client’s actual synchronisation
logic and documented behaviour.
2025-12-12 12:47:29 +11:00
..
images Update broken link for FreeDesktop.org Trash Specification (#3550) 2025-11-27 18:46:41 +11:00
puml Update Documentation - clarify --local-first (#3293) 2025-05-25 11:55:47 +10:00
advanced-usage.md Clarify using .nosync in mounted directories (#3401) 2025-07-31 06:41:16 +10:00
application-config-options.md Improve --resync warning prompt for clarity and safer operation (#3562) 2025-12-12 12:47:29 +11:00
application-security.md OneDrive Client for Linux v2.5.0 (#2805) 2024-09-16 11:14:46 +10:00
build-rpm-howto.md Update minimum compiler version details (#3330) 2025-06-10 13:31:45 +10:00
business-shared-items.md Fix spelling problems as identified by GitHub Action check-spelling (#2946) 2024-11-04 11:32:18 +11:00
client-architecture.md Improve --resync warning prompt for clarity and safer operation (#3562) 2025-12-12 12:47:29 +11:00
contributing.md Implement FR #2472: Add gdc support (#3213) 2025-04-16 19:03:12 +10:00
docker.md Implement FR #3491: Add ONEDRIVE_THREADS Docker option (#3494) 2025-10-28 05:55:08 +11:00
install.md Add MX Linux (#3532) 2025-11-14 06:49:02 +11:00
known-issues.md OneDrive Client for Linux v2.5.0 (#2805) 2024-09-16 11:14:46 +10:00
national-cloud-deployments.md OneDrive Client for Linux v2.5.0 (#2805) 2024-09-16 11:14:46 +10:00
podman.md Implement FR #3491: Add ONEDRIVE_THREADS Docker option (#3494) 2025-10-28 05:55:08 +11:00
privacy-policy.md Update Security Documents (#2484) 2023-09-11 07:26:14 +10:00
sharepoint-libraries.md OneDrive Client for Linux v2.5.0 (#2805) 2024-09-16 11:14:46 +10:00
terms-of-service.md Update Documentation (#3510) 2025-11-05 10:35:42 +11:00
ubuntu-package-install.md Add MX Linux (#3532) 2025-11-14 06:49:02 +11:00
usage.md Improve --resync warning prompt for clarity and safer operation (#3562) 2025-12-12 12:47:29 +11:00
webhooks.md Fix spelling problems as identified by GitHub Action check-spelling (#2946) 2024-11-04 11:32:18 +11:00