From 9aadc03327113ae03ba5e245947d4d76dc1e025d Mon Sep 17 00:00:00 2001
From: Jared Baker <jared.baker@hashicorp.com>
Date: Mon, 18 Sep 2023 16:28:13 -0400
Subject: [PATCH] docs: add contributor guide local development setup

---
 docs/README.md | 21 +++++++++++++++++++--
 1 file changed, 19 insertions(+), 2 deletions(-)

diff --git a/docs/README.md b/docs/README.md
index 5b88d4333bb..0d265fef628 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -1,4 +1,21 @@
 # Documentation
 
-- [Using the AWS Provider](https://registry.terraform.io/providers/hashicorp/aws/latest/docs)
-- [AWS Provider contributing guide](https://hashicorp.github.io/terraform-provider-aws/)
+This directory contains documentation for the [Terraform AWS Provider Contributor Guide](https://hashicorp.github.io/terraform-provider-aws/). Resource and data source documentation is located in the [`website`](../website/) directory and available in the [Terraform Registry](https://registry.terraform.io/providers/hashicorp/aws/latest/docs).
+
+## Local Development
+
+To serve the contributing guide locally, [`mkdocs`](https://www.mkdocs.org/user-guide/installation/) and the [`mkdocs-material`](https://github.com/squidfunk/mkdocs-material#quick-start) extension must be installed. Both require Python and `pip`.
+
+```console
+% pip3 install mkdocs
+```
+
+```console
+% pip3 install mkdocs-material
+```
+
+Once installed, the documentation can be served from the root directory:
+
+```console
+% mkdocs serve
+```