Agent release 3.0 (#567)

- Adds the Agent 3.x documentation under the NGINX One docset
- Updates the Agent 2.x documentation

Author: JTorreG

content/agent/overview.md renamed to content/agent/about.md

@@ -1,16 +1,15 @@
 ---
-title: Overview
+title: About
 draft: false
 weight: 100
 toc: true
 nd-docs: DOCS-1091
-type:
-- how-to
+nd-content-type: how-to
 ---
 
 ## Overview
 
-NGINX Agent is a companion daemon for your NGINX Open Source or NGINX Plus instance. It enables:
+NGINX Agent version 2 is a companion daemon for your NGINX Open Source or NGINX Plus instance. It enables:
 
 - Remote management of NGINX configurations
 - Collection and reporting of real-time NGINX performance and operating system metrics
@@ -47,7 +46,6 @@ For NGINX Agent to work properly with an NGINX Plus instance, the API needs to b
 NGINX Agent allows a gRPC connected control system to register a listener for a specific event. The control mechanism is then invoked when NGINX Agent sends an associated system signal. The source of a notification can be either the NGINX instance or NGINX Agent itself. Here's a list of currently supported events:
 
 
-{{< raw-html>}}<div class="table-responsive">{{</raw-html>}}
 {{<bootstrap-table "table table-striped table-bordered">}}
 | Event                            | Description                                  |
 | -------------------------------- | -------------------------------------------- |
@@ -64,6 +62,6 @@ NGINX Agent allows a gRPC connected control system to register a listener for a
 | CONFIG_ROLLBACK_SUCCESS_MESSAGE  | Successfully rolled back NGINX configuration |
 | CONFIG_ROLLBACK_FAILURE_MESSAGE  | Failed to roll back NGINX configuration      |
 {{</bootstrap-table>}}
-{{< raw-html>}}</div>{{</raw-html>}}
+
 
 

content/agent/changelog.md

@@ -0,0 +1,20 @@
+---
+title: Community and contribution
+toc: true
+weight: 600
+nd-docs: DOCS-1884
+---
+
+Discover the various ways you can participate in the F5 NGINX Agent project:
+
+## Community
+
+- Have questions or ideas to discuss? Join the conversation about NGINX Agent in the [NGINX Community Forum](https://community.nginx.org/).
+
+## Contribute
+
+Get involved with the project by contributing! Please see our [contributing guide](https://github.com/nginx/agent/blob/main/CONTRIBUTING.md) for details.
+
+## License
+
+[Apache License, Version 2.0](https://github.com/nginx/agent/blob/main/LICENSE)

content/agent/community.md

@@ -1,6 +1,10 @@
 ---
-title: Configuration
-description: Learn how to configure NGINX Agent.
-weight: 400
+title: "Configuration"
+weight: "400"
 url: /nginx-agent/configuration/
+cascade:
+  logo: NGINX-product-icon.png
+  layout: agent-v2-migration
 ---
+
+Learn how to configure NGINX Agent.

content/agent/configuration/_index.md

@@ -4,8 +4,7 @@ draft: false
 weight: 100
 toc: true
 nd-docs: DOCS-1229
-type:
-- how-to
+nd-content-type: how-to
 ---
 
 The following sections explain how to configure NGINX Agent using configuration files, CLI flags, and environment variables.

content/agent/configuration/configuration-overview.md

@@ -1,11 +1,10 @@
 ---
-title: Add NGINX users to nginx-agent Group
+title: "Add NGINX users to nginx-agent group"
 draft: false
 weight: 300
 toc: true
 nd-docs: DOCS-933
-type:
-- how-to
+nd-content-type: how-to
 ---
 
 ## Overview

content/agent/configuration/configure-nginx-agent-features.md

@@ -3,8 +3,7 @@ title: Health checks
 draft: false
 weight: 400
 toc: true
-type:
-- how-to
+nd-content-type: how-to
 nd-docs: DOCS-1677
 ---
 

content/agent/configuration/configure-nginx-agent-group.md

@@ -1,64 +1,61 @@
 ---
-title: Development environment setup
-draft: false
-weight: 200
+title: "Development environment setup"
 toc: true
 nd-docs: DOCS-1088
-type:
-- how-to
+nd-content-type: how-to
 ---
 
 ## Overview
 
-Learn how to setup a Development Environment for NGINX Agent.
+This page describes how to configure a development environment for F5 NGINX Agent.
 
-## Select an Operating System
+While most Linux or FreeBSD operating systems can be used to contribute to the NGINX Agent project, the following steps have been designed for Ubuntu.
 
-While most Linux or FreeBSD operating systems can be used to contribute to the NGINX Agent project, the following steps have been designed for Ubuntu. Ubuntu is packaged with most libraries required to build and run NGINX Agent, and is the recommended platform for NGINX Agent development.
+Ubuntu is the recommended operating system for development, as it comes with most packages requires to build and run NGINX Agent.
 
-## Install NGINX
+## Before you begin
 
-Follow the steps in the [Installation]({{< ref "/agent/installation-upgrade/" >}}) section to download, install, and run NGINX and NGINX Agent.
+To begin this task, you will require the following:
 
-## Clone the NGINX Agent Repository
+- A [working NGINX Agent instance]({{< ref "/nginx-one/agent/install-upgrade/" >}}).
+- A [Go installation](https://go.dev/dl/) of version 1.22.2 or newer.
+- A [Protocol Buffer Compiler](https://grpc.io/docs/protoc-installation/) installation.
 
-Using your preferred method, clone the NGINX Agent repository into your development directory. See [Cloning a GitHub Repository](https://docs.github.com/en/repositories/creating-and-managing-repositories/cloning-a-repository) for additional help.
+You will also need a copy of the NGINX Agent repository, which you can clone using `git`:
 
-## Installing Prerequisite Packages
+```shell
+git clone [email protected]:nginx/agent.git
+```
+
+Read [Cloning a repository](https://docs.github.com/en/repositories/creating-and-managing-repositories/cloning-a-repository) for more information
+
+Follow the steps in the [Installation]({{< ref "/nginx-one/agent/install-upgrade/" >}}) topic to install NGINX Agent.
+
+## Install prerequisite packages
 Depending on the operating system distribution, it may be necessary to install the following packages in order to build NGINX Agent.
 
 Change to the NGINX Agent source directory:
-```bash
+```shell
 cd <path_to_development_directory>/agent
 ```
 
 Install Make:
-```bash
+```shell
 sudo apt install make
 ```
 
-NGINX Agent is written in Go. You may [download Go](https://go.dev/doc/install) and follow installation instructions on the same page or run:
-```bash
-sudo apt install golang-go
-```
-
-Install Protoc:
-```bash
-sudo apt install -y protobuf-compiler
-```
-
 Install NGINX Agent tools and dependencies:
 
 Before starting development on NGINX Agent, it is important to download and install the necessary tool and dependencies required by NGINX Agent. You can do this by running the following `make` command:
-```bash
+```shell
 make install-tools deps
 ```
 
-## Building NGINX Agent from Source Code
+## Build NGINX Agent from source code
 
 Run the following commands to build and run NGINX Agent:
 
-```bash
+```shell
 make build
 sudo make run
 ```