Propósito
¿Por qué una documentación? Te podrías estar preguntando. He tenido varias páginas webs a lo largo de mi vida, con diferentes diseños y usando diferentes tecnologías. Sin embargo, he terminado abandonándolas porque no se adaptaban finalmente a lo que estaba buscando.
Inspiración
No soy fan de documentar en primeras versiones de productos, pero cuando las cosas maduran, se necesita establecer unas guidelines de cómo se va a trabajar para estar todos alineados. Ese es el objetivo de esta web, escribir todo aquello que he ido madurando a lo largo del tiempo y que me ha funcionado.
Esta web está inspirada en la documentación de una librería o un framework. Es decir, tiene un orden y estructura muy parecida a la que te puedes encontrar cuando navegas por alguna de ellas. Soy muy fan de la documentación de NextJS, por lo que podrás encontrar muchos parecidos en la forma de presentar la información.
En cuanto al diseño, he cogido inspiración de shadcn/ui, una de la más limpias y bonitas que me he encontrado hasta ahora.
Estructura
La web está divida en varias secciones, cada una de ellas centrada en un tema en específico.
En el caso de que haya alguna conexión entre conceptos o crea conveniente que hay una dependencia, enlazaré a la página correspondiente.
De todas formas, la he estructurado de tal forma que tenga sentido leerla en orden, por lo que si decides leerla de principio a fin, no tendrás ningún problema.
Objetivos
Esta web tiene principalmente dos objetivos:
Seguir aprendiendo. No hay mejor forma de aprender algo que intentar enseñarlo a otra persona. Al escribir sobre un tema, tengo que asegurarme de que lo entiendo lo suficientemente bien como para explicarlo con claridad.
Compromiso. Cuando haces algo público, te sientes más comprometido con ello. Aquí hablo de algunos de mis principios y valores en el mundo del desarrollo de software, y quiero que esta web sea un reflejo de ellos.
¿Por qué no un blog?
Hoy en día, la mayoría de las plataformas de publicación de contenido (ya sean blogs, podcasts, canales de YouTube, …) dependen de algoritmos para posicionar contenido. Enfocar todo esto como una documentación me permite centrarme en la calidad del contenido, no en la cantidad o en la forma en la que se presenta.
Quiero compartir la información de la forma que a mi me parece que es útil, no de la forma que a un algoritmo le parezca que va a tener más impacto. Quiero poder actualizar y corregir sin tener que crear un nuevo artículo repitiendo mucha información solo para que Google vea que tengo más páginas indexadas.