Governance

About the code

For making new features, you can made a new module for your own application. If you want to publish it on the website, you can send us an message.

If you want to add a new feature or a change on the codebase, the process is:

  1. Suggest your change in Metadecidim

  2. Wait until Product Team reviews and accept the feature, as it’s important to be consistent with the rest of the software, comply with the Social Contract, etc.

  3. Then you can make the Pull Request.

  4. The PR will get reviewed by:

    1. Product Team: will review the functionality

    2. Mantainers: will review the code quality

new feature workflow process

Some things that you need to take in account about this process:

  • If you make the PR without Product Team approval then you could get rejected (after investing lots of time on developing).

  • Proposals can receive endorsements, although these are not decisive for a proposal to be included on the roadmap. The endorsements serve as indicators of the interest of the proposal or the need it covers. The comments to the proposals are also enabled, to collectively elaborate the initial idea and bring it to a productive result.

  • Every Thursday the Product team reviews all new proposals that have been published the previous week

  • If no funding is available it is included in the backlog of the corresponding component or module.

About the organization

Decidim was initially created by the city of Barcelona, but quickly it evolved through the help of Localret and other entities and administrations from Catalonia, such as Diputació de Barcelona (Barcelona Provincial Government), and other catalan cities: Terrassa, Sabadell, Gavà, L’Hospitalet de Llobregat, Badalona and Sant Cugat. You can read more about the history in About.

Since our first version in 2017 we’ve detected that it’s necessary for the sustainability of the project to not depend in a given institution such as the city of Barcelona, as that could be problematic for the future. Other open source projects made by public institutions that didn’t have a strong community or a sustainability strategy get shut down or slowly die without funding.

Making this kind of open source software from the public institutions and through public contracting law is really difficult and one other issue that we want to tackle with this new organization is about having resources for contracting in-house developers.

With all this on mind, we started with the Metadecidim Governance participatory process starting in November 2017:

A process open to the entire Community regarding the decision-making and representative bodies that we must equip ourselves with in order to build an autonomous, transparent and democratic organisation for the Decidim Project.

The objective is to define an organizational and representation system (internal organs and how they are chosen) that can be transformed into an autonomous entity or association from which the whole community participates and can manage the project at multiple levels

The Decidim project needs a system of its own governance that allows it to enjoy sufficient autonomy to continue growing in a sustainable manner, which is why it has to be provided with decision-making and conflict resolution bodies.

As a result of this participatory process, on February 2019 the Decidim Free Software Association (Associació de Software Lliure Decidim in catalan) was created. You can read more about the General Assembly of the Decidim Association.