Elizabeth Fuentes L for AWS Español

Posted on Apr 27, 2023 • Edited on Nov 15, 2023

10 tips para escribir un buen blog

#spanish #tutorial #beginners #productivity

🇻🇪🇨🇱 Dev.to Linkedin GitHub Twitter Instagram Youtube

Original version: Scripting your blog post like it´s an action movie. 10 things sreenwriter do that will make you a better blogger. - James Beswick AWS Developer Advocate – Serveless

Cuando decidimos escribir un blog por primera vez, no siempre es fácil porque tenemos miedo de si nuestro contenido va a gustar, y nos empezamos a preguntar:

¿Mi blog va a ser visitado?
¿Mi blog va a entretener al lector con su contenido?
¿Mi lector aprenderá algo de mi blog?
¿Mi blog será mencionado por otros autores?
¿Y si no tengo buena ortografía?

Está bien tener miedo, pero esta mejor tener una guía con 10 tips que te ayude a superar esos miedos y lograr responder con fuerte “Si” todas esas preguntas (menos la última pregunta de la ortografía).

Acá van los 10 tips:

1. Conoce tu audiencia.

Cuando escribes un blog piensa en ti como si fueras un artista que quiere cautivar a su audiencia, los lectores, y para lograrlo debes conocerlos.

Supongamos que alguien me pregunta ¿Cuál es tu trabajo?, lo ideal sería responder de acuerdo a quien hace la pregunta:

En general: “soy Developer Advocate, ayudo a los clientes a aprender los beneficios de la tecnología”.
En un evento de la industria: “Trabajo en AWS”
En la TV: “Trabajo en Amazon en la división de tecnología”, porque no todos conocen a AWS,
A mi mamá: “Mamá, trabajo programando con computadoras”.

Piensa en la audiencia, como personas con problemas a los cuales hay que ayudar a solucionarlos, no como personas que quieren conocer un servicio y sus funcionalidades. Cuéntales de los servicios como herramientas para lograr las soluciones, por ejemplo en la Tabla 1, hay dos tipos de títulos Enfocados en el servicio y Enfocados en la Audiencia.

🧰 Enfoque en el servicio	👩🏻‍💻 Enfoque en la Audiencia
“Usando Amazon Athena para hacer consultar datos en S3”	“Convierta fácilmente tus datos en información para el cliente”
“DynamoDB ahora ofrece aprovisionamiento on-demand”	“Escalando tu base de datos para la temporada alta de ventas”

Tabla 1 Títulos de acuerdo enfoque interno vs audiencia.

Si empleas los títulos de Enfoque en el servicio de la Tabla 1, es probable que no captes atención la atención de la audiencia, porque el nombre del servicio y su funcionalidad no es conocimiento general, pero si lo cambias a un enfoque donde le cuentas que se puede resolver como en Enfoque en la Audiencia inmediatamente crear un título atractivo, porque
estás hablando de la solución a un problema y despertar su curiosidad.

Ten en cuenta que cuando eres el artista que escribe un blog, debes hacerlo accesible a las masas, para lograrlo debes tener cuidado de no ser “muy amplio” o “muy ajustado”.

Hablar del contenido es “para todos”, posiblemente no sea de verdad para todos y termine siendo “para nadie”, trata de no enfocarte en conjuntos específicos (al menos que eso quieras), por ejemplo si hablas de “solo para startups de medicina biológica” te estas refiriendo a una audiencia muy acotada.

Mira algunos ejemplos en la Tabla 2.

Muy amplio 🤯	Bloggable 😊	Muy ajustado 😵‍💫
Todos los clientes	Empresas migrando	Startups de medicina biológica
Todos los desarrolladores	Python	PHP 4 or COBOL
Todo el mundo	En las zonas de servicios de AWS	Geografías menores
Cualquier desarrollador	Arquitectos Cloud	CTO o internos

Tabla 2 Uso de amplio y estrecho.

2. Planificar – MUCHA planificación.

¿Cómo empezamos a escribir un blog post?

En un nuestra imaginación: abrimos un documento en blanco y “abracadabra palabras vengan a mi🔮🪄”
En la realidad: Hay que planificar antes de empezar a escribir.

Para empezar a planificar debes hacerte las siguientes preguntas:

¿Cuál es el nivel de conocimiento que debe tener mi audiencia?:
- Fundacional (100): puede tener una experiencia mínima o nula con los servicios de AWS.
- Intermedio (200): ha utilizado varios servicios de AWS desde la consola, la API o la CLI (o los tres).
- Avanzado (300): son desarrolladores que crean aplicaciones a través de API o la CLI.
- Experto (400): son desarrolladores o arquitectos.
Si quisieras llevar el tema de tu blog a una conversación, ¿podrías explicar su contenido en menos de 10min?.
¿Qué puedes asumir del conocimiento del lector?
Si tu blog contiene código, ¿Como lo vas a mostrar o empaquetar?, de tal forma que se entienda.
¿Cuál es tu nueva idea que no se ha escrito antes? o si existe, ¿Qué es lo nuevo que tiene tu versión?.
¿Qué te emociona de escribir ese blog post?

Cuando no planificamos es común atascarse y entrar en pánico, en la Tabla 3 algunas situaciones típicas que podemos superar con la planificación.

🚨Pánico sin planificación🚨	🚀Con planificación🚀
¡Es muy largo!	Si es muy largo, reestructúralo y divídelo en más de un blog post.
¡Es muy corto!	Tal vez un blog post no es la mejor idea, no está mal cambiar el medio ¿qué tal un video?
¡Estoy bloqueado!	¿Cómo avanzo? Con la planificación no hay bloqueos, las ideas están antes de escribir.
¡No tengo fuentes de ideas!	Conversa tu idea con amigos o colegas, busca puntos de vistas, ¡te sorprenderás!

Tabla 3. Pánico vs planificación.

3. Define el escenario.

En el mundo de la entretención los primeros minutos son cruciales, por ejemplo al ver una película si los primeros minutos no llaman tu atención no la continuas viendo, la olvidaras y no la recomendaras a nadie, todo lo contrario.

Lo mismo pasa con los blog post, las primeras líneas son las más importantes, deben transmitir lo que va a lograr el lector cuando termine su lectura, debe despertar su curiosidad para continuar leyendo y llegar al final.

Un ejemplo de despertar la curiosidad de la audiencia:

“Puede usar el reconocimiento facial para procesar fotos de forma rápida y económica. Utilice estas herramientas sin servidor y código mínimo para crear una aplicación lista para producción en 15 minutos.”

Fíjate que en el párrafo anterior no se menciona el nombre del servicio, pero te dice lo que puedes lograr.

Para definir el escenario define los límites de tu blog respondiéndote lo siguiente:

¿Qué pretendes cubrir?
¿Qué puedes cubrir adecuadamente en el tiempo permitido?
¿Qué estas asumiendo de la audiencia?
¿Sabes suficiente del problema que quieres solucionar?
¿La solución que estas entregando es la mejor?
¿Qué necesita saber el lector para encontrar el blog post útil?

Seguro para ti la idea del blog post es la mejor del mundo, pero recuerda que no estas escribiendo para ti.

4. Cuenta una historia.

Cuando pienses en tu blog post, aborda la solución como una historia.

Como ejemplo, te contare la historia del Parque temático Innovator Island, una serie de blogs de 3 episodios donde se guía al lector en la creación de una aplicación web para manejar los tiempos de espera de sus visitantes, tomar fotografías, alertas de notificaciones y traducción de idiomas.

Los episodios tienen los Temas a tratar y Casos de usos de la Tabla 4:

Tema a tratar	Casos de Uso
Mensajería en tiempo real con pub/sub MQTT	Muestra los tiempos de espera de los viajes en un mapa interactivo.
Lambdas activadas con S3, usando OpenCV y Layers de funciones Lambda.	Procesa las fotos de los paseos.

Tabla 4 Tema a tratar vs Casos de uso.

Contar una historia usando términos técnicos es aburrido 😑, y puede ser abstractos porque no transmites lo que quieres solucionar.

Entregar casos de usos convincentes despierta la curiosidad del lector, las personas recuerdan las historias de acuerdo a los sentimientos de cómo se sintieron cuando la escucharon (o leyeron) y si cuentas de forma agradable como construir algo para solucionar un problema dejaras un buen sentimiento que recordar.

5. Muestra, no cuentes.

No cuentes como hacer, muestra como lo haces:

Usa diagramas de las arquitecturas.
Usa capturas de pantalla.
Usa un balance entre imágenes y texto para dividir contenidos.
Incluye videos
Incluye demos

Que las imágenes sean legibles, acotadas a lo que necesitas mostrar y si es posible encierra la parte de la imagen que quieres enfocar.

Por ejemplo, en Fig. 1 se utiliza para mostrar “En Create datasets ingresa a View datasets”.

Fig. 1 En Create datasets ingresa a View datasets.

6. Usa el título.

El titulo le transmite al lector de lo que trata el contenido del blog post, escoge uno bueno de eso dependerá si el lector decide leerlo o no.

