Hasta que tengamos una forma nativa de manejar documentos localizados, creo que anteponer las banderas al título es la forma más práctica de hacerlo, y una excepción razonable a esta directriz.
Creo que este tipo de cosas tiene diferentes opiniones y preferencias en ambos sentidos, pero para esta guía de estilo, nos ceñimos a las normas aceptadas en la industria. Una vez más, las directrices de Google y Microsoft coinciden en que es mejor usar contracciones comunes.
Dicho esto, he leído algunas publicaciones que sugieren que el uso de contracciones negativas (como “can’t”) podría dificultar la comprensión para los hablantes no nativos de inglés. Profundizaremos un poco más en esto y, si es necesario, actualizaremos la guía de estilo en consecuencia.
¡He eliminado ese ejemplo! ![]()
Sí, eso es muy común (no solo en Discourse), pero estoy de acuerdo en que no es del todo correcto. Sería mejor usar comillas, así que creo que lo haré explícito en la guía de estilo.
Ese es un gran punto. ¡Lo añadiré a la guía de estilo!
Por mucho que agradezca no tener ya un montón de temas de documentación atribuidos a mí, usar Discourse como autor de todos los temas de documentación del equipo se siente un poco frío.
¡Gracias por tus comentarios! @maiki hizo algunos buenos puntos anteriormente, y estoy de acuerdo con lo que dice allí. Para añadir a eso, diré que una de las razones por las que hemos cambiado la documentación oficial para que @Discourse sea el autor es para darles un mayor sentido de autoridad a los lectores, especialmente a las personas que visitan la documentación por primera vez. Este es también el ímpetu detrás de toda la guía de estilo en primer lugar.
Cualquiera que escriba documentación definitivamente puede inyectar su personalidad en su escritura, y la discusión sobre temas de documentación individuales no va a ninguna parte, así que ese es siempre un buen lugar para hacer las cosas más personales también.
Todos estos comentarios son muy apreciados ![]()