Skip to content

Commit b9a2829

Browse files
Merge pull request #35 from EatSleepProgramRepeat/34-write-a-contributingmd-file
wrote CONTRIBUTING.md
2 parents ef63553 + 791accc commit b9a2829

File tree

1 file changed

+69
-1
lines changed

1 file changed

+69
-1
lines changed

CONTRIBUTING.md

Lines changed: 69 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1,69 @@
1-
# How to contribute to CDPrintable
1+
# Contributing to CDPrintable
2+
3+
Thanks for your interest in helping out with **CDPrintable**! This project aims to make it easy to generate printable CD case inserts from track listings.
4+
5+
Whether you're fixing bugs, improving the UI, or adding features—your help is welcome!
6+
7+
---
8+
9+
## 🚀 Getting Started
10+
11+
1. **Fork this repository**
12+
You’ll need your own copy of the repo to make changes.
13+
14+
2. **Clone your fork**
15+
```bash
16+
git clone https://github.com/YOUR_USERNAME/CDPrintable.git
17+
cd CDPrintable
18+
```
19+
3. **Open in your IDE**
20+
Open this project in IntelliJ IDEA or your preferred IDE. I use IntelliJ IDEA, but anything should work fine. The main entry point is `src/main/java/com.CDPrintable/main.java`.
21+
22+
## 🤝 Adding the original repo as a remote/rebasing
23+
24+
If you want to keep your fork up to date with the original repo, you can add it as a remote and rebase your changes on top of it.
25+
26+
1. Add the original repo as a remote:
27+
```bash
28+
git remote add upstream https://github.com/EatSleepProgramRepeat/CDPrintable.git
29+
```
30+
2. Fetch the latest changes from the original repo:
31+
```bash
32+
git fetch upstream
33+
```
34+
3. Merge the changes into your fork:
35+
```bash
36+
git checkout main
37+
git merge upstream/main
38+
```
39+
4. Or, rebase to update your changes:
40+
```bash
41+
git remote add upstream https://github.com/EatSleepProgramRepeat/CDPrintable.git
42+
git fetch upstream
43+
git rebase upstream/main
44+
```
45+
46+
## 🧰 Ways to Contribute
47+
48+
1. 🐞 Report/Fix Bugs
49+
- If you find a bug, please report it by opening an issue. If you can, try to fix it and submit a pull request.
50+
- If you want to fix a bug, please check the issues tab to see if it’s already been reported. If not, feel free to open a new issue.
51+
2. 🎨 Improve the UI
52+
- If you have ideas for improving the UI, please open an issue or submit a pull request.
53+
- We are planning on (possibly) switching away from Swing. Let us know if you find anything better!
54+
3. 🚀 Add Features
55+
- If you have ideas for new features, please open an issue or submit a pull request.
56+
- We are planning on adding a lot of new features, so feel free to jump in and help out!
57+
4. ✅ Solve an issue
58+
- If you want to help out, please check the issues tab to see if there are any open issues. If you find one that you want to work on, please comment on it so that others know you’re working on it.
59+
- I like to make many detailed issues, so feel free to pick any of them!
60+
61+
## 📝 A Few Notes
62+
63+
- When you make a pull request, please reference the issue you’re working on in the description.
64+
- Please make sure your code is well-documented and follows the existing style of the project.
65+
- For more information, check out [Coding Conventions](https://github.com/EatSleepProgramRepeat/CDPrintable/wiki/Coding-Conventions).
66+
67+
# ❤️ Thank You!
68+
69+
We really appreciate anything you can do for this project. Thank you for your help on **CDPrintable**! You're making the world a better place by helping small open-source projects like this one.

0 commit comments

Comments
 (0)