Cómo escribir una excelente publicación técnica en un blog

Cinco pasos para pasar de la idea al resultado perfecto

He estado trabajando en la comunidad de código abierto durante casi 5 años, creando y promocionando herramientas para desarrolladores como Meteor y Apollo. En ese tiempo, descubrí que los blogs son una de las formas más efectivas de difundir ideas.

Una publicación de blog no tarda tanto en prepararse como un video o una conferencia, pero es fácil de consumir y puede llegar a un montón de personas. Personalmente, también he obtenido muchos beneficios de la escritura: me ha ayudado a organizar mis pensamientos, enseñar a las personas sobre las tecnologías que amo y dar a conocer mi nombre.

Desde que publiqué mi primera publicación de blog en 2014, terminé escribiendo 68 publicaciones hasta ahora aquí en Medium, algunas con más de 50 mil visitas y 1000 fanáticos, y edité muchas publicaciones para mis amigos y compañeros de trabajo. Durante ese tiempo, aprendí algunas estrategias para llevar una publicación del concepto a la publicación.

En este artículo, repasaremos cinco pasos principales de mi proceso para escribir una publicación:

  1. Encuentra un buen tema y comprométete con él
  2. Haz que tus objetivos y tu audiencia sean específicos
  3. Ten un comienzo, un desarrollo y un final
  4. Obtenga comentarios y repita
  5. Agregue los toques finales: empaque, publicación y promoción

¡Vayamos directamente al primer paso!

1. Encuentra un buen tema y comprométete con él

¡No puedes empezar con una publicación a menos que tengas algo sobre lo que escribir! Cuando hablo con personas que quieren empezar a bloguear, este suele ser su principal bloqueador.

La estrategia más simple es escribir sobre lo que sabe. Si pasaste muchas horas aprendiendo sobre algo y crees que podrías explicarlo en solo unos minutos, brindarás mucho valor a tus lectores.

Otra idea es escribir sobre un área que cree que carece de contenido. Por ejemplo, en este momento no hay muchas publicaciones sobre cómo postularse a conferencias técnicas, por lo que el contenido sobre eso podría llenar un vacío en la comunidad.

Aquí hay algunos tipos específicos de publicaciones que podría elegir. Los ejemplos son de las publicaciones relacionadas con GraphQL en el blog de Apollo:

  1. Una guía paso a paso para lograr un objetivo específico: "Crear una excelente lista desplazable en React Native con FlatList" o "Simplificar sus componentes React con Apollo y Recompose". Son excelentes para los lectores que buscan ingresar, hacer algo y salir rápidamente.
  2. Una encuesta en profundidad sobre un tema en particular: "Uso de nulabilidad en GraphQL" o "Anatomía de una consulta GraphQL". Estos son útiles si se dirige a una audiencia más interesada que quiere tomar una taza de café y aprender mucho.
  3. Una lista numerada de datos útiles sobre un tema común: "4 formas sencillas de llamar a una API GraphQL" o "5 beneficios de las consultas GraphQL estáticas". Se trata de una lectura divertida y liviana, ya que no tiene que comprometerse a leer todo y es fácil consumir las piezas del tamaño de un bocado.

Ahora, permítanme disipar algunas preocupaciones comunes:

  1. Ya hay contenido sobre este tema. No dejes que eso te detenga. Incluso si ya se ha escrito sobre tu idea, puedes poner tu propia perspectiva sobre ella o hacerla específica para tu situación.
  2. Mi idea no es lo suficientemente interesante. Muchos de mis amigos y compañeros de trabajo no terminan escribiendo porque les preocupa que sus conclusiones sean aburridas u obvias. ¡Eso es un sentimiento normal! Si eres un experto en algo, entonces, por supuesto, las conclusiones sobre las que estás escribiendo serán aburridas… para ti . La clave es que la gente de tu audiencia aún no sabe esas cosas.

