Skip to content

docs: final review polish for link health and source references#142

Merged
johnxie merged 1 commit intomainfrom
docs/final-polish-pass
Feb 12, 2026
Merged

docs: final review polish for link health and source references#142
johnxie merged 1 commit intomainfrom
docs/final-polish-pass

Conversation

@johnxie
Copy link
Owner

@johnxie johnxie commented Feb 12, 2026

Summary\n- fixed confirmed broken external links across tutorials and contributor templates\n- replaced stale project links with canonical current sources (Goose, Dify, Perplexica, Deer Flow, Fabric, AutoGen, RAGFlow, Botpress, OpenBB, PhotoPrism)\n- updated template placeholders to avoid shipping known-dead example links\n- aligned CONTRIBUTING contact links with available repo endpoints\n\n## Validation\n- broken_link_count=0

new_broken_link_count=0
resolved_link_count=0
missing_index_count=0
placeholder_summary_count=0
structure_counts={"docs_only": 0, "index_only": 0, "mixed": 0, "root_only": 185}\n- v2_index_count=110
All format_version: v2 indexes contain required section categories.\n- regenerated derived assets:\n - Wrote manifest: /Users/johnxie/Documents/GitHub/awesome-code-docs/tutorials/tutorial-manifest.json
tutorial_count=185
structure_counts={"docs_only": 0, "index_only": 0, "mixed": 0, "root_only": 185}\n - Wrote JSON: /Users/johnxie/Documents/GitHub/awesome-code-docs/discoverability/tutorial-index.json
Wrote llms.txt: /Users/johnxie/Documents/GitHub/awesome-code-docs/llms.txt
Wrote llms-full.txt: /Users/johnxie/Documents/GitHub/awesome-code-docs/llms-full.txt
Wrote directory markdown: /Users/johnxie/Documents/GitHub/awesome-code-docs/discoverability/tutorial-directory.md
tutorial_count=185\n - Wrote: /Users/johnxie/Documents/GitHub/awesome-code-docs/tutorials/README.md
tutorial_directories=185
tutorial_markdown_files=1678
tutorial_markdown_lines=477603
structure_counts={'root_only': 185, 'docs_only': 0, 'index_only': 0, 'mixed': 0}\n - Wrote: /Users/johnxie/Documents/GitHub/awesome-code-docs/TUTORIAL_STRUCTURE.md
Wrote: /Users/johnxie/Documents/GitHub/awesome-code-docs/CONTENT_GAPS_ANALYSIS.md\n- custom external-link sweep of markdown links (full repo + changed-file subset):\n - hard failures (HTTP 404/410): 0\n - remaining transient errors were non-deterministic network resets on otherwise-200 GitHub URLs

@johnxie johnxie merged commit 61dea0f into main Feb 12, 2026
1 check passed
@johnxie johnxie deleted the docs/final-polish-pass branch February 12, 2026 16:39
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant