Skip to content

i18n(es): translate last batch of docs#235

Merged
dreyfus92 merged 4 commits intomainfrom
es-up-06
Feb 23, 2026
Merged

i18n(es): translate last batch of docs#235
dreyfus92 merged 4 commits intomainfrom
es-up-06

Conversation

@dreyfus92
Copy link
Member

@dreyfus92 dreyfus92 commented Feb 23, 2026

Description

  • What does this PR change? Give us a brief description.
    Translates last batch of docs

Summary by CodeRabbit

  • Documentation
    • Added Spanish upgrade guides for 0.1.0-beta.18–beta.21 covering breaking changes, bugfixes and migration steps.
    • Notes include: new hooks/plugin and Effect-based directions, Node.js 20+ requirement, config structure updates, image service migration to a plugin, Web Vitals guidance, CLI-related refactor notes, and a repeated warning about password hash algorithm changes and post-upgrade actions.

@dreyfus92 dreyfus92 requested a review from a team as a code owner February 23, 2026 15:39
@htg-1-studiocms-cloud
Copy link

htg-1-studiocms-cloud bot commented Feb 23, 2026

Dokploy Preview Deployment

Name Status Preview Updated (UTC)
StudioCMS Docs ✅ Done Preview URL 2026-02-23T16:10:04.519Z

@coderabbitai
Copy link
Contributor

coderabbitai bot commented Feb 23, 2026

Warning

Rate limit exceeded

@dreyfus92 has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 3 minutes and 55 seconds before requesting another review.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

📥 Commits

Reviewing files that changed from the base of the PR and between b280836 and cc9f697.

📒 Files selected for processing (1)
  • src/content/docs/es/guides/upgrade/version-guides/0-1-0-beta-19.mdx
📝 Walkthrough

Walkthrough

Adds four new Spanish upgrade guide pages for StudioCMS v0.1.0-beta.18 through v0.1.0-beta.21, each with i18n frontmatter, imported UI components, QuickUpdate rendering, Spanish notes on important changes and bug fixes, and links/aside warnings about password hash algorithm changes.

Changes

Cohort / File(s) Summary
Spanish Upgrade Guides
src/content/docs/es/guides/upgrade/version-guides/0-1-0-beta-18.mdx, src/content/docs/es/guides/upgrade/version-guides/0-1-0-beta-19.mdx, src/content/docs/es/guides/upgrade/version-guides/0-1-0-beta-20.mdx, src/content/docs/es/guides/upgrade/version-guides/0-1-0-beta-21.mdx
Added four Spanish-language upgrade guide pages (beta.18 → beta.21). Each file adds frontmatter (i18nReady, title, description, topic/sidebar metadata), imports QuickUpdate, ReadMore, Aside, renders QuickUpdate, and includes sections on notable changes, bug fixes, migration notes, and password-hash aside warnings with internal/external links.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~8 minutes

Possibly related PRs

Suggested reviewers

  • Adammatthiesen
  • RATIU5

Poem

🐰 En español salto y canto, cuatro guías a la vez,
Beta dieciocho a veintiuno, pasos escritos al revés,
Advertencias, enlaces y cambios marcados,
Con un QuickUpdate y aside bien pegados,
¡Brinca y actualiza, todo está documentado!

🚥 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 title clearly and specifically summarizes the main change: translating the final batch of Spanish documentation files for version upgrade guides (0.1.0-beta-18 through beta-21).
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-06

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
Member

studiocms-no-reply commented Feb 23, 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/guides/upgrade/version-guides/0-1-0-beta-18.mdx Localization added, will be marked as complete.
es/guides/upgrade/version-guides/0-1-0-beta-19.mdx Localization added, will be marked as complete.
es/guides/upgrade/version-guides/0-1-0-beta-20.mdx Localization added, will be marked as complete.
es/guides/upgrade/version-guides/0-1-0-beta-21.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.

@dreyfus92 dreyfus92 changed the title translate: last batch of docs i18n(es): translate last batch of docs Feb 23, 2026
Copy link
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: 6

