Skip to content

Commit 8b55c58

Browse files
committed
debug and fix ToC breakage
1 parent 8df9569 commit 8b55c58

File tree

14 files changed

+691
-123
lines changed

14 files changed

+691
-123
lines changed

Makefile

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,13 +7,14 @@ else
77
endif
88
SCRIPTS_DIR := ./scripts
99

10-
.PHONY: help validate validate-single test coverage generate test-regenerate test-regenerate-no-cleanup test-regenerate-allow-diff test-regenerate-cycle docs-tree docs-tree-check download-resources add_resource add-category sort format format-check generate-resource-id mypy ci clean clean-all
10+
.PHONY: help validate validate-single validate-toc test coverage generate test-regenerate test-regenerate-no-cleanup test-regenerate-allow-diff test-regenerate-cycle docs-tree docs-tree-check download-resources add_resource add-category sort format format-check generate-resource-id mypy ci clean clean-all
1111

1212
help:
1313
@echo "Available commands:"
1414
@echo " make add-category - Add a new category to the repository"
1515
@echo " make validate - Validate all links in the resource CSV"
1616
@echo " make validate-single URL=<url> - Validate a single resource URL"
17+
@echo " make validate-toc - Validate TOC anchors against GitHub HTML"
1718
@echo " make test - Run validation tests on test CSV"
1819
@echo " make coverage - Run pytest with coverage reports"
1920
@echo " make mypy - Run mypy type checks"
@@ -69,6 +70,11 @@ validate-single:
6970
fi
7071
@$(PYTHON) -m scripts.validation.validate_single_resource "$(URL)" $(if $(SECONDARY),--secondary "$(SECONDARY)") $(if $(NAME),--name "$(NAME)")
7172

73+
# Validate TOC anchors against GitHub HTML (requires .claude/root-readme-html-article-body.html)
74+
validate-toc:
75+
@echo "Validating TOC anchors against GitHub HTML..."
76+
@$(PYTHON) -m scripts.testing.validate_toc_anchors
77+
7278
# Run all tests using pytest
7379
test:
7480
@echo "Running all tests..."

README.md

