(pd-project-repo-roadmapping)=
# Mapeo de ruta
Si planeas un gran trabajo en tu proyecto, es una buena idea producir un esquema del trabajo para compartir con sus colaboradores potenciales. Tu mapa de ruta debe cubrir tu meta y visión e incluir una línea de tiempo para las tareas que necesitan completarse, ayudando así a los nuevos colaboradores de tu proyecto a entender lo que está ocurriendo actualmente en el proyecto y lo que viene a continuación.
```{figure} ../../figures/project-roadmap.jpg
---
name: project-roadmap
alt: la imagen muestra una mano sosteniendo un smartphone con un mapa marcado con hitos 1, 2 y 3. Esta aplicación telefónica para mapas o navegadores analógicos es útil para entender hitos y proyectar mapas de ruta en proyectos de investigación.
---
Ilustración sobre el mapa de ruta del proyecto.
_The Turing Way_ proyecto de ilustración por Scriberia. Utilizado bajo una licencia CC-BY 4.0. DOI: 10.5281/zenodo.3332807.
```
Para crear un mapa de rutas, es importante trazar los hitos clave, necesarias para cumplir los hitos y los desafíos relacionados para ayudarle a asignar sus recursos y tiempo para trabajar en ellos de forma eficiente. Los hitos se pueden organizar alrededor de los objetivos de su proyecto, eventos comunitarios, desarrollo de colaboradores o calendarios. Si trabaja en GitHub, puedes usar [el panel del proyecto de GitHub](https://help.github.com/en/articles/tracking-the-progress-of-your-work-with-project-boards) para gestionar todas las tareas en asuntos en los que proporcionas detalles y recopilas la información relevante de forma colaborativa y abierta.
Un mapa de ruta puede describirse en la página de destino o en el archivo README para describir los siguientes aspectos de tu proyecto:
1. Resumen del proyecto para proporcionar una visión general y el estado actual de su proyecto.
2. Incorporar información que describe cómo otros pueden involucrarse y qué tareas inmediatas pueden hacer.
3. Línea temporal con metas a corto y largo plazo para su proyecto que describen las tareas que hay que realizar. en qué están trabajando los contribuyentes y dónde va a pasar a continuación. Por ejemplo, si se realiza una nueva versión del proyecto o un evento será organizado.
Para más detalles, por favor vea [esta presentación](https://docs.google.com/presentation/d/e/2PACX-1vSMCLWnN1_lO4ofD9cCjN9TJxyHYIvBFfgarOlwi95G4JJ5m672v-sYFbvfRyHPag83XviEJBrIecga/pub?start=false&loop=false&delayms=3000) por el programa [Open Life Science](https://openlifesci.org/) de capacitación y mentoría.
## Estudio de Caso: Proyecto AutSPACES
*Este estudio de caso ha sido redactado por <NAME>, director comunitario del proyecto AutSPACES (2021).*
[AutSPACES](https://github.com/alan-turing-institute/AutSPACEs) es una plataforma ciudadana de ciencia co-creada por personas audísticas y sus seguidores, junto con investigadores y la comunidad de código abierto. Para comunicarnos con éxito dónde estamos y qué hay que hacer, el proyecto AutSPACES ha creado un mapa de ruta muy detallado.
**¿Cómo empezamos?**
Para iniciar la creación de una Hoja de Ruta utilizamos la función de problemas en GitHub para comenzar el viaje de la creación de un mapa de ruta. Aquí, hemos planteado un problema en nuestro repositorio de GitHub en el que invitamos a los colaboradores a comentar cualquier hito propuesto y las tareas circundantes que deberían incluirse en el roadmap.
El Administrador de la Comunidad recopilará toda la información para producir una Hoja de Ruta que sea competente para la comunidad.
**¿Qué incluye nuestra Hoja de Ruta?**
La hoja de ruta incluirá hitos de alto nivel que están formados por una lista de temas de los cuales cada uno contiene una lista de comprobación con tareas granulares. Esto informará a cualquier colaborador donde pueda empezar a participar en el proyecto.
Los hitos, en este proyecto, se ven más como un tema general que como una lista de ticks . La idea detrás de esto es que no queremos marcar un hito ya que creemos que el trabajo es continuo, abierto y sujeto a revisión e iteración en todos los aspectos.
Las líneas de tiempo clave y las dependencias serán resaltadas ya que esto permitirá a todos los colaboradores saber cómo encaja cada tarea en el proyecto más amplio. Habrá una priorización de tareas que se correspondan con la dirección estratégica del proyecto; lo que es necesario hacer en este momento.
**¿Dónde pondremos nuestro mapa de ruta?**
El proyecto AutSPACES es un proyecto de Ciencia Ciudadana e Investigación Participativa. Esto significa que muchos de nuestros colaboradores no tienen la experiencia técnica necesaria para usar GitHub. Por lo tanto, tenemos que asegurarnos de que nuestra hoja de ruta sea accesible para todos y no sólo a través de GitHub. Por lo tanto, nuestro mapa de ruta será el anfitrión:
- En nuestro sitio web
- En un documento compartido para uso interno (hoja Excel)
- Github repository (MarkDown file)
Sin embargo, abordaremos esta barrera técnica ya que nuestro mapa de ruta incluirá un enlace a problemas en el repositorio. Para superar esto, hemos planeado enseñar habilidades básicas en GitHub, como crear una cuenta y acceder a nuestra lista de problemas.
**¿Cómo lo mantendremos actualizado?**
Uno de los principales problemas con los mapas de ruta y los planes de proyectos similares es el riesgo de que se queden anticuados. Puede confundir en lugar de ayudar a comunicar dónde está el proyecto y a dónde tiene que ir.
El proyecto AutSPACES crea un informe de progreso de forma contundente que registra las actualizaciones de la comunidad, el estado del desarrollo de software y el progreso de la investigación, así como qué tareas se han completado desde la última actualización y cuáles deben ser los siguientes pasos.
Estas actualizaciones manejan y alimentan las futuras actualizaciones de la hoja de ruta. Este proceso nos permite asegurar que nuestra hoja de ruta y nuestras prioridades de tareas estén siempre actualizadas.