Add automation for index docs (#943)

This PR automates docsgen for this provider's installation doc.

Followup on pulumi/home#3598.

.ci-mgmt.yaml

@@ -25,3 +25,4 @@ actions:
       run: |
         cd provider && go test -v -json -count=1 -cover -timeout 2h -tags=${{ matrix.language }} -parallel 4 . 2>&1 | tee /tmp/gotest.log | gotestfmt
 pulumiConvert: 1
+registryDocs: true

Makefile

@@ -29,7 +29,7 @@ development: install_plugins provider build_sdks install_sdks
 
 build: install_plugins provider build_sdks install_sdks
 
-build_sdks: build_nodejs build_python build_dotnet build_go build_java 
+build_sdks: build_nodejs build_python build_dotnet build_go build_java build_registry_docs
 
 install_go_sdk:
 
@@ -96,6 +96,10 @@ build_python: upstream
 		cd ./bin && \
 		../venv/bin/python -m build .
 
+# Run the bridge's registry-docs command to generated the content of the installation docs/ folder at provider repo root
+build_registry_docs:
+	$(WORKING_DIR)/bin/$(TFGEN) registry-docs --out $(WORKING_DIR)/docs
+
 clean:
 	rm -rf sdk/{dotnet,nodejs,go,python}
 

docs/_index.md

@@ -1,6 +1,6 @@
 ---
 title: Cloudflare Provider
-meta_desc: Provides an overview on how to configure the Pulumi Cloudflare Provider.
+meta_desc: Provides an overview on how to configure the Pulumi Cloudflare provider.
 layout: package
 ---
 ## Installation
@@ -12,6 +12,7 @@ The cloudflare provider is available as a package in all Pulumi languages:
 * Go: [`github.com/pulumi/pulumi-cloudflare/sdk/v5/go/cloudflare`](https://github.com/pulumi/pulumi-cloudflare)
 * .NET: [`Pulumi.Cloudflare`](https://www.nuget.org/packages/Pulumi.Cloudflare)
 * Java: [`com.pulumi/cloudflare`](https://central.sonatype.com/artifact/com.pulumi/cloudflare)
+## Overview
 
 The Cloudflare provider is used to interact with resources supported by
 Cloudflare. The provider needs to be configured with the proper credentials
@@ -185,10 +186,7 @@ public class App {
 ```
 {{% /choosable %}}
 {{< /chooser >}}
-
-<!-- schema generated by tfplugindocs -->
-## Schema
-### Optional
+## Configuration Reference
 
 - `apiBasePath` (String) Configure the base path used by the API client. Alternatively, can be configured using the `CLOUDFLARE_API_BASE_PATH` environment variable.
 - `apiClientLogging` (Boolean) Whether to print logs from the API client (using the default log library logger). Alternatively, can be configured using the `CLOUDFLARE_API_CLIENT_LOGGING` environment variable.