refactor: Move translated docs to /l/{locale}/ directory structure

[abdulrahmancodes]

No description provided.

[greptile-apps]

Greptile Overview

Greptile Summary

This PR restructures the translated documentation from a flat {locale}/ directory structure to a more organized /l/{locale}/ pattern. The change affects 71 files, primarily moving French documentation from packages/twenty-docs/fr/ to packages/twenty-docs/l/fr/.

Key changes:

• Updated crowdin.yml to output translations to /l/{locale}/ instead of {locale}/
• Refactored fix-translated-links.sh to work with the new structure and updated link patterns to include the /l/ prefix
• Updated docs.json navigation config with 188 path changes for French documentation
• Moved all 66 French MDX files to the new location
• Updated internal links in content files to use /l/fr/ prefix

Issues found:

• Broken links to /l/fr/developers/local-setup which doesn't exist (referenced in introduction and docker-compose pages)

Confidence Score: 4/5

• Safe to merge with minor documentation link issues that should be addressed
• The refactoring is well-executed with consistent updates across configuration, scripts, and content. However, broken links to the non-existent French local-setup page reduce confidence from 5 to 4. These are not critical runtime errors but will create a poor user experience for French documentation readers.
• packages/twenty-docs/l/fr/developers/introduction.mdx and packages/twenty-docs/l/fr/developers/self-hosting/docker-compose.mdx contain broken links to /l/fr/developers/local-setup

Important Files Changed

File Analysis

Filename	Score	Overview
crowdin.yml	5/5	Updated translation paths to include /l/ prefix for locale-based directory structure
packages/twenty-docs/scripts/fix-translated-links.sh	5/5	Refactored to work with new /l/{locale}/ structure, simplified directory detection logic
packages/twenty-docs/docs.json	5/5	Updated all French documentation paths from fr/ to l/fr/ prefix throughout navigation structure
packages/twenty-docs/l/fr/developers/introduction.mdx	4/5	Moved from fr/ to l/fr/ with updated internal links, but references non-existent /l/fr/developers/local-setup

Sequence Diagram

sequenceDiagram
    participant Dev as Developer
    participant Crowdin as Crowdin Service
    participant Script as fix-translated-links.sh
    participant Docs as Documentation System
    
    Dev->>Crowdin: Push English MDX files
    Note over Dev,Crowdin: Source: packages/twenty-docs/{section}/**/*.mdx
    
    Crowdin->>Crowdin: Translate content
    Note over Crowdin: Translators work on content
    
    Crowdin->>Docs: Pull translations to /l/{locale}/ directory
    Note over Docs: New structure: packages/twenty-docs/l/fr/{section}/**/*.mdx
    
    Script->>Docs: Scan /l/{locale}/ directories
    Script->>Script: Process each locale
    
    loop For each MDX file
        Script->>Docs: Update href="/user-guide/" to href="/l/{locale}/user-guide/"
        Script->>Docs: Update href="/developers/" to href="/l/{locale}/developers/"
        Script->>Docs: Update markdown links similarly
        Script->>Docs: Update full docs.twenty.com URLs
    end
    
    Script->>Docs: Clean up .bak files
    
    Note over Docs: All internal links now use /l/{locale}/ prefix
    Note over Docs: docs.json updated with new paths

Loading

Additional Comments (1)

1. packages/twenty-docs/l/fr/developers/self-hosting/docker-compose.mdx, line 1 (link)

   logic: This file also references the non-existent /l/fr/developers/local-setup page (full URL in content).

_{71 files reviewed, 2 comments}

_{Edit Code Review Agent Settings | Greptile}

[github-actions]

Thanks @abdulrahmancodes for your contribution!
This marks your 73rd PR on the repo. You're top 1% of all our contributors 🎉
See contributor page - Share on LinkedIn - Share on Twitter