Skip to content

Latest commit

 

History

History
59 lines (41 loc) · 3.39 KB

CONTRIBUTING.md

File metadata and controls

59 lines (41 loc) · 3.39 KB
Raw

How to contribute

First of all, thanks for taking your time to contribute!!

Please note that only questions on the framework, and official channels will be answered here. For any third-party channels, please contact their respective authors.

Here is a simple guide on how you can file in an issue, or submit a pull request that is useful and effective.

If you need help, or want to talk to the authors, feel free to chat with us at our Gitter chat or Telegram support group.

Reporting bugs

Before submitting a bug report

  • Read through the documentation to see if it has covered your quesiton.
  • Check the current issue list to see if it's been reported.

How Do I Submit A (Good) Bug Report?

  • Use a clear and descriptive title for the issue to identify the problem.
  • Describe the exact steps which reproduce the problem in as many details as possible.
  • Provide specific examples to demonstrate the steps.
  • Describe the behavior you observed after following the steps and point out what exactly is the problem with that behavior.
  • Explain which behavior you expected to see instead and why.
  • If the problem wasn't triggered by a specific action, describe what you were doing before the problem happened and share more information using the guidelines below.
  • Provide log related to the issue. Use python3 main.py -vv to start the logging process, and submit the entire log from the first step you performed.

Provide more context by answering these questions:

  • Did the problem start happening recently (e.g. after updating to a new version) or was this always a problem?
  • Can you reliably reproduce the issue? If not, provide details about how often the problem happens and under which conditions it normally happens.

Include details about your configuration and environment:

  • What version of EFB are you using? You can get the version by running python3 main.py -V.
  • What's the name and version of the OS you're using?
  • Which channel caused the problem? Or did the framework cause it?

!!! attention When submitting your log, please remember to hide your private information.

Suggesting enhancements

If you have any suggestions, feel free to raise it up in the issue list. Please try to provide as much details as you can, that includes:

  • Use a clear and descriptive title for the issue to identify the suggestion.
  • Give details on how the enhancement behave.
  • Provide specific examples to demonstrate the steps.
  • Specify the name and version of the OS you're using.

Adapted from Atom contribution guide by GitHub Inc.

Pull requests

When you have done some changes and want to submit it to us, fork it to your account and submit a GitHub pull request. Please write a detailed description for your pull request on:

  • What changes have you made?
  • What problem have you solved?
  • Which issue have you addressed if applicable.

Always write a clear log message for your commits. One-line messages are fine for small changes, but bigger changes needs a detailed description after the one-liner.

Adapted from OpenGovernment contribution guide by Participatory Politics Foundation