En la Tabla 5 puedes encontrar los Si y No que debes tener en cuenta al crear el título de tu blog post.

🆗 Los SI de un Título de blog post	🛑 Los NO de un Título de blog post
Plantea una pregunta o problema	Ser indirecto, tímido o demasiado inteligente.
Que aparezca en las búsquedas: no muy largo y con palabras claves.	Usar términos que el lector no conoce.
Se tenaz pero positivo	Ser negativo
Se claro como el cristal.	Engañoso o no claro.

Tabla 5. Si y No que debes tener en cuenta en el título de un blog post.

Puedes ver algunos ejemplos de títulos buenos y malos en la Tabla 6.

👍 Títulos buenos	👎 Títulos malos
“Cómo cargar aplicaciones web sin servidor de prueba”	“Prácticas recomendadas de Artillery.js y uso de configuraciones automatizadas”
“Construyendo un robot meteorológico marciano con funciones Lambda”	“Sondeo de un servicio de agua utilizando un dispositivo Arduino IoT.”
“Crear un sitio estático para reemplazar WordPress en 10 minutos”	“Publica pipelines de Gastby o Jekyll en un CDN”

Tabla 6. Títulos buenos vs malos.

Los títulos deben:

Tener máximo 75 caracteres.
Usa las mismas palabras clave en el título y los primeros 255 caracteres del blog post.
Enganchar al lector
Empezar con un gerundio. (Ejemplo: “Crea”, “Construye”)
Si vas a mencionar un servicio, solo menciona el más importante.

7. Aplica la regla de 80/20

Combina 80% de contenido familiar con 20% de contenido original, por ejemplo:

Usa contenido existente, como ejemplos o tutoriales.
Usa lenguaje o servicios familiares, por ejemplo: REST + React + Lambda – pero con DynamoDB.

Una idea importante del post, varias ideas mezcladas en un solo blog post puede causar que tu audiencia pierda interés.

8. Respeta el tiempo de la audiencia.

Ponte del lado de la audiencia antes de publicar tu blog post y pregúntate:

¿Qué te parece el articulo?
¿Avanzaste rápido para terminar?
¿Usaste CTRL+F para buscar palabras claves?
¿Te rendiste rápido?
¿Prefieres mucho texto o imágenes?
¿Por qué debo leer el artículo en vez de hacer otras cosas?

Si empezaste a avanzar rápido y buscar palabras claves, deberías mejorarlo, si aburre al autor, ¿que puedes esperar del lector?

Ve al punto, si tienes una introducción compleja que no engancha a la audiencia elimínala y ve directo al problema que quieres solucionar, que la audiencia considere que es el tiempo que leerá tu blog es un tiempo bien invertido.

Enumera los servicios que usa tu solución, no los describas con mucho detalle y coloca un enlace a las páginas oficiales para mayor información.

Estas entregando una guía para solucionar un problema, si no es necesario no seas tan especifico, puedes apoyarte en enlaces a documentaciones, referencias y repositorios de GitHub con el código completo, que sea costumbre crear repositorios de GitHub para compartir tu código.

Si tu blog no es técnico trata de que no supere las 1200 palabras, si es técnico que no superen las 2400 y que los párrafos no tengan más de 200 palabras.

9. Claridad.

Se conciso y directo, no te vayas por las ramas.

Por ejemplo, ¿que ves de malo en el siguiente texto?

“La consola lambda es generalmente donde ejecutaremos nuestro código, y siempre se puede actualizar fácilmente cada vez que tengamos una nueva versión, ¡pero tenga cuidado de no guardar los cambios accidentalmente!”

Es largo y está lleno de palabras que se pueden resumir, ¿verdad?, que te parece una versión como esta:

“Puedes ejecutar código en la consola AWS Lambda y realizar cambios fácilmente mediante el control de versiones integrado”

Evita escritura conversacional: no escribas como hablas.

Como lo cuentas en una conversación:

“OK, mi pequeña función puede frenar esa factura de AWS y su aplicación ahorrará una tonelada de GB mientras está en eso, por lo que agregará esto a todas sus aplicaciones en poco tiempo.”

Como lo deberías escribir:

“Este código puede ayudar a reducir el tiempo de ejecución y el costo en todas sus aplicaciones.”

Hay una gran diferencia entre escuchar y leer, cuando conversamos usamos palabras de adorno que al leer se ven como tropiezos en la lectura, además de que ese tipo de escritura complica la traducción a otros idiomas, y el sueño de los artistas es que nuestro arte este en varios idiomas.

