fejugger / rulebook

4 stars 1 forks source link

Reglamento de Jugger

Bienvenido al repositorio del reglamento de jugger de La Federación Española de Jugger.

Actualmente el reglamento se encuentra en su versión 5.1

Versiones anteriores

¿Por qué un repositorio?

Con el objetivo de aumentar la transparencia del proceso de revisión del reglamento y democratizar la participación de los jugadores en los debates de las normas utilizamos un repositorio con control de cambios.

De esta manera, cada interacción sobre el documento puede ser trazada y conocer quién y cuando realizó cualquier cambio.

Del mismo modo aprovechamos la funcionalidad del servicio web para poder tener de manera centralizada y disponible debates sobre las normas (issues) y solicitudes de cambio (pull request).

De esta manera, los jugadores puede generar un nuevo debate en el momento en que surja la duda sin necesidad de esperar a un plazo determinado ni a un formulario que se cierra.

Del mismo modo, al estar 100% disponible online y actualizado en tiempo real, el repositorio servirá para añadir aclaraciones sobre normas que tendrá vigencia sin necesidad de tener que esperar al cambio de reglamento.

¿Cómo funciona el repositorio?

Un repositorio es un almacén de ficheros sobre los que se realiza con un control de versiones. Es decir, un fichero de texto con información adicional sobre los cambios que se han realizado sobre el mismo.

Todos los ficheros sobre los que se realiza el control de versiones se pueden ver en la pestaña code.

Code

Al hacer click en un fichero, podemos ver su contenido. De manera adicional, también podemos ver cuando se modificó por última vez.

Files

El reglamento se encuenta en el fichero rulebook.md

La extensión .md hace referencia a un archivo de texto con formato que utiliza sintaxis especial para dar formato a los contenidos. Es un acrónimo de "Markdown". Se utiliza principalmente para documentar proyectos, crear artículos en sitios web y para escribir mensajes en plataformas de discusión.

En lugar de utilizar código HTML o lenguaje de marcado para dar formato al texto, Markdown utiliza una sintaxis sencilla y fácil de aprender. Por ejemplo, los títulos se escriben con "#", las listas con "-" y las citas con ">".

Al guardar un archivo con la extensión .md, se puede visualizar en un formato legible en un editor de texto o se puede convertir a HTML o PDF para su publicación en un sitio web o para su impresión.

Puedes encontrar más información en el siguiente enlace.

Solicitudes de cambios

El repositorio gestiona las modificaciones a través de las pull request.

Generalmente cada solicitud de cambio representará una regla nueva para ser votada por los representantes.

PR

Una pull request es una solicitud de cambios sobre el contenido actual. Una pull request esta formada por un nombre, una descripción y los cambios que se proponen.

PR1

Al crear una pull request, automaticamente se abre un debate sobre el mismo en el que cualquier usuario registrado puede participar.

Para ver los cambios, simplemente es necesario ir al elemento Files changed del menú.

PR2

Para notificar los cambios se utiliza un código de colores muy sencillo:

De manera adicional, podemos ver los cambios en formato enriquecido.

Rich1

Rich2

También podemos ver el resultado final del contenido modificado.

View1

Añadir comentarios sobre algún cambio específico

Los usuarios registrados pueden añadir comentarios sobre la solicitud en general o sobre alguna parte del contenido.

Comment1

Comment2

Comment3

Crear un debate o realizar una pregunta

TBD