Spanish translation of official ENS docs to remove language barrier #466
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
added 9 commits
September 3, 2025 16:05
- Create src/pages/es/ directory - Add initial translated pages: web/, learn/, faq, terminology - Follow English/Spanish format for all files - Translate core user-facing pages: * index.mdx - Main landing page * faq.mdx - Frequently Asked Questions * terminology.mdx - Technical terminology glossary * web/index.mdx - Getting started with ENS integration * web/quickstart.mdx - Quickstart guide for developers * web/libraries.mdx - Tools and libraries * web/resolution.mdx - Address resolution guide * web/subdomains.mdx - Subdomain management * learn/protocol.mdx - ENS protocol overview * learn/dns.mdx - DNS integration guide * registry/eth.mdx - ETH registrar documentation * registry/dns.mdx - DNS registrar documentation * resolvers/quickstart.mdx - Resolver quickstart * resolution/names.mdx - Name processing and normalization * dns/tlds.mdx - Supported TLD list * dao/proposals/4.10.mdx - Root key transfer proposal * dao/proposals/5.1.mdx - DNSSEC upgrade proposal
- Add resolvers/interfaces.mdx - Resolver interface standards - Add resolvers/ccip-read.mdx - Offchain/L2 resolvers documentation - Add wrapper/overview.mdx - Name Wrapper overview - Add resolution/index.mdx - Resolution process documentation This ensures ALL internal links work correctly and users never encounter 404s. Verified: 0 broken internal links remaining.
- Fix 'Ethereum Name Service' to maintain proper capitalization - Correct 'registrador' to 'registrar' (technical term) - Fix 'Controlador' to 'Controller' (technical term) - Correct 'Registrador ETH' to 'ETH Registrar' (proper naming) - Fix 'Registro' vs 'Record' vs 'Registration' terminology - Improve natural Spanish flow while maintaining technical accuracy - Ensure consistency across all translated files
- Fix links to DAO pages (stewards, constitution) to point to English versions - Fix links to wrapper pages (fuses, creating-subname-registrar) to point to English versions - Fix links to resolver pages (writing, public, interacting) to point to English versions - Fix links to registry pages (ens, reverse) to point to English versions - Fix links to web pages (naming-contracts, reverse) to point to English versions - Fix links to learn pages (ccip-read) to point to English versions - All links now point to existing pages, ensuring no 404 errors
- Fix link to resolvers/writing#offchain-resolvers to point to English version - All dead links now resolved
- Fix import path from '../../components/Properties' to '../../../components/Properties' - Resolves build error for ccip-read.mdx
- Fix all component import paths to use '../../../components/' instead of '../../components/' - Ensures proper resolution of components from resolvers subdirectory
|
Follow-up commit: fixed internal links in Spanish pages to avoid dead routes (use /es prefix only where translations exist; otherwise link to English). Also replaced placeholder text on es/index.mdx.\n\n- Built locally with Node 24, pnpm 9.15.5, bun: build passes without dead links\n- Scope limited to files under src/pages/es/**\n\nHappy to adjust if you prefer different linking policy for untranslated pages. |
imrulo
changed the title
|
I appreciate the effort but unfortunately we aren’t prepared to maintain multilingual docs at this point |
Totally understand 👍 Thanks for clarifying. If you ever open docs to translations, I’d be glad to help with Spanish. |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Purpose\n- Translate the official ENS documentation into Spanish to remove the language barrier for Spanish-speaking users and communities.\n- Enable more people to learn about and adopt Ethereum Name Service in their native language.\n\nScope\n- Adds Spanish pages under src/pages/es/**.\n- Keeps links consistent: uses /es routes when available, falls back to English when a Spanish page doesn’t yet exist.\n\nStatus\n- Built locally successfully (no dead links).\n- Open for review from maintainers. Feedback is welcome to ensure accuracy and tone.\n\nThank you for reviewing.