<!-- review: finished -->

<a id="development"></a>

# Desarrollo

Angie es un proyecto de código abierto
que da la bienvenida a todos los colaboradores.

<a id="source-code"></a>

## Código fuente

Puedes clonar el código fuente de Angie desde nuestros repositorios públicos:
[Mercurial](https://hg.angie.software/angie),
[Git](https://git.angie.software/web-server/angie).

<a id="coding-style"></a>

## Estilo de codificación

Tus cambios deben ser consistentes con el resto del código de Angie;
las [convenciones de codificación](https://es.angie.software//angie/docs/developer_guide.md#developer-guide) son un buen punto de partida.

<a id="commit-messages"></a>

### Mensajes de commit

Históricamente, el registro de commits se mantiene en inglés.

Comienza con un resumen de una sola línea de lo que se hizo.
Puede llevar un prefijo que el registro de commits use para la parte de código afectada.
El resumen puede tener hasta 67 caracteres
y puede ir seguido de una línea en blanco y más detalles.

Un buen mensaje indica qué causó el cambio, qué se hizo al respecto,
y cuál es la situación ahora:

```none
API: bad things removed, good things added.

As explained elsewhere[1], the original API was bad because stuff;
this change was introduced to improve that aspect locally.

Levels of goodness have been implemented to mitigate the badness;
this is now the preferred way to work.  Also, the badness is gone.

[1] https://example.com
```

Detalles que pueden pasar desapercibidos:

- El resumen termina con un punto y empieza con una letra mayúscula.
- Si se usa un prefijo, éste va seguido de una letra minúscula.
- Dos espacios en blanco separan oraciones dentro de una misma línea.

<a id="final-checks"></a>

## Verificaciones finales

- Haz todo lo posible para verificar que los cambios funcionen en *todas* las plataformas de destino.
- Para cada plataforma, ejecuta la suite de pruebas para asegurarte de que no haya regresiones:
  ```sh
  $ cd tests
  $ prove .
  ```

  Consulta el archivo `tests/README` para obtener detalles.
- Asegúrate de estar cómodo con los [términos legales](https://es.angie.software//legal/index.md#legal).

<a id="submitting-contributions"></a>

## Envío de contribuciones

Para enviar un parche, crea una pull request en nuestro
[espejo de GitHub](https://github.com/webserver-llc/angie/).

Para preguntas y sugerencias, ponte en contacto con los desarrolladores a través de
[Issues de GitHub](https://github.com/webserver-llc/angie/issues).