Generate top-level and individual API reference docs for all SDK clients

CONTRIBUTING.md

@@ -1,3 +1,4 @@
+<!-- --8<-- [start:docs] -->
 # Contributing Guidelines
 
 Thank you for your interest in contributing to our project. Whether it's a bug report, new feature, correction, or additional
@@ -53,7 +54,7 @@ opensource-codeofconduct@amazon.com with any additional questions or comments.
 ## Security issue notifications
 If you discover a potential security issue in this project we ask that you notify AWS/Amazon Security via our [vulnerability reporting page](http://aws.amazon.com/security/vulnerability-reporting/). Please do **not** create a public github issue.
 
-
+<!-- --8<-- [end:docs] -->
 ## Licensing
 
 See the [LICENSE](LICENSE) file for our project's licensing. We will ask you to confirm the licensing of your contribution.

README.md

@@ -1,4 +1,5 @@
 ## AWS SDK for Python
+<!-- --8<-- [start:docs] -->
 [![Apache 2 licensed][apache-badge]][apache-url]
 
 [apache-badge]: https://img.shields.io/badge/license-APACHE2-blue.svg
@@ -29,6 +30,7 @@ features we are actively working on.
 You can provide feedback or report a bug by submitting an [issue](https://github.com/awslabs/aws-sdk-python/issues/new/choose).
 This is the preferred mechanism to give feedback so that other users can engage in the conversation, +1 issues, etc.
 
+<!-- --8<-- [end:docs] -->
 ## Security
 
 See [CONTRIBUTING](CONTRIBUTING.md#security-issue-notifications) for more information.

docs/contributing/index.md

@@ -0,0 +1,4 @@
+--8<-- "CONTRIBUTING.md:docs"
+## Licensing
+
+See the [LICENSE](https://github.com/awslabs/aws-sdk-python/blob/develop/LICENSE) file for our project's licensing. We will ask you to confirm the licensing of your contribution.

docs/index.md

@@ -0,0 +1,3 @@
+# AWS SDK for Python
+
+--8<-- "README.md:docs"

docs/stylesheets/extra.css

@@ -0,0 +1,3 @@
+.md-grid {
+    max-width: 70rem;
+}

mkdocs.yml

@@ -0,0 +1,82 @@
+site_name: AWS SDK for Python
+site_description: Documentation for AWS SDK for Python Clients
+
+copyright: Copyright © 2025, Amazon Web Services, Inc
+repo_name: awslabs/aws-sdk-python
+repo_url: https://github.com/awslabs/aws-sdk-python
+
+theme:
+  name: material
+  palette:
+    - scheme: default
+      primary: white
+      accent: light blue
+      toggle:
+        icon: material/brightness-7
+        name: Switch to dark mode
+    - scheme: slate
+      primary: black
+      accent: light blue
+      toggle:
+        icon: material/brightness-4
+        name: Switch to light mode
+  features:
+    - navigation.tabs
+    - navigation.tabs.sticky
+    - navigation.top
+    - search.suggest
+    - search.highlight
+    - content.code.copy
+
+plugins:
+  - search
+  - gen-files:
+      scripts:
+        - scripts/generate_doc_stubs.py
+        - scripts/generate_nav.py
+  - mkdocstrings:
+      handlers:
+        python:
+          options:
+            show_source: false
+            show_signature: true
+            show_signature_annotations: true
+            show_root_heading: true
+            show_root_full_path: false
+            show_object_full_path: false
+            show_symbol_type_heading: true
+            show_symbol_type_toc: true
+            show_category_heading: true
+            group_by_category: true
+            separate_signature: true
+            signature_crossrefs: true
+            filters:
+            - "!^_"
+            - "!^deserialize"
+            - "!^serialize"
+
+markdown_extensions:
+  - pymdownx.highlight
+  - pymdownx.inlinehilite
+  - pymdownx.snippets:
+      base_path: ['.']
+  - pymdownx.superfences
+  - pymdownx.tabbed:
+      alternate_style: true
+  - admonition
+  - def_list
+  - toc:
+      permalink: true
+      toc_depth: 3
+
+extra:
+    social:
+    - icon: fontawesome/brands/github
+      link: https://github.com/awslabs/aws-sdk-python
+
+extra_css:
+    - stylesheets/extra.css
+
+validation:
+  nav:
+    omitted_files: ignore

pyproject.toml

@@ -0,0 +1,20 @@
+[project]
+name = "aws-sdk-python"
+version = "0.1.0"
+description = "Add your description here"
+readme = "README.md"
+requires-python = ">=3.12"
+dependencies = [
+    "mkdocs-awesome-pages-plugin>=2.10.1",
+]
+
+[dependency-groups]
+dev = [
+    "mkdocs-awesome-pages-plugin>=2.10.1",
+]
+docs = [
+    "mkdocs==1.6.1",
+    "mkdocstrings[python]==0.30.1",
+    "mkdocs-material==9.7.0",
+    "mkdocs-gen-files>=0.5.0",
+]