Collaboration Guidelines

[RichDeto]

Aportes de la comunidad

Este paquete se propone incorporar cualquier función de propósitos generales que utilice como base los datos geográficos de Uruguay. Todos los aportes en este sentido son bienvenidos.

Si trabajas con datos geográficos de Uruguay y querés agregar tu función o tus datos, te recomendamos que leas los siguientes consejos de como colaborar:

Para agregar tu función:

- Haz un fork de este repositorio
- Agrega tu función como un archivo .R en la carpeta R/ con el mismo nombre que la función
- Documenta la misma con roxygen2 aclarando su funcionalidad, los parámetros y un ejemplo de uso. Para ver como se documenta poder revisar otra de las funciones en ese mismo directorio
- Recuerda que para que tu función se pueda utilizar, al final de la documentación debes agregar un #' @export
- Controla que los tipos y valores de los parametros de tu función estén bien (para un ejemplo, podes mirar `data-raw/metadata.R`
- Agrega las dependencias en el archivo `DESCRIPTION`
- Chequea el paquete con devtools::check()
- Si todo funciona bien, entonces hace un pull request

Para agregar datos geográficos a la función load_geouy():

- Identifica la URL del servicio WFS correspondiente
- Agrega un registro al archivo `metadata` en el directorio `data-raw`, con los datos correspondientes.
- Incluye además este registro en la tabla correspondiente del `README.md` con el formato correspondiente.
- Si todo funciona bien, entonces genera un pull request

---

Community contributions

This package intends to incorporate any function of general requirements that use the geographic data of Uruguay as a base. All contributions in this regard are welcome.

If you work with geographic data of Uruguay and want to add your function or data, we recommend that you read the following tips on how to collaborate:

To add your function:

- Fork of this repository
- Add your function as an `.R` file in the `R/` folder with the same name as the function
- Document it with `roxygen2` clarifying its functionality, parameters and an example of use. To see how it is documented to review another function in the same directory
- Remember at the end of the documentation you must add a # '@export
- Check that the types and values of your function parameters are fine (for example, you can look at `data-raw/metadata.R`
- Add the dependencies in the `DESCRIPTION` file 
- Check the package with devtools::check()
- If everything works fine, then make a pull request

To add geographic data to the load_geouy() function:

- Fork of this repository
- Identify the corresponding WFS service URL
- Add a record to the `metadata` file in the `data-raw/` directory, with the corresponding data.
- Also include this record in the corresponding table of the `README.md` file, with the corresponding format.
- If everything works fine, then make a pull request