Definiendo el blog a crear

Ivan Medina
Aprendiendo en público
3 min readJul 6, 2024

Vamos a definir el objetivo de qué queremos construir, como lo mencionamos en la entrada introductoria, esta será un blog, pero, ¿cuál es el scope de dicho blog?. ¿Cómo sabemos si nuestro blog cumple la expectativa que tienen los stakeholders (para este caso, yo mismo 😅).

Para tener esto claro, documentaremos el product spec de este blog.

Photo by rivage on Unsplash

Descripción del producto

Un blog especializado en programación, escrito por programadores (inicialmente solo yo), destinado a proporcionar contenido técnico, tutoriales, análisis de herramientas, y artículos en general sobre desarrollo de software. El objetivo es crear un espacio para compartir conocimientos entre desarrolladores de todos los niveles de experiencia a través de posts interactivos y con la mejor experiencia de usuario posible para su legibilidad.

Características del producto

Contenido

  • Tutoriales: Guías detalladas para aprender nuevas tecnologías, frameworks y lenguajes de programación.
  • Análisis de proyectos open source: Notas sobre particularidades de implementación en distintos proyectos open source.
  • Mejores Prácticas: Artículos sobre patrones de diseño, metodologías ágiles, y técnicas de optimización de código.
  • Noticias y Actualizaciones: Información sobre las últimas tendencias y novedades en el mundo de la programación.
  • Notas rápidas: Contenido corto y directo sobre un tema técnico en específico.

Diseño y experiencia de usuario

  • Diseño Responsivo: Optimización para dispositivos móviles y tablets.
  • Navegación Intuitiva: Menús y categorías claramente definidos para facilitar la búsqueda de contenido.
  • Temas Oscuro y Claro: Opción de cambiar entre temas de visualización para mejorar la accesibilidad.
  • Código Interactivo: Secciones de código en los artículos que los lectores pueden modificar y ejecutar en línea.
  • Comentarios: Espacio para que los lectores puedan discutir y hacer preguntas sobre los artículos.

Funcionalidades técnicas

  • Motor de Búsqueda: Búsqueda por palabras clave, categorías y tags.
  • Integración con GitHub: Enlaces directos a repositorios de código y ejemplos.
  • Boletín Informativo: Suscripción a un boletín semanal con lo más destacado del blog.
  • Autenticación de Usuarios: Registro y login para comentar y guardar artículos favoritos.
  • SEO Optimizado: Mejores prácticas en SEO para asegurar la visibilidad en motores de búsqueda.
  • Analíticas de Uso: Herramientas de análisis para medir el tráfico y la interacción del usuario.

KPIs (Key Performance Indicators)

  • Tráfico Mensual: Número de visitantes únicos por mes.
  • Engagement: Tiempo promedio en el sitio y número de páginas vistas por visita.
  • Crecimiento de Suscriptores: Número de nuevos suscriptores al boletín semanal.
  • Interacción: Número de comentarios, likes y shares en redes sociales.
  • Retención de Usuarios: Tasa de retorno de visitantes recurrentes.

Scope y demás

En un product spec, probablemente esperaríamos más información sobre recursos, contexto, presupuesto y más detalles que en una empresa podrías encontrar. Sin embargo, dado que este producto es un side project no detallaremos esos puntos a excepción del scope en diversas fases:

MVP (Minimum Viable Product)

El producto mínimo viable deberá contemplar lo siguiente:

  1. Estar hosteado y accessible a través de un dominio a definir posteriormente.
  2. Mostrar las distintas categorías de contenido definido previamente.
  3. Cumplir con los líneamientos de diseño y experiencia establecidos (a excepción de los comentarios).
  4. SEO mínimo para que las entradas del blog puedan ser compartidas en redes sociales.
  5. Contar con una experiencia de redacción mínima pero eficiente.
  6. Recolectar las métricas necesarias para valorar los KPIs.

Post MVP

  • Mejorar la experiencia de redacción
  • Agregar la capacidad de comentarios y bookmarks (incluye la autenticación de usuarios).
  • Implementar el motor de búsqueda.
  • Agregar la funcionalidad de boletín informativo.
  • Mejorar la instrumentación y pipeline de CI/CD.
  • Mejorar las métricas de core web vitals.
  • Mucho más…

Conclusión

Se que en la entrada anterior mencioné que sería el único que no tendría snippets de código, pero al ser un producto que se crea desde cero, considero importante poder establecer un mejor contexto sobre lo que vamos a construir y lo que priorizamos en cada paso. Espero que esto te de una mejor perspectiva y genere aun más curiosidad de cómo lo vamos a implementar. Desde ya te comento, que la implementación sufrirá múltiples iteraciones, refactors y por qué no, tal vez algunos rebuilds.

Pd. Si en caso crees que usé algún GPT para el product spec, estás en lo correcto. Aun así, solo tomé la base de la estructura y modifiqué gran parte de su contenido para adaptarlo a lo que quiero compartir en esta entrada 😎.

--

--