La redacción técnica para empresas emergentes es importante: este es el motivo

Bienvenido a la primera publicación de blog de nuestra nueva serie, " Cómo la redacción técnica puede potenciar su startup ".

En esta serie, le mostraré cómo la redacción técnica puede beneficiar a las empresas emergentes, desde ganar visibilidad hasta generar confianza con su audiencia. Como proveedor de servicios de redacción para nuevas empresas, he visto el impacto positivo que puede tener un contenido bien elaborado.

Hoy comenzaré con una descripción general de cómo la redacción técnica puede impulsar el crecimiento de su startup. Estén atentos a más publicaciones sobre por qué escribir es una herramienta vital para las empresas emergentes.

La redacción técnica juega un papel importante en el éxito de una startup. Implica crear documentación clara, concisa y centrada en el usuario que explique cómo funciona un producto o servicio. “ Opiniones firmes, pero débilmente sostenidas. ” Salga a la luz, pero manténgase a la caza de opiniones disidentes de personas inteligentes y respetuosas.

El software de escritura está a medio camino entre escribir una novela y construir un puente.

La escritura técnica tolera e incluso fomenta idiosincrasias estilísticas que la publicación tradicional no aceptaría. Apóyate en ellos.

El contenido técnico es oportuno o atemporal, sin casi nada intermedio.

Crédito de la imagen: "Estado de las relaciones con los desarrolladores": puede acceder al informe completo aquí.

La persona que escribe el plan en una organización/startup tiene un poder tremendo. Si desea encontrar personas prometedoras en una empresa de tecnología, investigue quién está redactando el plan. Aunque es posible que no se les ocurran todas las ideas, sabrá que tienen la energía, la motivación y las habilidades para organizar y comunicar ideas por escrito.

Rodéate a ti mismo y a tu startup de “pensadores laterales” que no pueden evitar proponer perspectivas variantes sobre todo lo que ven en tu producto o servicio. No siempre tendrán razón, pero siempre desafían tu pensamiento y escritura.

Invertir en redacción técnica puede tener un impacto sustancial en el éxito de su startup. No sólo beneficia a sus usuarios sino que también contribuye a la eficiencia y eficacia de sus operaciones internas. Recuerde que el objetivo es producir documentación que sea clara, concisa y comprensible para el público objetivo. Como resultado, aumentará la satisfacción del usuario, la lealtad y el crecimiento empresarial.

Recuerde: los formatos de medios son cíclicos. Nietzsche escribió en aforismos y Twitter es aforismos como servicio. El hip-hop trajo de vuelta la poesía. Montaigne fue pionero en el formato de ensayo y los blogs los volvieron a poner de moda.

Las empresas emergentes deberían escribir más manifiestos, blogs, documentos limpios y guías de integración.

¿Qué es la redacción técnica?

Durante los últimos 3 años, he trabajado en documentación, guías de integración y publicaciones de blogs técnicos para más de 20 empresas emergentes. Comencé a contribuir durante mi función como defensor de desarrolladores en SuperTokens, una alternativa a Auth0, Firebase Auth, en 2021, y ayudé a los desarrolladores a realizar la transición a la nueva autenticación de usuarios de código abierto.

Descubrí que disfruto escribiendo blogs y documentación técnica . Es satisfactorio producir escritos técnicos de alta calidad que beneficien a otros.

He leído muchos recursos de documentación y redacción técnica a lo largo de los años. He escrito sobre por qué todo ingeniero debería escribir y he recopilado mis notas para ayudarme a recordar puntos clave más adelante en mi carrera, pero también como una herramienta para ayudarme a pensar en escribir ahora.

GPT ha revelado hasta qué punto la escritura es pura pablum. Insulso, sin vida, aburrido, no ofensivo y no vale el precio de la tinta con la que fue impreso. por lo tanto, los buenos escritores serán más importantes para sus nuevas empresas, quienes pueden crear y escribir excelentes blogs técnicos y el plagio de ChatGPT no es un problema. Si no puedes escribir más que una máquina, ¿qué haces escribiendo?

Si es un desarrollador interesado en escribir blogs técnicos, he escrito un blog completo dedicado a qué es la redacción técnica y cómo escribir buenos blogs técnicos .

Mis principios de escritura

Al escribir redacción técnica, siempre trato de tener en cuenta los siguientes principios.

• El objetivo de la escritura es hacer que las tareas sean lo más simples y eficientes posible para los usuarios.
• Los desarrolladores prefieren que se les muestre en lugar de que se les diga y prefieren aprender haciendo.
• Ayude a sus usuarios a lograr su primer éxito lo antes posible.
• Manténgalo simple y escriba en un lenguaje sencillo.

¿Por qué es importante la redacción técnica para las empresas emergentes?

He estado escribiendo contenido técnico durante los últimos 3 años. Esto es lo que aprendí:

• Los blogs y la documentación técnicos claros ayudan a los usuarios finales a comprender su producto de manera rápida y eficiente, lo que reduce la frustración y aumenta la satisfacción.

