Skip to content

Comments

fix(docs): Correct broken links and TOC anchors in multilingual documentation#8

Merged
arcaela merged 1 commit intomainfrom
fix/docs-links-issue-7
Dec 13, 2025
Merged

fix(docs): Correct broken links and TOC anchors in multilingual documentation#8
arcaela merged 1 commit intomainfrom
fix/docs-links-issue-7

Conversation

@arcaela
Copy link
Member

@arcaela arcaela commented Dec 13, 2025

Summary

Fixes #7

This PR resolves all broken documentation links and TOC anchor issues across the multilingual documentation (EN/ES/DE).

Changes Made

  • mkdocs.yml: Corrected navigation structure pointing to non-existent paths (guides/, api/)
  • TOC anchors: Fixed 47 broken anchor links
    • Removed accents from anchors (#introducción#introduccion)
    • Fixed triple-dash anchors (#primarykey---claves#primarykey-claves)
  • Cross-reference links: Updated links to match new documentation structure
  • decorators.de.md: Removed TOC entries for non-existent sections
  • Changelog: Added v1.0.21 entry in all three languages

Files Modified (28 files)

Category Files
Configuration mkdocs.yml
Changelog changelog.md, changelog.es.md, changelog.de.md
Homepage index.es.md, index.de.md
Installation installation.md, installation.es.md, installation.de.md
Getting Started getting-started.md, getting-started.es.md, getting-started.de.md
References client.*.md, decorators.*.md, core-concepts.*.md, migration.es.md
Examples basic.*.md, advanced.*.md, relations.*.md

Result

  • MkDocs build warnings: 47 → 0
  • All internal documentation links now resolve correctly
  • German navbar no longer appears incorrectly on 404 pages

Test plan

  • Run mkdocs build and verify 0 warnings
  • Navigate through documentation and verify all links work
  • Test all three languages (EN/ES/DE)
  • Verify TOC anchors navigate to correct sections

…entation

Fixes #7

- Fix mkdocs.yml navigation structure pointing to non-existent paths
- Fix 47 broken TOC anchor links (removed accents, fixed triple-dashes)
- Fix cross-reference links in installation, getting-started, and examples
- Fix decorators link format across client.md files
- Remove non-existent TOC entries from decorators.de.md
- Add v1.0.21 changelog entry in EN/ES/DE
@arcaela arcaela merged commit 36b9c27 into main Dec 13, 2025
1 of 3 checks passed
@arcaela arcaela deleted the fix/docs-links-issue-7 branch December 13, 2025 19:08
arcaela added a commit that referenced this pull request Dec 13, 2025
…entation (#8)

Fixes #7

- Fix mkdocs.yml navigation structure pointing to non-existent paths
- Fix 47 broken TOC anchor links (removed accents, fixed triple-dashes)
- Fix cross-reference links in installation, getting-started, and examples
- Fix decorators link format across client.md files
- Remove non-existent TOC entries from decorators.de.md
- Add v1.0.21 changelog entry in EN/ES/DE
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.

fix(docs): Correct broken links and TOC anchors in multilingual documentation

1 participant