Skip to content

i18n(es): translate docs in ecosystem/packages directory#230

Merged
Adammatthiesen merged 4 commits into
mainfrom
es-up-03
Feb 21, 2026
Merged

i18n(es): translate docs in ecosystem/packages directory#230
Adammatthiesen merged 4 commits into
mainfrom
es-up-03

Conversation

@dreyfus92
Copy link
Copy Markdown
Member

@dreyfus92 dreyfus92 commented Feb 21, 2026

Description

  • What does this PR change? Give us a brief description.
    Translates docs in ecosystem/packages directory

Summary by CodeRabbit

  • Documentation
    • Added Spanish documentation for several ecosystem packages (Buildkit, CFetch, Kysely, Markdown Remark, SDK, StudioCMS UI, Template Language). Each guide includes installation and configuration steps, usage examples (CLI and API patterns), supported options/flags, sample code snippets, integration guidance, and references to related resources to aid implementation and adoption.

@dreyfus92 dreyfus92 requested a review from a team as a code owner February 21, 2026 01:04
@htg-1-studiocms-cloud
Copy link
Copy Markdown

htg-1-studiocms-cloud Bot commented Feb 21, 2026

Dokploy Preview Deployment

Name Status Preview Updated (UTC)
StudioCMS Docs ✅ Done Preview URL 2026-02-21T02:29:34.935Z

@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented Feb 21, 2026

📝 Walkthrough

Walkthrough

Seven new Spanish documentation pages added under src/content/docs/es/ecosystem/packages/: buildkit.mdx, cfetch.mdx, kysely.mdx, markdown-remark.mdx, sdk.mdx, studiocms-ui.mdx, and template-lang.mdx. Each file includes frontmatter, MDX component imports, usage guidance, code examples, and API/reference content. No runtime or public API changes.

Changes

Cohort / File(s) Summary
Spanish Ecosystem Package Documentation
src/content/docs/es/ecosystem/packages/buildkit.mdx, src/content/docs/es/ecosystem/packages/cfetch.mdx, src/content/docs/es/ecosystem/packages/kysely.mdx, src/content/docs/es/ecosystem/packages/markdown-remark.mdx, src/content/docs/es/ecosystem/packages/sdk.mdx, src/content/docs/es/ecosystem/packages/studiocms-ui.mdx, src/content/docs/es/ecosystem/packages/template-lang.mdx
Adds seven Spanish MDX docs covering installation, configuration, CLI usage (where applicable), API surfaces, code samples, and i18n frontmatter. Review focus: accuracy of code examples, frontmatter keys (i18nReady, catalogEntry, tableOfContents), and imported MDX components/shortcodes.

Sequence Diagram(s)

(omitted — changes are documentation only)

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Possibly related PRs

Suggested reviewers

  • Adammatthiesen
  • louisescher

Poem

🐰 Saltando entre bytes y luz,
Nuevas páginas en español, qué virtud.
Buildkit y cFetch, versos en papel,
Kysely y SDK marcan el laurel.
¡Salta la doc, celebra y come un pastel!

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The PR title clearly and concisely describes the main change: adding Spanish translations for documentation in the ecosystem/packages directory. It directly matches the changeset content.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch es-up-03

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@studiocms-no-reply
Copy link
Copy Markdown
Member

studiocms-no-reply commented Feb 21, 2026

Lunaria Status Overview

🌕 This pull request will trigger status changes.

Learn more

By default, every PR changing files present in the Lunaria configuration's files property will be considered and trigger status changes accordingly.

You can change this by adding one of the keywords present in the ignoreKeywords property in your Lunaria configuration file in the PR's title (ignoring all files) or by including a tracker directive in the merged commit's description.

Tracked Files

