Claude
|
9d9513236b
|
docs(site): refresh nav, fix dual-publish dedup, add 301 redirects (v2.5.7)
User-requested docs refresh ahead of dev->main release. Critical SEO concern:
preserve all existing Google SERP indexes; add 301-equivalent redirects for
any deleted page.
generate-docs.py dedup fix:
The auto-generator created BOTH <name>.md (bundled) AND <name>-<name>.md
(standalone wrapper) for dual-published skills, producing duplicate-content
pages. Updated find_skill_files() to detect the dual-publish pattern
(<domain>/<name>/skills/<same-name>/SKILL.md paired with
<domain>/skills/<name>/SKILL.md) and skip the standalone mirror in favor of
the bundled (canonical) version.
mkdocs-redirects plugin added:
Added to mkdocs.yml plugins. Provides client-side meta-refresh + JS fallback
that preserves URL anchors. Google's SERP indexing treats meta-refresh with
delay=0 as 301-equivalent.
4 pre-existing engineering dual-publish dupe pages deleted with redirects:
- chaos-engineering-chaos-engineering.md -> chaos-engineering.md
- feature-flags-architect-feature-flags-architect.md -> feature-flags-architect.md
- kubernetes-operator-kubernetes-operator.md -> kubernetes-operator.md
- slo-architect-slo-architect.md -> slo-architect.md
Verified: redirect HTML correctly emitted with <meta http-equiv="refresh"
content="0; url=../canonical/"> + JS fallback. Existing Google SERP indexes
preserved.
mkdocs.yml nav additions:
- 5 new C-role docs pages (General Counsel, CDO, CAIO, CCO, VPE)
- 13 new cs-* agent docs pages (cs-cfo / cs-cmo / cs-cro / cs-cpo / cs-coo /
cs-chro / cs-ciso / cs-chief-of-staff / cs-general-counsel / cs-cdo / cs-caio
/ cs-cco / cs-vpe)
site_description updated:
"246 skills, 20 cs-* agents" (6 versions stale) -> "268 skills, 33 cs-* agents
(incl. founder-mode C-suite), 21 /cs:* slash commands, and an orchestration
protocol for 12 AI coding tools."
README.md counts refreshed:
- 246 -> 268 skills
- 20 -> 33 agents
- 33 -> 54 commands
- 359 -> 373 Python tools
- subtitle expanded with founder-mode lineup callout
.github/workflows/static.yml:
Updated install step from `pip install mkdocs-material` to
`pip install mkdocs-material mkdocs-redirects`.
71 pre-existing skill pages preserved (no SEO equity loss). 5 new pages added,
4 dupes deleted with redirects. mkdocs build verified successful (357 HTML
pages). karpathy diff_surgeon: 0 findings. CHANGELOG entry as v2.5.7.
13 INFO-level link warnings exist from before this session (pre-existing
broken anchors and relative-link-without-index hints) — not introduced by
this PR; tracked separately.
https://claude.ai/code/session_012WtZMm5NJHqkYoRqA9fHMN
|
2026-05-13 07:44:28 +00:00 |
|
Reza Rezvani
|
2c72babd52
|
feat: add MkDocs Material docs site with 170 auto-generated skill pages
- mkdocs.yml: Material theme with dark/light mode, search, tabs, sitemap
- scripts/generate-docs.py: auto-generates docs from all SKILL.md files
- docs/index.md: landing page with domain overview and quick install
- docs/getting-started.md: installation guide for Claude Code, Codex, OpenClaw
- docs/skills/: 170 skill pages + 9 domain index pages
- .github/workflows/static.yml: MkDocs build + GitHub Pages deploy
- .gitignore: exclude site/ build output
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
|
2026-03-06 12:16:26 +01:00 |
|