Escribiendo tu primer blogpost técnico

Yo escribí en Medium mi blogpost sobre mi proyecto personal. Dónde hice un EDA en un dataset de anime que encontré en Kaggle.

Link -> https://medium.com/mlearning-ai/exploratory-data-analysis-eda-on-myanimelist-data-15134022dc7e

Me gustaría si me pudieran dar algun feedback.

Aun no creo mi primer blogpots, pero lo que si he creado es un sitio web para mi y mi portafolio, comenzo como copia de un compañero pero lo edite tanto que ya puedo decir que es mi web:

https://aazg.github.io/

alli se pueden ver unos proyectos, al pasar el curso da un resumen del proyecto y deja ver dos botones, uno al repositorio y otro a deepnote para ver el proyecto en un cuaderno de jupyter ya ejecutado.

En Deepnote ademas tengo todos mis proyectos:
https://deepnote.com/@aazg

Debo añadir que los proyectos en deepnote estan enlazados con el repositorio en github del proyecto, por lo cual siempre que actualizo en deepnote hago un git push origin main y todo se va a github, claro los proyectos cuando los comienzo los desarrollo en local para mayor rapidez porque tengo una buena maquina.

Tambien tengo los proyectos aca:
https://www.datascienceportfol.io/aazg

varian los proyectos entre uno y otro ya que tengo que estar actualizando.

Adicionalmente tengo whatsapp bussines con lo cual subo mis proyectos a un catalogo de acuerdo al tipo de machine learning implementado y los tengo alli, pero en esencia todo gira en torno a subirlo a deepnote ya que es el enlace que uso para que la gente visualice el proyecto.

Tenia pensado publicar en un blog, de hecho lo tengo como hipervinculo en mi web, pero tenia la duda de que seria mejor profesionalmente, medium o un blog personal, pareciera que medium tiene mejor posicionamiento en google y quiero que la gente lea mis proyectos. Creo que la opcion ideal seria Medium y copy paste de ese escrito en Linkedin.

