El uso de la wiki integrada en GitHub se considera una mala práctica (anti-pattern) debido a sus limitaciones técnicas y de control. Aunque ofrece acceso rápido desde cualquier parte del repositorio, carece de las ventajas de la documentación versionada en carpetas locales, como la capacidad de clonar el código sin perder el acceso a la documentación, la revisión de pares mediante pull requests y la integración con herramientas de linting como Vale. Además, la wiki no permite la carga de imágenes y ofrece pocas opciones de personalización visual.
La recomendación técnica es mantener la documentación en una carpeta /docs dentro del repositorio principal durante las etapas iniciales de desarrollo. Esta estructura permite versionar los archivos junto al código, facilitando la gestión de versiones antiguas y la integración con GitHub Pages. Para proyectos más maduros, se sugiere migrar a un repositorio independiente con su propio proceso de construcción, lo que permite una mejor gestión de la documentación a largo plazo. Esta estrategia minimiza la fricción para los contribuyentes y asegura que la documentación esté siempre sincronizada con el código fuente.