Usar la wiki de GitHub es un anti-patrón

The GitHub wiki is an anti-pattern

Usar la wiki de GitHub es un anti-patrón

Michael Heap sostiene que la wiki de GitHub solo ofrece un beneficio —estar siempre accesible— frente a numerosas desventajas: no se versiona con el código, no pasa por pull requests, no admite imágenes y carece de herramientas de linting. En su lugar, propone la carpeta /docs: se revisa como código, se publica con GitHub Pages y facilita la migración a un repositorio propio cuando la documentación crece.

Usar la carpeta /docs es la opción con la mejor relación esfuerzo-recompensa mientras desarrollas un producto nuevo.

Más de este día

2026-09-23