doc: Added first test case documentation.

Signed-off-by: Iva Horn <iva.horn@nextcloud.com>

Author: i2h3

doc/test-cases/README.md

@@ -0,0 +1,25 @@
+# Test Process
+
+This is the first step to improve our release process by introducing a formalized and documented test process as a part of it.
+We keep it simple for now and rely on Markdown files with a fixed template.
+This enables versioning tied directly to our project and also lowers the entry barrier to the whole topic while adding minimal overhead.
+
+**These test cases and the testing as part of the release process is not binding!** We are testing the waters for now and adjust course along the way.
+
+## Categories
+
+- **Smoke Tests** (`/smoke`): Critical functionality that must work for a build to be viable.
+- **Regression Tests** (`/regression`): Core features that should remain stable across releases.
+- **Integration Tests** (`/integration`): Client-server interactions and external dependencies.
+
+For the start, macOS file provider extension test cases are placed in the root folders of these categories.
+They might also be moved to subfolders later on, because the file provider extension is an independent component which shares a lot of potential and redundant test cases with the classic synchronization.
+For example, [TC-1000: Delete a File](./integration/TC-1000-delete-a-file.md) is ambiguous in the project scope but unique in the file provider extension scope.
+Also, the classic synchronization needs to be tested across all supported platforms while the file provider extension is only available on macOS.
+The same applies to the virtual files on Windows.
+Hence some namespacing later on is inevitable.
+
+## Test Case Format
+
+Please have a look at the already existing test cases.
+We are still evaluating which format works best for us.

doc/test-cases/integration/TC-1000-delete-a-file.md

@@ -0,0 +1,35 @@
+# TC-1000: Delete a File
+
+- **Platform:** macOS (File Provider)
+- **Related Issues:** None yet
+
+## Description
+
+A file moved to the trash locally should also be moved likewise on the server while appearing in the local and remote trash.
+
+## Preconditions
+
+- Have a fresh Nextcloud account with the default demo content
+- Have an account and file provider domain set up and ready on macOS
+- macOS trash is empty
+
+## Test Steps
+
+| Step | Action | Expected Result |
+|------|--------|-----------------|
+| 1 | Open Finder | The sidebar lists a location called "Nextcloud" |
+| 2 | Select the "Nextcloud" location | The items in the Nextcloud user's root folder appear in Finder |
+| 3 | Open the context menu on "Nextcloud intro.mp4" | A menu item to move it to the trash is listed |
+| 4 | Select the menu item to move it to the trash | The file disappears from the Finder window |
+| 5 | Open the trash from the Dock | "Nextcloud intro.mp4" now is located there as the only item |
+
+## Expected Results
+
+- The item moved to the trash does not appear in its original location anymore
+- The item moved to the trash does appear in the macOS trash
+- The item moved to the trash does appear in the Nextcloud trash web user interface
+
+## Related Test Cases
+
+- [TC-1001: Restore a File](TC-1001-restore-a-file.md)
+- [TC-1002: Empty the Trash](TC-1002-empty-the-trash.md)

doc/test-cases/integration/TC-1001-restore-a-file.md

@@ -0,0 +1,30 @@
+# TC-1001: Restore a File
+
+- **Platform:** macOS (File Provider)
+- **Related Issues:** None yet
+
+## Description
+
+A previously deleted file can be restored to its original location.
+
+## Preconditions
+
+- The steps of [TC-1000: Delete a File](tc-1000-delete-a-file.md)
+
+## Test Steps
+
+| Step | Action | Expected Result |
+|------|--------|-----------------|
+| 1 | Open the trash from the Dock | "Nextcloud intro.mp4" now is located there as the only item |
+| 2 | Open the context menu on "Nextcloud intro.mp4" | A menu item to restore it is listed |
+| 3 | Select the menu item to restore it | The file disappears from the Finder window which presents the trash content |
+
+## Expected Results
+
+- The item restored from the trash does not appear in the trash anymore
+- The item restored from the trash does appear in the original folder in Finder again
+- The item restored from the trash does appear in the original folder in the Nextcloud web user interface again
+
+## Related Test Cases
+
+- [TC-1000: Delete a File](TC-1000-delete-a-file.md)

