feat: Replace details HTML with Hugo shortcode (#1321)

This commit replaces the majority of instances of raw details HTML 
in the documentation repo with the Hugo shortcode instead. 

The remaining instances are exceptions to our rule of avoiding 
raw HTML in documentation, as they are bespoke interactive elements.

The affected files have also had other formatting styles brought up 
to contemporary standards, such as metadata, the deprecation of 
the bootstrap shortcode, and the removal of horizontal lines.

Author: ADubhlaoich

.github/CODEOWNERS

@@ -26,8 +26,8 @@ content/nginx/nms/agent/*   @nginx/nginx-agent
 content/nap-dos/*           @nginx/dos-docs-approvers
 
 # F5 WAF for NGINX
-content/nap-waf/*           @nginx/nap-docs-approvers
-data/nap-waf/*              @nginx/nap-docs-approvers
+content/waf/*               @nginx/waf
+content/includes/waf/*      @nginx/waf
 
 # NGINXaaS for Azure 
 content/nginxaas-azure/*          @nginx/n4a-docs-approvers

content/agent/configuration/configuration-overview.md

@@ -3,8 +3,9 @@ title: Basic configuration
 draft: false
 weight: 100
 toc: true
-nd-docs: DOCS-1229
 nd-content-type: how-to
+nd-product: Agent
+nd-docs: DOCS-1229
 ---
 
 The following sections explain how to configure NGINX Agent using configuration files, CLI flags, and environment variables.
@@ -27,8 +28,7 @@ The default locations of configuration files for NGINX Agent are `/etc/nginx-age
 
 Examples of the configuration files are provided below:
 
-<details open>
-    <summary>example nginx-agent.conf</summary>
+{{< details summary="Open nginx-agent.conf example">}}
 
 {{< call-out "note" >}}
 In the following example `nginx-agent.conf` file, you can change the `server.host` and `server.grpcPort` to connect to the control plane.
@@ -112,11 +112,9 @@ nginx_app_protect:
   precompiled_publication: true
 ```
 
-</details>
-
+{{< /details >}}
 
-<details open>
-    <summary>example dynamic-agent.conf</summary>
+{{< details summary="Open dynamic-agent.conf example">}}
 
 {{< call-out "note" >}}
 Default location in Linux environments: `/var/lib/nginx-agent/agent-dynamic.conf`
@@ -146,7 +144,7 @@ tags:
   - qa
 ```
 
-</details>
+{{< /details >}}
 
 ## CLI Flags & Environment Variables
 
@@ -239,8 +237,7 @@ Default location in FreeBSD environments: `/var/db/nginx-agent/agent-dynamic.con
 
 By default, NGINX Agent rotates logs daily using logrotate with the following configuration:
 
-<details open>
-  <summary>NGINX Agent Logrotate Configuration</summary>
+{{< details summary="Logrotate configuration example" >}}
 
 ``` yaml
 /var/log/nginx-agent/*.log
@@ -263,7 +260,7 @@ By default, NGINX Agent rotates logs daily using logrotate with the following co
    notifempty
 }
 ```
-</details>
+{{< /details >}}
 
 If you need to change the default configuration, update the file at `/etc/logrotate.d/nginx-agent`.
 

content/includes/nim/disconnected/license-usage-offline-script.md

@@ -2,10 +2,9 @@
 nd-docs: "DOCS-1662"
 ---
 
-<details closed>
-<summary style="font-weight:bold">View the full contents of the license_usage_offline.sh script</summary>
+{{< details summary="Full license_usage_offline.sh script" >}}
 
-``` bash
+```shell
 #!/bin/bash
 
 # Function to encode the username and password to base64
@@ -413,4 +412,4 @@ curl --insecure --location "https://$ip_address/api/platform/v1/report/upload" \
 echo "Report acknowledgement successfully uploaded to NGINX Instance Manager $ip_address."
 ```
 
-</details>
+{{< /details >}}

content/ngf/install/helm.md

@@ -22,8 +22,7 @@ To complete this guide, you will need:
 
 {{< call-out "important" >}} If you’d like to use NGINX Plus, some additional setup is also required: {{< /call-out >}}
 
-<details closed>
-<summary>NGINX Plus JWT setup</summary>
+{{< details summary="NGINX Plus JWT setup" >}}
 
 {{< include "/ngf/installation/jwt-password-note.md" >}}
 
@@ -41,7 +40,7 @@ To complete this guide, you will need:
 
 {{< call-out "note" >}} For more information on why this is needed and additional configuration options, including how to report to NGINX Instance Manager instead, see the [NGINX Plus Image and JWT Requirement]({{< ref "/ngf/install/nginx-plus.md" >}}) document. {{< /call-out >}}
 
-</details>
+{{< /details >}}
 
 ## Deploy NGINX Gateway Fabric
 

content/ngf/install/manifests.md

@@ -20,8 +20,7 @@ To complete this guide, you'll need to install:
 
 {{< call-out "important" >}} If you’d like to use NGINX Plus, some additional setup is also required: {{< /call-out >}}
 
-<details closed>
-<summary>NGINX Plus JWT setup</summary>
+{{< details summary="NGINX Plus JWT setup" >}}
 
 {{< include "/ngf/installation/jwt-password-note.md" >}}
 
@@ -39,7 +38,7 @@ To complete this guide, you'll need to install:
 
 {{< call-out "note" >}} For more information on why this is needed and additional configuration options, including how to report to NGINX Instance Manager instead, see the [NGINX Plus Image and JWT Requirement]({{< ref "/ngf/install/nginx-plus.md" >}}) document. {{< /call-out >}}
 
-</details>
+{{< /details >}}
 
 ## Deploy NGINX Gateway Fabric
 

content/nginx-one/agent/install-upgrade/install-from-oss-repo.md

@@ -29,59 +29,53 @@ Before you install NGINX Agent for the first time on your system, you need to se
 up the `nginx-agent` packages repository. Afterward, you can install and update
 NGINX Agent from the repository.
 
-<details>
-<summary>Install NGINX Agent on RHEL, CentOS, Rocky Linux, AlmaLinux, and Oracle Linux</summary>
-
-### Install NGINX Agent on RHEL, CentOS, Rocky Linux, AlmaLinux, and Oracle Linux
+### Install NGINX Agent on Alpine Linux
 
-{{< include "/agent/installation/oss/oss-rhel.md" >}}
+{{< details summary="Expand instructions" >}}
 
-</details>
+{{< include "/agent/installation/oss/oss-alpine.md" >}}
 
-<details>
-<summary>Install NGINX Agent on Ubuntu</summary>
+{{< /details >}}
 
-### Install NGINX Agent on Ubuntu
+### Install NGINX Agent on Amazon Linux
 
-{{< include "/agent/installation/oss/oss-ubuntu.md" >}}
+{{< details summary="Expand instructions" >}}
 
-</details>
+{{< include "/agent/installation/oss/oss-amazon-linux.md" >}}
 
-<details>
-<summary>Install NGINX Agent on Debian</summary>
+{{< /details >}}
 
 ### Install NGINX Agent on Debian
 
+{{< details summary="Expand instructions" >}}
+
 {{< include "/agent/installation/oss/oss-debian.md" >}}
 
-</details>
+{{< /details >}}
 
-<details>
-<summary>Install NGINX Agent on SLES</summary>
+### Install NGINX Agent on RHEL, CentOS, Rocky Linux, AlmaLinux, and Oracle Linux
 
-### Install NGINX Agent on SLES
+{{< details summary="Expand instructions" >}}
 
-{{< include "/agent/installation/oss/oss-sles.md" >}}
+{{< include "/agent/installation/oss/oss-rhel.md" >}}
 
-</details>
+{{< /details >}}
 
-<details>
-<summary>Install NGINX Agent on Alpine Linux</summary>
+### Install NGINX Agent on SLES
 
-### Install NGINX Agent on Alpine Linux
+{{< details summary="Expand instructions" >}}
 
-{{< include "/agent/installation/oss/oss-alpine.md" >}}
+{{< include "/agent/installation/oss/oss-sles.md" >}}
 
-</details>
+{{< /details >}}
 
-<details>
-<summary>Install NGINX Agent on Amazon Linux</summary>
+### Install NGINX Agent on Ubuntu
 
-### Install NGINX Agent on Amazon Linux
+{{< details summary="Expand instructions" >}}
 
-{{< include "/agent/installation/oss/oss-amazon-linux.md" >}}
+{{< include "/agent/installation/oss/oss-ubuntu.md" >}}
 
-</details>
+{{< /details >}}
 
 ### Manually connect NGINX Agent to NGINX One Console
 

content/nginx-one/agent/install-upgrade/install-from-plus-repo.md

@@ -2,7 +2,8 @@
 title: Install from NGINX Plus repo
 toc: true
 weight: 200
-docs: DOCS-000
+nd-content-type: how-to
+nd-product: NGINX One
 nd-docs: DOCS-1877
 ---
 
@@ -16,7 +17,7 @@ For a quick guide on how to connect your instance to NGINX One Console see: [Con
 
 ## Overview
 
-Follow the steps in this guide to install NGINX Agent in your NGINX instance using
+Follow the steps in this guide to install F5 NGINX Agent in your NGINX instance using
 the NGINX Plus repository.
 
 ## Before you begin
@@ -29,59 +30,53 @@ Before you install NGINX Agent for the first time on your system, you need to
 set up the `nginx-agent` packages repository. Afterward, you can install and update
 NGINX Agent from the repository.
 
+### Install NGINX Agent on Alpine Linux
 
-<details>
-<summary>Install NGINX Agent on RHEL, CentOS, Rocky Linux, AlmaLinux, and Oracle Linux</summary>
+{{< details summary="Expand instructions" >}}
 
-### Install NGINX Agent on RHEL, CentOS, Rocky Linux, AlmaLinux, and Oracle Linux<a name="install-nginx-agent-on-rhel-centos-rocky-linux-almalinux-and-oracle-linux-plus"></a>
-
-{{< include "/agent/installation/plus/plus-rhel.md" >}}
+{{< include "/agent/installation/plus/plus-alpine.md" >}}
 
-</details>
+{{< /details >}}
 
-<details>
-<summary>Install NGINX Agent on Ubuntu</summary>
+### Install NGINX Agent on Amazon Linux
 
-### Install NGINX Agent on Ubuntu<a name="install-nginx-agent-on-ubuntu-plus"></a>
+{{< details summary="Expand instructions" >}}
 
-{{< include "/agent/installation/plus/plus-ubuntu.md" >}}
+{{< include "/agent/installation/plus/plus-amazon-linux.md" >}}
 
-</details>
+{{< /details >}}
 
-<details>
-<summary>Install NGINX Agent on Debian</summary>
+### Install NGINX Agent on Debian
 
-### Install NGINX Agent on Debian<a name="install-nginx-agent-on-debian-plus"></a>
+{{< details summary="Expand instructions" >}}
 
 {{< include "/agent/installation/plus/plus-debian.md" >}}
 
-</details>
+{{< /details >}}
 
-<details>
-<summary>Install NGINX Agent on SLES</summary>
+### Install NGINX Agent on RHEL, CentOS, Rocky Linux, AlmaLinux, and Oracle Linux
 
-### Install NGINX Agent on SLES<a name="install-nginx-agent-on-sles-plus"></a>
+{{< details summary="Expand instructions" >}}
 
-{{< include "/agent/installation/plus/plus-sles.md" >}}
+{{< include "/agent/installation/plus/plus-rhel.md" >}}
 
-</details>
+{{< /details >}}
 
-<details>
-<summary>Install NGINX Agent on Alpine Linux</summary>
+### Install NGINX Agent on SLES
 
-### Install NGINX Agent on Alpine Linux<a name="install-nginx-agent-on-alpine-linux-plus"></a>
+{{< details summary="Expand instructions" >}}
 
-{{< include "/agent/installation/plus/plus-alpine.md" >}}
+{{< include "/agent/installation/plus/plus-sles.md" >}}
 
-</details>
-<details>
-<summary>Install NGINX Agent on Amazon Linux</summary>
+{{< /details >}}
 
-### Install NGINX Agent on Amazon Linux<a name="install-nginx-agent-on-amazon-linux-plus"></a>
+### Install NGINX Agent on Ubuntu
 
-{{< include "/agent/installation/plus/plus-amazon-linux.md" >}}
+{{< details summary="Expand instructions" >}}
+
+{{< include "/agent/installation/plus/plus-ubuntu.md" >}}
 
-</details>
+{{< /details >}}
 
 ### Manually connect NGINX Agent to NGINX One Console