2024-01-11 21:52:52 +03:00
# Contributing to GitButler
So you're interested in contributing to GitButler. Amazing!
## Understand the License
First thing to know, GitButler is not a side project, it is the product of a
2024-02-17 05:31:05 +03:00
pretty cool company located in Berlin who develop this client and its
2024-01-11 21:52:52 +03:00
associated services professionally. For this reason, we have licensed this
software under the [Functional Source License ](https://fsl.software/ ), a
mostly permissive non-compete license that converts to Apache 2.0 or MIT after
two years.
So, it's not strictly OSS, but it _will_ be. You're free to contribute,
but you can't take this and use it to compete with us. You can, however,
otherwise use it however you want.
We figured this is better than closed source while still letting us make a
living from our hard work without worrying too much about bad actors.
## Our Development Process
As a private company, we have our own development processes that we try to be
fairly open about, but we're all sitting in a room in Berlin, so external
contributions and remote work aren't really a central part of our process.
2024-02-17 05:31:05 +03:00
It's possible that you want to see a feature, and we disagree, so if you want
to get something accepted, please discuss it with us first, so we can all be
2024-01-11 21:52:52 +03:00
fairly confident that your work has a chance to be accepted before you spend
your time or result in needing to maintain a fork.
The two places to communicate with us are on Discord and GitHub (issues and
2024-02-17 05:31:05 +03:00
discussions, etc.).
2024-01-11 21:52:52 +03:00
Join our Discord here: https://discord.gg/MmFkmaJ42D
## Submitting a Bug Report
You probably know how to submit a bug report.
You know, check first to see if something is already there, give us detail to
recreate it if at all possible. Things you would want you to do if you were
maintaining this project.
## Submitting a Change
2024-02-17 05:31:05 +03:00
If you talked it over with us, and we agree that it's something we would take,
2024-01-11 21:52:52 +03:00
please do the familiar GitHub dance of forking the repository and submitting
2024-02-17 05:31:05 +03:00
a Pull Request, so we can review and possibly merge it.
2024-01-11 21:52:52 +03:00
Any contributions sent to us implicitly give us the right to redistribute that
work under the same license and rights.
2024-02-17 05:31:05 +03:00
[Why we don't explicitly require a CLA for contributions to GitButler ](https://ben.balter.com/2018/01/02/why-you-probably-shouldnt-add-a-cla-to-your-open-source-project/ )
2024-01-11 21:52:52 +03:00
## How will GitButler Stay in Business?
The client is open source and free to use, forever. If you want to use this
as your Git client, it will never be pulled out from under you.
In parallel with this client, we're also developing some rad cloud services
2024-02-17 05:31:05 +03:00
that you can optionally enable but are not necessary or limiting to your
2024-01-11 21:52:52 +03:00
client experience. If we can provide some compelling team functionality that
you can get your boss to pay for, then we would love to have your business
in that area. If it's not interesting to you, then never fear, the client is
2024-02-17 05:31:05 +03:00
fully functional on its own and totally free.
2024-01-11 21:52:52 +03:00
## Kudos
We _love_ our community. Whether you just join Discord to give us some feedback,
file a well researched issue, or submit a killer PR, we are excited that you
care about what we're doing.
However, helping us with our codebase is over the top. We'll call out our
contributors in some way, though we haven't quite figured out how yet. But
2024-02-17 05:31:05 +03:00
rest assured, we'll give you credit. Or schwag, maybe. Or a beer, if you're
2024-01-11 21:52:52 +03:00
ever in town.
## Get into the Code!
Ok, you're officially onboarded. Grab the code and start in on the
[DEVELOPMENT.md ](DEVELOPMENT.md ) file.
God speed.