Technical Documentation
Return to Main Documentation
ENGLISH - version 2.3
ENGLISH - version 2.3
  • Introduction
  • Getting started
    • Create your fork
    • Configure your fork
    • Keep your fork updated
    • Communication
  • Installation
    • Local installation
      • Prerequisites
      • Ubuntu Linux
      • Debian Linux
      • macOS
      • Windows
      • Vagrant
      • Docker
    • Production and staging servers
      • Installer
      • Create a deploy user
      • Generating SSH Key
      • Manual installation (not recommended)
      • Digital Ocean
      • Heroku
      • Mail server configuration
    • Basic configuration
    • User documentation and guides
  • Customization
    • Introduction
    • Translations and texts
    • Images
    • Styles with CSS
    • JavaScript
    • Models
    • Controllers
    • Views and HTML
    • Components
    • Other Ruby classes (GraphQL, lib, mailers, builders)
    • Gems
    • Application configuration
    • Routes
    • Tests
  • Technical Features
    • OAuth
    • GraphQL
    • Debates and proposals recommendations
    • Configure Census Connection
    • Local Census
    • Multitenancy
    • User content translations
  • Open Source project
    • Code of conduct
    • Contributing
    • Coding conventions
    • Open source forks and modifications
    • License
Powered by GitBook
On this page
  • Reporting an issue
  • Resolving an issue
  • Other ways of contributing
  1. Open Source project

Contributing

PreviousCode of conductNextCoding conventions

Last updated 2 months ago

We appreciate you want to help us by contributing to Consul Democracy. Here's a guide we made describing how to contribute changes to the project.

Reporting an issue

If you have seen anything wrong in the platform performance or directly in the code, we encourage you to .

Before doing it, please take some time to check the and make sure what you are about to report isn't already reported by another person. In case someone else reported the same problem before, if you have more details about it you can write a comment in the issue page -a little more help can make a huge difference!

In order to write a new issue, take into account these few tips to make it easy to read and comprehend:

  • Try to use a descriptive and to-the-point title.

  • It's a good idea to include some sections -in case they're needed- such as: steps to reproduce the bug, expected behaviour/response, actual response or screenshots.

  • Also it could be helpful to provide your operating system, browser version and installed plugins.

Resolving an issue

labeled with PRs-welcome are well defined features ready to be implemented by whoever wants to do it. In the other hand, the not-ready label marks features or changes not well defined yet or subject to an internal decision, so we recommend not to try to resolve them until the admins come to a resolution.

We suggest to follow these steps to keep a good track of the changes you're about to make:

  • First of all, add a comment to the issue to make everyone know you are going to work on it. If the issue has someone assigned it means that person is already solving it.

  • Fork the project.

  • Create a feature branch based on the master branch. To make it easier to identify, you can name it with the issue number followed by a concise and descriptive name (e.g. 123-fix_proposals_link).

  • Check our to help you decide how to write your code.

  • Work in your branch committing there your changes.

  • Make sure all tests are passing. In case you're extending or creating a new feature, consider adding its own specs.

  • Once you've finished, send a pull request to the describing your solution to help us understand it. It's also important to tell what issue you're addressing, so specify it in the pull request description's first line (e.g. Fixes #123).

  • Our core team will review your PR and suggest changes if necessary. If everything looks good, your changes will be merged :)

Other ways of contributing

We'll appreciate any kind of contribution to Consul Democracy. Even if you can't contribute to it coding, you still can:

  • Create issues about any problem or error you've encountered.

Working on your first Pull Request? You can learn how from this free series .

Help translate the platform to other languages you master at .

Help with .

open an issue in the Consul Democracy Github repository
existing issues
Issues in Consul Democracy
coding conventions
Consul Democracy repository
How to Contribute to an Open Source Project on GitHub
Consul Democracy's Crowdin
Consul Democracy's documentation