Temp Docs Testing

jonathan343 · jonathan343 · commit 349caa900da9 · 2025-07-11T11:34:09.000-04:00
diff --git a/clients/aws-sdk-bedrock-runtime/README.md b/clients/aws-sdk-bedrock-runtime/README.md
@@ -1,4 +1,4 @@
-## Amazon Bedrock Runtime Client
+# Amazon Bedrock Runtime Client
 
 The `aws_sdk_bedrock_runtime` client is still under active developement.
 Changes may result in breaking changes prior to the release of version
@@ -10,4 +10,4 @@ Documentation is available in the `/docs` directory of this package.
 Pages can be built into portable HTML files for the time being. You can
 follow the instructions in the docs [README.md](https://github.com/awslabs/aws-sdk-python/blob/main/clients/aws-sdk-bedrock-runtime/docs/README.md).
 
-For high-level documentation, you can view the [`dev-guide`](https://github.com/awslabs/aws-sdk-python/tree/main/dev-guide) at the top level of this repo.
+For high-level documentation, you can view the [`dev-guide`](https://github.com/awslabs/aws-sdk-python/tree/main/dev-guide) at the top level of this repo.                      
diff --git a/clients/aws-sdk-bedrock-runtime/uv.lock b/clients/aws-sdk-bedrock-runtime/uv.lock
diff --git a/docs/assets/aws-logo-white.png b/docs/assets/aws-logo-white.png
diff --git a/docs/clients/aws-sdk-bedrock-runtime.md b/docs/clients/aws-sdk-bedrock-runtime.md
@@ -0,0 +1 @@
+::: aws_sdk_bedrock_runtime
diff --git a/docs/clients/aws-sdk-bedrock-runtime/about.md b/docs/clients/aws-sdk-bedrock-runtime/about.md
@@ -0,0 +1 @@
+--8<-- "clients/aws-sdk-bedrock-runtime/README.md"
diff --git a/docs/clients/aws-sdk-bedrock-runtime/clients.md b/docs/clients/aws-sdk-bedrock-runtime/clients.md
@@ -0,0 +1 @@
+::: aws_sdk_bedrock_runtime.client
diff --git a/docs/clients/aws-sdk-python.md b/docs/clients/aws-sdk-python.md
@@ -0,0 +1 @@
+--8<-- "clients/aws-sdk-python/README.md"
diff --git a/docs/index.md b/docs/index.md
@@ -0,0 +1 @@
+--8<-- "README.md"
diff --git a/docs/overrides/main.html b/docs/overrides/main.html
@@ -0,0 +1,13 @@
+{% extends "base.html" %}
+
+{% block announce %}
+  <style>
+    .md-banner__inner {
+      margin: 0.25rem auto !important;
+    }
+  </style>
+  <link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Material+Symbols+Outlined:opsz,wght,FILL,GRAD@24,400,0,0&icon_names=warning" />
+  <div style="display: flex;align-items: center;">
+    <span class="material-symbols-outlined">warning</span>This project is in an experimental state and should not be used in production!
+  </div>
+{% endblock %}
diff --git a/docs/requirements.txt b/docs/requirements.txt
@@ -0,0 +1,2 @@
+mkdocs-material
+mkdocstrings-python
diff --git a/docs/stylesheets/extra.css b/docs/stylesheets/extra.css
@@ -0,0 +1,4 @@
+[data-md-color-primary=black] .md-banner {
+    background-color: #ffec3d;
+    color: black;
+}
diff --git a/mkdocs.yml b/mkdocs.yml
@@ -0,0 +1,92 @@
+# Project Information
+site_name: AWS SDK for Python
+watch: [README.md]
+
+# Copyright
+copyright: Copyright &copy; 2025, Amazon Web Services, Inc
+
+# Repository
+repo_name: awslabs/aws-sdk-python
+repo_url: https://github.com/awslabs/aws-sdk-python
+
+# Theme
+theme:
+  name: material
+  custom_dir: docs/overrides
+  logo: assets/aws-logo-white.png
+  palette:
+    # Palette toggle for automatic mode
+    - media: "(prefers-color-scheme)"
+      toggle:
+        icon: material/brightness-auto
+        name: Switch to light mode
+
+    # Palette toggle for light mode
+    - media: "(prefers-color-scheme: light)"
+      scheme: default
+      primary: black
+      toggle:
+        icon: material/brightness-7
+        name: Switch to dark mode
+
+    # Palette toggle for dark mode
+    - media: "(prefers-color-scheme: dark)"
+      scheme: slate
+      primary: black
+      toggle:
+        icon: material/brightness-4
+        name: Switch to system preference
+  features:
+    - navigation.top
+    - navigation.footer
+    - content.code.copy
+    - announce.dismiss
+
+# Plugins
+plugins:
+- search
+- mkdocstrings:
+    handlers:
+      python:
+        paths: [clients/*/src]
+        options:
+          show_submodules: true
+          show_symbol_type_heading: true
+          show_symbol_type_toc: true
+
+# Navigation
+nav:
+  - index.md
+  - aws-sdk-python:
+    -  About: clients/aws-sdk-python.md
+  - aws-sdk-bedrock-runtime:
+    -  About: clients/aws-sdk-bedrock-runtime/about.md
+    -  Client: clients/aws-sdk-bedrock-runtime/clients.md
+#  - Designs:
+#      - auth: designs/auth.md
+#      - documents: designs/documents.md
+#      - event-streams: designs/event-streams.md
+#      - exceptions: designs/exceptions.md
+#      - http-interfaces: designs/http-interfaces.md
+#      - retries: designs/retries.md
+#      - serialization: designs/serialization.md
+#      - shapes: designs/shapes.md
+
+# Extensions
+markdown_extensions:
+  - admonition
+  - pymdownx.highlight:
+      anchor_linenums: true
+      line_spans: __span
+      pygments_lang_class: true
+  - pymdownx.inlinehilite
+  - pymdownx.snippets
+  - pymdownx.superfences
+
+# Extras
+extra:
+  social:
+  - icon: fontawesome/brands/github
+    link: https://github.com/awslabs/aws-sdk-python
+extra_css:
+  - stylesheets/extra.css

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	`+--8<-- "clients/aws-sdk-bedrock-runtime/README.md"`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	`+--8<-- "clients/aws-sdk-python/README.md"`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,2 @@`
	`1`	`+mkdocs-material`
	`2`	`+mkdocstrings-python`