Improve readme structure

- Take test case headings one level up.
- Improve notes on testing scope.
- Update/fix notes on nested folders from last commit.

Signed-off-by: Fon E. Noel NFEBE <[email protected]>

Author: nfebe

README.md

@@ -34,8 +34,8 @@ Run `./upload-test.py test-tree/apod --archive-path "/archives/rclone QA 1 (0a0j
 
 ## Testing scope
 
-The scope of testing here verifies the possibility of correctly uploading and downloading
- a finite set of file types in a particular size range to [Permanent.org](Permanent.org) using [rclone](https://rclone.org/)
+The scope of testing via the test cases documented below verifies the possibility of correctly uploading and downloading
+ a defined set of file types in a particular size range to [Permanent.org](Permanent.org) using [rclone](https://rclone.org/)
  which talks to permanent using the [SFTP service](https://github.com/PermanentOrg/sftp-service)
 
 ### What file types are tested?
@@ -46,9 +46,9 @@ The scope of testing here verifies the possibility of correctly uploading and do
 - Videos in `.mp4`, `.webm`, `.gifs` and `.3gp` common in mobile devices.
 - Executable files in `.exe`, `.run`, `.sh`, `.dep` and extension-less bin executables.
 
-### What test cases are covered?
+## Test Cases?
 
-#### Challenging Names
+### Challenging Names
 
 Run `./generate-tree.py` to generate test data, which will be placed
 in a new subdirectory named `test-tree/challenging-names`.
@@ -60,13 +60,13 @@ first, of course).  See the long comment at the top of
 [upload-test.sh](upload-test.sh) for information about what it's
 trying to do and what problems we know about so far.
 
-#### Duplicates
+### Duplicates
 
 A duplicate is a file/folder with exactly the same name. Of course this is not possible on regular file systems but Permanent does support it.
 There is a deduplication algorithm from Permanent that the `sftp-service` relies to ensure that files with identical names on Permanent won't be 
  be considered as the same on regular file systems.
 
-##### How test duplicate
+#### How test duplicate
 
 - Create a folder in the test archive of the remote (permanent.org or permanent.dev depending on your test target) e.g 'duplicates'.
 - Upload at least two copies of multiple identical files into the folder `duplicates` for example (`file.txt`, `file.txt`, `file.txt` and `photo.png`, `photo.png` ...)
@@ -75,7 +75,7 @@ There is a deduplication algorithm from Permanent that the `sftp-service` relies
 ```
 `./test-download.py --remote=prod --archive-path "/archives/rclone QA 1 (0a0j-0000)/My Files/" --remote-dir=duplicates`
 ```
-##### Expected results
+#### Expected results
 
 - Check downloads folder in `test-tree/downloads` and ensure that results looks like:
 
@@ -89,19 +89,19 @@ There is a deduplication algorithm from Permanent that the `sftp-service` relies
 
 0 directories, 5 files
 ```
-##### Multiple Identical Uploads
+#### Multiple Identical Uploads
 
 This test case captures what happens if you sync the same path with unchanged content multiples times.
 
-##### How test identical uploads
+#### How test identical uploads
 
 - Generate challenging names if not generated earlier, see [Challenging Names](#challenging-names)
 
 Run `./upload-test.py test-tree/challenging-names --only=414 --remote-dir=test-414 --log-file=log-duplicate-upload.txt --remote=prod --archive-path="/archives/QA (0a21-0000)/My Files/"`
 
 *Notice the use of the `--only` flag which specifies only files containing the number `414` should be uploaded, you can change this number to follow a string pattern in the generated challenging names but the provide example works just fine.*
 
-##### Expected results
+#### Expected results
 
 - `rclone` should report `Sizes identical` and `Unchanged skipping`
 
@@ -111,8 +111,8 @@ Run `./upload-test.py test-tree/challenging-names --only=414 --remote-dir=test-4
 ```
 - No duplicates should be be seen on Permanent UI.
 
-##### Large uploads
-###### Uploads
+#### Large uploads
+##### Uploads
 
 To test large file (`400MB` +) uploads, a couple of large files are required. Some ready-made test files can be downloaded via:
 
@@ -138,9 +138,9 @@ Once the files are on disk:
 
 Run `./upload-test.py test-tree/special-files/large --remote-dir=large-files --log-file=log-large-files.txt --remote=prod --archive-path="/archives/QA (0a21-0000)/My Files/"`
 
-##### Nested folders/files
+#### Nested folders/files
 
-###### Uploading
+##### Uploading
 
 We have a default nest of folders that goes down 4 levels.
 
@@ -161,19 +161,17 @@ test-tree/misc/nested/
 └── record-level-0.txt
 ```
 
-To test a nest with more levels, simply paste the folder structure inside `test-tree/misc/nested` or manually created more folder levels in the existing nest.
+To test a nest with more levels, simply paste a nested folder structure inside `test-tree/misc/nested` or manually create more folder levels in the existing nest.
 
-###### Downloading
+##### Downloading
 
 *The steps in the upload section above must be completed before this step*
 
 Run
 
 `./test-download.py --remote=prod --archive-path="/archives/rclone QA 1 (0a21-0000)/My Files/" --remote-dir=nested`
 
-- Check downloads folder in `test-tree/downloads` and ensure `downloads/nested` that results looks like the structured previous uploaded in the nested folder upload tests above.
-
-
+Check downloads folder in `test-tree/downloads` and ensure `downloads/nested` that results looks like the structured previous uploaded in the nested folder upload tests above.
 
 
 ### What file types and scenarios are left out?