tarea: definir y construir wiki
hay tres opciones, por favor tomar en cuenta somos personas opcupadas y con baja conexcion internet:
-
definir la wiki como parte del repositorio, estaria dentro de un directorio en la raiz llamado "docs" el cual es compatible con el autobuilder html statico de github, con lo que se podra autogenerarse la web de la wiki sin tener que estar haciuendo cosas manuales
-
definir la wiki como un submodulo que inmediatamente se deposite en el directorio en la raiz llamado "docs" el cual es compatible con el autobuilder html statico de github, con lo que se podra autogenerarse la web de la wiki sin tener que estar haciuendo cosas manuales
-
hibrida: esto es tener las dos, y como la opcion 2 es realmente un repositorio git tambien, yo (o cualqueira) pueda tener un git local y en cada push hcaer mirroring a otro origin, sin embargo esto es complicado y no es automatico, no es uan opcion muy viable para personas opcupadas.
Despues de definir la opcion, se modifica el settings de wiki del proyecto para que apunte a la solcuon final.
Espero por tu decicion, pero acoto notas:
PROS OPCION 1: Tener el documentaion en el repo hace que hasta tu mismo en cada cambio de codigo o commit puedas tambien subir notas de como debe quedar al documentacion y en donde. Mi eleccion es la opcion 1 aunqeu la opcion 2 se vea muy profesional no puedo dejar de pensar en lo que yo paria cuando alguien complicaba las cosas en internet, y yo pienso en esas personas. ademas guachi es algo que debe mantenerse simple y pequeño asi que para que complicarse.
CONTRAS OPCION 1: Aunque no propiamente un contra, porque no permitiria la colaboracion facil, es mas una medida de control antes cambios arbirtrarios, puesto que los usuarios y aun cuando usen la interfaz grafica necesitaran tener permisos, sino tendran que hacer un fork y proponer un pull request, cosa que me gusta.
PROS OPCION 2: si se usa la wiki normal, este sera un repositorio git (que se puede clonar tambien) y gracias al sistema gitlab wiki usuarios podran editar libremente
CONTRA OPCION 2: cualquiera puede editar, si ponemos permisos seria lo mismo que el caso de la opcion 1, lo cual me parece ilogico, y aun cuando este asi, para mi escomplicado distintos lugares para la misma cosa, prefiero el repo incluya ya la documentacion en directorio "docs" en formato wiki