Fix outdated howtos (#628)

Author: ianbotsf

.changes/bd94e49c-61f2-4cf2-814c-77df7f651500.json

@@ -0,0 +1,8 @@
+{
+    "id": "bd94e49c-61f2-4cf2-814c-77df7f651500",
+    "type": "documentation",
+    "description": "Update outdated howto docs to correctly describe client instantiation and client engine configuration",
+    "issues": [
+        "awslabs/aws-sdk-kotlin#620"
+    ]
+}

docs/howto/configuring/endpoints.md

@@ -5,8 +5,7 @@ you can just use the default `EndpointResolver` provided with each service clien
 a custom endpoint though such as working with a pre-release version of a service or access to specific service 
 features not yet modeled in the SDK (e.g. S3 has dual-stack and FIPS endpoints).
 
-
-An [Endpoint Resolver](https://github.com/awslabs/aws-sdk-kotlin/blob/main/aws-runtime/aws-endpoint/common/src/aws/sdk/kotlin/runtime/endpoint/AwsEndpointResolver.kt#L11)
+An [Endpoint Resolver](https://github.com/awslabs/aws-sdk-kotlin/blob/main/aws-runtime/aws-endpoint/common/src/aws/sdk/kotlin/runtime/endpoint/AwsEndpointResolver.kt)
 can be configured to provide custom endpoint resolution logic for service clients. Every
 service client config is generated with an endpoint resolver that can be overridden. The endpoint resolver is given the
 service and region as a string, allowing for the resolver to dynamically drive its behavior. Each service client 
@@ -18,10 +17,9 @@ resolver.
 The following code snippet shows how a service endpoint resolver can be overridden for S3:
 
 ```kotlin
-val sharedConfig = AwsClientConfig.fromEnvironment()
-val client = S3Client(sharedConfig) {
+val client = S3Client.fromEnvironment {
     endpointResolver = AwsEndpointResolver { service, region ->
-       AwsEndpoint("https://mybucket.s3.us-west-2.amazonaws.com", CredentialScope(region = "us-west-2")) 
+        AwsEndpoint("https://mybucket.s3.us-west-2.amazonaws.com", CredentialScope(region = "us-west-2"))
     }
 }
-```
+```

docs/howto/configuring/http-clients.md

@@ -1,33 +1,34 @@
 # Configuring HTTP Clients
 
-By default the AWS SDK for Kotlin uses an HTTP client known as the AWS Common Runtime (CRT) HTTP client. This 
-client was written by AWS to ensure the best experience with AWS services. However customers may choose to override 
-the default HTTP client by specifying an existing [HttpClientEngine](https://github.com/awslabs/smithy-kotlin/blob/main/runtime/protocol/http/common/src/aws/smithy/kotlin/runtime/http/engine/HttpClientEngine.kt) 
-implementation or implementing their own, and referencing that implementation in the service client configuration at 
-the time of client construction.
+By default, the AWS SDK for Kotlin uses an HTTP client from OkHttp. Customers may choose to override the default HTTP
+client by specifying an existing
+[HttpClientEngine](https://github.com/awslabs/smithy-kotlin/blob/main/runtime/protocol/http/common/src/aws/smithy/kotlin/runtime/http/engine/HttpClientEngine.kt)
+implementation or implementing their own and referencing that implementation in the service client configuration at the
+time of client construction.
 
-The SDK provides an additional client, `KtorEngine` via the `aws.smithy.kotlin:http-client-engine-ktor` dependency.
+The SDK provides an additional client called `CrtHttpEngine` via the `aws.smithy.kotlin:http-client-engine-crt`
+dependency. This implementation wraps the [AWS CRT](https://docs.aws.amazon.com/sdkref/latest/guide/common-runtime.html)
+which provides high-performance, cross-platform implementations of common SDK features.
 
 [![Maven][maven-badge]][maven-url]
 
-[maven-badge]: https://img.shields.io/maven-central/v/aws.smithy.kotlin/http-client-engine-ktor.svg?label=Maven
-[maven-url]: https://search.maven.org/search?q=g:aws.smithy.kotlin+a:http-client-engine-ktor
+[maven-badge]: https://img.shields.io/maven-central/v/aws.smithy.kotlin/http-client-engine-crt.svg?label=Maven
+[maven-url]: https://search.maven.org/search?q=g:aws.smithy.kotlin+a:http-client-engine-crt
 
 ## Example
 
-The following code snippet demonstrates constructing an S3 client using the [Ktor OkHttp HTTP client](https://ktor.io/docs/http-client-engines.html#okhttp):
+The following code snippet demonstrates constructing an S3 client using the CRT HTTP client:
 
 `build.gradle.kts`:
 ```kotlin
 dependencies {
-    implementation("aws.smithy.kotlin:http-client-engine-ktor:<version>")
+    implementation("aws.smithy.kotlin:http-client-engine-crt:<version>")
 }
 ```
 
 Application code:
 ```kotlin
-val sharedConfig = AwsClientConfig.fromEnvironment()
-val client = S3Client(sharedConfig) {
-    httpClientEngine = KtorEngine()
+val client = S3Client.fromEnvironment {
+    httpClientEngine = CrtHttpEngine()
 }
-```
+```