Add doctoc to automatically generate TOCs

Author: lucacome

.pre-commit-config.yaml

@@ -44,5 +44,12 @@ repos:
     rev: v1.35.1
     hooks:
       - id: yamllint
+
+  - repo: https://github.com/thlorenz/doctoc
+    rev: v2.2.0
+    hooks:
+      - id: doctoc
+        args: [--update-only, --title, "## Table of Contents"]
+
 ci:
   skip: [golangci-lint-full]

CONTRIBUTING.md

@@ -5,18 +5,24 @@ are considering contributing!
 
 ## Table Of Contents
 
-[Ask a Question](#ask-a-question)
-
-[Getting Started](#getting-started)
-
-[Contributing](#contributing)
-
-[Style Guides](#style-guides)
-
-- [Git Style Guide](#git-style-guide)
-- [Go Style Guide](#go-style-guide)
-
-[Code of Conduct](CODE_OF_CONDUCT.md)
+<!-- START doctoc generated TOC please keep comment here to allow auto update -->
+<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
+## Table of Contents
+
+- [Ask a Question](#ask-a-question)
+- [Getting Started](#getting-started)
+  - [Project Structure](#project-structure)
+- [Contributing](#contributing)
+  - [Report a Bug](#report-a-bug)
+  - [Suggest an Enhancement](#suggest-an-enhancement)
+  - [Open a Pull Request](#open-a-pull-request)
+  - [Issue lifecycle](#issue-lifecycle)
+  - [F5 Contributor License Agreement (CLA)](#f5-contributor-license-agreement-cla)
+- [Style Guides](#style-guides)
+  - [Git Style Guide](#git-style-guide)
+  - [Go Style Guide](#go-style-guide)
+
+<!-- END doctoc generated TOC please keep comment here to allow auto update -->
 
 ## Ask a Question
 

README.md

@@ -18,6 +18,59 @@
 
 NGINX Prometheus exporter makes it possible to monitor NGINX or NGINX Plus using Prometheus.
 
+<!-- START doctoc generated TOC please keep comment here to allow auto update -->
+<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
+## Table of Contents
+
+- [Overview](#overview)
+- [Getting Started](#getting-started)
+  - [A Note about NGINX Ingress Controller](#a-note-about-nginx-ingress-controller)
+  - [Prerequisites](#prerequisites)
+  - [Running the Exporter in a Docker Container](#running-the-exporter-in-a-docker-container)
+  - [Running the Exporter Binary](#running-the-exporter-binary)
+- [Usage](#usage)
+  - [Command-line Arguments](#command-line-arguments)
+- [Exported Metrics](#exported-metrics)
+  - [Common metrics](#common-metrics)
+  - [Metrics for NGINX OSS](#metrics-for-nginx-oss)
+    - [Stub status metrics](#stub-status-metrics)
+  - [Metrics for NGINX Plus](#metrics-for-nginx-plus)
+    - [Connections](#connections)
+    - [HTTP](#http)
+    - [SSL](#ssl)
+    - [HTTP Server Zones](#http-server-zones)
+    - [Stream Server Zones](#stream-server-zones)
+    - [HTTP Upstreams](#http-upstreams)
+    - [Stream Upstreams](#stream-upstreams)
+    - [Stream Zone Sync](#stream-zone-sync)
+    - [Location Zones](#location-zones)
+    - [Resolver](#resolver)
+    - [HTTP Requests Rate Limiting](#http-requests-rate-limiting)
+    - [HTTP Connections Limiting](#http-connections-limiting)
+    - [Stream Connections Limiting](#stream-connections-limiting)
+    - [Cache](#cache)
+    - [Worker](#worker)
+- [Troubleshooting](#troubleshooting)
+- [Releases](#releases)
+  - [Docker images](#docker-images)
+  - [Binaries](#binaries)
+  - [Homebrew](#homebrew)
+  - [Snap](#snap)
+- [Building the Exporter](#building-the-exporter)
+  - [Building the Docker Image](#building-the-docker-image)
+  - [Building the Binary](#building-the-binary)
+- [Grafana Dashboard](#grafana-dashboard)
+- [SBOM (Software Bill of Materials)](#sbom-software-bill-of-materials)
+  - [Binaries](#binaries-1)
+  - [Docker Image](#docker-image)
+- [Provenance](#provenance)
+- [Contacts](#contacts)
+- [Contributing](#contributing)
+- [Support](#support)
+- [License](#license)
+
+<!-- END doctoc generated TOC please keep comment here to allow auto update -->
+
 ## Overview
 
 [NGINX](https://nginx.org) exposes a handful of metrics via the [stub_status