doc/test-cases/integration/TC-1002-empty-the-trash.md

@@ -0,0 +1,30 @@
+# TC-1002: Empty the Trash
+
+- **Platform:** macOS (File Provider)
+- **Related Issues:** None yet
+
+## Description
+
+When emptying the trash of macOS, an item should be removed permanently on the local device as on the Nextcloud server.
+
+## Preconditions
+
+- The steps of [TC-1000: Delete a File](tc-1000-delete-a-file.md)
+
+## Test Steps
+
+| Step | Action | Expected Result |
+|------|--------|-----------------|
+| 1 | Open the trash from the Dock | "Nextcloud intro.mp4" now is located there as the only item |
+| 2 | Click the button to empty the trash in the Finder header bar | The trash is emptied and left without content |
+
+## Expected Results
+
+- The deleted item does not appear in its original folder in Finder anymore
+- The deleted item does not appear in the trash in Finder anymore
+- The deleted item does not appear in its original folder in the Nextcloud web user interface anymore
+- The deleted item does not appear in the trash in the Nextcloud web user interface anymore
+
+## Related Test Cases
+
+- [TC-1000: Delete a File](TC-1000-delete-a-file.md)

doc/test-cases/integration/TC-1003-delete-a-file-on-the-server.md

@@ -0,0 +1,32 @@
+# TC-1004: Delete a File on the Server
+
+- **Platform:** macOS (File Provider)
+- **Related Issues:** None yet
+
+## Description
+
+When moving a file into the trash in the Nextcloud web user interface, it should vanish from the file provider domain and not show up in the local trash.
+
+## Preconditions
+
+- Have a file in the Nextcloud account. For clarity, it will be referred to as "Test.md" from here on but can be named arbitrarily
+- Have the client and account set up on a Mac with file provider domain enabled
+- See the file in question in Finder in the file provider domain location
+
+## Test Steps
+
+| Step | Action | Expected Result |
+|------|--------|-----------------|
+| 1 | Open the Nextcloud web user interface | See the file "Test.md" to delete |
+| 2 | Delete the file in the web user interface | The file "Test.md" appears in the trash in the web user interface |
+
+## Expected Results
+
+- The deleted item does not appear in its original folder in Finder anymore
+- The deleted item does also not appear in the trash in Finder
+- The deleted item does not appear in its original folder in the Nextcloud web user interface anymore
+- The deleted item does appear in the trash in the Nextcloud web user interface
+
+## Related Test Cases
+
+- [TC-1004: Empty the Trash on the Server](TC-1004-empty-the-trash-on-the-server.md)

doc/test-cases/integration/TC-1004-empty-the-trash-on-the-server.md

@@ -0,0 +1,29 @@
+# TC-1004: Empty the Trash on the Server
+
+- **Platform:** macOS (File Provider)
+- **Related Issues:** None yet
+
+## Description
+
+When emptying the trash in the Nextcloud web user interface, a previously and locally deleted file should also vanish from the local trash.
+
+## Preconditions
+
+- The steps of [TC-1000: Delete a File](tc-1000-delete-a-file.md)
+
+## Test Steps
+
+| Step | Action | Expected Result |
+|------|--------|-----------------|
+| 1 | Open the trash in the Nextcloud web user interface | See the file "Nextcloud intro.mp4" to delete |
+| 2 | Empty the deleted files in the Nextcloud web user interface | All items disappear from the user interface |
+
+## Expected Results
+
+- The item does not appear in its original location anymore
+- The item does appear in the macOS trash
+- The item no longer appears in the Nextcloud web user interface listing the trash content
+
+## Related Test Cases
+
+- [TC-1000: Delete a File](tc-1000-delete-a-file.md)