Add docs README

Author: SamRemis

codegen/core/src/main/java/software/amazon/smithy/python/codegen/generators/SetupGenerator.java

@@ -288,7 +288,6 @@ private static void writeDocsSkeleton(
                         .orElse(context.settings().service().getName()));
         writeConf(settings, context, projectName);
         writeIndexes(context, projectName);
-        writeDocsReadme(context);
         writeMakeBat(context);
         writeMakeFile(context);
     }
@@ -450,26 +449,31 @@ private static void writeIndexes(GenerationContext context, String projectName)
 
 
     /**
-     * Write the readme in the docs folder describing instructions for generation
+     * Write a Makefile.
+     * A Makefile is used on Unix-based systems to build Sphinx documentation.
+     * This file contains rules for cleaning the build directory and generating HTML documentation.
      *
      * @param context The generation context containing the writer delegator.
      */
     private static void writeDocsReadme(
             GenerationContext context
     ) {
-        context.writerDelegator().useFileWriter("docs/README.md", writer -> {
-            writer.write("""                                
+        context.writerDelegator().useFileWriter("docs/README.", "", writer -> {
+            writer.write("""
+                # Documentation
+                                
                 ## Generating Documentation
                 
                 Sphinx is used for documentation. You can generate HTML locally with the
                 following:
                 
                 ```
-                $$ uv pip install ".[docs]"
-                $$ cd docs
-                $$ make html
+                $ uv pip install ".[docs]"
+                $ cd docs
+                $ make html
                 ```
-                    """);
+                
+                        """);
         });
     }