Los 10 mandamientos de la redacción técnica para desarrolladores

<p>- No omitir componentes esenciales de la oración<br /> - Mantener la concordancia entre los componentes de la oración<br /> - Usar correctamente las partículas gramaticales<br /> - Evitar las formas pasivas y causativas<br /> - Evitar la doble negación<br /> - Usar expresiones claras<br /> - Distinguir entre orden y listas<br /> - Aprovechar el estilo esquemático<br /> - Revisar la ortografía y los espacios<br /> - Revisar la escritura de extranjerismos</p>

[xguru]

<p>- Los 4 principios del technical writing https://es.news.hada.io/topic?id=5409<br /> - El arte de la revisión: cómo escribir documentación técnica para desarrolladores https://es.news.hada.io/topic?id=5446</p&gt;

[hongminhee]

<p>En el caso de los programadores, en la práctica basta con prestar atención solo al inglés cuando se trata de la romanización de extranjerismos, pero conviene tener en cuenta que las normas coreanas para palabras extranjeras se basan no en la ortografía sino en la pronunciación real, y que el inglés no refleja bien la pronunciación en su escritura, por lo que se transcribe mirando los símbolos fonéticos y no la ortografía de la palabra; si recuerdan esto, cometerán menos errores.<br /> <br /> Si no están seguros, 1) busquen directamente esa palabra inglesa en el diccionario coreano y, si aparece, usen esa forma; 2) si no aparece, busquen la palabra en un diccionario de inglés y deduzcan la transcripción a partir del Alfabeto Fonético Internacional (IPA). Sin embargo, como las reglas de transcripción de extranjerismos toman como referencia la pronunciación británica para el inglés, a veces también aparecen grafías inesperadas.<br /> <br /> Si no es inglés, resulta cómodo usar algo como Hangulize (https://hangulize.org/), pero como la ortografía del inglés es un desastre, es difícil hacerlo de forma mecánica de esa manera y, según dicen, hace falta consultar un diccionario. (En el caso de neologismos, a veces no están registrados en los diccionarios, así que puede ser necesario comprobar en lugares como YouTube cómo está pronunciando la gente esa palabra.)</p>