Ficha · Sesión 30 · Módulo VI, La publicación
«De la pregunta a la herramienta»
¿Puede otra persona llegar a tu resultado con lo que dejaste escrito?
Sí, si tu repositorio trae el código, datos que se pueden compartir y un README que alguien siguió sin ayuda. Si no, la réplica te dice exactamente qué falta.
Presentación y réplica
El oficio que ya tienes
Replicar: presentar en un seminario y someter el trabajo a que otra persona lo verifique. Un repositorio que otra persona puede correr es un resultado que otra persona puede verificar, sin depender de tu palabra.
En Marienthal
Presentas la encuesta de uso del tiempo como un estudio: la pregunta, el cuestionario, cómo se codificaron las respuestas abiertas, cuánto coincidió el modelo contigo y qué muestra el tablero. Luego alguien del grupo clona el repositorio, carga los datos de ejemplo, corre el análisis y compara sus cifras con las tuyas.
En tu proyecto
Etiqueta la versión que presentas. Intercambia repositorios con otra persona del grupo: tú replicas el suyo y esa persona el tuyo. Anota cada paso en que se atoró, corrige tu README y guarda el cambio. Escribe en tu bitácora la siguiente pregunta que quieres responder.
Conceptos
- Réplica
- Obtener el mismo resultado siguiendo el mismo procedimiento, hecho por otra persona y sin ayuda de quien lo hizo primero.
- README
- El archivo que se lee primero en un repositorio: qué es el proyecto, cómo se instala y cómo se corre.
- Datos de ejemplo
- Un conjunto pequeño, inventado o anonimizado, con la misma estructura que tus datos reales, para que el análisis corra sin exponer a nadie.
- Etiqueta
- Un nombre fijo para una versión del repositorio, como v1.0, que señala con qué código se obtuvo un resultado.
Instrumental
git clone <dirección-del-repositorio>- Bajar una copia completa del repositorio, con todo su historial
git tag -a v1.0 -m "Versión presentada"- Marcar la versión exacta con la que obtuviste los resultados que presentas
git push origin v1.0- Publicar esa marca para que quien replica use la misma versión
git log --oneline- Recorrer el historial del proyecto como un cuaderno de campo
Para tu bitácora
¿Qué tuvo que preguntarte quien replicó tu proyecto, y por qué no estaba escrito?