Muchas personas creen que, para ser un buen Escritor Técnico, debes ser un experto en materia. Y aunque esto es un concepto equivocado común, no es de extrañar que la gente mantenga esta creencia. Después de todo, tu trabajo como escritor técnico es comunicar información técnica compleja a un público de una manera que sea fácil de digerir. Afortunadamente, la realidad es que no tiene que ser una PYME para escribir un artículo técnico de clase mundial. Necesidad es curiosidad, estructura, y la voluntad de preguntar a un experto en materia las preguntas correctas.Y esa es la belleza de la escritura técnica: preguntar las preguntas correctas es más importante que tener todas las respuestas. por La guía no-SME a una gran historia técnica Brandish tu falta de experiencia como la arma que es La gran escritura técnica comienza con la mentalidad de un aprendiz.La falta de experiencia de la que te preocupas tanto te da una ventaja interesante: la oportunidad de abordar el tema con la misma y Usted hace las preguntas que los expertos olvidan preguntar (las que sus lectores también están preguntando en silencio), interroga cada concepto, rompe el jargón en lenguaje simple, y al llenar su propia brecha de conocimiento, le da al lector la mejor experiencia. greenness curiosity https://ucatt.arizona.edu/news/curse-knowledge?embedable=true Construir una relación con un experto en asuntos Hemos establecido que no es necesario ser una PYME para escribir una gran historia técnica, pero Y usted necesita construir una relación con esa persona (o recurso). Necesita una conexión con los cerebros detrás del Proyecto Técnico / tema sobre el que está escribiendo. someone Su trabajo es entonces ser un puente entre las ideas de esta persona y sus lectores. Pero aquí está la cosa sobre las pymes: a menudo viven profundamente dentro de la complejidad de sus propios sistemas.Estás ahí para sacar esas ideas y traducirlas en algo que viaja. Confía en que represente su trabajo con precisión, haga preguntas reflexivas y maneje su tiempo con respeto. build trust. Cómo comunicarse con las pymes Haga su tarea de casa primero.No aparezca en una reunión de PYME en blanco.Leer, investigar y prepararse con preguntas específicas e inteligentes. Pregunta “por qué” más que “qué”.El “qué” te dice lo que se construyó; el “por qué” te dice para quién es y por qué importa.Cuando descubres el “por qué”, descubres el contexto del mundo real, que es lo que a tus lectores les importa de todos modos. Clarifique la terminología de inmediato. No falsear el entendimiento. Los términos mal utilizados en una pieza técnica pueden arruinar la credibilidad. Resume después de cada llamada. Envíe un breve seguimiento con lo que entiende y asegúrese de estar en la misma página. Traducir, no transcribir Cuando esté listo para poner la pluma en el papel, debe recordar que su trabajo no es arrojar el jargón de un experto en la página. En la práctica, esto significa quitar el jargón al lenguaje simple. el lector será afectado por el producto/servicio en lugar de toda la interesante tecnología que lo potencia. Cómo En lugar de decir, Dice que “El producto XYZ es genial porque está construido con blah blah de vanguardia, primera de su tipo.” “El producto XYZ, construido con blah blah de última generación, es genial porque te ayuda a hacer ABC”. La primera línea aplasta la tecnología; la segunda sirve al lector. Al final del día, estás construyendo un puente entre el conocimiento experto y la comprensión cotidiana.Cuanto más claro sea el puente, más personas pueden cruzarlo. Verificar los hechos como su vida depende de ella Esto no es opcional, especialmente para las pequeñas y medianas empresas. Las historias técnicas dependen de la precisión. A diferencia de la prosa, tus hechos deben ser 100% verdaderos y verificables, tu código debe funcionar, y tus ejemplos deben ser reproducibles. Executa todo – capturas de pantalla, fragmentos de código y estadísticas – de vuelta a tu experto para confirmación. Estás jugando un juego de confianza, y nada lo erode más rápido que un error que podría haber sido capturado con un correo electrónico. Contar la historia (Palabra clave, “Historia”) Una vez que hayas verificado los hechos, construye la historia. Al final del día, la escritura técnica sigue . escribiendo Y eso significa que necesita estructura, flujo y pago. (el problema o el objetivo), despliega el (su proceso o descubrimiento), y cerrar con el (Introducción o acción) why how what next Para hacer las cosas más fáciles, hemos construido una guía práctica basada en esta estructura exacta de 3 actos. Empezar con él aquí: Taller de escritura de historias técnicas. Get started with it here: . Technical Storytelling Writing Template Taller Técnico de Escritura de Cuentos Escribe como si lo estuvieras explicando a un amigo.Y si alguna vez te olvidas de dónde empezar, recuerda que la claridad vence a la complejidad cada vez. Esperamos que esto le haya ofrecido cierta claridad (y tranquilizado sus miedos) acerca de navegar por la industria de la escritura técnica sin experiencia en materia. ¡Hasta la próxima vez!
