From a8c40bca2c7f631f14cf87142bc213b6c33a3965 Mon Sep 17 00:00:00 2001 From: yagueteiro Date: Sun, 3 Apr 2022 17:27:45 +0200 Subject: [PATCH] =?UTF-8?q?Crea=20un=20nuevo=20README=20traducido=20al=20i?= =?UTF-8?q?ngl=C3=A9s?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 28 +++++++++++--------- README_en.md | 75 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 90 insertions(+), 13 deletions(-) create mode 100644 README_en.md diff --git a/README.md b/README.md index d8fab8d..d2c0216 100644 --- a/README.md +++ b/README.md @@ -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 | | +| Discord | | +| Idea inicial | (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. - … diff --git a/README_en.md b/README_en.md new file mode 100644 index 0000000..4974003 --- /dev/null +++ b/README_en.md @@ -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).