Skip to content

Fix IA quick wins: broken links, naming conflicts, file artifacts#1857

Draft
huth-stacks wants to merge 1 commit intostacks-network:masterfrom
huth-stacks:fix/ia-quick-wins
Draft

Fix IA quick wins: broken links, naming conflicts, file artifacts#1857
huth-stacks wants to merge 1 commit intostacks-network:masterfrom
huth-stacks:fix/ia-quick-wins

Conversation

@huth-stacks
Copy link
Copy Markdown
Collaborator

Summary

Four low-risk IA fixes identified by documentation architecture review. No content changes.

Changes

  1. Cookbook README - Fixed 2 broken card links (/broken/spaces/...) → correct paths to stacks.js/ and clarity/
  2. Build sidebar - Renamed "Learn Clarinet" / "Learn Rendezvous" / "Learn Stacks.js" → "Clarinet" / "Rendezvous" / "Stacks.js" (removes confusing "Learn" prefix that conflicts with top-level Learn section)
  3. Press archives - Renamed september-2025-1.mdoctober-2025.md, september-2025-2.mdnovember-2025.md (copy-paste naming errors)
  4. Reference - Renamed README (1).mdstacks-node-configuration.md (GitBook duplicate-file artifact)

Context

These are quick wins from a documentation IA review that scored the overall docs at 5.7/10. These fixes address the lowest-hanging fruit without requiring structural changes.

Test plan

  • Verify Cookbook card links navigate to correct recipe sections
  • Verify Build sidebar shows "Clarinet" not "Learn Clarinet"
  • Verify Press October/November links resolve correctly
  • Verify Reference "Stacks Node Configuration" page loads

🤖 Generated with Claude Code

- Fix Cookbook README: replace 2 broken /broken/spaces/ card links
  with correct paths to stacks.js/ and clarity/ recipe sections
- Rename "Learn Clarinet"/"Learn Rendezvous"/"Learn Stacks.js" to
  "Clarinet"/"Rendezvous"/"Stacks.js" in Build sidebar (removes
  confusing "Learn" prefix that conflates with top-level Learn section)
- Rename misnamed Press files: september-2025-1.md → october-2025.md,
  september-2025-2.md → november-2025.md (copy-paste naming errors)
- Rename Reference "README (1).md" → stacks-node-configuration.md
  (GitBook duplicate-file naming artifact)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@CLAassistant
Copy link
Copy Markdown

CLAassistant commented Mar 25, 2026

CLA assistant check
All committers have signed the CLA.

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.

2 participants