• Una redacción técnica exhaustiva demuestra que se toma en serio su producto y a sus usuarios. Aumenta la confianza y la seguridad de su marca.

• Los nuevos usuarios finales pueden dominar rápidamente su producto si tienen acceso a guías, integración y documentos bien organizados y fáciles de seguir.

• La documentación y los blogs técnicos bien estructurados mejoran el SEO de su sitio web y ayudan a los clientes potenciales a encontrarlo más fácilmente.

• A medida que su startup crezca, necesitará incorporar más empleados. Una buena redacción y documentación técnica son esenciales para capacitar a los nuevos empleados de manera eficiente.

• Aquí hay algunos ejemplos de excelentes blogs de ingeniería:

• El blog de Cloudflare

• Blog de ingeniería de DoorDash

• El blog tecnológico de Netflix

  
  

• Los blogs y la documentación técnicos detallados demuestran que tiene un producto y una estrategia comercial bien pensados, que pueden resultar atractivos para posibles inversores y socios.

• Los comentarios de los usuarios finales provenientes de blogs y documentación técnicos suelen ser invaluables para mejorar su producto e identificar áreas de confusión.

• Los blogs y la documentación bien escritos se pueden traducir fácilmente a otros idiomas locales, lo que le permite llegar a una audiencia global más amplia.

• Tener documentación y blogs técnicos superiores puede ser un diferenciador significativo, brindándole una ventaja sobre la competencia.

  
  

Buena redacción técnica = marketing orgánico para desarrolladores

Los desarrolladores tienen fama de ser reacios al marketing, pero eso no es necesariamente cierto.

En realidad, los desarrolladores están ganando poder adquisitivo y respeto dentro de empresas de todos los tamaños. Los empleadores reconocen la importancia de invertir en herramientas para ayudar a los desarrolladores a mantenerse productivos y felices porque los buenos desarrolladores son difíciles de encontrar y retener.

La variedad de herramientas para desarrolladores ha aumentado dramáticamente, desde IDE hasta abstracciones de nivel superior y servicios pagos como GPT, incluidas herramientas de bajo código.

La redacción técnica es una estrategia exitosa de marketing para desarrolladores basada en la autenticidad y la comprensión de la audiencia. Las empresas emergentes deben pasar tiempo con los desarrolladores, tanto en línea como en persona, para comprender sus necesidades y preferencias.

El contenido técnico debe ser realmente útil y educativo y, a menudo, es más eficaz cuando lo crea un compañero desarrollador. Las opciones incluyen ingenieros internos, defensores de desarrolladores, programas de redacción comunitarios, escritores independientes, ingenieros de software independientes y escritores como yo .

Los desarrolladores están presentes en plataformas como X (anteriormente Twitter), Hacker News, Reddit y LinkedIn y les encanta leer publicaciones de blogs técnicos bien escritas.

¿Por qué se destaca la estrategia de redacción técnica?

Si bien admito que las grandes empresas de tecnología y las nuevas empresas están mejorando a la hora de llegar a los desarrolladores. Pasé 13 años como ingeniero de software práctico y líder técnico antes de comenzar mi blog como desarrollador de marketing, así que aquí está mi opinión sobre por qué la redacción técnica es un gran activo para las empresas emergentes.

El marketing de empresa a desarrollador ("marketing B2D") describe iniciativas de marketing diseñadas para llegar a los desarrolladores y la redacción técnica es una de las mejores formas de hacerlo sin dejar de ser genuina, auténtica e interesante.

Muchas nuevas empresas luchan con el marketing técnico B2D porque es más difícil llegar a los desarrolladores que al consumidor medio. Trucos como regalos, cupones de comida gratis, camisetas gratis o eventos excluyentes centrados en el alcohol no son el camino a seguir.

Sea interesante: escribir es, con diferencia, la forma más rápida de obtener comentarios de los desarrolladores en ingeniería de software.

Cree un proyecto interesante con su producto, escriba sobre él y compártalo en público para obtener comentarios e iterarlo.

Todos los desarrolladores apreciamos la honestidad. En los últimos tiempos, personalmente me gustó la página del blog de Supabase . Han escrito algunos blogs muy interesantes y lograron un muy buen crecimiento a partir de su contenido escrito.

Como startup, esto significa que debes ser honesto acerca de tu producto en la comunidad.

Muchos defensores de los desarrolladores de contratación de grandes empresas de tecnología: alguien con experiencia técnica que defenderá su producto en eventos en vivo.

Las grandes empresas de tecnología como Google/Amazon/Meta/Netflix tienen equipos de estas personas para dar charlas en conferencias, realizar sesiones de capacitación y escribir contenido técnico sobre los productos de su empresa, pero el rol de defensor de los desarrolladores no es una buena opción para la mayoría de las nuevas empresas. porque tienen que moverse rápido y desafortunadamente muchos defensores de los desarrolladores son personas perezosas y por debajo del promedio.

