Skip to main content

​
Internazionalizzazione

La documentazione di Switchbord viene preparata per la stessa copertura linguistica dell’app e del sito marketing: inglese, italiano, spagnolo, tedesco, francese, portoghese e cinese. I contenuti pubblici attuali della documentazione restano in inglese mentre viene generato e revisionato l’albero di documentazione localizzata. Il sito della documentazione ora tiene traccia della localizzazione come superficie documentale esplicita, così che la navigazione Mintlify, la parità delle pagine e la revisione delle traduzioni possano essere verificate insieme al lavoro di i18n dell’applicazione.

​
Piano delle lingue

  • en è la lingua di origine.
  • it, es, de, fr, pt e zh sono le lingue di destinazione.
  • La documentazione localizzata deve preservare i blocchi di codice, i percorsi API, i nomi delle variabili di ambiente, i nomi di prodotto e la sintassi dei componenti MDX.
  • I link interni nella documentazione localizzata devono restare all’interno della lingua selezionata, una volta generate le directory per lingua.

​
Requisiti di qualità

Prima che la documentazione localizzata venga pubblicata, ogni lingua di destinazione deve superare:
  1. La parità tra pagine di origine e di destinazione rispetto all’albero inglese.
  2. La parità del frontmatter per title e description.
  3. La validazione Mintlify.
  4. I controlli sui link non funzionanti per ogni albero linguistico.
  5. La revisione umana per le pagine legali, di sicurezza e di riferimento API.

​
Nota implementativa

I testi dell’app e del marketing sono gestiti tramite bundle di messaggi JSON e Languine. La documentazione è in MDX e richiede un flusso di traduzione compatibile con MDX che preservi i code fence, i link e i tag dei componenti.