Contributing to Odin
First off, thank you for considering contributing to our Minecraft mod! We appreciate your time and effort in helping us improve and expand the project.
If you find a bug in the mod, please report it by creating a new post in our Discord. Please include:
- A clear and descriptive title.
- A detailed description of the issue.
- Steps to reproduce the issue.
- Any relevant screenshots or logs.
If you have an idea for a new feature or an enhancement to an existing feature, we'd love to hear about it! Please open a new post in our Discord and include:
- A clear and descriptive title.
- A detailed description of the proposed feature.
- Any potential use cases or benefits.
We welcome contributions from everyone. Here are the steps to get started:
-
Navigate to the Repository: Go to the GitHub page of the repository you want to contribute to.
-
Fork the Repository: Click the Fork button at the top right of the repository page. This creates a copy of the repository under your GitHub account.
-
Clone the Repository: On your GitHub page, navigate to the forked repository and click the "Code" button. Copy the URL provided.
-
Run Git Clone Command: Open your terminal and run:
git clone https://github.com/YOUR_USERNAME/REPOSITORY_NAME.git
Replace
YOUR_USERNAME
with your GitHub username andREPOSITORY_NAME
with the name of the repository. -
Navigate to the Project Directory:
cd REPOSITORY_NAME
- Create a New Branch:
Use a descriptive name for your branch, such as
git checkout -b your-branch-name
feature/update-readme
orbugfix/fix-typo
.
-
Make Necessary Changes: Edit the files in your favorite text editor or IDE.
-
Stage Your Changes:
git add .
-
Commit Your Changes:
git commit -m "A brief description of your changes"
- Push Your Branch to GitHub:
git push origin your-branch-name
-
Navigate to the Odin Repository: Go to the Odin repository where you want to contribute.
-
Open Pull Requests Tab: Click on the "Pull Requests" tab, then click the "New Pull Request" button.
-
Select Your Branch: Choose the branch you made changes to from your forked repository.
-
Create the Pull Request: Add a title and description for your pull request, explaining what changes you made and why. Then click the "Create Pull Request" button.
-
Monitor Your Pull Request: Reviewers may provide feedback or request changes. Be sure to respond and make any necessary updates.
-
Push Additional Changes: If you need to make additional changes, commit them to your branch and push them. The pull request will automatically update with your new commits.
git add .
git commit -m "Address review feedback"
git push origin your-branch-name
Congratulations! You’ve successfully forked a repository, made changes, and created a pull request. This is the typical workflow for contributing to open-source projects on GitHub. Happy coding!