docs: Updated submodules and improved formatting.

aws/fargate_service/README.md

@@ -103,15 +103,16 @@ existing secret. For example:
 
 ```hcl
 environment_secrets = {
-  EXAMPLE_CLIENT_ID = "client:client_id"
+  EXAMPLE_CLIENT_ID  = "client:client_id"
   EXAMPLE_CLIENT_KEY = "arn:aws:secretsmanager:us-east-1:123456789012:secret:project/staging/client:key"
 }
 ```
 
 ### secrets_manager_secrets
 
-> _**Note:** This feature may be removed in a future version. It is recommended
-> to use the [secrets] module to manage secrets instead._
+> [!CAUTION]
+> This feature may be removed in a future version. It is recommended to use the
+> [secrets] module to manage secrets instead.
 
 An optional map of secrets to be created in [AWS Secrets
 Manager][secrets-manager]. Once the secret is created, any changes to the value
@@ -121,7 +122,7 @@ will be ignored. For example, to create a secret named `example`:
 secrets_manager_secrets = {
   example = {
     recovery_window = 7
-    description = "Example credentials for our application."
+    description     = "Example credentials for our application."
   }
 }
 ```

aws/secrets/README.md

@@ -4,11 +4,12 @@ This module manages secrets in AWS through [Secrets Manager][secrets-manager].
 It will create a KMS key for encrypting secrets, and optionally create one or
 more secrets.
 
-**Warning: OpenTofu state files are stored as plain text. For this reason it
-is not recommended that you pass secret values to this module, unless you
-expect them to be rotated _immediately_. It _is_ safe to use the
-`create_random_password` option, as this value will be generated by AWS and not
-stored in the state file.**
+> [!CAUTION]
+> OpenTofu state files are stored as plain text. For this reason it is not
+> recommended that you pass secret values to this module, unless you expect them
+> to be rotated _immediately_. It _is_ safe to use the `create_random_password`
+> option, as this value will be generated by AWS and not stored in the state
+> file.
 
 ## Usage
 
@@ -19,23 +20,23 @@ to match your desired configuration. For example:
 module "secrets" {
   source = "github.com/codeforamerica/tofu-modules/aws/secrets"
 
-    project                = "my-project"
-    environment            = "dev"
-
-    secrets = {
-      example = {
-        description = "An example secret."
-      }
-      "password/test" = {
-        create_random_password = true
-        description = "Random password for testing."
-      }
-      named = {
-        description = "A secret with an explicit name."
-        name = "my-project/named/secret"
-      }
+  project     = "my-project"
+  environment = "dev"
+
+  secrets = {
+    example = {
+      description = "An example secret."
+    }
+    "password/test" = {
+      create_random_password = true
+      description            = "Random password for testing."
+    }
+    named = {
+      description = "A secret with an explicit name."
+      name        = "my-project/named/secret"
     }
   }
+}
 ```
 
 Make sure you re-run `tofu init` after adding the module to your configuration.
@@ -72,7 +73,7 @@ will be ignored. For example, to create a secret named `example`:
 secrets = {
   example = {
     recovery_window = 7
-    description = "Example credentials for our application."
+    description     = "Example credentials for our application."
   }
 }
 ```
@@ -89,8 +90,8 @@ for the secret:
 secrets = {
   example = {
     recovery_window = 7
-    description = "Example credentials for our application."
-    name = "my/example/key"
+    description     = "Example credentials for our application."
+    name            = "my/example/key"
   }
 }
 ```

aws/serverless_database/README.md

@@ -14,18 +14,18 @@ to match your desired configuration. For example:
 module "database" {
   source = "github.com/codeforamerica/tofu-modules/aws/serverless_database"
 
+  project     = "my-project"
+  environment = "dev"
+  service     = "web"
+
   logging_key_arn = module.logging.kms_key_arn
   secrets_key_arn = module.secrets.kms_key_arn
-  vpc_id = module.vpc.vpc_id
-  subnets = module.vpc.private_subnets
-  ingress_cidrs = module.vpc.private_subnets_cidr_blocks
+  vpc_id          = module.vpc.vpc_id
+  subnets         = module.vpc.private_subnets
+  ingress_cidrs   = module.vpc.private_subnets_cidr_blocks
 
   min_capacity = 2
   max_capacity = 32
-
-  project                = "my-project"
-  environment            = "dev"
-  service                = "web"
 }
 ```
 
@@ -63,7 +63,6 @@ tofu init -upgrade
 | snapshot_identifier | Optional name or ARN of the snapshot to restore the cluster from. Only applicable on create.                                               | `bool`   | `false` | no       |
 | tags                | Optional tags to be applied to all resources.                                                                                              | `list`   | `[]`    | no       |
 
-
 ## Outputs
 
 | Name             | Description                                      | Type     |

aws/vpc/README.md

@@ -48,11 +48,11 @@ For example:
 
 ```hcl
 peers = {
-  "aptible": {
-    account_id: "123456789012",
-    vpc_id: "vpc-012ab34cde5678fa9",
-    region: "us-east-1",
-    cidr: "10.123.0.0/16"
+  aptible = {
+    account_id = "123456789012",
+    vpc_id     = "vpc-012ab34cde5678fa9",
+    region     = "us-east-1",
+    cidr       = "10.123.0.0/16"
   }
 }
 ```

mkdocs.yaml

@@ -30,7 +30,7 @@ markdown_extensions:
 theme:
   name: material
   icon:
-    logo: material/puzzle
+    logo: simple/opentofu
   palette:
     scheme: slate
   features:
@@ -63,22 +63,22 @@ extra:
 nav:
   - Home: index.md
   - Architecture:
-      Overview: architecture/architecture.md
-      Create a New Module: architecture/create.md
-      GitHub Actions: architecture/github-actions.md
+      - Overview: architecture/architecture.md
+      - Create a New Module: architecture/create.md
+      - GitHub Actions: architecture/github-actions.md
   - Modules:
-      Aptible:
-          Managed Endpoint: modules/aptible/managed-endpoint.md
-      AWS:
-          Backend: modules/aws/backend.md
-          CloudFront WAF: modules/aws/cloudfront-waf.md
-          Fargate Service: modules/aws/fargate-service.md
-          Logging: modules/aws/logging.md
-          Secrets: modules/aws/secrets.md
-          Serverless Database: modules/aws/serverless-database.md
-          VPC: modules/aws/vpc.md
+      - Aptible:
+          - Managed Endpoint: modules/aptible/managed-endpoint.md
+      - AWS:
+          - Backend: modules/aws/backend.md
+          - CloudFront WAF: modules/aws/cloudfront-waf.md
+          - Fargate Service: modules/aws/fargate-service.md
+          - Logging: modules/aws/logging.md
+          - Secrets: modules/aws/secrets.md
+          - Serverless Database: modules/aws/serverless-database.md
+          - VPC: modules/aws/vpc.md
   - About:
-      Contributing: contributing.md
-      License: license.md
+      - Contributing: contributing.md
+      - License: license.md
 
 copyright: Produced by Code for America under the MIT license.