Swift proof v1

поправил некоторые формулировки, в т.ч. не нужно мн.ч. в словосочетаниях Files list -> file list, files group -> file group.
в коде переменные конечно же не правил.

Author: michaos1

Documentation/REST API.md

@@ -34,10 +34,10 @@ let query = PaginationQuery()
     .stored(true)
     .ordering(.sizeDESC)
     .limit(5)
-// Make files list object
+// Make a list of files object
 let filesList = uploadcare.list()
 
-// Get files list
+// Get file list
 filesList.get(withQuery: query) { (list, error) in
     if let error = error {
         print(error)
@@ -184,7 +184,7 @@ uploadcare.listOfGroups(withQuery: query) { (list, error) in
     print(list ?? "")
 }
 
-// Using GroupsList object
+// Using a GroupsList object
 let groupsList = uploadcare.listOfGroups()
 
 groupsList.get(withQuery: query) { (list, error) in
@@ -250,7 +250,7 @@ uploadcare.getProjectInfo { (project, error) in
 
 ## Secure delivery ([API Reference](https://uploadcare.com/docs/delivery/file_api/#authenticated-urls?utm_source=github&utm_medium=referral&utm_campaign=uploadcare-swift)) ##
 
-This method allows you to get an authenticated URL from your backend by using a redirect.
+This method allows you to get an authenticated URL from your backend by using redirect.
 To answer a request to that URL, your backend should generate an authenticated URL to your file and perform REDIRECT to a generated URL. A redirected URL will be caught and returned in the completion handler of that method.
 
 Example: https://yourdomain.com/{UUID}/ — backend redirects to https://cdn.yourdomain.com/{uuid}/?token={token}&expire={timestamp}.
@@ -288,7 +288,7 @@ uploadcare.convertDocumentsWithSettings([task1, task2]) { (response, error) in
 }
 ```
 
-Alternatively you can pass custom "paths" param as array of strings (see ([documentation](https://uploadcare.com/docs/transformations/document_conversion/#convert-url-formatting?utm_source=github&utm_medium=referral&utm_campaign=uploadcare-swift))):
+Alternatively, you can pass custom "paths" param as array of strings (see ([documentation](https://uploadcare.com/docs/transformations/document_conversion/#convert-url-formatting?utm_source=github&utm_medium=referral&utm_campaign=uploadcare-swift))):
 
 ```swift
 uploadcare.convertDocuments([":uuid/document/-/format/:target-format/"]) { (response, error) in
@@ -347,7 +347,7 @@ uploadcare.convertVideosWithSettings([task1, task2]) { (response, error) in
 }
 ```
 
-Alternatively you can pass custom "paths" param as array of strings (see ([documentation](https://uploadcare.com/docs/transformations/video_encoding/#process-url-formatting?utm_source=github&utm_medium=referral&utm_campaign=uploadcare-swift))):
+Alternatively, you can pass custom "paths" param as array of strings (see ([documentation](https://uploadcare.com/docs/transformations/video_encoding/#process-url-formatting?utm_source=github&utm_medium=referral&utm_campaign=uploadcare-swift))):
 
 ```swift
 uploadcare.convertVideos([":uuid/video/-/format/ogg/"]) { (response, error) in

Documentation/Upload API.md

@@ -37,7 +37,7 @@ fileForUploading1.upload(withName: "random_file_name.jpg", store: .store) { (res
 // Completion block is optional
 fileForUploading2?.upload(withName: "my_file.jpg", store: .store)
 
-// Or you can just upload data and provide filename
+// Or you can just upload data and provide a filename
 let task = uploadcare.uploadAPI.upload(files: ["random_file_name.jpg": data], store: .store, expire: nil, { (progress) in
     print("upload progress: \(progress * 100)%")
 }) { (resultDictionary, error) in
@@ -58,12 +58,12 @@ task.cancel()
 
 ## Multipart uploads ([API Reference](https://uploadcare.com/api-refs/upload-api/#operation/multipartFileUploadStart/?utm_source=github&utm_medium=referral&utm_campaign=uploadcare-swift)) ##
 
-Multipart Uploads are useful when you are dealing with files larger than 100MB or explicitly want to accelerate uploads. Each Multipart Upload contains 3 steps:
+Multipart Uploads are useful when you are dealing with files larger than 100MB or you explicitly want to accelerate uploads. Each Multipart Upload contains 3 steps:
 1. Start transaction
 2. Upload file chunks concurrently
 3. Complete transaction
 
-You can use this upload method which will run all 3 steps for you:
+You can use this upload method and it'll run all 3 steps for you:
 
 ```swift
 guard let url = Bundle.main.url(forResource: "Mona_Lisa_23mb", withExtension: "jpg") else { return }
@@ -88,6 +88,7 @@ task?.cancel()
 
 // You can pause uploading
 task?.pause()
+
 // To resume uploading
 task?.resume()
 ```
@@ -124,7 +125,7 @@ let task3 = UploadFromURLTask(sourceUrl: url!)
 
 ## Check the status of a file uploaded from URL ([API Reference](https://uploadcare.com/api-refs/upload-api/#operation/fromURLUploadStatus/?utm_source=github&utm_medium=referral&utm_campaign=uploadcare-swift)) ##
 
-Use token that was recieved with Upload files from URLs method:
+Use a token recieved with Upload files from the URLs method:
 
 ```swift
 uploadcare.uploadAPI.uploadStatus(forToken: "UPLOAD_TOKEN") { (status, error) in
@@ -148,7 +149,7 @@ uploadcare.uploadAPI.fileInfo(withFileId: "FILE_UUID") { (file, error) in
 }
 ```
 
-## Create files group ([API Reference](https://uploadcare.com/api-refs/upload-api/#operation/createFilesGroup/?utm_source=github&utm_medium=referral&utm_campaign=uploadcare-swift)) ##
+## Create file group ([API Reference](https://uploadcare.com/api-refs/upload-api/#operation/createFilesGroup/?utm_source=github&utm_medium=referral&utm_campaign=uploadcare-swift)) ##
 
 Uploadcare library provides 2 methods to create a group:
 
@@ -165,7 +166,7 @@ self.uploadcare.uploadAPI.createFilesGroup(files: files) { (response, error) in
 }
 ```
 
-2. Provide an array of files UUIDs:
+2. Provide an array of file UUIDs:
 
 ```swift
 let filesIds: [String] = ["FILE_UUID1", "FILE_UUID2"]
@@ -192,6 +193,6 @@ uploadcare.uploadAPI.filesGroupInfo(groupId: "FILES_GROUP_ID") { (group, error)
 
 ## Secure uploads ([API Reference](https://uploadcare.com/docs/api_reference/upload/signed_uploads/?utm_source=github&utm_medium=referral&utm_campaign=uploadcare-swift)) ##
 
-Requests signing works by default if secret key is provided during SDK initialization. SDK generates a signature internally. The signature is valid for 30 minutes. The new signature is generated automatically when the old one expires.
+Signing requests works by default if a Secret key is provided during SDK initialization. SDK generates a signature internally, and this signature stays valid for 30 minutes. New signatures are generated automatically when older ones expire.
 
-Please notice that signed uploads should be enabled in your project’s settings in the [Uploadcare dashboard](https://uploadcare.com/dashboard/).
+Note that Signed Uploads should be enabled in the project’s settings in your [Uploadcare dashboard](https://uploadcare.com/dashboard/).

README.md

@@ -6,7 +6,7 @@
 
 Uploadcare Swift API client for iOS, iPadOS, tvOS, macOS, and Linux handles uploads and further operations with files by wrapping Uploadcare Upload and REST APIs.
 
-Check out out [Demo App](/Demo).
+Check out our [Demo App](/Demo).
 
 * [Installation](#installation)
 * [Initialization](#initialization)
@@ -44,7 +44,7 @@ To use a stable version, add a dependency to your Cartfile:
 github "uploadcare/uploadcare-swift" "0.1.0"
 ```
 
-To use current dev version:
+To use the current dev version:
 
 ```
 github "uploadcare/uploadcare-swift" "develop"
@@ -78,7 +78,7 @@ let uploadcare = Uploadcare(withPublicKey: "YOUR_PUBLIC_KEY", secretKey: "YOUR_S
 
 ## Using Upload API
 
-Check full [Upload API documentation](https://github.com/uploadcare/uploadcare-swift/blob/master/Documentation/Upload%20API.md) for all available methods.
+Check the [Upload API documentation](https://github.com/uploadcare/uploadcare-swift/blob/master/Documentation/Upload%20API.md) to see all available methods.
 
 Example of direct uploads:
 
@@ -97,7 +97,7 @@ fileForUploading1.upload(withName: "random_file_name.jpg", store: .store) { (res
 // Completion block is optional
 fileForUploading2?.upload(withName: "my_file.jpg", store: .store)
 
-// Or you can just upload data and provide filename
+// Or you can just upload data and provide a filename
 let task = uploadcare.uploadAPI.upload(files: ["random_file_name.jpg": data], store: .store, expire: nil, { (progress) in
     print("upload progress: \(progress * 100)%")
 }) { (resultDictionary, error) in
@@ -118,7 +118,7 @@ task.cancel()
 
 ## Using REST API
 
-Check full [REST API documentation](https://github.com/uploadcare/uploadcare-swift/blob/master/Documentation/REST%20API.md) for all available methods.
+Refer to the [REST API documentation](https://github.com/uploadcare/uploadcare-swift/blob/master/Documentation/REST%20API.md) for all methods.
 
 Example of getting list of files:
 
@@ -128,10 +128,10 @@ let query = PaginationQuery()
     .stored(true)
     .ordering(.sizeDESC)
     .limit(5)
-// Make files list object
+// Make a list of files object
 let filesList = uploadcare.list()
 
-// Get files list
+// Get file list
 filesList.get(withQuery: query) { (list, error) in
     if let error = error {
         print(error)