Fino a quando non avremo un modo nativo per gestire documenti localizzati, penso che anteporre le bandiere al titolo sia il modo più pratico per farlo, e una ragionevole eccezione a questa linea guida.
Penso che questo tipo di cose abbia opinioni e preferenze diverse in entrambi i casi, ma per questa guida di stile ci atteniamo alle norme industriali accettate. Ancora una volta, le linee guida di Google e Microsoft concordano entrambe sul fatto che sia meglio usare le contrazioni comuni.
Detto questo, ho letto alcuni post che suggeriscono che l’uso di contrazioni negative (come “can’t”) potrebbe rendere la comprensione più difficile per i non anglofoni. Approfondiremo ulteriormente questo aspetto e, se necessario, aggiorneremo la guida di stile di conseguenza.
Ho rimosso quell’esempio! ![]()
Sì, è molto comune (non solo su Discourse), ma sono d’accordo che non sia del tutto corretto. Sarebbe meglio usare le virgolette, quindi penso che lo renderò esplicito nella guida di stile.
Questo è un ottimo punto, lo aggiungerò alla guida di stile!
Per quanto apprezzi non avere più un sacco di argomenti di documentazione a me attribuiti, usare Discourse come autore di tutti gli argomenti di documentazione del team sembra un po’ freddo.
Grazie per questo feedback! @maiki ha fatto alcuni buoni punti sopra, e sono d’accordo con quello che dice lì. Per aggiungere a ciò, dirò che uno dei motivi per cui abbiamo spostato la documentazione ufficiale per avere @Discourse come autore è per dare loro un maggiore senso di autorità per i lettori, specialmente per le persone che si avvicinano alla documentazione per la prima volta. Questo è anche lo slancio dietro l’intera guida di stile in primo luogo.
Chiunque scriva documentazione può sicuramente ancora infondere la propria personalità nella propria scrittura, e la discussione sui singoli argomenti di documentazione non va da nessuna parte, quindi quello è sempre un buon posto per rendere le cose più personali.
Tutto questo feedback è molto apprezzato ![]()