From c2c9086fff2f5667f0fb8947852e43b6b349c897 Mon Sep 17 00:00:00 2001
From: John DiSanti <jdisanti@amazon.com>
Date: Thu, 16 Nov 2023 13:35:18 -0800
Subject: [PATCH 1/4] Only output dev preview warning messages for 0.x versions

---
 aws/SDK_README.md.hb                          |  11 +-
 .../smithy/rustsdk/AwsCrateDocsDecorator.kt   |  21 ++-
 .../test/kotlin/AwsCrateDocsDecoratorTest.kt  |  53 ++++++
 .../test/kotlin/SdkCodegenIntegrationTest.kt  |  53 ++++++
 .../amazon/smithy/rustsdk/TestUtil.kt         |   1 +
 .../core/testutil/CodegenIntegrationTest.kt   |   2 +
 .../smithy/rust/codegen/core/testutil/Rust.kt |   3 +-
 .../src/subcommand/hydrate_readme.rs          | 168 +++++++++++++++++-
 8 files changed, 291 insertions(+), 21 deletions(-)

diff --git a/aws/SDK_README.md.hb b/aws/SDK_README.md.hb
index cf0897c35b..09fa2ae5cf 100644
--- a/aws/SDK_README.md.hb
+++ b/aws/SDK_README.md.hb
@@ -5,6 +5,7 @@ It gets instantiated and copied into the build artifacts by the `aws:sdk:assembl
 Available template arguments:
 - `{{sdk_version_<crate_name_in_snake_case>}}` (e.g., `{{sdk_version_aws_config}}` for the `aws-config` crate): the version number of the given crate (just the number, no `v` prefix)
 - `{{msrv}}`: The MSRV Rust compiler version (just the number, no `v` prefix)
+- `{{warning_banner}}`: Show the production warning banner
 --}}
 <!--
 IMPORTANT:
@@ -14,11 +15,14 @@ To update it, edit the `aws/SDK_README.md.hb` Handlebars template in that reposi
 
 # The AWS SDK for Rust [![Docs](https://img.shields.io/badge/docs-blue)](https://awslabs.github.io/aws-sdk-rust/) ![MSRV](https://img.shields.io/badge/msrv-{{msrv}}-red) [![Usage Guide](https://img.shields.io/badge/Developer_Guide-blue)](https://docs.aws.amazon.com/sdk-for-rust/latest/dg/welcome.html)
 
-This repo contains the new AWS SDK for Rust (the SDK) and its [public roadmap](https://github.com/orgs/awslabs/projects/50/views/1).
+This repo contains the AWS SDK for Rust and its [public roadmap](https://github.com/orgs/awslabs/projects/50/views/1).
 
+{{#if warning_banner}}
 **Please Note**: The SDK is currently released as a developer preview, without support or assistance for use on production workloads. Any use in production is at your own risk.
+{{/if}}
 
-The SDK is code generated from [Smithy models](https://awslabs.github.io/smithy/) that represent each AWS service. The code used to generate the SDK can be found in [smithy-rs](https://github.com/smithy-lang/smithy-rs).
+The SDK is code generated from [Smithy models](https://awslabs.github.io/smithy/) that represent each AWS service.
+The code used to generate the SDK can be found in [smithy-rs](https://github.com/smithy-lang/smithy-rs).
 
 ## Getting Started with the SDK
 
@@ -67,7 +71,8 @@ In order to use the SDK, you must already have Rust and Cargo installed. If you
 
 ## Using the SDK
 
-While we're working on the SDK, detailed usage instructions will be added to the [Developer Guide](https://docs.aws.amazon.com/sdk-for-rust/latest/dg/welcome.html). Please suggest additional sections for the guide by opening an issue and describing what you are trying to do.
+While we're working on the SDK, detailed usage instructions will be added to the [Developer Guide](https://docs.aws.amazon.com/sdk-for-rust/latest/dg/welcome.html).
+Please suggest additional sections for the guide by opening an issue and describing what you are trying to do.
 
 ## Getting Help
 * [Developer Guide](https://docs.aws.amazon.com/sdk-for-rust/latest/dg/welcome.html)
diff --git a/aws/sdk-codegen/src/main/kotlin/software/amazon/smithy/rustsdk/AwsCrateDocsDecorator.kt b/aws/sdk-codegen/src/main/kotlin/software/amazon/smithy/rustsdk/AwsCrateDocsDecorator.kt
index 90cf4d6e02..2edb1a9b0f 100644
--- a/aws/sdk-codegen/src/main/kotlin/software/amazon/smithy/rustsdk/AwsCrateDocsDecorator.kt
+++ b/aws/sdk-codegen/src/main/kotlin/software/amazon/smithy/rustsdk/AwsCrateDocsDecorator.kt
@@ -103,12 +103,13 @@ internal class AwsCrateDocGenerator(private val codegenContext: ClientCodegenCon
             else -> rawTemplate(text + "\n", *args)
         }
 
-    private fun docText(
+    internal fun docText(
         includeHeader: Boolean,
         includeLicense: Boolean,
         asComments: Boolean,
     ): Writable = writable {
         val moduleName = codegenContext.settings.moduleName
+        val stableVersion = !codegenContext.settings.moduleVersion.startsWith("0.")
         val description = normalizeDescription(
             codegenContext.moduleName,
             codegenContext.settings.getService(codegenContext.model).getTrait<DocumentationTrait>()?.value ?: "",
@@ -119,14 +120,18 @@ internal class AwsCrateDocGenerator(private val codegenContext: ClientCodegenCon
         if (includeHeader) {
             template(asComments, escape("# $moduleName\n"))
         }
+
+        // TODO(PostGA): Remove warning banner conditionals.
         // NOTE: when you change this, you must also change SDK_README.md.hb
-        template(
-            asComments,
-            """
-            **Please Note: The SDK is currently released as a developer preview, without support or assistance for use
-            on production workloads. Any use in production is at your own risk.**${"\n"}
-            """.trimIndent(),
-        )
+        if (!stableVersion) {
+            template(
+                asComments,
+                """
+                **Please Note: The SDK is currently released as a developer preview, without support or assistance for use
+                on production workloads. Any use in production is at your own risk.**${"\n"}
+                """.trimIndent(),
+            )
+        }
 
         if (description.isNotBlank()) {
             template(asComments, escape("$description\n"))
diff --git a/aws/sdk-codegen/src/test/kotlin/AwsCrateDocsDecoratorTest.kt b/aws/sdk-codegen/src/test/kotlin/AwsCrateDocsDecoratorTest.kt
index aa2485e6ae..7cd935e381 100644
--- a/aws/sdk-codegen/src/test/kotlin/AwsCrateDocsDecoratorTest.kt
+++ b/aws/sdk-codegen/src/test/kotlin/AwsCrateDocsDecoratorTest.kt
@@ -4,10 +4,18 @@
  */
 
 import org.junit.jupiter.api.Assertions.assertEquals
+import org.junit.jupiter.api.Assertions.assertFalse
+import org.junit.jupiter.api.Assertions.assertTrue
 import org.junit.jupiter.api.Test
 import software.amazon.smithy.model.loader.ModelAssembler
+import software.amazon.smithy.model.node.ObjectNode
+import software.amazon.smithy.model.shapes.ShapeId
 import software.amazon.smithy.rust.codegen.client.testutil.testClientCodegenContext
+import software.amazon.smithy.rust.codegen.client.testutil.testClientRustSettings
+import software.amazon.smithy.rust.codegen.core.rustlang.RustWriter
+import software.amazon.smithy.rust.codegen.core.testutil.asSmithyModel
 import software.amazon.smithy.rustsdk.AwsCrateDocGenerator
+import software.amazon.smithy.rustsdk.AwsTestRuntimeConfig
 
 class AwsCrateDocsDecoratorTest {
     private val codegenContext = testClientCodegenContext(ModelAssembler().assemble().unwrap())
@@ -106,4 +114,49 @@ class AwsCrateDocsDecoratorTest {
             ),
         )
     }
+
+    // TODO(PostGA): Remove warning banner conditionals.
+    @Test
+    fun warningBanner() {
+        val context = { version: String ->
+            testClientCodegenContext(
+                model = """
+                    namespace test
+
+                    service Foobaz {
+                    }
+                """.asSmithyModel(),
+                settings = testClientRustSettings(
+                    moduleVersion = version,
+                    service = ShapeId.from("test#Foobaz"),
+                    runtimeConfig = AwsTestRuntimeConfig,
+                    customizationConfig =
+                    ObjectNode.parse(
+                        """
+                        { "awsSdk": {
+                            "awsConfigVersion": "dontcare" } }
+                        """,
+                    ) as ObjectNode,
+                ),
+            )
+        }
+
+        // Test unstable versions first
+        var codegenContext = context("0.36.0")
+        var result = AwsCrateDocGenerator(codegenContext).docText(includeHeader = false, includeLicense = false, asComments = true).let { writable ->
+            val writer = RustWriter.root()
+            writable(writer)
+            writer.toString()
+        }
+        assertTrue(result.contains("The SDK is currently released as a developer preview"))
+
+        // And now stable versions
+        codegenContext = context("1.0.0")
+        result = AwsCrateDocGenerator(codegenContext).docText(includeHeader = false, includeLicense = false, asComments = true).let { writable ->
+            val writer = RustWriter.root()
+            writable(writer)
+            writer.toString()
+        }
+        assertFalse(result.contains("The SDK is currently released as a developer preview"))
+    }
 }
diff --git a/aws/sdk-codegen/src/test/kotlin/SdkCodegenIntegrationTest.kt b/aws/sdk-codegen/src/test/kotlin/SdkCodegenIntegrationTest.kt
index da4f719625..d4bd5e9ab1 100644
--- a/aws/sdk-codegen/src/test/kotlin/SdkCodegenIntegrationTest.kt
+++ b/aws/sdk-codegen/src/test/kotlin/SdkCodegenIntegrationTest.kt
@@ -4,7 +4,10 @@
  */
 
 import org.junit.jupiter.api.Test
+import software.amazon.smithy.rust.codegen.core.rustlang.rust
 import software.amazon.smithy.rust.codegen.core.testutil.asSmithyModel
+import software.amazon.smithy.rust.codegen.core.testutil.integrationTest
+import software.amazon.smithy.rustsdk.awsIntegrationTestParams
 import software.amazon.smithy.rustsdk.awsSdkIntegrationTest
 
 class SdkCodegenIntegrationTest {
@@ -50,4 +53,54 @@ class SdkCodegenIntegrationTest {
     fun smokeTestSdkCodegen() {
         awsSdkIntegrationTest(model) { _, _ -> /* it should compile */ }
     }
+
+    // TODO(PostGA): Remove warning banner conditionals.
+    @Test
+    fun warningBanners() {
+        // Unstable version
+        awsSdkIntegrationTest(
+            model,
+            params = awsIntegrationTestParams().copy(moduleVersion = "0.36.0"),
+        ) { _, rustCrate ->
+            rustCrate.integrationTest("banner") {
+                rust(
+                    """
+                    ##[test]
+                    fn banner() {
+                        use std::process::Command;
+                        use std::path::Path;
+
+                        // Verify we're in the right directory
+                        assert!(Path::new("Cargo.toml").try_exists().unwrap());
+                        let output = Command::new("grep").arg("developer preview").arg("-i").arg("-R").arg(".").output().unwrap();
+                        assert_eq!(0, output.status.code().unwrap(), "it should output the banner");
+                    }
+                    """,
+                )
+            }
+        }
+
+        // Stable version
+        awsSdkIntegrationTest(
+            model,
+            params = awsIntegrationTestParams().copy(moduleVersion = "1.0.0"),
+        ) { _, rustCrate ->
+            rustCrate.integrationTest("no_banner") {
+                rust(
+                    """
+                    ##[test]
+                    fn banner() {
+                        use std::process::Command;
+                        use std::path::Path;
+
+                        // Verify we're in the right directory
+                        assert!(Path::new("Cargo.toml").try_exists().unwrap());
+                        let output = Command::new("grep").arg("developer preview").arg("-i").arg("-R").arg(".").output().unwrap();
+                        assert_eq!(1, output.status.code().unwrap(), "it should _not_ output the banner");
+                    }
+                    """,
+                )
+            }
+        }
+    }
 }
diff --git a/aws/sdk-codegen/src/test/kotlin/software/amazon/smithy/rustsdk/TestUtil.kt b/aws/sdk-codegen/src/test/kotlin/software/amazon/smithy/rustsdk/TestUtil.kt
index 4ea54ceafc..ad08e25aeb 100644
--- a/aws/sdk-codegen/src/test/kotlin/software/amazon/smithy/rustsdk/TestUtil.kt
+++ b/aws/sdk-codegen/src/test/kotlin/software/amazon/smithy/rustsdk/TestUtil.kt
@@ -37,6 +37,7 @@ fun awsTestCodegenContext(model: Model? = null, settings: ClientRustSettings? =
 
 fun awsSdkIntegrationTest(
     model: Model,
+    params: IntegrationTestParams = awsIntegrationTestParams(),
     test: (ClientCodegenContext, RustCrate) -> Unit = { _, _ -> },
 ) =
     clientIntegrationTest(
diff --git a/codegen-core/src/main/kotlin/software/amazon/smithy/rust/codegen/core/testutil/CodegenIntegrationTest.kt b/codegen-core/src/main/kotlin/software/amazon/smithy/rust/codegen/core/testutil/CodegenIntegrationTest.kt
index 5aa33a1ea4..19bd7ddf58 100644
--- a/codegen-core/src/main/kotlin/software/amazon/smithy/rust/codegen/core/testutil/CodegenIntegrationTest.kt
+++ b/codegen-core/src/main/kotlin/software/amazon/smithy/rust/codegen/core/testutil/CodegenIntegrationTest.kt
@@ -21,6 +21,7 @@ import java.util.logging.Logger
 data class IntegrationTestParams(
     val addModuleToEventStreamAllowList: Boolean = false,
     val service: String? = null,
+    val moduleVersion: String = "1.0.0",
     val runtimeConfig: RuntimeConfig? = null,
     val additionalSettings: ObjectNode = ObjectNode.builder().build(),
     val overrideTestDir: File? = null,
@@ -36,6 +37,7 @@ fun codegenIntegrationTest(model: Model, params: IntegrationTestParams, invokePl
         model,
         params.additionalSettings,
         params.addModuleToEventStreamAllowList,
+        params.moduleVersion,
         params.service,
         params.runtimeConfig,
         params.overrideTestDir,
diff --git a/codegen-core/src/main/kotlin/software/amazon/smithy/rust/codegen/core/testutil/Rust.kt b/codegen-core/src/main/kotlin/software/amazon/smithy/rust/codegen/core/testutil/Rust.kt
index 4739061cd3..db1f7fe4b5 100644
--- a/codegen-core/src/main/kotlin/software/amazon/smithy/rust/codegen/core/testutil/Rust.kt
+++ b/codegen-core/src/main/kotlin/software/amazon/smithy/rust/codegen/core/testutil/Rust.kt
@@ -164,6 +164,7 @@ fun generatePluginContext(
     model: Model,
     additionalSettings: ObjectNode = ObjectNode.builder().build(),
     addModuleToEventStreamAllowList: Boolean = false,
+    moduleVersion: String = "1.0.0",
     service: String? = null,
     runtimeConfig: RuntimeConfig? = null,
     overrideTestDir: File? = null,
@@ -174,7 +175,7 @@ fun generatePluginContext(
     val manifest = FileManifest.create(testPath)
     var settingsBuilder = Node.objectNodeBuilder()
         .withMember("module", Node.from(moduleName))
-        .withMember("moduleVersion", Node.from("1.0.0"))
+        .withMember("moduleVersion", Node.from(moduleVersion))
         .withMember("moduleDescription", Node.from("test"))
         .withMember("moduleAuthors", Node.fromStrings("testgenerator@smithy.com"))
         .letIf(service != null) { it.withMember("service", service) }
diff --git a/tools/ci-build/publisher/src/subcommand/hydrate_readme.rs b/tools/ci-build/publisher/src/subcommand/hydrate_readme.rs
index 683a570f40..720e518c64 100644
--- a/tools/ci-build/publisher/src/subcommand/hydrate_readme.rs
+++ b/tools/ci-build/publisher/src/subcommand/hydrate_readme.rs
@@ -9,6 +9,7 @@ use fs_err as fs;
 use handlebars::Handlebars;
 use serde::Serialize;
 use serde_json::json;
+use smithy_rs_tool_common::package::PackageCategory;
 use smithy_rs_tool_common::versions_manifest::VersionsManifest;
 use std::path::PathBuf;
 
@@ -41,15 +42,7 @@ pub fn subcommand_hydrate_readme(
     let template = fs::read_to_string(input)
         .with_context(|| format!("Failed to read README template file at {input:?}"))?;
 
-    let mut context = json!({ "msrv": msrv });
-    for (crate_name, metadata) in versions_manifest.crates {
-        let key = format!("sdk_version_{}", crate_name.replace('-', "_"));
-        context
-            .as_object_mut()
-            .unwrap()
-            .insert(key, serde_json::Value::String(metadata.version));
-    }
-
+    let context = make_context(msrv, &versions_manifest);
     let hydrated = hydrate_template(&template, &context)?;
     fs::write(output, hydrated.as_bytes())
         .with_context(|| format!("Failed to write hydrated README to {:?}", output))?;
@@ -62,10 +55,42 @@ fn hydrate_template<C: Serialize>(template_string: &str, template_context: &C) -
         .context("Failed to hydrate README template")
 }
 
+fn make_context(msrv: &str, versions_manifest: &VersionsManifest) -> serde_json::Value {
+    let mut context = json!({ "msrv": msrv });
+
+    // TODO(PostGA): Remove warning banner conditionals
+    context.as_object_mut().unwrap().insert(
+        "warning_banner".into(),
+        serde_json::Value::Bool(!stable_release(&versions_manifest)),
+    );
+
+    for (crate_name, metadata) in &versions_manifest.crates {
+        let key = format!("sdk_version_{}", crate_name.replace('-', "_"));
+        context
+            .as_object_mut()
+            .unwrap()
+            .insert(key, serde_json::Value::String(metadata.version.clone()));
+    }
+    context
+}
+
+// TODO(PostGA): Remove warning banner conditionals
+fn stable_release(manifest: &VersionsManifest) -> bool {
+    manifest.crates.iter().any(|(_name, version)| {
+        version.category == PackageCategory::AwsSdk && !version.version.starts_with("0.")
+    })
+}
+
 #[cfg(test)]
 mod tests {
     use super::hydrate_template;
+    use crate::subcommand::hydrate_readme::make_context;
     use serde_json::json;
+    use smithy_rs_tool_common::package::PackageCategory;
+    use smithy_rs_tool_common::versions_manifest::{
+        CrateVersion, ManualInterventions, VersionsManifest,
+    };
+    use std::collections::BTreeMap;
 
     #[test]
     fn test_hydrate_template() {
@@ -90,4 +115,129 @@ mod tests {
             hydrated,
         )
     }
+
+    fn version(category: PackageCategory, version: &str) -> CrateVersion {
+        CrateVersion {
+            category,
+            version: version.into(),
+            source_hash: "dontcare".into(),
+            model_hash: None,
+        }
+    }
+    fn make_manifest(crates: &BTreeMap<String, CrateVersion>) -> VersionsManifest {
+        VersionsManifest {
+            smithy_rs_revision: "dontcare".into(),
+            aws_doc_sdk_examples_revision: "dontcare".into(),
+            manual_interventions: ManualInterventions::default(),
+            crates: crates.clone(),
+            release: None,
+        }
+    }
+
+    // TODO(PostGA): Remove warning banner conditionals
+    #[test]
+    fn test_stable_release() {
+        // Validate assumptions about package categories with some precondition checks
+        assert_eq!(
+            PackageCategory::SmithyRuntime,
+            PackageCategory::from_package_name("aws-smithy-runtime"),
+            "precondition"
+        );
+        assert_eq!(
+            PackageCategory::AwsRuntime,
+            PackageCategory::from_package_name("aws-runtime"),
+            "precondition"
+        );
+        assert_eq!(
+            PackageCategory::AwsSdk,
+            PackageCategory::from_package_name("aws-sdk-s3"),
+            "precondition"
+        );
+
+        // With S3 at 0.36, it is not considered stable
+        let mut crates = BTreeMap::new();
+        crates.insert(
+            "aws-smithy-http".to_string(),
+            version(PackageCategory::SmithyRuntime, "0.36.0"),
+        );
+        crates.insert(
+            "aws-smithy-runtime".to_string(),
+            version(PackageCategory::SmithyRuntime, "1.0.0"),
+        );
+        crates.insert(
+            "aws-runtime".to_string(),
+            version(PackageCategory::AwsRuntime, "1.0.0"),
+        );
+        crates.insert(
+            "aws-sdk-s3".to_string(),
+            version(PackageCategory::AwsSdk, "0.36.0"),
+        );
+        let manifest = make_manifest(&crates);
+        assert!(
+            !super::stable_release(&manifest),
+            "it is not stable since S3 is 0.36"
+        );
+
+        // Now with S3 at 1.0, it is considered stable
+        crates.insert(
+            "aws-sdk-s3".to_string(),
+            version(PackageCategory::AwsSdk, "1.0.0"),
+        );
+        let manifest = make_manifest(&crates);
+        assert!(
+            super::stable_release(&manifest),
+            "it is stable since S3 is 1.0"
+        );
+    }
+
+    // TODO(PostGA): Remove warning banner conditionals
+    #[test]
+    fn test_warning_banner() {
+        // First, test with unstable versions
+        let mut crates = BTreeMap::new();
+        crates.insert(
+            "aws-smithy-runtime".to_string(),
+            version(PackageCategory::SmithyRuntime, "1.0.0"),
+        );
+        crates.insert(
+            "aws-runtime".to_string(),
+            version(PackageCategory::AwsRuntime, "1.0.0"),
+        );
+        crates.insert(
+            "aws-sdk-s3".to_string(),
+            version(PackageCategory::AwsSdk, "0.36.0"),
+        );
+        let manifest = make_manifest(&crates);
+
+        let context = make_context("dontcare-msrv", &manifest);
+        assert!(
+            context
+                .as_object()
+                .unwrap()
+                .get("warning_banner")
+                .unwrap()
+                .as_bool()
+                .unwrap(),
+            "it should have the warning banner because it's unstable"
+        );
+
+        // Next, test with stable versions
+        crates.insert(
+            "aws-sdk-s3".to_string(),
+            version(PackageCategory::AwsSdk, "1.0.0"),
+        );
+        let manifest = make_manifest(&crates);
+
+        let context = make_context("dontcare-msrv", &manifest);
+        assert!(
+            !context
+                .as_object()
+                .unwrap()
+                .get("warning_banner")
+                .unwrap()
+                .as_bool()
+                .unwrap(),
+            "it should _not_ have the warning banner because it's unstable"
+        );
+    }
 }

From 231f6aba51c6aabe7658b2474e0865d4bb821274 Mon Sep 17 00:00:00 2001
From: John DiSanti <jdisanti@amazon.com>
Date: Thu, 16 Nov 2023 15:03:04 -0800
Subject: [PATCH 2/4] More readme updates

---
 aws/SDK_README.md.hb                  | 10 ++++++----
 aws/rust-runtime/aws-config/README.md |  5 ++---
 2 files changed, 8 insertions(+), 7 deletions(-)

diff --git a/aws/SDK_README.md.hb b/aws/SDK_README.md.hb
index 09fa2ae5cf..f9aea16f0b 100644
--- a/aws/SDK_README.md.hb
+++ b/aws/SDK_README.md.hb
@@ -21,7 +21,7 @@ This repo contains the AWS SDK for Rust and its [public roadmap](https://github.
 **Please Note**: The SDK is currently released as a developer preview, without support or assistance for use on production workloads. Any use in production is at your own risk.
 {{/if}}
 
-The SDK is code generated from [Smithy models](https://awslabs.github.io/smithy/) that represent each AWS service.
+The SDK is code generated from [Smithy models](https://smithy.io/2.0/index.html) that represent each AWS service.
 The code used to generate the SDK can be found in [smithy-rs](https://github.com/smithy-lang/smithy-rs).
 
 ## Getting Started with the SDK
@@ -71,8 +71,8 @@ In order to use the SDK, you must already have Rust and Cargo installed. If you
 
 ## Using the SDK
 
-While we're working on the SDK, detailed usage instructions will be added to the [Developer Guide](https://docs.aws.amazon.com/sdk-for-rust/latest/dg/welcome.html).
-Please suggest additional sections for the guide by opening an issue and describing what you are trying to do.
+Detailed usage instructions are available in the [Developer Guide](https://docs.aws.amazon.com/sdk-for-rust/latest/dg/welcome.html).
+Suggestions for additional sections or improvements for the guide are welcome. Please open an issue describing what you are trying to do.
 
 ## Getting Help
 * [Developer Guide](https://docs.aws.amazon.com/sdk-for-rust/latest/dg/welcome.html)
@@ -87,7 +87,9 @@ Please suggest additional sections for the guide by opening an issue and describ
 
 The SDK uses **GitHub Issues** to track feature requests and issues with the SDK. In addition, we use **GitHub Projects** to provide users with a high level view of our roadmap and the features we're actively working on.
 
-You can provide feedback or report a bug  by submitting a **GitHub issue**. This is the preferred mechanism to give feedback so that other users can engage in the conversation, +1 issues, etc. Issues you open will be evaluated for our roadmap in the Developer Preview launch.
+You can provide feedback or report a bug  by submitting a **GitHub issue**.
+This is the preferred mechanism to give feedback so that other users can engage in the conversation, +1 issues, etc.
+Issues you open will be evaluated for our roadmap.
 
 ### Contributing
 
diff --git a/aws/rust-runtime/aws-config/README.md b/aws/rust-runtime/aws-config/README.md
index 7f523063d6..1626006dbf 100644
--- a/aws/rust-runtime/aws-config/README.md
+++ b/aws/rust-runtime/aws-config/README.md
@@ -2,8 +2,6 @@
 
 AWS SDK config and credential provider implementations.
 
-**Please Note: The SDK is currently released as an alpha and is intended strictly for feedback purposes only. Do not use this SDK for production workloads.**
-
  The implementations can be used either via the default chain implementation `from_env`/`ConfigLoader` or ad-hoc individual credential and region providers.
 
 A `ConfigLoader` can combine different configuration sources into an AWS shared-config `Config`. The `Config` can then be used to configure one or more AWS service clients.
@@ -46,7 +44,8 @@ tokio = { version = "1", features = ["full"] }
 
 ## Using the SDK
 
-Until the SDK is released, we will be adding information about using the SDK to the [Developer Guide](https://docs.aws.amazon.com/sdk-for-rust/latest/dg/welcome.html). Feel free to suggest additional sections for the guide by opening an issue and describing what you are trying to do.
+Detailed usage instructions are available in the [Developer Guide](https://docs.aws.amazon.com/sdk-for-rust/latest/dg/welcome.html).
+Suggestions for additional sections or improvements for the guide are welcome. Please open an issue describing what you are trying to do.
 
 ## Getting Help
 

From b08a2f4235b371923d721f09f8db3dd5c114c9c3 Mon Sep 17 00:00:00 2001
From: John DiSanti <jdisanti@amazon.com>
Date: Thu, 16 Nov 2023 15:05:19 -0800
Subject: [PATCH 3/4] Sanity check the module version

---
 .../amazon/smithy/rustsdk/AwsCrateDocsDecorator.kt         | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/aws/sdk-codegen/src/main/kotlin/software/amazon/smithy/rustsdk/AwsCrateDocsDecorator.kt b/aws/sdk-codegen/src/main/kotlin/software/amazon/smithy/rustsdk/AwsCrateDocsDecorator.kt
index 2edb1a9b0f..60fa405adc 100644
--- a/aws/sdk-codegen/src/main/kotlin/software/amazon/smithy/rustsdk/AwsCrateDocsDecorator.kt
+++ b/aws/sdk-codegen/src/main/kotlin/software/amazon/smithy/rustsdk/AwsCrateDocsDecorator.kt
@@ -108,8 +108,11 @@ internal class AwsCrateDocGenerator(private val codegenContext: ClientCodegenCon
         includeLicense: Boolean,
         asComments: Boolean,
     ): Writable = writable {
+        val moduleVersion = codegenContext.settings.moduleVersion
+        check(moduleVersion.isNotEmpty() && moduleVersion[0].isDigit())
+
         val moduleName = codegenContext.settings.moduleName
-        val stableVersion = !codegenContext.settings.moduleVersion.startsWith("0.")
+        val stableVersion = !moduleVersion.startsWith("0.")
         val description = normalizeDescription(
             codegenContext.moduleName,
             codegenContext.settings.getService(codegenContext.model).getTrait<DocumentationTrait>()?.value ?: "",
@@ -154,7 +157,7 @@ internal class AwsCrateDocGenerator(private val codegenContext: ClientCodegenCon
             ```toml
             [dependencies]
             aws-config = { version = "$awsConfigVersion", features = ["behavior-version-latest"] }
