* Update version.

* Update README.

* Add version API.

* Update Gems.

* Update Jazzy docs.

* Update formatting.

* Start refactoring Usage document.

* Bit of work.

* Parameter encoding docs.

* Prep for merge.

* Start refactoring Usage document.

* Bit of work.

* Parameter encoding docs.

* Prep for merge.

* Finish parameter update.

* Header and start response docs.

* Finish updating DataRequest APIs.

* Update Download and Upload sections.

* Fix misspelling, cURL example.

* Update some styling.

* Break up long line.

* More styling.

* Additional styling.

* Update code snippet.

* Remove unnecessary note.

* Update a few bits of styling.

* Clean up headers whitespace.

* Update for HTTP method changes.

* Update docs for AF types, styling updates.

* Add index.

* Update ToC.

* Update README.

* Update note for mutiple handlers.

* Remove parens from closure capture examples.

* Usage Documentation Updates - cnoon Edits (#2929)

* Small updates and edits to the Usage documentation

* Removed unnecessary comma addition in array parameter encoding section

* Add AFError based typealiases, use them.

* Fix reachability thread-safety.

* Update tests for AFError usage.

* Allow os events, they’re important sometimes.

* Add newlines.

* Add SwiftFormat, format everything.

* Remove whitespace formatting target.

* Update sample version.

* Remove whitespace scheme.

* Cleanup some error formatting.

* Further error clean up.

* Add missing doc comment.

* Add background session precondition.

* Disable tests using background session.

* Update URLCache initializer.

* Additional cache update.

* Fix caching, readd CacheHandler tests.

* Refactor reachability implementation.

* Additional cleanup and tests.

* Make listener queue private and pass it when listening.

* Protect previous status.

* Make *Response doubly generic

* Use AFError as default Request and *Response failure type. Wrap all thrown errors into AFError.

* Update tests

* Fix didCompleteTaskNotificaton not being posted

* Avoid nesting AFError

* Fix AFError documentation

* Remove custom URLRequest validation failure reason

* Enforce AFError in RetryResult.doNotRetryWithError

* Simplify perform setup operations

* Rename downloaded file move error case

* Remove unnecessary unwraps

* Use responseDecodable(of:)

* Revert ValidationResult error type

* Clean up whitespace

* Rename AFError casting convenience method

* Fix RetryResult failing test

* Revert validation test

* Revert RetryResult.doNotRetryWithError

* Fix punctuation

* Rename AFError property

* Revert "default" keyword to "or"

* Make switch cases in AFError exhaustive

* Fix AFError descriptions

* Add convenience to unconditionally cast Error to AFError

* Add source URL to AFError.downloadedFileMoveFailed

* Fix newlines

* Remove explicit types

* Use responseDecodable(of:)

* Wrap request adaptation errors and revert tests

* Make *Response doubly generic

* Use regular optionals in tests

* Add URLRequest validation, error, and tests.

* Clean up whitespace.

* Add DataPreprocessor API.

* Make DataPreprocessor a protocol.

* Cleanup whitespace.

* Rename included preprocessors, make public, add tests.

* Add test.

* Update documentation.

* Make HTTPMethod a struct.

* Make HTTPMethod case-sensitive.

* Allow FileManager to be passed to UploadRequest.

* Fix some spelling and inline doc alignment.

* Replace all internal references to AFResult<T> with Result<T, Error>

* Style changes

* Add bulk request cancellation API.

* Resume tasks before cancelling to ensure we get metrics event.

* Make cancellation reliable by resuming before cancel.

* Add queue parameter, remove unnecessary self.

* Fix thread-safety issue for serialization queue usage.

* Add launch screen for example.

* Update for beta 7.

* Update Jazzy docs.

* Connect events to cURL description.

* Clean up and add more tests.

* Add DataEncoding and KeyEncoding. (#2858)

* Appending response serializer now resumes request if finished to handle races (#2862)

* aquiring -> acquiring

* didnt -> didn't

* occured -> occurred

* reponse -> response

* recieves -> receives

* recieve -> receive

* Reverted changes in docs

* Rename internal Result extensions.

* Update Alamofire docs.

* Update AFError docs.

* Cleanup HTTPHeaders.

* ParameterEncoder doc update.

* Whitespace cleanup.

* Update all Request docs, update Destination and cancel handling.

* Refactor download cancellation for common method.

* Start Session documentation.

* Update Gems.

* Update Session queue ids.

* Continue Session docs.

* DataRequest and DownloadRequest docs.

* Add default value note.

* Continue request docs.

* Whitespace cleanup.

* Finish Session docs, update AF docs.

* Small doc cleanup.

* SessionDelegate cleanup.

* Update docs for NetworkReachabilityManager.

* Update docs for MultipartFormData.

* Remove OS check, as compiler warns.

* Update RedirectHandler docs.

* Update RequestInterceptor docs.

* Update ServerTrustEvaluation docs.

* ResponseSerialization doc updates.

* Misc. cleanup.

* Update Gems.

* Add docs for missed public API.

* Make cancel() on DownloadRequest not produce resumeData.

* Fix download events.

* Add missing fileManager parameter.

* Make event tests more explicit.

* Whitespace cleanup.

* ParameterEncoding -> ParameterEncoder

* Fix typo.

* Updates for PR feedback.

* Final PR fixes.

* Add extra line before Returns doc.

* Clean up download cancellation.

As recommended by Apple at WWDC, using os_unfair_lock by reference will lead to a crash rate of up to 1%.

* Added date encoding strategies to `URLEncodedFormEncoder`

* Documentation fixes and error handling in `URLEncodedFormEncoder.DateEncoding`

* Added release notes to the CHANGELOG and bumped the version to 5.0.0-beta.6

* Regenerated jazzy docs for the 5.0.0-beta.6 release

re #2793 #2794

It appears that iTMSTransporter only allows a CFBundleShortVersionString to have at most three non-negative integers. See PR #2799 for more info.

ERROR ITMS-90060: "This bundle is invalid. The value for key CFBundleShortVersionString '5.0.0.beta.5' in the Info.plist file must be a period-separated list of at most three non-negative integers. Please find more information about CFBundleShortVersionString at https://developer.apple.com/documentation/bundleresources/information_property_list/cfbundleshortversionstring"
The call to the iTMSTransporter completed with a non-zero exit status: 1. This indicates a failure.

* Refactor DownloadRequest.cancel to match other requests.

* Add missing DownloadTask eventMonitor calls.

* Fix metrics vs. completion race, duplicate task events.

* Add general tests for all events.

* Update naming of RequestTaskMap methods.

* Switch on the tuple elements separately.

* Update CHANGELOG and version for beta 5.

* Update Gems.

* Update Jazzy docs.

* OS X -> macOS in README.

* Added Notification suffix to Request notification names

* Added notification support for request task events

* Updated did complete task key to match property name

* Moved MultipartUpload to internal type and threshold to MultipartFormData

* Made MultipartUpload final class to prevent subclassing