Lines changed: 32 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -32,36 +32,36 @@ Claude Code is a CLI-based coding assistant from [Anthropic](https://www.anthrop
3232

3333
## Contents
3434

35-
- [Agent Skills 🤖](#agent-skills--)
36-
- [General](#general-)
37-
- [Workflows & Knowledge Guides 🧠](#workflows--knowledge-guides--)
38-
- [General](#general--1)
39-
- [Tooling 🧰](#tooling--)
40-
- [General](#general--2)
41-
- [IDE Integrations](#ide-integrations-)
42-
- [Usage Monitors](#usage-monitors-)
43-
- [Orchestrators](#orchestrators-)
44-
- [Status Lines 📊](#status-lines--)
45-
- [General](#general--3)
46-
- [Hooks 🪝](#hooks--)
47-
- [General](#general--4)
48-
- [Slash-Commands 🔪](#slash-commands--)
49-
- [General](#general--5)
50-
- [Version Control & Git](#version-control--git-)
51-
- [Code Analysis & Testing](#code-analysis--testing-)
52-
- [Context Loading & Priming](#context-loading--priming-)
53-
- [Documentation & Changelogs](#documentation--changelogs-)
54-
- [CI / Deployment](#ci--deployment-)
55-
- [Project & Task Management](#project--task-management-)
56-
- [Miscellaneous](#miscellaneous-)
57-
- [CLAUDE.md Files 📂](#claudemd-files--)
58-
- [Language-Specific](#language-specific-)
59-
- [Domain-Specific](#domain-specific-)
60-
- [Project Scaffolding & MCP](#project-scaffolding--mcp-)
61-
- [Alternative Clients 📱](#alternative-clients--)
62-
- [General](#general--6)
63-
- [Official Documentation 🏛️](#official-documentation--%EF%B8%8F)
64-
- [General](#general--7)
35+
- [Agent Skills 🤖](#agent-skills-)
36+
- [General](#general)
37+
- [Workflows & Knowledge Guides 🧠](#workflows--knowledge-guides-)
38+
- [General](#general-1)
39+
- [Tooling 🧰](#tooling-)
40+
- [General](#general-2)
41+
- [IDE Integrations](#ide-integrations)
42+
- [Usage Monitors](#usage-monitors)
43+
- [Orchestrators](#orchestrators)
44+
- [Status Lines 📊](#status-lines-)
45+
- [General](#general-3)
46+
- [Hooks 🪝](#hooks-)
47+
- [General](#general-4)
48+
- [Slash-Commands 🔪](#slash-commands-)
49+
- [General](#general-5)
50+
- [Version Control & Git](#version-control--git)
51+
- [Code Analysis & Testing](#code-analysis--testing)
52+
- [Context Loading & Priming](#context-loading--priming)
53+
- [Documentation & Changelogs](#documentation--changelogs)
54+
- [CI / Deployment](#ci--deployment)
55+
- [Project & Task Management](#project--task-management)
56+
- [Miscellaneous](#miscellaneous)
57+
- [CLAUDE.md Files 📂](#claudemd-files-)
58+
- [Language-Specific](#language-specific)
59+
- [Domain-Specific](#domain-specific)
60+
- [Project Scaffolding & MCP](#project-scaffolding--mcp)
61+
- [Alternative Clients 📱](#alternative-clients-)
62+
- [General](#general-6)
63+
- [Official Documentation 🏛️](#official-documentation-%EF%B8%8F)
64+
- [General](#general-7)
6565

6666
## Agent Skills 🤖
6767

@@ -358,3 +358,5 @@ This project is released with a Code of Conduct. By participating, you agree to
358358

359359
This list is licensed under [Creative Commons CC BY-NC-ND 4.0](https://creativecommons.org/licenses/by-nc-nd/4.0/) - this means you are welcome to fork, clone, copy and redistribute the list, provided you include appropriate attribution; however you are not permitted to distribute any modified versions or to use it for any commercial purposes. This is to prevent disregard for the licenses of the authors whose resources are listed here. Please note that all resources included in this list have their own license terms.
360360

361+
362+
<!-- OBLIGATORY GUARD AGAINST SILLY END-OF-FILE PROBLEM -->

README_ALTERNATIVES/README_AWESOME.md

Lines changed: 32 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -32,36 +32,36 @@ Claude Code is a CLI-based coding assistant from [Anthropic](https://www.anthrop
3232

3333
## Contents
3434

35-
- [Agent Skills 🤖](#agent-skills--)
36-
- [General](#general-)
37-
- [Workflows & Knowledge Guides 🧠](#workflows--knowledge-guides--)
38-
- [General](#general--1)
39-
- [Tooling 🧰](#tooling--)
40-
- [General](#general--2)
41-
- [IDE Integrations](#ide-integrations-)
42-
- [Usage Monitors](#usage-monitors-)
43-
- [Orchestrators](#orchestrators-)
44-
- [Status Lines 📊](#status-lines--)
45-
- [General](#general--3)
46-
- [Hooks 🪝](#hooks--)
47-
- [General](#general--4)
48-
- [Slash-Commands 🔪](#slash-commands--)
49-
- [General](#general--5)
50-
- [Version Control & Git](#version-control--git-)
51-
- [Code Analysis & Testing](#code-analysis--testing-)
52-
- [Context Loading & Priming](#context-loading--priming-)
53-
- [Documentation & Changelogs](#documentation--changelogs-)
54-
- [CI / Deployment](#ci--deployment-)
55-
- [Project & Task Management](#project--task-management-)
56-
- [Miscellaneous](#miscellaneous-)
57-
- [CLAUDE.md Files 📂](#claudemd-files--)
58-
- [Language-Specific](#language-specific-)
59-
- [Domain-Specific](#domain-specific-)
60-
- [Project Scaffolding & MCP](#project-scaffolding--mcp-)
61-
- [Alternative Clients 📱](#alternative-clients--)
62-
- [General](#general--6)
63-
- [Official Documentation 🏛️](#official-documentation--%EF%B8%8F)
64-
- [General](#general--7)
35+
- [Agent Skills 🤖](#agent-skills-)
36+
- [General](#general)
37+
- [Workflows & Knowledge Guides 🧠](#workflows--knowledge-guides-)
38+
- [General](#general-1)
39+
- [Tooling 🧰](#tooling-)
40+
- [General](#general-2)
41+
- [IDE Integrations](#ide-integrations)
42+
- [Usage Monitors](#usage-monitors)
43+
- [Orchestrators](#orchestrators)
44+
- [Status Lines 📊](#status-lines-)
45+
- [General](#general-3)
46+
- [Hooks 🪝](#hooks-)
47+
- [General](#general-4)
48+
- [Slash-Commands 🔪](#slash-commands-)
49+
- [General](#general-5)
50+
- [Version Control & Git](#version-control--git)
51+
- [Code Analysis & Testing](#code-analysis--testing)
52+
- [Context Loading & Priming](#context-loading--priming)
53+
- [Documentation & Changelogs](#documentation--changelogs)
54+
- [CI / Deployment](#ci--deployment)
55+
- [Project & Task Management](#project--task-management)
56+
- [Miscellaneous](#miscellaneous)
57+
- [CLAUDE.md Files 📂](#claudemd-files-)
58+
- [Language-Specific](#language-specific)
59+
- [Domain-Specific](#domain-specific)
60+
- [Project Scaffolding & MCP](#project-scaffolding--mcp)
61+
- [Alternative Clients 📱](#alternative-clients-)
62+
- [General](#general-6)
63+
- [Official Documentation 🏛️](#official-documentation-%EF%B8%8F)
64+
- [General](#general-7)
6565

6666
## Agent Skills 🤖
6767

@@ -358,3 +358,5 @@ This project is released with a Code of Conduct. By participating, you agree to
358358

359359
This list is licensed under [Creative Commons CC BY-NC-ND 4.0](https://creativecommons.org/licenses/by-nc-nd/4.0/) - this means you are welcome to fork, clone, copy and redistribute the list, provided you include appropriate attribution; however you are not permitted to distribute any modified versions or to use it for any commercial purposes. This is to prevent disregard for the licenses of the authors whose resources are listed here. Please note that all resources included in this list have their own license terms.
360360

361+
362+
<!-- OBLIGATORY GUARD AGAINST SILLY END-OF-FILE PROBLEM -->

README_ALTERNATIVES/README_CLASSIC.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -154,7 +154,7 @@ A strong bundle of core competencies for software engineering, with good coverag
154154
</details>
155155

156156
- <details open>
157-
<summary><a href="#official-documentation--%EF%B8%8F">Official Documentation</a></summary>
157+
<summary><a href="#official-documentation-%EF%B8%8F-">Official Documentation</a></summary>
158158

159159
- [General](#general--7)
160160

0 commit comments

Comments
 (0)