Remove documentation site and GitHub Action, update README references (#3047)

As of late December, NGINX has open sourced its documentation
repository. The next stage of this effort is to consolidate all of the
existing documentation into the single repository.

This commit removes the entire `/site` folder that was being used to
manage the documentation for NGINX Gateway Fabric separately from the
main pipeline, as well as the GitHub action used for deployment.

It also updates references to the folder to instead point towards the
documentation repository, where all updates will be made in the future.

Author: ADubhlaoich

.github/workflows/docs-build-push.yml

@@ -61,3 +61,7 @@ internal/mode/static/nginx/modules/coverage
 # temporary files used for manifest generation
 config/base/deploy.yaml
 config/base/deploy.yaml.bak
+
+# Temporary API documentation file, which should be committed
+# to the main documentation repository instead
+docs/api/content.md

.gitignore

@@ -46,7 +46,7 @@ Follow our [Installation Instructions](https://docs.nginx.com/nginx-gateway-fabr
 - We use [Go Modules](https://github.com/golang/go/wiki/Modules) for managing dependencies.
 - We use [Ginkgo](https://onsi.github.io/ginkgo/) and [Gomega](https://onsi.github.io/gomega/) for our BDD style unit
   tests.
-- The documentation website is found under `site/`.
+- The documentation is managed in [the NGINX documentation repository](https://github.com/nginx/documentation).
 
 ## Contributing
 
@@ -97,7 +97,7 @@ Before beginning development, familiarize yourself with the following documents:
   conventions to follow when writing Go code for the project.
 - [Architecture](https://docs.nginx.com/nginx-gateway-fabric/overview/gateway-architecture/): A high-level overview of the project's architecture.
 - [Design Principles](/docs/developer/design-principles.md): An overview of the project's design principles.
-- [NGINX Gateway Fabric Documentation](/site/README.md): An explanation of the documentation tooling and conventions.
+- [The NGINX documentation repository](https://github.com/nginx/documentation): The repository for NGINX documentation, which is used for the website.
 
 ## F5 Contributor License Agreement (CLA)
 

CONTRIBUTING.md

@@ -141,7 +141,7 @@ generate-manifests: ## Generate manifests using Helm.
 	./scripts/generate-manifests.sh
 
 generate-api-docs: ## Generate API docs
-	go run github.com/ahmetb/gen-crd-api-reference-docs@$(GEN_CRD_API_REFERENCE_DOCS_VERSION) -config site/config/api/config.json -template-dir site/config/api -out-file site/content/reference/api.md -api-dir "github.com/nginx/nginx-gateway-fabric/apis"
+	go run github.com/ahmetb/gen-crd-api-reference-docs@$(GEN_CRD_API_REFERENCE_DOCS_VERSION) -config docs/api/config.json -template-dir docs/api -out-file docs/api/content.md -api-dir "github.com/nginx/nginx-gateway-fabric/apis"
 
 .PHONY: generate-helm-docs
 generate-helm-docs: ## Generate the Helm chart documentation

Makefile

@@ -22,7 +22,7 @@ Learn about our [design principles](/docs/developer/design-principles.md) and [a
 
 ## Getting Started
 
-1. [Quick Start on a kind cluster](https://docs.nginx.com/nginx-gateway-fabric/get-started/).
+1. [Get started using a kind cluster](https://docs.nginx.com/nginx-gateway-fabric/get-started/).
 2. [Install](https://docs.nginx.com/nginx-gateway-fabric/installation/) NGINX Gateway Fabric.
 3. Deploy various [examples](examples).
 4. Read our [How-to guides](https://docs.nginx.com/nginx-gateway-fabric/how-to/).

README.md

@@ -8,3 +8,4 @@ _Please note: You can find the user documentation for NGINX Gateway Fabric in th
 
 - [Developer](developer/): Docs for developers of the project. Contains guides relating to processes and workflows.
 - [Proposals](proposals/): Enhancement proposals for new features.
+- [API](api/): The files for generating API documentation, used in the Makefile

docs/README.md

@@ -2,7 +2,9 @@
 ---
 title: "API reference"
 weight: 100
-toc: false
+type: reference
+product: NGF
+docs: DOCS-000
 ---
 
 ## Overview