Escribir tu primer blogpost técnico puede ser una excelente manera de compartir tus conocimientos, demostrar tu experiencia y ayudar a otros en la comunidad. Aquí tienes una guía paso a paso para que puedas estructurar y crear un blogpost efectivo: \### 1. \*\*Escoge un tema claro y específico\*\* \- \*\*Selecciona un tema que domines\*\*: Elige un tema sobre el cual tengas experiencia o que te entusiasme aprender. Esto hará que escribir sea más fluido. \- \*\*Define un enfoque específico\*\*: Es importante que el tema no sea demasiado amplio. Por ejemplo, en lugar de "Python para análisis de datos", podrías escribir sobre "Cómo usar `pandas` para limpiar datos duplicados en Python". \### 2. \*\*Conoce a tu audiencia\*\* \- \*\*Nivel técnico\*\*: ¿Tu audiencia es principiante, intermedia o avanzada? Asegúrate de ajustar el nivel de detalle y tecnicismo de tu contenido a tu público. \- \*\*Contexto\*\*: Piensa en lo que tu audiencia necesita aprender o resolver. ¿Es un tutorial para resolver un problema práctico, o una explicación teórica? \### 3. \*\*Estructura tu blogpost\*\* Un buen blogpost técnico debe tener una estructura clara. Aquí te propongo una: \*\*1. Título\*\* \- Asegúrate de que sea descriptivo, claro y atractivo. Ejemplo: “Introducción a Machine Learning con Python: Un tutorial paso a paso”. \*\*2. Introducción\*\* \- Presenta el problema o tema que abordarás. Explica por qué es importante o interesante. \- Enumera brevemente los puntos clave que cubrirás. \- Establece las expectativas para el lector: ¿Qué aprenderá al final? \*\*3. Cuerpo del artículo\*\* \- \*\*Subtítulos\*\*: Usa subtítulos para dividir el contenido en secciones lógicas. \- \*\*Explicación teórica\*\*: Si el tema lo requiere, empieza con una breve explicación conceptual. \- \*\*Código y ejemplos\*\*: Si tu post es sobre programación o tecnología, incluye fragmentos de código claros y explicados. Usa bloques de código (por ejemplo, con Markdown o HTML) para que sean fáciles de copiar y probar. \- \*\*Instrucciones paso a paso\*\*: Si estás haciendo un tutorial, enumera cada paso con claridad. \- \*\*Consejos útiles\*\*: Proporciona trucos, buenas prácticas o advertencias basadas en tu experiencia. \*\*4. Conclusión\*\* \- Resume lo aprendido o los resultados obtenidos. \- Puedes incluir un pequeño párrafo sobre próximos pasos o temas relacionados que podrían interesar al lector. \*\*5. Referencias y recursos adicionales\*\* \- Si mencionaste fuentes externas (documentación, artículos, papers), inclúyelos al final. También puedes agregar enlaces a recursos adicionales, como libros, cursos o documentación oficial. \### 4. \*\*Utiliza ejemplos prácticos y visuales\*\* \- \*\*Código reproducible\*\*: Si incluyes código, asegúrate de que sea completo, claro y fácil de seguir. Anima a los lectores a que lo prueben ellos mismos. \- \*\*Visualizaciones y gráficos\*\*: Si estás trabajando con datos, gráficos o resultados visuales, inclúyelos en el post para ilustrar mejor el contenido. \- \*\*Capturas de pantalla\*\*: Si el post es sobre herramientas o interfaces gráficas, agrega capturas de pantalla para que sea más fácil de seguir. \### 5. \*\*Escribe de manera clara y concisa\*\* \- Usa un \*\*lenguaje sencillo y directo\*\*. Evita las jergas innecesarias, a menos que tu audiencia sea avanzada. \- Divide los párrafos y evita bloques de texto largos. Usa listas o viñetas para puntos clave. \### 6. \*\*Revisa y edita\*\* \- Revisa el post varias veces para asegurarte de que esté bien estructurado, sin errores gramaticales y con el código bien formateado. \- Puedes pedirle a un amigo o colega que lo revise para asegurarte de que es fácil de entender. \### 7. \*\*Optimización para SEO\*\* Si quieres que tu blogpost sea encontrado por más personas a través de motores de búsqueda: \- \*\*Usa palabras clave\*\* relevantes (por ejemplo, si estás hablando de un framework o tecnología, asegúrate de mencionarlo varias veces en el artículo de forma natural). \- Incluye un \*\*meta descripción\*\* corta y descriptiva. \- Utiliza \*\*enlaces internos\*\* a otros posts que hayas escrito y \*\*enlaces externos\*\* a documentación o recursos confiables. \### 8. \*\*Promoción\*\* \- \*\*Comparte tu blogpost\*\* en redes sociales, foros técnicos (como StackOverflow o Reddit), y plataformas como LinkedIn. \- Publica en comunidades específicas que puedan estar interesadas en tu contenido, como GitHub, Dev.to o Medium. \### Ejemplo de estructura para un blogpost técnico: \--- \### \*\*Título: Cómo limpiar datos en Python con `pandas`\*\* \*\*Introducción\*\*: Limpiar datos es una de las tareas más comunes para los científicos de datos. En este tutorial, te mostraré cómo eliminar duplicados, manejar valores faltantes y formatear columnas utilizando la librería `pandas` en Python. \*\*Cuerpo\*\*: 1\. \*\*Eliminación de duplicados\*\* ```python import pandas as pd df = pd.read\_csv('data.csv') df = df.drop\_duplicates() ``` Explicación: … 2\. \*\*Manejo de valores faltantes\*\* ```python df.fillna(0, inplace=True) ``` Explicación: … \*\*Conclusión\*\*: En este post, hemos cubierto los aspectos esenciales de la limpieza de datos con `pandas`. Puedes continuar aprendiendo sobre manipulación avanzada de datos con otras funciones como `groupby` y `merge`.

Hola gente, como alguien que tiene una maestría (y no lo digo en sentido pretencioso), puedo darles los siguientes consejos ya que he escrito dos tesis y un artículo.

1. EMPIECEN siempre escribiendo las conclusiones, de esa forma puedes tener una mejor vista de lo que tienes que escribir antes de llegar a eso. La conclusión siempre tiene que ver con la hipótesis, pues fue el motivo de su trabajo, recuerden eso.
2. NO hagan una explicación super detallada de sus modelos en su reporte, en el desarrollo sólo hagan mención de ello, creen un apartado de anexos siempre para que expliquen mejor sus métodos.
3. Lean un par de artículos científicos para que aprendan a hacer un abstract/resumen. Sinceramente es lo que he visto que más le cuesta a las personas y también lo que más me costó a mí.

Nunca comenté nada en todo mi tiempo en Platzi y creo que por fin tenía algo que aportar, mi suscripción se acaba en un par de días, así que también es mi despedidad, no se desanimen!