feat(it): add GLOSSARY.yml by caugner · Pull Request #5 · mdn/translated-content-it

caugner · 2025-05-23T20:04:48Z

Description

Adds a Translation glossary as a YAML file.

Motivation

Makes it easier to collaborate.

Additional details

Created as follows:

In the mdn/content checkout: git ls-files files/en-us/learn_web_development/**/*.md | xargs cat > learn_web_development.md
Dragged that file into ChatGPT.
Prompt 1:

Please extract a list of technical terms and phrases from the attached content. The extracted terms will be used for localization purposes and should focus on domain-specific vocabulary, interface terms, and key concepts relevant to the content.
Prompt 2:
Using the extracted glossary terms, compile a YAML file with the following structure:
- dont_translate: a list of terms that should remain in English (not translated).
- translate: a dictionary where each key is the English term and each value is the Italian translation.
Ensure the YAML file does not use unnecessary quotes, and lists and dictionaries are alphabetically ordered. Output only the YAML.

Related issues and pull requests

caugner · 2025-05-23T20:07:46Z

files/it/GLOSSARY.yml

@code-a1 @zAlweNy26 @TheLonelyAdventurer Can you please take a look at this translation glossary, generated by GPT-4o based on the Learn web development area? 🙏

(If you hover over a line, you should see a "+" button show up, click that to comment on that line. To make a suggestion in your comment, click on the "±" button next to the "Preview" tab.)

zAlweNy26 · 2025-05-23T21:54:26Z

files/it/GLOSSARY.yml

+  color contrast: contrasto dei colori
+  column header: intestazione di colonna
+  command line: riga di comando
+  contact us: contatti


why not "contattaci" like on https://developer.allizom.org/it/docs/Learn_web_development#contattaci ?

zAlweNy26 · 2025-05-23T21:59:08Z

files/it/GLOSSARY.yml

+  performance: prestazioni
+  placeholder text: testo segnaposto
+  pointer device: dispositivo di puntamento
+  position property: proprietà position


@caugner may I ask why “position property” is here? Was there a specific need, such as the unintended translation of "position" ?

zAlweNy26 · 2025-05-23T22:01:07Z

files/it/GLOSSARY.yml

+  refactoring: rifattorizzazione
+  relative positioning: posizionamento relativo
+  responsive design: design responsivo
+  role attribute: attributo role


this should be "attributo ruolo" or "attributo del ruolo", I need some context @caugner please

Maybe "attributo di ruolo"

this should be "attributo ruolo" or "attributo del ruolo", I need some context @caugner please

I'm guessing it refers to the global role attribute, which is WAI-ARIA related.

Oh ok, I forgot about that, so the current translation is correct

zAlweNy26 · 2025-05-23T22:02:20Z

files/it/GLOSSARY.yml

+  semantic UI control: controllo UI semantico
+  server-side validation: validazione lato server
+  session: sessione
+  skip link: collegamento di salto


this should be "salta collegamento" or "ignora collegamento", depends also on the context here.

zAlweNy26 · 2025-05-23T22:09:55Z

@caugner sorry for leaving comments, I probably should have left a review instead 😬

TheLonelyAdventurer · 2025-05-24T10:30:19Z

files/it/GLOSSARY.yml

+  bandwidth: larghezza di banda
+  basics: basi
+  block-level element: elemento a livello di blocco
+  box model: modello a scatola


I'd leave it to "box model" because it's a technical term and we don't have a word for that

"modello a scatola" would not work in Italian

TheLonelyAdventurer · 2025-05-24T10:32:40Z

files/it/GLOSSARY.yml

+  client-side validation: validazione lato client
+  color contrast: contrasto dei colori
+  column header: intestazione di colonna
+  command line: riga di comando


I'd say "terminale" or "console" are more common, but it's not wrong to translate it as "riga di comando".

TheLonelyAdventurer · 2025-05-24T10:34:27Z

files/it/GLOSSARY.yml

+  command line: riga di comando
+  contact us: contatti
+  content sectioning: sezionamento del contenuto
+  continuous delivery: consegna continua


I'd leave it in English. It's a technical term and we usually write it as "Continuous Delivery", capitalized.

TheLonelyAdventurer · 2025-05-24T10:42:00Z

files/it/GLOSSARY.yml

+  contact us: contatti
+  content sectioning: sezionamento del contenuto
+  continuous delivery: consegna continua
+  continuous integration: integrazione continua


Same as CD. We usually write "Continuous Integration", capitalized. I've actually seen this one translated, but it's less common.

TheLonelyAdventurer · 2025-05-24T10:48:59Z

files/it/GLOSSARY.yml

+  explicit grid: griglia esplicita
+  feature detection: rilevamento delle funzionalità
+  focus state: stato di focus
+  form control: controllo modulo


If it's referring to <form>, then form has to be left unchanged, so it should be "controllo form" or maybe "controllo della form"

TheLonelyAdventurer · 2025-05-24T10:58:13Z

files/it/GLOSSARY.yml

+  line height: altezza della linea
+  link text: testo del collegamento
+  list item: elemento di lista
+  load balancer: bilanciatore di carico


I'd leave it in English because it's a technical term. I've seen it translated but it's less common.

TheLonelyAdventurer · 2025-05-24T11:05:48Z

files/it/GLOSSARY.yml

+  mouse-specific event: evento specifico del mouse
+  navigation menu: menu di navigazione
+  normal flow: flusso normale
+  outline (focus indicator): contorno (indicatore di focus)


I'd leave it "outline" if it's referring to the outline CSS property

TheLonelyAdventurer · 2025-05-24T11:06:55Z

files/it/GLOSSARY.yml

+  outline (focus indicator): contorno (indicatore di focus)
+  perceivable content: contenuto percepibile
+  performance: prestazioni
+  placeholder text: testo segnaposto


I'd leave it "placeholder" if it refers to the HTML attribute, like this: "testo placeholder"

TheLonelyAdventurer · 2025-05-24T11:09:17Z

files/it/GLOSSARY.yml

+  placeholder text: testo segnaposto
+  pointer device: dispositivo di puntamento
+  position property: proprietà position
+  programmatically detectable: rilevabile a livello di codice


I think "rilevabile programmaticamente" would be better

TheLonelyAdventurer · 2025-05-24T11:39:49Z

files/it/GLOSSARY.yml

+  skip link: collegamento di salto
+  soft skills: competenze trasversali
+  source order: ordine sorgente
+  stack trace: traccia dello stack


I'd leave it in English, I think it's more common

feat(it): add GLOSSARY.yml

048fcd7

caugner commented May 23, 2025

View reviewed changes

caugner added 4 commits May 23, 2025 23:04

fixup! feat(it): add GLOSSARY.yml

b82e17b

fixup! feat(it): add GLOSSARY.yml

79d58d6

Merge branch 'main' into glossary

bae752a

fixup! feat(it): add GLOSSARY.yml

5b4ff39

zAlweNy26 reviewed May 23, 2025

View reviewed changes

TheLonelyAdventurer reviewed May 24, 2025

View reviewed changes

Conversation

caugner commented May 23, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Motivation

Additional details

Related issues and pull requests

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

zAlweNy26 commented May 23, 2025

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

caugner commented May 23, 2025 •

edited

Loading