Saltar al contenido
← Sesión 30

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?

viridiana.dev · Viridiana