🤖 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/guides/upgrade/version-guides/0-1-0-beta-18.mdx`:
- Around line 25-27: The Aside titled "Nota" currently mentions "beta.17" but
this page is the `beta.18` upgrade guide; update the version reference in that
Aside so it reads `beta.18` (or reword to clarify it applies to upgrades from
`beta.17` onward) by editing the Aside block (Aside title="Nota") to replace
`beta.17` with `beta.18` or add the clarifying phrasing.

In `@src/content/docs/es/guides/upgrade/version-guides/0-1-0-beta-19.mdx`:
- Around line 23-24: Corrige la puntuación y mayúsculas en las dos frases
señaladas: en la línea que contiene "Integrado [Effect][effect-website], y
migrado..." cambia "(las funciones antiguas..." por "(Las funciones antiguas..."
para capitalizar la parentética; en la línea que menciona
"`@studiocms/web-vitals`" inserta la coma después de "por favor" ("por favor,
actualiza") y añade la coma antes de "ya que" ("futuros problemas, ya que
planeamos") para mejorar la claridad y corrección gramatical.
- Line 20: The bullet point currently in English referencing
`studiocms.config.*` should be translated into Spanish (file is marked
i18nReady: true); replace the English sentence "New Config structure, please
verify your `studiocms.config.*` file when updating. Config files can also end
in `.js`, `.mjs`, `.ts`, `.mts` now! Allowing flexibility, and full
type-safety." with a Spanish equivalent, preserving the inline backticks and
file extensions (e.g., "Nueva estructura de configuración: por favor verifica tu
archivo `studiocms.config.*` al actualizar. Los archivos de configuración
también pueden terminar en `.js`, `.mjs`, `.ts`, `.mts` ahora, lo que permite
flexibilidad y tipado completo."). Ensure punctuation and capitalization match
the rest of the Spanish document.
- Line 39: The [web-vitals-guide] link currently points to /es/package-catalog/
while there is a Spanish-only doc "web-vitals.mdx" marked i18nReady, causing an
i18n mismatch; either remove the Spanish-only page or create the corresponding
English translation and clear/update its i18nReady flag so both locales exist,
and then ensure the [web-vitals-guide] reference and its target (the
package-catalog index) are consistent across languages (update the link target
if you create the English page or remove the Spanish page to keep the original
/en link).

In `@src/content/docs/es/guides/upgrade/version-guides/0-1-0-beta-20.mdx`:
- Line 19: Reemplaza la forma verbal "falle" por el imperfecto de subjuntivo
"fallara" en la frase "causando que la configuración inicial falle" dentro del
texto (la oración que comienza con "Corregidas las rutas de configuración
inicial..."), de modo que quede "causando que la configuración inicial fallara"
para reflejar correctamente el evento pasado.

In `@src/content/docs/es/guides/upgrade/version-guides/0-1-0-beta-21.mdx`:
- Around line 3-4: Replace the untranslated English frontmatter values for the
title and description fields: change the title field value from "Upgrade:
0.1.0-beta.21" to "Actualización: 0.1.0-beta.21" and change the description
field value from "Upgrade StudioCMS to Beta.21" to "Actualiza StudioCMS a
Beta.21" so they match the Spanish pattern used by the other upgrade guides;
update the 'title' and 'description' entries accordingly in the file.

ℹ️ Review info

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between d6ca66b and 313d3fd.

📒 Files selected for processing (4)
  • src/content/docs/es/guides/upgrade/version-guides/0-1-0-beta-18.mdx
  • src/content/docs/es/guides/upgrade/version-guides/0-1-0-beta-19.mdx
  • src/content/docs/es/guides/upgrade/version-guides/0-1-0-beta-20.mdx
  • src/content/docs/es/guides/upgrade/version-guides/0-1-0-beta-21.mdx

Copy link
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

♻️ Duplicate comments (2)
src/content/docs/es/guides/upgrade/version-guides/0-1-0-beta-19.mdx (2)

24-24: ⚠️ Potential issue | 🟡 Minor

"Nota," should use a colon, not a comma

"Nota, Astro ha desaprobado..." — in Spanish, when "Nota" introduces an explanatory clause, the correct punctuation is a colon: "Nota: Astro ha desaprobado...".

✏️ Proposed fix
-- Añadido soporte para `@studiocms/web-vitals` para reemplazar `@astrojs/web-vitals` en el futuro. Nota, Astro ha desaprobado `@astrojs/web-vitals` y nos ha pedido que mantengamos el paquete, por favor, actualiza al nuevo paquete para prevenir futuros problemas, ya que planeamos eliminar el soporte para el paquete antiguo en una actualización futura.
+- Añadido soporte para `@studiocms/web-vitals` para reemplazar `@astrojs/web-vitals` en el futuro. Nota: Astro ha desaprobado `@astrojs/web-vitals` y nos ha pedido que mantengamos el paquete, por favor, actualiza al nuevo paquete para prevenir futuros problemas, ya que planeamos eliminar el soporte para el paquete antiguo en una actualización futura.
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@src/content/docs/es/guides/upgrade/version-guides/0-1-0-beta-19.mdx` at line
24, Replace the comma after "Nota" with a colon in the sentence that begins
"Nota, Astro ha desaprobado `@astrojs/web-vitals`..." so it reads "Nota: Astro
ha desaprobado..."; locate the sentence in the paragraph that mentions "Añadido
soporte para `@studiocms/web-vitals`..." and update the punctuation accordingly.

