Le API dovrebbero essere en_US o en_GB o entrambe? [chiuso]

8

Devo scrivere API nell'ortografia o nell'ortografia inglese degli Stati Uniti? O dovrei fornire la mappatura di entrambi a uno solo e internamente usando qualcuno che mi piace in modo che entrambi funzionino? Al momento la maggior parte delle API sono con l'ortografia statunitense. Qual è la soluzione per questo?

modifica: c'è un modo per standardizzare questo. Può essere di supporto entrambi?

    
posta Steven M. Vascellaro 31.12.2010 - 08:17
fonte

2 risposte

14

API internazionali

API che devono essere utilizzate a livello internazionale EN-US. Pertanto, se il tuo obiettivo è quello di fornire la tua API agli sviluppatori di tutto il mondo (o almeno diversi paesi in cui l'inglese britannico non è comunemente usato), dovresti utilizzare EN-US .

API locali

Naturalmente, le API di piccole dimensioni che prendono di mira un paese preciso possono essere nella lingua di questo paese. Ma pensa due volte a utilizzare EN-GB anche in questo caso:

  • Vivendo in Francia, personalmente non apprezzerei un API in francese; L'inglese è solo più facile da usare quando si tratta di sviluppo. Le impostazioni internazionali rendono strano scrivere in lingua locale. Se hai visto il codice sorgente con nomi di metodi cinesi, tedeschi o russi, capirai perché. Quello che attualmente vedo qui troppo spesso è il codice sorgente che mescola i nomi francesi con accenti (é, ê, à, ecc.), Nomi francesi senza accento (che è completamente sbagliato e può essere fuorviante), nomi inglesi e errori di ortografia in inglese) .
  • L'utilizzo di EN-GB può rendere più difficile l'utilizzo dell'API anche per gli sviluppatori britannici. È difficile ricordare che dobbiamo scrivere Color in C # o in PHP, ma Colour in una specifica API.
  • Quando crei un'API locale, puoi essere sicuro che non sarà famoso a livello internazionale in uno, due o dieci anni?
risposta data 31.12.2010 - 08:43
fonte
2

Ho visto entrambi. Un'API di un'azienda britannica utilizzava l'ortografia inglese britannica (ad es. "Autorizza" invece di "autorizzare"). Per mancanza di una risposta migliore, suggerirei di abbinare la convenzione utilizzata sulla piattaforma di destinazione. Ad esempio, se utilizzi una classe "Color" della piattaforma, non dovresti utilizzare "Colore" nella tua API.

    
risposta data 31.12.2010 - 08:28
fonte

Leggi altre domande sui tag