-
Notifications
You must be signed in to change notification settings - Fork 1
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
docs: add info about decision to use github
- Loading branch information
1 parent
da74661
commit 65300a2
Showing
3 changed files
with
50 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,47 @@ | ||
# Use Github as both our code repository & CI/CD | ||
|
||
## Context and Problem Statement | ||
|
||
We need somewhere to | ||
|
||
- Store our code to work on it collaboratively. | ||
- Raise issues and manage documentation around the code. | ||
- Track development via roadmaps and task trackers. | ||
|
||
We also need a pipeline runner (CI/CD): | ||
|
||
- Create build artifacts for deployment. | ||
- Run automated testing. | ||
- Deploy our code into various development environments. | ||
|
||
## Considered Options | ||
|
||
- Github | ||
- Gitlab | ||
- Codeberg | ||
- Bitbucket | ||
|
||
## Decision Outcome | ||
|
||
Github was originally chosen as it provided many benefits for free, over the | ||
competition. | ||
|
||
Cost and simplicity are key factors for us, being a small NGO that receives | ||
project specific funding. | ||
|
||
Since the decision was taken, Github was acquired by Microsoft and has | ||
some practices that we do not agree with (license violations for Copilot, | ||
amongst others). | ||
|
||
Reluctantly, we are stuck with Github due to the migration effort that would | ||
be required. | ||
|
||
### Consequences | ||
|
||
- Good, because free to use, including uncapped CI/CD usage as an NGO. | ||
- Good, has the most visibility and reach of all other platforms. | ||
- Bad, because as an organization it undertakes many practices we do not agree with. | ||
- Bad, the more we use Github workflows (propriatary), the further we are | ||
vendor-locked. | ||
- Bad, because it would be difficult to migrate all of the accumulated issues, | ||
milestones, project boards, subissues, etc. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1 @@ | ||
# Use Slack to engage with our community members |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters