From be71606d35f90b66131535b1406ebc3133219078 Mon Sep 17 00:00:00 2001
From: Luca Comellini <luca.com@gmail.com>
Date: Fri, 6 Sep 2024 18:37:45 -0700
Subject: [PATCH] Add doctoc to automatically generate TOCs

---
 .pre-commit-config.yaml |  6 ++++++
 CONTRIBUTING.md         | 30 ++++++++++++++++--------------
 release-process.md      | 10 ++++++++++
 3 files changed, 32 insertions(+), 14 deletions(-)

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index a5701be..66fd3eb 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -49,6 +49,12 @@ repos:
     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]
   autoupdate_schedule: quarterly # We use renovate for more frequent updates and there's no way to disable autoupdate
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 9fad8c5..2dca49a 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -3,20 +3,22 @@
 The following is a set of guidelines for contributing to the NGINX Telemetry Exporter. We really appreciate that you 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)
+- [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)
+- [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
 
diff --git a/release-process.md b/release-process.md
index 9654575..ef1df85 100644
--- a/release-process.md
+++ b/release-process.md
@@ -2,6 +2,16 @@
 
 This document outlines the steps involved in the release process for the Telemetry Exporter project.
 
+<!-- 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
+
+- [Versioning](#versioning)
+- [Release Planning and Development](#release-planning-and-development)
+- [Releasing a New Version](#releasing-a-new-version)
+
+<!-- END doctoc generated TOC please keep comment here to allow auto update -->
+
 ## Versioning
 
 The project follows [Semantic Versioning](https://semver.org/) for versioning.