-            $moduleName = "${codegenContext.settings.moduleVersion}"
+            $moduleName = "$moduleVersion"
             tokio = { version = "1", features = ["full"] }
             ```
 

From 09978298f2bba708637f98a37753efdae533bc32 Mon Sep 17 00:00:00 2001
From: John DiSanti <jdisanti@amazon.com>
Date: Thu, 16 Nov 2023 16:21:49 -0800
Subject: [PATCH 4/4] Fix clippy lint

---
 tools/ci-build/publisher/src/subcommand/hydrate_readme.rs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tools/ci-build/publisher/src/subcommand/hydrate_readme.rs b/tools/ci-build/publisher/src/subcommand/hydrate_readme.rs
index 720e518c64..db9b483f03 100644
--- a/tools/ci-build/publisher/src/subcommand/hydrate_readme.rs
+++ b/tools/ci-build/publisher/src/subcommand/hydrate_readme.rs
@@ -61,7 +61,7 @@ fn make_context(msrv: &str, versions_manifest: &VersionsManifest) -> serde_json:
     // TODO(PostGA): Remove warning banner conditionals
     context.as_object_mut().unwrap().insert(
         "warning_banner".into(),
-        serde_json::Value::Bool(!stable_release(&versions_manifest)),
+        serde_json::Value::Bool(!stable_release(versions_manifest)),
     );
 
     for (crate_name, metadata) in &versions_manifest.crates {