Habiendo dicho todo eso, al final del día, es difícil predecir qué temas serán una gran publicación y cuáles no, y a menudo es la ejecución lo que hace o deshace una publicación, no un tema brillante. Mi principal sugerencia sería intentar escribir sobre varias cosas diferentes y ver qué funciona.

2.Haga que sus objetivos y su audiencia sean específicos

Ahora que conoce su tema, necesita una audiencia y un objetivo para su publicación. ¿Quién lo leerá y qué sacarán de él?

Tu objetivo debe ser específico para que puedas concentrar toda tu energía en una idea principal. Para esta publicación, el objetivo no podría haber sido simplemente "escribir sobre blogs". Necesitaba un objetivo más específico en mente:

  • Audiencia: Personas que quieren empezar a escribir en blogs, especialmente sobre temas técnicos, pero que todavía no lo han hecho.
  • Objetivo: brindar a las personas un conjunto concreto de pasos y sugerencias para que puedan comenzar.

Una vez que los tenga, mantenga su publicación enfocada eliminando todo lo que no contribuya y evite agregar detalles adicionales solo porque está relacionado. Descubrí que las publicaciones relativamente concisas con un tiempo de lectura de 5 a 10 minutos son las más exitosas.

Conocer los antecedentes de su audiencia le permitirá adaptar su escritura a su conocimiento existente y puede ayudar a determinar cómo debe publicar y promover su contenido. Por ejemplo, espero publicar esto en freeCodeCamp, porque es posible que mucha gente de mi público objetivo ya haya leído esa publicación.

3. Tener un principio, un desarrollo y un final

Es desorientador cuando una publicación se desvía en una dirección inesperada. Los giros en la trama pueden ser un gran beneficio en los cuentos de ficción, pero es más fácil consumir un artículo técnico si obtienes exactamente lo que esperas. Puede mantener a sus lectores encaminados al darle a su publicación una estructura cómoda.

Introducción

El primer párrafo o dos de su publicación convencerá al lector de quedarse o perderá su atención. Comience con un poco de contexto para ayudar a las personas a comprender dónde encaja su publicación en el panorama general. Luego, dile a tu audiencia lo que obtendrán al leer tu artículo. Puede ser tentador dejar la gran revelación para el final, pero ten cuidado: si no tienes un buen gancho, tus lectores no se quedarán para averiguarlo.

Medio

Ahora que les ha dicho a sus lectores lo que pueden esperar, ¡déselo! Siéntase libre de entrar en todos los detalles que necesite y deje letreros en el camino para orientar a las personas. Utilice muchos títulos, listas numeradas y formato para ayudar a las personas a comprender dónde se encuentran y permitirles pasar al contenido que más les interesa.

Conclusión

No se limite a reducirse al vacío al final del artículo. Si su lector ha llegado hasta allí, realmente le importa. Bríndeles un resumen rápido de lo que aprendieron, una palmada en la espalda por leer y tal vez incluso algo que hacer a continuación si están inspirados: una llamada a la acción.

El formato que sugiero aquí no es el más creativo, y ciertamente hay otras formas de hacerlo. Pero una estructura simple es la forma más directa de comunicarse con sus lectores.

4. Obtenga comentarios y repita

No sabrá lo que la gente obtendrá de su escritura hasta que la lea. Aquí es donde tus suposiciones sobre tu tema, objetivos, los detalles de la publicación y la estructura se ponen realmente a prueba. Si desea obtener un buen resultado, no puede omitir este paso.

Puede parecer que está imponiendo cuando pide comentarios, o puede que le preocupe que sea negativo, pero las personas están más dispuestas a ayudar de lo que espera. Es mucho mejor averiguar cómo podría mejorar tu publicación antes de publicarla en el mundo. Cuando estaba preparando esta publicación, recibí comentarios muy valiosos que hicieron que el contenido fuera mucho mejor y más enfocado.

¿Qué debería preguntar a sus revisores? Mi principal consejo es dejarlo lo más abierto posible. Trate de no explicar desde el principio lo que pretendía lograr. Entregue el borrador como está y pregúntele a su revisor qué obtuvo de él o qué debería cambiarse. Cuando alguien en Internet encuentra su artículo, no tendrá ningún contexto adicional y tiene que mantenerse por sí solo.

