Skip to content


docs(CONTRIBUTING): improved contributing guide
Browse files Browse the repository at this point in the history
  • Loading branch information
ErikBjare committed Feb 24, 2021
1 parent 3343130 commit 9277301
Showing 1 changed file with 55 additions and 23 deletions.
78 changes: 55 additions & 23 deletions
Original file line number Diff line number Diff line change
@@ -1,12 +1,20 @@
How to Contribute

**Did you come here to read what you should do before creating an issue?** Scroll down!
<!-- This guide could be improved by following the advice at -->

**Note:** This is a work in progress, there is a lot we could do better so file a PR if you think we've missed something!
**Table of Contents**

- [Getting started](#getting-started)
- [How you can help](#how-you-can-help)
- [Filing an issue](#filing-an-issue)
- [Getting paid](#getting-paid)
- [Code of Conduct](#code-of-conduct)
- [Commit message guidelines](#commit-message-guidelines)
- [Questions?](#questions)

## Getting started with development

## Getting started

To develop on ActivityWatch you'll first want to install from source. To do so, follow [the guide in the documentation](

Expand All @@ -19,34 +27,50 @@ If you want some code examples for how to write watchers or other types of clien

There are many ways to contribute to ActivityWatch:

- Help with testing by being an early user and reporting bugs.
- Help with one of the issues labeled [`help wanted`](, these are especially suited for new contributors.
- Help write documentation.
- Help build the ecosystem.
- Work on issues labeled [`good first issue`][good first issue] or [`help wanted`][help wanted], these are especially suited for new contributors.
- Fix [`bugs`][bugs].
- Implement new features.
- Look among the [requested features][requested features] on the forum.
- Talk to us in the issues or on [our Discord server][discord] to get help on how to proceed.
- Write documentation.
- Build the ecosystem.
- Examples: New watchers, tools to analyze data, tools to import data from other sources, etc.
- Help fix bugs.
- See the issues in this repo.
- Help implement new features.
- Want to start working on a new feature? Find the appropriate subrepo, if any, and see if there is anything that needs doing.

Most of the above will get you up on our [contributor stats page]( as thanks!
If you're interested in what's next for ActivityWatch, have a look at our [roadmap][roadmap] and [milestones][milestones].

Most of the above will get you up on our [contributor stats page][contributors] as thanks!

[good first issue]:
[help wanted]:
[requested features]:

## Filing an issue

Thanks for wanting to help out with squashing bugs and more by filing an issue.

There are a few things you might consider when filing your issue:
When filing an issue, it's important to use an [issue template]( This ensures that we have the information we need to understand the issue, so we don't have to ask for tons of follow-up questions, so we can fix the issue faster!

## Getting paid

We're experimenting with paying our contributors using funds we've raised from donations and grants.

The idea is you track your work with ActivityWatch (and ensure it gets categorized correctly), then you modify the []( script to use your category rule and generate a report of time worked per day and the matching events.

If you've contributed to ActivityWatch (for a minimum of 10h) and want to get paid for your time, contact us!

You can read more about this experiment on [the forum]( and in [the issues](

## Code of Conduct

We have a Code of Conduct that we expect all contributors to follow, you can find it in [``](./

- Which version of ActivityWatch are you running?
- NOTE: There is currently no good way to find this out, sorry about that.
- What made the issue/bug appear? (steps to reproduce)
- Include a logfile
- Log files can be found in different places, depending on platform:
- macOS: `~/Library/Logs/activitywatch`
- Linux: `~/.cache/activitywatch/log`
- Windows: `C:\Users\<USERNAME>\AppData\Local\activitywatch\activitywatch\Logs`

## Commit message guidelines

Expand Down Expand Up @@ -77,4 +101,12 @@ This guideline was adopted in [issue #391](

## Questions?

If you have any questions, post on [the forum]( or email one of the maintainers at: [](
If you have any questions, you can:

- Talk to us on our [Discord server][discord]
- Post on [the forum][forum] or [GitHub Discussions][github discussions].
- (as a last resort/if needed) Email one of the maintainers at: [](

[github discussions]:

0 comments on commit 9277301

Please sign in to comment.