39-39: ⚠️ Potential issue | 🟡 Minor

[web-vitals-guide] points to the package catalog root

[web-vitals-guide]: /es/package-catalog/ resolves to the top-level catalog index rather than the Web-Vitals plugin page. A Spanish-specific page (/es/package-catalog/community-plugins/web-vitals.mdx) already exists. This was flagged in a prior review.

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

In `@src/content/docs/es/guides/upgrade/version-guides/0-1-0-beta-19.mdx` at line
39, The reference `[web-vitals-guide]: /es/package-catalog/` points to the
package catalog root instead of the Web-Vitals plugin page; update the reference
target for `[web-vitals-guide]` to the Spanish plugin page (use the existing
community-plugins web-vitals path, e.g. change `/es/package-catalog/` to
`/es/package-catalog/community-plugins/web-vitals/`) so the label resolves to
the correct Web-Vitals doc.
🤖 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/guides/upgrade/version-guides/0-1-0-beta-19.mdx`:
- Line 20: Reescribe la frase compuesta que deja el participio colgando y
corrige el término técnico: reemplaza `"Los archivos de configuración también
pueden terminar en `.js`, `.mjs`, `.ts`, `.mts` ahora! Permitiendo flexibilidad
y seguridad de tipo completa."` por una sola oración conectada (por ejemplo:
`Los archivos de configuración también pueden terminar en .js, .mjs, .ts o .mts,
lo que permite flexibilidad y seguridad de tipos completa.`) y cambia
`"seguridad de tipo"` a `"seguridad de tipos"`; busca la cadena
`studiocms.config.*` en el archivo `0-1-0-beta-19.mdx` para aplicar el ajuste.

---

Duplicate comments:
In `@src/content/docs/es/guides/upgrade/version-guides/0-1-0-beta-19.mdx`:
- Line 24: Replace the comma after "Nota" with a colon in the sentence that
begins "Nota, Astro ha desaprobado `@astrojs/web-vitals`..." so it reads "Nota:
Astro ha desaprobado..."; locate the sentence in the paragraph that mentions
"Añadido soporte para `@studiocms/web-vitals`..." and update the punctuation
accordingly.
- Line 39: The reference `[web-vitals-guide]: /es/package-catalog/` points to
the package catalog root instead of the Web-Vitals plugin page; update the
reference target for `[web-vitals-guide]` to the Spanish plugin page (use the
existing community-plugins web-vitals path, e.g. change `/es/package-catalog/`
to `/es/package-catalog/community-plugins/web-vitals/`) so the label resolves to
the correct Web-Vitals doc.

ℹ️ Review info

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 313d3fd and b280836.

📒 Files selected for processing (1)
  • src/content/docs/es/guides/upgrade/version-guides/0-1-0-beta-19.mdx

@coderabbitai
Copy link
Contributor

coderabbitai bot commented Feb 23, 2026

@dreyfus92, I apologize if my previous suggestion wasn't helpful. I'll approve this PR as requested. The Spanish translations look good to go.


🧠 Learnings used
Learnt from: ArmandPhilippot
Repo: withstudiocms/docs PR: 149
File: src/content/docs/fr/guides/upgrade/version-guides/0-1-0-beta-21.mdx:13-15
Timestamp: 2025-07-24T11:57:15.225Z
Learning: In the withstudiocms/docs repository, when reviewing French translation files, maintain consistency with the English version even if it means keeping unused imports. Structural parity between language versions is prioritized over removing unused code.

Learnt from: ArmandPhilippot
Repo: withstudiocms/docs PR: 149
File: src/content/docs/fr/guides/upgrade/version-guides/0-1-0-beta-20.mdx:18-18
Timestamp: 2025-07-24T12:00:35.014Z
Learning: In the withstudiocms/docs repository, while translations should maintain structural parity with English versions, improving readability during translation is acceptable when the original text has clear redundancy or readability issues that would also impact the translation quality. The maintainer ArmandPhilippot confirmed this approach is reasonable when the technical meaning is preserved.
✅ Actions performed

Comments resolved and changes approved.

@dreyfus92 dreyfus92 merged commit edac7e6 into main Feb 23, 2026
8 checks passed
@dreyfus92 dreyfus92 deleted the es-up-06 branch February 23, 2026 16:21
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