Las empresas emergentes necesitan ingenieros en tecnología altamente capacitados que puedan escribir y construir su blog de ingeniería, una plataforma a la que la gente quiera acudir todas las semanas, si no todos los días.

Las empresas emergentes deben aprovechar la redacción y la documentación técnicas como herramientas de marketing .

Crédito de la imagen: "Estado de las relaciones con los desarrolladores": puede acceder al informe completo aquí.

Papel de la redacción técnica en la comunicación eficaz

Podemos escribir muchos tipos diferentes de contenido técnico para desarrolladores de software.

• La documentación es importante, pero muy pocas empresas emergentes la aprovechan como canal de marketing.
• Los tutoriales y las guías prácticas pueden ayudar a los usuarios finales a ver cómo utilizar su producto en el mundo real.
• El contenido que genera conciencia se crea con el objetivo de aumentar la parte superior de su embudo y puede publicarse en sitios asociados externos para aumentar el alcance. Hashnode, DevTo, HackerNoon y DZone son lugares gratuitos para publicar contenido para desarrolladores.
• Las publicaciones de blog en su sitio web le permiten atraer lectores y aumentar las suscripciones.
• Patrocine a escritores independientes o ingenieros senior que escriban un blog técnico en su sitio web o boletines.

Cómo la redacción técnica garantiza claridad y comprensión

Escriba siempre buenos ejemplos comenzando con código real, esto genera confianza con los clientes e inversores mientras escribe en público.

Mis tácticas para escribir en público:

Alguien me preguntó recientemente en mi DM de Twitter: “Hola Ankur, soy un gran admirador de tu blog, pero tengo una pregunta: ¿cómo manejas la escritura en público? La gente en Internet a veces es tan idiota”.

A menudo escuché el consejo " Apaga o no lees los comentarios ", pero he adquirido una gran cantidad de conocimientos leyendo comentarios de Internet sobre mis publicaciones y las publicaciones de otras personas de extraños a lo largo de los años, aunque a veces la gente es unos idiotas.

Habla siempre de hechos reales y sé honesto.

Hablo principalmente de hechos, ya sean datos sobre nuevas empresas o defensores de los desarrolladores sobre mis experiencias como escritor. En general, diría que los comentarios de la gente sobre los hechos tienden a ser bastante normales. Los principales tipos de comentarios negativos que recibo se refieren a hechos sobre mis errores. Principalmente trato de evitar esto tratando de ser consciente de mi nivel de conocimiento sobre un tema y diciendo "No estoy seguro..." cuando no estoy seguro de algo.

Editar y refactorizar errores

Cometo muchos errores en las publicaciones de mi blog porque escribo sobre muchas cosas que están al límite de mi conocimiento. Cuando la gente señala errores, edito la publicación del blog y la arreglo. Generalmente, permanezco cerca de una computadora durante algunas horas después de publicar una publicación en mi blog en mi línea de tiempo de Twitter o LinkedIn para poder corregir los errores rápidamente a medida que surgen.

Cerrar la brecha de conocimiento tecnológico: el desafío principal en el programa de relaciones con desarrolladores de startups

El informe de la encuesta menciona que el desarrollo de contenido fue una de las principales actividades laborales para los profesionales de relaciones con desarrolladores en 2023, con una distinción entre desarrollo de contenido relacionado con la educación (55%) y desarrollo de contenido técnico, como documentación (50%). Esto resalta la importancia de la redacción técnica y la creación de contenido para interactuar y educar a las comunidades de desarrolladores.

Las 3 preguntas principales que toda startup debe hacerse antes de iniciar un blog técnico

Iniciar un blog técnico puede ser un paso importante para una startup, ya que requiere un enfoque reflexivo para garantizar que cumpla eficazmente el propósito previsto.

Haga estas preguntas si está iniciando un nuevo blog para su startup.

• el propósito de escribir

• El público objetivo

• el tipo de contenido a crear

  
  

Identificar el objetivo del blog es crucial, ya sea aumentar el conocimiento de la marca, complementar la documentación, crear una audiencia o establecer un liderazgo intelectual. En segundo lugar, comprender y delimitar la audiencia ayuda a adaptar el contenido en consecuencia. Por último, decidir el formato del contenido, ya sean tutoriales, resúmenes, estudios de casos, artículos, preguntas y respuestas, comparaciones o artículos de opinión, ayuda a mantener un blog coherente y atractivo.

Eso es todo por este blog. Seguiré escribiendo sobre este tema y compartiré más información sobre características más específicas en el próximo blog.

Estén atentos Hasta entonces, estos son algunos de mis blogs más populares que tal vez le guste leer.

• Desarrolladores de software, ¿por qué no han comenzado todavía a escribir técnicas?
• Cómo crear microservicios escalables con amplificación
• Cómo utilizar las funciones personalizadas de HarperDB

Espero poder compartir más sobre el poder de la redacción técnica en la próxima publicación.