Repository navigation
versioning documentation confusing and incomplete #1141
Description
Activity
cc @schiessle
The current text in
user_manual/files/version_control.rstexplains the expiration schedule and the 2-minute throttle, but never says what actually triggers a new version. A reader finishing the page still won't know whether versions are created on every upload, every edit, or only manually.Missing: a sentence explaining that a version is created whenever a file is uploaded or modified (via the web interface or a sync client), subject to the 2-minute minimum interval between versions.
Currently the user manual (as well as the admin guide) does not give a user unfamiliar with versioning a clear indication of the features and their uses. Much of the discussion relates to automatic deletion of saved versions, without any explanation of how and when versions are created.
Questions that should be addressed are:
For example, the text "Versioning creates backups of files" could read, "The previous version of any file in a Nextcloud server is saved every time it is edited on the server or uploaded by a client". That is, assuming I understand the facts correctly. Otherwise, the actual behavior would need to be clarified. I feel that I ought to understand at least that much after reading the manual.
See the forum discussion I opened earlier.