Lo principal para validar a partir de los comentarios es: ¿esta publicación logrará los objetivos que decidió en el paso 2? Repita hasta que esté seguro de que lo hará.

5. Agregue los toques finales: empaque, publicación y promoción.

Ahora que tiene la idea, el objetivo, la estructura y algunos comentarios, es hora de pulir todo y enviarlo.

embalaje

Crea un título y un subtítulo geniales, y asegúrate de que tu publicación tenga al menos una imagen. Esto es lo que la gente verá cuando la publicación se comparta en Twitter o Facebook, y es su oportunidad para que la gente se interese en leer.

También es importante que tu publicación se vea y se sienta profesional, para que tu contenido realmente brille. Debe intentar no tener errores ortográficos, gramaticales o formatos extraños en su publicación. Si tienes un amigo que es excelente para detectar pequeños detalles, pídele que lo lea antes de publicarlo.

El artículo de freeCodeCamp sobre cómo publicar también tiene excelentes consejos sobre estilo de escritura y formato. Dado que ya has trabajado mucho en tu publicación, vale la pena agregar ese pequeño esfuerzo adicional para pulirla y darle un alcance más amplio.

Finalmente, asegúrese de dar crédito a cualquier persona cuyo trabajo haya hecho referencia o que ayudó a revisar y editar su publicación.

Publicación

¡Ya casi estás ahí! Elige dónde publicas realmente la publicación para que tenga la mejor oportunidad de llegar a tu audiencia. Medium es generalmente un gran lugar para contenido técnico y facilita que las personas descubran su escritura.

Para obtener puntos de bonificación, intente convertir su publicación en una publicación relevante que ayude a compartir su contenido; en este caso, he seleccionado freeCodeCamp porque creo que este consejo será relevante para sus lectores. Si desea hacer lo mismo, aquí están las instrucciones para enviar su publicación. Es probable que las publicaciones en sus áreas de interés también busquen publicaciones, ¡así que no tema ponerse en contacto!

Promoción

Una vez que haya publicado la publicación, ¡no habrá terminado! Si desea que la gente vea lo que ha escrito y obtenga valor de ello, asegúrese de compartirlo en los lugares donde es probable que su audiencia se reúna. Esto puede incluir grupos de Facebook, Reddit, Hacker News, LinkedIn o cualquier otra plataforma. Además, asegúrese de compartir su creación en sus propias cuentas de redes sociales, como Twitter. ¡Tus amigos estarán emocionados de leer, compartir y votar lo que escribiste!

Y ahora, has terminado. Ve a tomar un café o da un paseo: escribir una publicación de blog de principio a fin no es poca cosa. Lea los comentarios y las respuestas de la comunidad para que pueda seguir mejorando. Y cuando tengas otra idea, ¡hazlo de nuevo!

No hay reemplazo para la práctica

Acabamos de analizar cinco de las cosas más importantes que se deben hacer al escribir una publicación de blog, desde la idea hasta la publicación. Ahora que lo ha leído, intente aplicar este consejo y ver qué funciona para usted.

Te dejo con un último consejo. Lo principal que aprendí de los blogs durante los últimos 3 años es que no puedo predecir en absoluto qué contenido despegará y qué terminará siendo un fracaso total. A veces, pongo varios días en una publicación, puliendo cada esquina, y no irá a ninguna parte. Por otro lado, “GraphQL vs. REST”, mi publicación más leída, fue escrita en unas pocas horas por la noche.

Entonces, incluso si su primera, segunda o tercera publicación no tiene éxito, siga probando cosas nuevas, exponiendo sus ideas y mejorando con el tiempo. El mundo quiere escuchar lo que tienes que decir. ¡Ve a decirles!

Muchas gracias a Anvisha Pai, Angela Zhang, Katie Siegel y los editores de freeCodeCamp por ayudarnos a revisar esta publicación.