Pasos

  1. Los autores solicitan la inclusión de un complemento en el sistema de traducciones mediante la lista de correo de complementos de NVDA.
  2. Un miembro del equipo de complementos de NVDA crea un repositorio para el complemento en https://bitbucket.org/nvdaaddonteam

    • Si el autor tiene una cuenta en Bitbucket, el/ella puede solicitar acceso de administrador al repositorio del complemento, y acceso de escritura a add-on files.
    • El repositorio del complemento debe contener una rama llamada stable, donde los autores u otras personas con acceso de escritura al repositorio deberían enviar código considerado estable cuando el complemento se actualice. Esta rama se usa para enviar mensajes traducibles a, y recibir mensajes traducidos desde, el repositorio de traducción de NVDA.
  3. Los administradores registran el complemento y envían los ajustes para traductores desde el servidor exbi ([email protected]):
    • cd a mr
    • mr up
    • cd available.d
    • mr registerAddon addonRepoName
    • git push
    • cd a mr
    • mr up
    • cd a mr/addons/addonRepoName
    • mr addon2settings
    • cd ~/mr/srt
    • svn commit */settings -m «Make blah add-on available for translation.» («se hace al complemento blah disponible para traducción», mensaje a enviar a los traductores)
  4. Editar addonfiles/automatic.crontab, a fin de que los mensajes se añadan a la rama stable, y de que los traductores reciban nuevos mensajes automáticamente.
    • Copia una de las líneas para un complemento existente, cambia el nombre del complemento y pégala en la sección correcta, commit y push.
    • Nota: Los administradores pueden realizar el proceso arriba manualmente, ejecutando mr svn2addon y mr addon2svn desde exbi.

Mantener el complemento

Nota: los responsables de mantenimiento pueden seguir otros procedimientos. Esta información sólo se proporciona como una referencia, de acuerdo a debates como este tema sobre gestión de repositorios.
  • Clona el repositorio del responsable de mantenimiento:
    • git clone https://github.com/usuarioGithub/repoComplemento
  • Añade un origen remoto para el repositorio de Bitbucket:
    • git remote add bitbucket https://bitbucket.org/nvdaaddonteam/repoComplemento
  • Descarga el repositorio de Bitbucket:
    • git fetch bitbucket
  • Sigue la rama stable:
    • git checkout -t bitbucket/stable
  • Periódicamente:
    • Desde la rama stable:
      • git pull # Descargar traducciones
      • git merge master # Código estable que contiene mensajes traducibles
      • git push bitbucket stable
    • Desde master:
      • git pull
      • git merge stable
      • git push origin master # Actualizar traducciones

Referencias para responsables de mantenimiento

Requisitos

Acceso a addonFiles

Esto se concederá sólo a personas que tengan un registro a lo largo del tiempo de revisiones y de las cuales se sepa que son de confianza en sus deberes, todo esto sujeto a un diálogo de toda la comunidad sobre la administración de repositorios. El mantenedor debe cumplir los siguientes criterios:
  1. Haber hecho una revisión básica como mínimo.
  2. Que se sepa que es un modelo de rol confiable en términos de autoría, revisión, mantenimiento y promoción de complementos (la administración de un repositorio es un trabajo con un montón de responsabilidades).
  3. Que se sepa que es responsivo a la comunicación para y desde usuarios y otros desarrolladores.
  4. Mantener vigilado el desarrollo del núcleo de NVDA.

Acceso a los repositorios y registro de complementos

  • El registro o el acceso a repositorios no se denegará por problemas personales, como diferencia de pareceres, críticas al código de los administradores o actitud basada en evidencia, etc. Si un administrador no es de confianza en sus deberes, debe ser reemplazado por otro mantenedor.
  • Así y todo, si la solicitud de registro o acceso se hace de forma que se vea (perceptiva o realmente) como amenazante o dañina para la persona a la que se pide el alta de un nuevo mantenedor, o para toda la comunidad en esa materia, la solicitud será denegada y se archivará para siempre (a fin de que sirva como lección para la persona que lo hizo en primer lugar así como para la comunidad).

Enlaces relacionados

Agradecimientos

Este documento está basado en el trabajo e información proporcionados por Mesar Hameed y James Teh. Gracias por hacer esto posible.