docs: restore the missing accents in the Spanish pages - #511
Open
marevol wants to merge 1 commit into
Open
Conversation
Seven Spanish pages had lost most of their accents. The damage was partial rather than stylistic: the same page reads "Búsqueda" in its title and "Descripcion" two lines later, "índice" in one paragraph and "indice" in the next. It is a defect, not a house style. Measured as the share of lines carrying an accented character, these seven sat at 0.003 to 0.037 while the rest of the Spanish set sits between 0.15 and 0.25. They now sit between 0.13 and 0.27. The correct spellings were not guessed. They were taken from the healthy Spanish pages in this repository: every accented word in them was collected, keyed by its unaccented form, and a mapping was kept only where exactly one accented form existed and the unaccented form is not itself a Spanish word. That produced 597 substitutions. Two orthographic rules were applied on top - no Spanish word ends in an unaccented -cion or -sion, and the plural -ciones/-siones correctly carries none - and the remaining 121 rare inflected forms and homographs were resolved one by one against their context. Homographs were left alone unless the context settled them: - que, como, cuando, donde, cual stay unaccented as relatives and conjunctions; only genuine interrogatives were accented, such as "identifica qué paso ha fallado" and the heading "Cómo funciona". - esta and este stay unaccented as demonstratives; only the verb forms became está and esté. - si stays unaccented as the conditional. - solo stays unaccented, per current RAE. One substitution from the bulk pass was wrong and was reverted: "Mejora continua" translates "Continuous Improvement", so the adjective is correct there and the verb continúa is not. Prose only. Every literal block, inline literal, URL and substitution reference was extracted from both revisions and compared: 1645 protected fragments, all byte-identical. The diff is 795 insertions against 795 deletions, so no line was added, removed or reflowed, and section title underlines are unaffected because an accent does not change a character count.
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
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.
Summary
Seven Spanish pages had lost most of their accents. The damage is partial rather
than stylistic - the same page reads
Búsquedain its title andDescripciontwo lines later,
índicein one paragraph andindicein the next. It is adefect, not a house style.
Share of lines carrying an accented character:
config/datastore/ds-database.rstconfig/datastore/ds-git.rstconfig/llm-openai.rstconfig/llm-gemini.rstconfig/rag-chat.rstconfig/datastore/ds-slack.rstconfig/rate-limiting.rstThe rest of the Spanish 15.9 set sits between 0.15 and 0.25. These seven were the
only outliers; everything else is above 0.07.
How the spellings were chosen
Not by guessing. Every accented word in the healthy Spanish pages of this
repository was collected and keyed by its unaccented form. A mapping was kept
only where exactly one accented form existed and the unaccented form is not
itself a Spanish word - 597 substitutions.
Two orthographic rules were applied on top: no Spanish word ends in an unaccented
-cionor-sion, and the plurals-ciones/-sionescorrectly carry none.The remaining 121 rare inflected forms and homographs were resolved one at a time
against their context: future and conditional (
estaran→estarán,eliminarian→eliminarían), preterite (elimino→eliminó,inicio→iniciówhere it is the verb and not the noun), imperative with an encliticpronoun (
coloquelo→colóquelo,Administrela→Adminístrela), andadjectives (
explicito→explícito,matematicas→matemáticas).Homographs left alone
que,como,cuando,donde,cualstay unaccented as relatives andconjunctions. Only genuine interrogatives were accented:
identifica qué paso ha fallado, and the headingCómo funciona.esta/estestay unaccented as demonstratives; only verb forms becameestá/esté.sistays unaccented as the conditional.solostays unaccented, per current RAE.enviowas split by meaning:envió(verb) at one site,envío(noun) atanother.
One bulk substitution was wrong and was reverted.
Mejora continuatranslates "Continuous Improvement", so the adjective is correct there and the
verb
continúais not.Scope
Prose only, and 15.9 only.
`` span,URL and
|Fess|substitution - were extracted from both revisions and compared:all byte-identical.
removed or reflowed.
count.
tools/check_headings.pypasses over all seven languages, as do thetoolsunit tests andupdate_eol.py --check.Spanish text inside code blocks was deliberately left as it is - for example the
curl payload in
rag-chat.rst:445still readsexplicame como instalar Fess.Not addressed
ds-git.rst:306usesreindexiza, which is not standard Spanish(
se reindexawould be). Not an accent problem, so out of scope here.llm-openai.rstandllm-gemini.rstusecommitaas a verb.rate-limiting 48) are present identically before and after this change.