You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@lucenenet.apache.org by pa...@apache.org on 2026/06/22 16:39:52 UTC

(lucenenet) branch master updated: Add pre-commit hook `doctoc` to auto generate README table of contents (#1366)

This is an automated email from the ASF dual-hosted git repository.

paulirwin pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/lucenenet.git


The following commit(s) were added to refs/heads/master by this push:
     new cba1a56b5 Add pre-commit hook `doctoc` to auto generate README table of contents (#1366)
cba1a56b5 is described below

commit cba1a56b588e870eb537aaa19c06610d5c09f7a4
Author: John Bampton <jb...@users.noreply.github.com>
AuthorDate: Tue Jun 23 02:39:46 2026 +1000

    Add pre-commit hook `doctoc` to auto generate README table of contents (#1366)
---
 .pre-commit-config.yaml |  7 +++++++
 README.md               | 44 ++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 51 insertions(+)

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
index cbf742e13..db76ef31d 100644
--- a/.pre-commit-config.yaml
+++ b/.pre-commit-config.yaml
@@ -31,6 +31,13 @@ repos:
       - id: check-hooks-apply
         name: run check hooks apply
         description: check that all the hooks apply to the repository
+  - repo: https://github.com/thlorenz/doctoc.git
+    rev: 59dcae910a6ad4bbe8711275b854e3cd5c30f08b # frozen: v2.5.0
+    hooks:
+      - id: doctoc
+        name: add TOC for Markdown files
+        description: automatically keeps your table of contents up to date
+        files: ^README\.md$
   - repo: https://github.com/codespell-project/codespell
     rev: 2ccb47ff45ad361a21071a7eedda4c37e6ae8c5a # frozen: v2.4.2
     hooks:
diff --git a/README.md b/README.md
index 2d13a0a23..03d650c20 100644
--- a/README.md
+++ b/README.md
@@ -4,6 +4,50 @@
 [![Azure DevOps builds (master)](https://img.shields.io/azure-devops/build/lucene-net/6ba240c9-9598-47e7-a793-0ed8a4ba2f8b/3/master)](https://dev.azure.com/lucene-net/Lucene.NET/_build?definitionId=3&_a=summary)
 [![GitHub](https://img.shields.io/github/license/apache/lucenenet)](https://github.com/apache/lucenenet/blob/master/LICENSE.txt)
 
+<!-- START doctoc generated TOC please keep comment here to allow auto update -->
+<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
+
+- [Powerful Full-text search for .NET](#powerful-full-text-search-for-net)
+- [Supported Frameworks](#supported-frameworks)
+  - [Lucene.NET 3.0.3](#lucenenet-303)
+  - [Lucene.NET 4.8.0](#lucenenet-480)
+- [Status](#status)
+- [Download](#download)
+  - [Lucene.NET 3.0.3](#lucenenet-303-1)
+      - [Core Library](#core-library)
+      - [All Packages](#all-packages)
+  - [Lucene.NET 4.8.0](#lucenenet-480-1)
+      - [Core Library](#core-library-1)
+      - [All Packages](#all-packages-1)
+- [Documentation](#documentation)
+  - [Legacy Versions](#legacy-versions)
+- [Demos & Tools](#demos--tools)
+- [How to Contribute](#how-to-contribute)
+  - [Join Mailing Lists](#join-mailing-lists)
+  - [Ask a Question](#ask-a-question)
+  - [Report a Bug](#report-a-bug)
+  - [Start a Discussion](#start-a-discussion)
+  - [Submit a Pull Request](#submit-a-pull-request)
+- [Building and Testing](#building-and-testing)
+  - [Command Line](#command-line)
+      - [Prerequisites](#prerequisites)
+      - [Execution](#execution)
+        - [Windows](#windows)
+        - [Linux or macOS](#linux-or-macos)
+      - [Build Options](#build-options)
+        - [Windows](#windows-1)
+        - [Linux or macOS](#linux-or-macos-1)
+  - [Visual Studio](#visual-studio)
+    - [Prerequisites](#prerequisites-1)
+    - [Execution](#execution-1)
+  - [Azure DevOps](#azure-devops)
+    - [Prerequisites](#prerequisites-2)
+    - [Execution](#execution-2)
+      - [If you don't already have a pipeline set up:](#if-you-dont-already-have-a-pipeline-set-up)
+      - [If you already have a pipeline set up:](#if-you-already-have-a-pipeline-set-up)
+
+<!-- END doctoc -->
+
 ## Powerful Full-text search for .NET
 
 Apache Lucene.NET is an open-source full-text search library written in C#. It is a port of the popular Java Apache Lucene project.