La carpeta docs/ no contiene documentacion. Contiene el resultado de compilar un
sitio web, commiteado.
La evidencia
$ ls -la docs/
1103 404.html
894 index.html
81860 index-8PaU6JJo.css
2033305 index-D3-mAlci.js
9856 logo-OZlxya_r.svg
1987920 typezero-hero-Cz7_U_3z.png
2093342 xray-hero-DoQlJw3x.png
Casi 6 MB. Ni un archivo de texto que explique nada.
Dos detalles que valen la pena:
-
Los nombres estan hasheados (index-D3-mAlci.js). Cada vez que alguien
reconstruya el sitio, los archivos nuevos entran con otro hash y los viejos se
quedan. El repositorio engorda para siempre.
-
typezero-hero y xray-hero son de otros proyectos. No pertenecen a este
repositorio. Son de la pagina personal del autor original.
Por que importa
Quien entra a docs/ buscando como usar esto, no encuentra nada. Y quien clona el
repositorio se lleva 6 MB de imagenes de otros proyectos.
Direccion del arreglo
Como se toma este trabajo: comentá la issue con un plan concreto (que archivo, que
funcion, y como lo vas a verificar). Se asigna por la calidad de ese plan, no por
orden de llegada. La PR va despues de la asignacion, con el cambio real adentro.
La carpeta
docs/no contiene documentacion. Contiene el resultado de compilar unsitio web, commiteado.
La evidencia
Casi 6 MB. Ni un archivo de texto que explique nada.
Dos detalles que valen la pena:
Los nombres estan hasheados (
index-D3-mAlci.js). Cada vez que alguienreconstruya el sitio, los archivos nuevos entran con otro hash y los viejos se
quedan. El repositorio engorda para siempre.
typezero-heroyxray-heroson de otros proyectos. No pertenecen a esterepositorio. Son de la pagina personal del autor original.
Por que importa
Quien entra a
docs/buscando como usar esto, no encuentra nada. Y quien clona elrepositorio se lleva 6 MB de imagenes de otros proyectos.
Direccion del arreglo
docs/y agregar el directorio de salida al.gitignoreuna rama
gh-pages, en vez de vivir en maindocs/documentacion de verdad: que hace cada contrato, cual es elflujo de una partida, y como se despliega
git gcdespues, aunque el peso historico solo se saca reescribiendola historia, cosa que probablemente no valga la pena
Como se toma este trabajo: comentá la issue con un plan concreto (que archivo, que
funcion, y como lo vas a verificar). Se asigna por la calidad de ese plan, no por
orden de llegada. La PR va despues de la asignacion, con el cambio real adentro.