Merge branch 'master' into dongie/endpoint-not-acquired-fix

Author: dagnir

.all-contributorsrc

@@ -1138,6 +1138,15 @@
       "contributions": [
         "maintenance"
       ]
+    },
+    {
+      "login": "humanzz",
+      "name": "Ahmed Kamel",
+      "avatar_url": "https://avatars.githubusercontent.com/u/5001?v=4",
+      "profile": "https://github.com/humanzz",
+      "contributions": [
+        "code"
+      ]
     }
   ],
   "contributorsPerLine": 7,

CONTRIBUTING.md

@@ -8,6 +8,7 @@ __Jump To:__
 * [Bug Reports](#bug-reports)
 * [Feature Requests](#feature-requests)
 * [Code Contributions](#code-contributions)
+* [Running CI Checks Locally](#running-ci-checks-locally)
 * [Additional Resources](#additional-resources)
 
 ## Bug Reports
@@ -146,6 +147,45 @@ days, especially if it's a large or complex one. If, after a week, your Pull
 Request has not had any engagement from the SDK team, feel free to ping a
 member to ask for a review.
 
+### Running CI Checks Locally
+
+CI runs unit tests, integration tests, Checkstyle, and SpotBugs on every PR. 
+While not required before opening a PR, running these locally helps catch issues early and speeds up the code review cycle.
+
+#### Unit Tests (Full Build)
+
+```sh
+mvn clean install
+```
+
+To iterate faster, build only the modules you're working on:
+
+```sh
+mvn clean install -pl :dynamodb-enhanced -am
+```
+
+#### Integration Tests
+
+Integration tests make real AWS API calls and will incur costs to the account owner. 
+They require an `aws-test-account` profile in `~/.aws/credentials`:
+
+```
+[aws-test-account]
+aws_access_key_id = <your-access-key>
+aws_secret_access_key = <your-secret-key>
+```
+
+If this profile is not found, the tests fall back to the default credential provider chain.
+
+```sh
+# All integration tests
+mvn clean install -Dskip.unit.tests -P integration-tests -Dfindbugs.skip -Dcheckstyle.skip
+
+# Specific module
+mvn clean install -pl :dynamodb-enhanced -am -Dskip.unit.tests -P integration-tests -Dfindbugs.skip -Dcheckstyle.skip
+```
+
+
 ## Additional Resources
 We maintain [docs](docs/README.md) where information like design decisions, internal
 architecture, and style conventions are documented that you may find helpful

README.md

@@ -3,7 +3,7 @@
 [![Maven](https://img.shields.io/maven-central/v/software.amazon.awssdk/s3.svg?label=Maven)](https://search.maven.org/search?q=g:%22software.amazon.awssdk%22%20AND%20a:%22s3%22)
 [![codecov](https://codecov.io/gh/aws/aws-sdk-java-v2/branch/master/graph/badge.svg)](https://codecov.io/gh/aws/aws-sdk-java-v2)
 <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
-[![All Contributors](https://img.shields.io/badge/all_contributors-125-orange.svg?style=flat-square)](#contributors-)
+[![All Contributors](https://img.shields.io/badge/all_contributors-127-orange.svg?style=flat-square)](#contributors-)
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 
 The **AWS SDK for Java 2.0** is a rewrite of 1.0 with some great new features. As with version 1.0,
@@ -352,6 +352,9 @@ Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/d
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/ryanyuan"><img src="https://avatars.githubusercontent.com/u/7124535?v=4?s=100" width="100px;" alt="Ryan Yuan"/><br /><sub><b>Ryan Yuan</b></sub></a><br /><a href="https://github.com/aws/aws-sdk-java-v2/commits?author=ryanyuan" title="Documentation">📖</a></td>
       <td align="center" valign="top" width="14.28%"><a href="https://github.com/salmanmkc"><img src="https://avatars.githubusercontent.com/u/32169182?v=4?s=100" width="100px;" alt="Salman Chishti"/><br /><sub><b>Salman Chishti</b></sub></a><br /><a href="#maintenance-salmanmkc" title="Maintenance">🚧</a></td>
     </tr>
+    <tr>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/humanzz"><img src="https://avatars.githubusercontent.com/u/5001?v=4?s=100" width="100px;" alt="Ahmed Kamel"/><br /><sub><b>Ahmed Kamel</b></sub></a><br /><a href="https://github.com/aws/aws-sdk-java-v2/commits?author=humanzz" title="Code">💻</a></td>
+    </tr>
   </tbody>
 </table>
 

docs/user-agent.md

@@ -0,0 +1,21 @@
+# User Agent
+
+## Additional Metadata
+
+The table below documents additional metadata the SDK may include in the `User-Agent` header of a request. These take the form of `md/[name]#[value]` in the request.
+
+|Name|Value(s)|Description|
+|---|---|---|
+|`rb`||The request body implementation. This includes `ContentStreamProvider` for sync clients, and `AsyncRequestBody` for async clients.|
+||`f`|"File". The body implementation reads from a file.|
+||`b`|"Bytes". The body implementation reads from a byte array.|
+||`c`|"String" The body implementation reads from a string. |
+||`s`|"Stream". The body implementation reads from an `InputStream`.|
+||`p`|"Publisher". The body implementation reads from an `SdkPublisher`.|
+||`u`|"unknown"|
+|`rt`||The response transformer implementation. This includes `ResponseTransformer` for sync clients, and `AsyncResponseTransformer` for async clients.|
+||`f`|"File". The response transformer writes the response body to a file.|
+||`b`|"Bytes". The response transformer writes the response body to a byte array.|
+||`s`|"Stream". The response transformer adapts the response body to an `InputStream`.|
+||`p`|"Publisher". The response transformer adapts the response body to an `SdkPublisher`.|
+||`u`|"unknown"|