Ten cuidado con las palabras que empleas, hay varios tipos de español y dialectos en cada país, trata de ser lo más neutral posible para que tu contenido sea comprendido por todos los que hablan tú mismo idioma.

Por último, cada párrafo debe representar 1 idea clara y que sume al contenido del blog, si hay varias ideas en un párrafo es mejor darle un enter y punto aparte, y si no suma al contenido del blog mejor eliminar.

10. Guía a la audiencia.

En películas la audiencia sabe que esperar, tienen un inicio, medio con desenlace y final, en los blogs post los lectores también esperar que este dividido en partes, como:

Título: La primera guía que tiene la audiencia de lo que se cubrirá en el blog post.
Introducción: un párrafo donde cuentas el viaje que va a hacer el lector al leer tu blog post.
Sitúa el problema: cual es el escenario y la situación que quieres resolver.
Muestra los pasos para llegar a la solución: La solución debe ser sencilla y fácil de comprender, guía al lector de forma interactiva, mantenlo enganchado.
Conclusión: Acá dejas el resumen de lo que se logra con el blog post. Muchos lectores leen primero las conclusiones para decidir si leen el blog post completo o no, tener una buena conclusión ayuda a captar más lectores.

Si quisieras generar una guía paso a paso de cómo solucionar el problema, debe ser con los pasos y contenido necesarios. Veamos un ejemplo sencillo de “cómo preparar huevos revueltos” en Tabla 7.

😴 Lo obvio	😃 Bueno	🥱 Muchos detalles
Ve al supermercado y compra los huevos más baratos. Consigue tus propias gallinas. También puedes hacer un soufflé. Ten un entrenamiento culinario. Haz huevos revueltos mientras estas acampando. Como saber si este hambriento.	Compra dos huevos. Rompe los huevos y remueve cualquier resto de la cascara. Revuelve con una cuchara por 30 segundos. Mézclalos con una cucharada de mantequilla. Cocínalo en el microondas por 1 minuto. Sirve.	Ingresa los huevos en la historia. Pros/contras de distintas técnicas de cocinas huevos. ¿Es ético comer huevos? Omega 3 y tu cerebro. Bate tu propia mantequilla. Como el microondas cocina el huevo.

Tabla 7. 3 formas de explicar paso a paso como preparar huevos revueltos.

En lector debe disfrutar el viaje desde la curiosidad de cómo resolver el problema hasta el conocimiento obtenido de lograr la solución, si lo haces como en Lo obvio o en Muchos detalles del ejemplo de ¿cómo preparar huevos revueltos?, vas a perder al lector porque la lectura no es útil y ni entretenida.

Antes de publicar tu blog post pídele a alguien, o más de uno, que no conozca la solución al problema que planteas que lo lea, y te cuente que le parece, si la lectura es buena, y si los pasos lo mantuvieron enganchado hasta el final.

También puedes pedir comentarios a alguien que conozca la solución, posiblemente hay una mejor forma de hacerlo y nunca es tarde para mejorar.

Conclusión:

Cuando tomas la decisión de convertirte en un artista que escribe blogs post, no pienses solo en sentarte a escribir y que lleguen las ideas, piensa en entregar una experiencia agradable a tu audiencia, el lector, despierta la curiosidad con el problema y luego entrégale el conocimiento con la solución, diviértete y recuerda seguir los tips:

Conoce tu audiencia: identifica para quienes estas escribiendo el blog y enfócate en ellos.
** Planifica:** la planificación te ayudará a comprender la idea y como desarrollarla antes de empezar a escribir: además de que evitará los bloqueos.
Define el escenario: asegúrate de definir los límites de la idea que quieres cubrir.
Cuenta una historia: las personas las recuerdan las historias y es más agradable que hablar de problemas abstractos.
Muestra, no cuentes: No solo uses palabras, apóyate con imágenes, arquitecturas, capturas de pantalla, videos, el límite es la imaginación.
Usa el título: Las personas deciden leer el blog post si el titulo les parece atractivo, escoge uno bueno.
Usa la regla del 80/20: Combina 80% de contenido familiar con 20% de contenido original, a las personas les gusta ver contenido familiar con algo de innovación.
Respeta el tiempo de la audiencia: que la audiencia considere que es el tiempo que leerá tu blog es un tiempo bien invertido.
Claridad: Se conciso y directo, no te vayas por las ramas, evita escritura conversacional.
Guía a la audiencia: Haz de la lectura a tu blog un viaje interesante, resuelve problemas que sean interesantes para la audiencia y no lo llenes de pasos redundantes o muy cargados.