Skip to content

Latest commit

 

History

History
70 lines (49 loc) · 3.98 KB

CONTRIBUTING.md

File metadata and controls

70 lines (49 loc) · 3.98 KB
Raw

Contributing to this project

First off, thanks for taking the time to contribute! You are awesome! 🎉👏

Table Of Contents

How to contribute

Reporting Bugs

Before creating bug reports, please make sure there isn't already an existing issue describing your problem, for bugs are tracked as GitHub issues. Simply create an issue and provide the necessary information by filling in the bug-report template.

Suggesting Enhancements

Enhancement suggestions are also tracked as GitHub issues. Before creating enhancement suggestions, please check the existing issues as you might find out that you don't need to create one. When you are creating an enhancement suggestion, please include as many details as possible. Fill in the feature-request template, including the steps that you imagine you would take if the feature you're requesting existed.

Provide Code via Pull Requests

Simply fill in the required template. Please do not include issue numbers in the PR title, but mention it in the PR body.

Git Commit Messages

  • Use the present tense ("Add feature" not "Added feature")
  • Use the imperative mood ("Move cursor to..." not "Moves cursor to...")
  • Limit the first line to 72 characters or less
  • Start your commit messages with one of the following emojis:
    • ➕ :heavy_plus_sign: when adding a file or implementing a feature
    • 🔨 :hammer: when fixing a bug or issue
    • 💚 :green_heart: when improving code or comments
    • ⚡ :zap: when improving performance
    • 📜 :scroll: when updating docs or readme
    • 🔑 :key: when dealing with security
    • 🔁 :repeat: when updating dependencies or data
    • ✅ :white_check_mark: when releasing a new version
    • 👕 :shirt: when refactoring or removing linter warnings
    • ❌ :x: when removing code or files

Providing Translations

You can add a new translation or improve an existing one by taking the following steps:

  1. Go to Localazy
  2. Click Sign in (upper right)
  3. Choose Sign in with Github (or another method you prefer)
  4. Click Authorize Localazy
  5. Open the ThirdStats project
  6. Choose a language and start translating. As this project is public, you don't need any authentification, just start to translate ThridStats. You'll be made a trusted translator later.

If you run into any problems, leave a comment on the corresponding issue #343 or start a discussion thread.

Beta-Testing

Testing and reporting bugs is a great way to help! Here's how:

  1. Download the latest nightly build from the ThirdStats CDN (XPI file)
  2. Start Thunderbird and install the XPI file by going to Settings > Add-ons and Themes > Extensions > Gear Button > Install Add-on from file > Choose the downloaded XPI file
  3. Now start using ThirdStats and check if...
    • ThirdStats logo appears in the menu and the popup shows all active accounts
    • add-on options page displays properly, alle options can be changed, options can be reset
    • stats page display properly, data is shown correctly, processing works, all filter work as expected

If you run into any problems, leave a comment on the corresponding issue #370 or start a discussion thread.

Thanks a lot for your support 💚