From 7a3c4ea01e2ad53c6b54136bc19b7f0ad977da7d Mon Sep 17 00:00:00 2001
From: Barrett Ruth <62671086+barrettruth@users.noreply.github.com>
Date: Thu, 5 Mar 2026 01:31:15 -0500
Subject: [PATCH] docs: add table of contents to vimdoc (#146)

## Problem

The vimdoc has 16 sections but no table of contents, making it hard
to navigate with `:help diffs`.

## Solution

Add a numbered `CONTENTS` section with dot-leader formatting and
`|tag|` links to each existing section, matching the style used in
the project's other plugins.
---
 doc/diffs.nvim.txt | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/doc/diffs.nvim.txt b/doc/diffs.nvim.txt
index 65345d4..3bb5a09 100644
--- a/doc/diffs.nvim.txt
+++ b/doc/diffs.nvim.txt
@@ -22,6 +22,26 @@ Features: ~
 - Gutter (line number) highlighting
 - Inline merge conflict marker detection, highlighting, and resolution
 
+==============================================================================
+CONTENTS                                                      *diffs-contents*
+
+  1. Introduction ............................................... |diffs.nvim|
+  2. Requirements ....................................... |diffs-requirements|
+  3. Setup ..................................................... |diffs-setup|
+  4. Configuration ............................................ |diffs-config|
+  5. Commands ............................................... |diffs-commands|
+  6. Mappings ............................................... |diffs-mappings|
+  7. Fugitive Status Keymaps ................................ |diffs-fugitive|
+  8. Conflict Resolution .................................... |diffs-conflict|
+  9. Merge Diff Resolution ..................................... |diffs-merge|
+ 10. Neogit ................................................... |diffs-neogit|
+ 11. API ......................................................... |diffs-api|
+ 12. Implementation ................................... |diffs-implementation|
+ 13. Known Limitations ................................... |diffs-limitations|
+ 14. Highlight Groups ..................................... |diffs-highlights|
+ 15. Health Check ............................................. |diffs-health|
+ 16. Acknowledgements ............................... |diffs-acknowledgements|
+
 ==============================================================================
 REQUIREMENTS                                              *diffs-requirements*