Crea un nuevo README traducido al inglés

This commit is contained in:
yagueteiro 2022-04-03 17:27:45 +02:00
parent c9fd858fb2
commit a8c40bca2c
2 changed files with 90 additions and 13 deletions

View File

@ -1,24 +1,26 @@
# Subvenciones
_[- Read in English -](README_en.md)_
Un reto con la Base de Datos Nacional de Subvenciones (BDNS).
| | |
| ------------ | ------------------------------------------------------------------ |
| GitHub | https://github.com/JaimeObregon/subvenciones |
| Discord | https://discord.gg/r2ytSa782D |
| Idea inicial | https://twitter.com/JaimeObregon/status/1507693311422877697 (hilo) |
| GitHub | <https://github.com/JaimeObregon/subvenciones> |
| Discord | <https://discord.gg/r2ytSa782D> |
| Idea inicial | <https://twitter.com/JaimeObregon/status/1507693311422877697> (hilo) |
# El punto de partida
## El punto de partida
El Ministerio de Hacienda y Función Pública de España, a través de la Intervención General de la Administración del Estado, opera el [Sistema Nacional de Publicidad de Subvenciones y Ayudas Públicas](https://www.infosubvenciones.es). Se trata, telegráficamente, de un portal web que recoge las convocatorias y concesiones de subvenciones públicas.
![Portada del portal oficial](docs/assets/infosubvenciones-home.jpg)
Este portal es una inciativa en favor de la transparencia, pero tiene notables limitaciones.
Este portal es una iniciativa en favor de la transparencia, pero tiene notables limitaciones.
# El problema
## El problema
El portal oficial proporciona un interfaz cutre de acceso a unos datos que, sin embargo, son de alto valor para la transparencia:
El portal oficial proporciona una interfaz cutre de acceso a unos datos que, sin embargo, son de alto valor para la transparencia:
1. **La búsqueda es rudimentaria**, con una experiencia de usuario mejorable. El portal aparentemente no permite usos simples tales como, por ejemplo, reunir y explorar la totalidad de las subvenciones concedidas a un beneficiario dado. Y la ergonomía del sistema es pobre, con un interfaz de usuario tedioso, enlaces que caducan y que por lo tanto no se pueden guardar ni compartir…
@ -26,7 +28,7 @@ El portal oficial proporciona un interfaz cutre de acceso a unos datos que, sin
1. **No se pueden descargar los datos.** Se pueden hacer descargas parciales, pero el portal no proporciona un mecanismo para la descarga de la totalidad del conjunto de datos. Esto impide una exploración _offline_ del conjunto de datos y la aplicación de métodos avanzados de análisis.
# El reto
## El reto
¿Podemos, como sociedad civil, hacerlo mejor? ¿Podemos, como país, dotarnos de un instrumento mejor para el acceso y la publicidad de estos datos públicos?
@ -34,7 +36,7 @@ El reto consiste en arramplar con todos los datos del portal oficial y construir
Y hacerlo de forma cooperativa, reuniendo esfuerzos y capacidades en torno a un proyecto colaborativo de software libre y código abierto al que todo aquel que lo desee puede asomarse y contribuir.
# Cómo contribuir
## Cómo contribuir
`[WIP]`
@ -54,7 +56,7 @@ Y hacerlo de forma cooperativa, reuniendo esfuerzos y capacidades en torno a un
- **Si eres otra cosa**, ¡adelante! Echa un vistazo, observa y participa como desees.
# Próximos pasos
## Próximos pasos
`[WIP]`
@ -64,16 +66,16 @@ Y hacerlo de forma cooperativa, reuniendo esfuerzos y capacidades en torno a un
1. El repositorio puede sacarse del GitHub de JaimeObregon y moverse a otro más neutro, para que el proyecto no esté asociado al nombre de nadie en particular.
# Marco legal
## Marco legal
`[WIP]`
# Participantes
## Participantes
¡Desentierra tu hacha, participa y añade tu nombre de guerra! 😄
- Jaime Gómez Obregón ([@JaimeObregon](https://twitter.com/jaimeobregon)), _scraping_ de los datos y propuesta inicial.
- JuanMa Cuevas ([@juanmacuevas](https://twitter.com/juanmacuevas)), programador python & android. _hacktivista_ aficionado.
- JuanMa Cuevas ([@juanmacuevas](https://twitter.com/juanmacuevas)), programador python & android. _hacktivista_ aficionado.
- …

75
README_en.md Normal file
View File

@ -0,0 +1,75 @@
# Subvenciones (subsidies)
A challenge with the National Subsidies Database (Base de Datos Nacional de Subvenciones)
| | |
| ------------ | ------------------------------------------------------------------ |
| GitHub | https://github.com/JaimeObregon/subvenciones |
| Discord | https://discord.gg/r2ytSa782D |
| Original idea | https://twitter.com/JaimeObregon/status/1507693311422877697 (thread in Spanish) |
## The starting point
The spanish Ministry of Finance operates the [National System of Publication of Subsidies and State Grants](https://www.infosuvenciones.es) (Sistema Nacional de Publicidad de Subvenciones y Ayudas Públicas). It is a web portal that gathers all call for proposals and public grants.
![Official portal homepage](docs/assets/infosubvenciones-home.jpg)
This website is an initiative in favour of transparency, but has notable limitations.
## The problem
The official portal provides a poor interface for accessing the data that, however, has a great value for transparency:
1. **The search tool is rudimentary**, with a user experience with room for improvement. The portal, apparently, does not allow simple uses such as, for example, gathering and exploring the totality of the grants given to a specific beneficiary. The ergonomy of the system is poor, with a tedious user interface, links that expire and therefore cannot be shared...
1. **The data queries are very slow.** The mere loading of an arbitrary page may involve waiting more than 2 minutes. This dinamites the citizenship's access to the data, as in practice the queries are so slow that it turns out to be impossible. The citizen gives up.
1. **The data cannot be downloaded.** Partial downloads are available, but the portal does not provide a mechanism to download the complete set of data. This disallows the _offline_ use of the data and the application of advanced analysis methods.
## The challenge
Can we, as civil society, make it better? Can we, as a country, provide us with a better tool to access and publish these public data?
The challenge consists in getting all of the public data from the official portal and create an alternative tool to explore them in a useful, effective and creative way.
And make it cooperatively, joining efforts and capabilities around a collaborative open source project to which everyone who wants to can get involved and contribute.
## How to contribute
`[WIP]`
- **If you are a programmer**...
- **If you are an expert in public grants**...
- **If you are a designer**...
- **If you work in the public administration**, for example as an auditor, you can tell us how to ...
- **If you are a journalist**...
- **If you are an specialist in data protection**...
- **If you are a lawyer**...
- **If you are something else**, go ahead! Take a look and collaborate in what you like.
## Next steps
`[WIP]`
1. Finish this intro
1. Organize the next steps
1. The repo can be moved away from JaimeObregon and into a more neutral place, so the project is not associated with someone specific.
## Legal framework
`[WIP]`
...
## Contributors
Go ahead, participate and add your name to the list! You can find it [in the main README (spanish version)](README.md).