Replace Sphinx doc gen with MkDocs and Markdown

Author: arandito

.github/workflows/ci.yml

@@ -38,6 +38,11 @@ jobs:
           activate-environment: true
           enable-cache: true
 
+      - name: Install pandoc
+        uses: pandoc/actions/setup@v1
+        with:
+          version: 3.8.2
+
       - name: Setup workspace
         run: |
           make install

README.md

@@ -112,12 +112,13 @@ With both files your project directory should look like this:
 
 The code generator libraries have not been published yet, so
 you'll need to build it yourself. To build and run the generator, you will need
-the following prerequisites:
+the following prerequisites installed in your environment:
 
 * [uv](https://docs.astral.sh/uv/)
 * The [Smithy CLI](https://smithy.io/2.0/guides/smithy-cli/cli_installation.html)
 * JDK 17 or newer
 * make
+* [pandoc](https://pandoc.org/installing.html) CLI
 
 This project uses [uv](https://docs.astral.sh/uv/) for managing all things python.
 Once you have it installed, run the following command to check that it's ready to use:
@@ -169,6 +170,12 @@ if __name__ == "__main__":
     asyncio.run(main())
 ```
 
+#### pandoc CLI
+
+The code generator uses [pandoc](https://pandoc.org/) to convert documentation from Smithy models
+into Markdown format for Python docstrings, which can then be used to generate 
+documentation with [Material for MkDocs](https://squidfunk.github.io/mkdocs-material/getting-started/).
+
 #### Is Java really required?
 
 Only for now. Once the generator has been published, the Smithy CLI will be able

codegen/aws/core/src/main/java/software/amazon/smithy/python/aws/codegen/AwsMkDocsFileGenerator.java

@@ -8,4 +8,4 @@ software.amazon.smithy.python.aws.codegen.AwsProtocolsIntegration
 software.amazon.smithy.python.aws.codegen.AwsServiceIdIntegration
 software.amazon.smithy.python.aws.codegen.AwsUserAgentIntegration
 software.amazon.smithy.python.aws.codegen.AwsStandardRegionalEndpointsIntegration
-software.amazon.smithy.python.aws.codegen.AwsRstDocFileGenerator
+software.amazon.smithy.python.aws.codegen.AwsMkDocsFileGenerator