File Note
es/ecosystem/packages/buildkit.mdx Localization added, will be marked as complete.
es/ecosystem/packages/cfetch.mdx Localization added, will be marked as complete.
es/ecosystem/packages/kysely.mdx Localization added, will be marked as complete.
es/ecosystem/packages/markdown-remark.mdx Localization added, will be marked as complete.
es/ecosystem/packages/sdk.mdx Localization added, will be marked as complete.
es/ecosystem/packages/studiocms-ui.mdx Localization added, will be marked as complete.
es/ecosystem/packages/template-lang.mdx Localization added, will be marked as complete.
Warnings reference
Icon Description
🔄️ The source for this localization has been updated since the creation of this pull request, make sure all changes in the source have been applied.

Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 9

🧹 Nitpick comments (1)
src/content/docs/es/ecosystem/packages/sdk.mdx (1)

23-25: Duplicate ReadMore blocks pointing to the same URL.

Lines 23–25 and lines 46–48 both link to /es/how-it-works/sdk/ with near-identical content. Consider removing one or differentiating them (e.g., keeping only the one in the "Lecturas adicionales" section).

Also applies to: 46-48

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@src/content/docs/es/ecosystem/packages/sdk.mdx` around lines 23 - 25, There
are duplicate ReadMore blocks both linking to /es/how-it-works/sdk/ (the
ReadMore component at lines 23–25 and again at 46–48); remove one of them
(preferably delete the earlier ReadMore or the non-"Lecturas adicionales"
instance) so only the intended "Lecturas adicionales" ReadMore remains, or
alternatively change the copy/URL of one to point to a different resource to
avoid duplication; locate the ReadMore component instances in
src/content/docs/es/ecosystem/packages/sdk.mdx and remove or modify the
duplicate.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@src/content/docs/es/ecosystem/packages/buildkit.mdx`:
- Line 16: The introductory sentence "Este es un kit CLI basado en esbuild para
construir integraciones Astro" is missing a trailing period; update that line in
src/content/docs/es/ecosystem/packages/buildkit.mdx to end with a period so it
reads "Este es un kit CLI basado en esbuild para construir integraciones Astro."
ensuring punctuation consistency.
- Line 66: The sentence "Para otros tipos de contenido y cómo usarlos, consulte
[la documentación de esbuild](https://esbuild.github.io/content-types/)" is
missing a terminal period; update that string in the Markdown/MDX content so it
ends with a period, i.e. append "." to the sentence text in src content where
the link appears (the exact sentence in buildkit.mdx).
- Around line 50-51: Reemplaza el artículo masculino "Los" por el femenino "Las"
en la oración que empieza "Los siguientes extensiones de archivo..." para que
concuerde con el sustantivo femenino "extensiones" — es decir, cambia esa frase
a "Las siguientes extensiones de archivo se copiarán de su src a sus respectivas
salidas y no se transformarán como si fueran activos estáticos."

In `@src/content/docs/es/ecosystem/packages/cfetch.mdx`:
- Line 17: The introductory sentence "Esta es una [integración de
Astro](https://docs.astro.build/es/guides/integrations-guide/) que proporciona
una función fetch con caché para proyectos Astro SSR" is missing a trailing
period; update that line in src/content/docs/es/ecosystem/packages/cfetch.mdx so
the sentence ends with a period (i.e., append "." to the end of the sentence) to
correct punctuation.

In `@src/content/docs/es/ecosystem/packages/kysely.mdx`:
- Line 18: Fix the spacing in the sentence by adding a space before the
parenthetical so "libSQL(SQLite)" becomes "libSQL (SQLite)"; update the text in
the markdown/MDX content where the phrase appears (the line containing
"Actualmente StudioCMS solo soporta bases de datos libSQL(SQLite), MySQL y
PostgreSQL via Kysely.") to read "libSQL (SQLite)".
- Around line 256-257: The exported function is misnamed `insertUser` while its
implementation and internal variable use `getUserById`; rename the export from
`insertUser` to `getUserById` (update the `export const insertUser =
Effect.gen(...)` declaration to `export const getUserById = Effect.gen(...)`)
and adjust any local references or re-exports that expect `insertUser` so they
now reference `getUserById` (check usages around `getDbClient` / `withCodec` to
ensure imports/exports remain consistent).

In `@src/content/docs/es/ecosystem/packages/markdown-remark.mdx`:
- Line 152: The sentence "Este proyecto está fuertemente basado en y compatible
con el paquete integrado de Astro `@astrojs/markdown-remark`" is missing a
period; update that string by appending a period so the sentence ends with
"…`@astrojs/markdown-remark`." ensuring proper punctuation before the next
heading.

In `@src/content/docs/es/ecosystem/packages/template-lang.mdx`:
- Line 123: Replace the untranslated English section heading "### Default
Values" with its Spanish equivalent to match surrounding headings; locate the
heading string "### Default Values" in the file and change it to "### Valores
predeterminados" (preserve Markdown heading level and spacing).
- Line 17: Translate the English sentence that describes the package into
Spanish: replace the line that reads "`@withstudiocms/template-lang` is a simple
MIT Licensed TypeScript ESM template language for HTML emails, similar to
Handlebars but focused on simplicity and database data integration." with an
equivalent Spanish sentence while keeping the package identifier
`@withstudiocms/template-lang`, license mention (MIT), and technical terms
(TypeScript, ESM, HTML emails, Handlebars) intact so readers can still recognize
the package and functionality.

---

Nitpick comments:
In `@src/content/docs/es/ecosystem/packages/sdk.mdx`:
- Around line 23-25: There are duplicate ReadMore blocks both linking to
/es/how-it-works/sdk/ (the ReadMore component at lines 23–25 and again at
46–48); remove one of them (preferably delete the earlier ReadMore or the
non-"Lecturas adicionales" instance) so only the intended "Lecturas adicionales"
ReadMore remains, or alternatively change the copy/URL of one to point to a
different resource to avoid duplication; locate the ReadMore component instances
in src/content/docs/es/ecosystem/packages/sdk.mdx and remove or modify the
duplicate.

Comment thread src/content/docs/es/ecosystem/packages/buildkit.mdx Outdated
Comment thread src/content/docs/es/ecosystem/packages/buildkit.mdx Outdated
Comment thread src/content/docs/es/ecosystem/packages/buildkit.mdx Outdated
Comment thread src/content/docs/es/ecosystem/packages/cfetch.mdx
Comment thread src/content/docs/es/ecosystem/packages/kysely.mdx
Comment thread src/content/docs/es/ecosystem/packages/kysely.mdx
Comment thread src/content/docs/es/ecosystem/packages/markdown-remark.mdx
Comment thread src/content/docs/es/ecosystem/packages/template-lang.mdx Outdated
Comment thread src/content/docs/es/ecosystem/packages/template-lang.mdx Outdated
Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

🧹 Nitpick comments (1)
src/content/docs/es/ecosystem/packages/buildkit.mdx (1)

49-49: Lowercase assets in Spanish prose.

In Spanish, "Assets" (line 49) is a common noun and should be written in lowercase. The capitalised English form reads as a proper noun.

✏️ Proposed fix
-#### Archivos considerados como Assets
+#### Archivos considerados como assets
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@src/content/docs/es/ecosystem/packages/buildkit.mdx` at line 49, Update the
heading "#### Archivos considerados como Assets" so the noun "Assets" is
lowercase in Spanish prose; replace that header with "#### Archivos considerados
como assets" (i.e., change the word Assets → assets) to conform to Spanish
capitalization rules.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@src/content/docs/es/ecosystem/packages/buildkit.mdx`:
- Line 28: The sentence "Una vez que instales el paquete buildkit, ahora tienes
acceso a una utilidad CLI `buildkit`, añade lo siguiente a tus scripts de
integración:" contains a comma splice; split it into two sentences by replacing
the comma before "añade" with a period and capitalizing "Añade" (e.g.,
"...utilidad CLI `buildkit`. Añade lo siguiente a tus scripts de integración:")
so the two independent clauses are properly separated.

In `@src/content/docs/es/ecosystem/packages/template-lang.mdx`:
- Line 17: Update the package description for `@withstudiocms/template-lang` to
correct Spanish grammar: replace "MIT Licenciado" with "con licencia MIT" (or
"bajo licencia MIT") and change "y integración" to "e integración" so the
sentence reads naturally in Spanish and follows the euphony rule before words
beginning with "i"/"hi".

---

Nitpick comments:
In `@src/content/docs/es/ecosystem/packages/buildkit.mdx`:
- Line 49: Update the heading "#### Archivos considerados como Assets" so the
noun "Assets" is lowercase in Spanish prose; replace that header with "####
Archivos considerados como assets" (i.e., change the word Assets → assets) to
conform to Spanish capitalization rules.

Comment thread src/content/docs/es/ecosystem/packages/buildkit.mdx
Comment thread src/content/docs/es/ecosystem/packages/template-lang.mdx Outdated
Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🧹 Nitpick comments (1)
src/content/docs/es/ecosystem/packages/template-lang.mdx (1)

46-46: Adjective placement makes simple ambiguous.

"para interpolación de variables simple" places simple immediately after variables (feminine plural), so it reads as "simple variables" and would need simples. Moving the adjective clarifies that it modifies interpolación:

✏️ Proposed fix
-Está principalmente diseñado para interpolación de variables simple.
+Está principalmente diseñado para la interpolación simple de variables.
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@src/content/docs/es/ecosystem/packages/template-lang.mdx` at line 46, The
phrase "para interpolación de variables simple" misplaces the adjective so it
appears to modify "variables"; update the sentence in the text that currently
reads "A diferencia de otros lenguajes de plantillas, el lenguaje de plantillas
de StudioCMS se enfoca en la simplicidad y no incluye lógica compleja o
estructuras de control. Está principalmente diseñado para interpolación de
variables simple." to place "simple" next to "interpolación" (for example: "Está
principalmente diseñado para la interpolación simple de variables" or "Está
principalmente diseñado para la interpolación de variables de forma simple") so
the adjective clearly modifies "interpolación."
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@src/content/docs/es/ecosystem/packages/template-lang.mdx`:
- Line 38: The opening sentence has a subject–verb/person mismatch: "Para
aquellos interesados en usar el lenguaje de plantillas de StudioCMS en sus
proyectos, puedes instalarlo usando tu gestor de paquetes preferido:" — either
make the whole sentence third person plural (e.g., change "puedes" → "pueden"
and "tu gestor" → "su gestor") or convert the opener to second person singular
(e.g., change "Para aquellos interesados" → "Si estás interesado" or "Para ti
interesado") so subject and verbs/pronouns agree; update the clause containing
"puedes instalarlo" and "tu gestor de paquetes preferido" accordingly to match
the chosen person.

---

Duplicate comments:
In `@src/content/docs/es/ecosystem/packages/template-lang.mdx`:
- Line 17: In the sentence describing `@withstudiocms/template-lang`, replace
the conjunction "y integración" with "e integración" to follow Spanish euphony
rules (since "integración" begins with "i"); edit the string containing
"`@withstudiocms/template-lang` es un lenguaje..." so it reads "...TypeScript
ESM e licencia MIT para plantillas..." (ensure only the conjunction before
"integración" is changed).

---

Nitpick comments:
In `@src/content/docs/es/ecosystem/packages/template-lang.mdx`:
- Line 46: The phrase "para interpolación de variables simple" misplaces the
adjective so it appears to modify "variables"; update the sentence in the text
that currently reads "A diferencia de otros lenguajes de plantillas, el lenguaje
de plantillas de StudioCMS se enfoca en la simplicidad y no incluye lógica
compleja o estructuras de control. Está principalmente diseñado para
interpolación de variables simple." to place "simple" next to "interpolación"
(for example: "Está principalmente diseñado para la interpolación simple de
variables" or "Está principalmente diseñado para la interpolación de variables
de forma simple") so the adjective clearly modifies "interpolación."

Comment thread src/content/docs/es/ecosystem/packages/template-lang.mdx
@Adammatthiesen Adammatthiesen merged commit 63b51e1 into main Feb 21, 2026
8 checks passed
@Adammatthiesen Adammatthiesen deleted the es-up-03 branch February 21, 2026 02:32
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants