generated from nhcarrigan/template
Compare commits
2 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
| f58a9d62c5 | |||
| 73beb11b3b |
@@ -24,8 +24,8 @@ In case of any discrepancy between this document and project-specific guidelines
|
||||
|
||||
All commits must be cryptographically signed using either GPG or SSH. This requirement serves to verify the authenticity and integrity of your contributions.
|
||||
|
||||
- For GPG signing, ensure your GPG key is associated with your GitHub or Codeberg account.
|
||||
- For SSH signing, use a key linked to your GitHub or Codeberg account.
|
||||
- For GPG signing, ensure your GPG key is associated with your Github or NHCarrigan Git account.
|
||||
- For SSH signing, use a key linked to your Github or NHCarrigan Git account.
|
||||
|
||||
By signing your commit, you are certifying that:
|
||||
|
||||
@@ -95,76 +95,43 @@ To work with secrets locally, you must set up the 1Password CLI (Command Line In
|
||||
|
||||
## 3. Setting Up Your Development Environment
|
||||
|
||||
### 3.1 Forking the Repository
|
||||
### 3.1 Gaining a contributor account
|
||||
|
||||
1. Navigate to the original repository on Codeberg.
|
||||
2. Click the "Fork" button in the upper right corner of the page.
|
||||
3. Select your account as the destination for the fork.
|
||||
4. Wait for Codeberg to create a copy of the repository in your account.
|
||||
1. Navigate to our [contributor form](https://forms.nhcarrigan.com/form/c0_N5hb-VcmC2ClzaGOvDxVirMN_coiWG7eoPhDPsZ0).
|
||||
2. Fill out the web form.
|
||||
3. Wait for Naomi to approve your account.
|
||||
|
||||
### 3.2 Cloning Your Fork
|
||||
### 3.2 Cloning A Project
|
||||
|
||||
1. Go to your forked repository on Codeberg.
|
||||
2. Click the "Code" button and copy the URL (HTTPS or SSH, depending on your setup).
|
||||
1. Go to repository on NHCarrigan's Git instance.
|
||||
2. Click the "Code" button and copy the HTTPS URL.
|
||||
3. Open your terminal or command prompt.
|
||||
4. Navigate to the directory where you want to store the project.
|
||||
5. Run the following command, replacing `<url>` with the URL you copied:
|
||||
|
||||
```
|
||||
```bash
|
||||
git clone <url>
|
||||
```
|
||||
|
||||
6. Enter your GitHub credentials if prompted.
|
||||
6. Enter your Git credentials if prompted.
|
||||
|
||||
### 3.3 Setting Up the Upstream Remote
|
||||
### 3.3 Keeping Your Clone Up-to-Date
|
||||
|
||||
Adding the original repository as an upstream remote allows you to easily keep your fork up-to-date.
|
||||
Regularly update your clone to incorporate changes from the upstream repository:
|
||||
|
||||
1. Change into the project directory:
|
||||
1. Check out the main branch:
|
||||
|
||||
```
|
||||
cd <project-name>
|
||||
```
|
||||
|
||||
2. Add the upstream remote:
|
||||
|
||||
```
|
||||
git remote add upstream <original-repository-url>
|
||||
```
|
||||
|
||||
Replace `<original-repository-url>` with the **git** URL of the original repository.
|
||||
|
||||
3. Verify the new remote:
|
||||
|
||||
```
|
||||
git remote -v
|
||||
```
|
||||
|
||||
You should see entries for both `origin` (your fork) and `upstream`.
|
||||
|
||||
### 3.4 Keeping Your Fork Up-to-Date
|
||||
|
||||
Regularly update your fork to incorporate changes from the upstream repository:
|
||||
|
||||
1. Fetch the branches and commits from the upstream repository:
|
||||
|
||||
```
|
||||
git fetch upstream
|
||||
```
|
||||
|
||||
2. Check out your fork's local main branch:
|
||||
|
||||
```
|
||||
```bash
|
||||
git checkout main
|
||||
```
|
||||
|
||||
3. Merge changes from upstream/main into your local main branch:
|
||||
2. Pull changes from upstream to your local clone:
|
||||
|
||||
```
|
||||
git merge upstream/main
|
||||
```bash
|
||||
git pull
|
||||
```
|
||||
|
||||
### 3.5 Troubleshooting
|
||||
### 3.4 Troubleshooting
|
||||
|
||||
If you encounter any issues during setup:
|
||||
|
||||
@@ -172,7 +139,7 @@ If you encounter any issues during setup:
|
||||
2. Search for similar issues in the project's issue tracker.
|
||||
3. If the problem persists, open a new issue with detailed information about the problem and steps to reproduce it.
|
||||
|
||||
You can also reach out to us on our forum: https://forum.nhcarrigan.com
|
||||
You can also reach out to us on our Discord: https://chat.nhcarrigan.com/
|
||||
|
||||
## 4. Claiming an Issue
|
||||
|
||||
@@ -206,10 +173,10 @@ We encourage collaboration and pair programming on complex issues!
|
||||
|
||||
### 4.5 Working on the Issue
|
||||
|
||||
1. Once assigned, create a new branch in your fork for this specific issue.
|
||||
1. Once assigned, create a new branch in the project for this specific issue.
|
||||
2. Use a descriptive branch name, e.g., `fix/issue-123-button-alignment`.
|
||||
3. Make your changes, committing regularly with clear, concise commit messages.
|
||||
4. Push your changes to your fork.
|
||||
4. Push your changes to your branch.
|
||||
5. Open a pull request when ready for review (see Pull Request Guidelines in section [X]).
|
||||
|
||||
### 4.6 Keeping the Community Updated
|
||||
@@ -245,16 +212,16 @@ Pay attention to issue labels for additional context:
|
||||
|
||||
## 5. Working on Your Issue
|
||||
|
||||
### 5.1 Updating Your Fork
|
||||
### 5.1 Updating Your Clone
|
||||
|
||||
Before starting work, ensure your forked version is up to date with the original repository. If you've set up the `upstream` remote as mentioned in Section 3, follow these steps:
|
||||
Before starting work, ensure your clone is up to date with the original repository.
|
||||
|
||||
1. Open your terminal and navigate to your project's root directory.
|
||||
2. Run the following commands:
|
||||
|
||||
```bash
|
||||
git fetch upstream
|
||||
git merge upstream/main
|
||||
git checkout main
|
||||
git pull
|
||||
```
|
||||
|
||||
### 5.2 Creating a New Branch
|
||||
@@ -282,7 +249,7 @@ Always create a new branch for your work:
|
||||
|
||||
1. Make your code changes, following the project's coding standards and guidelines.
|
||||
2. Regularly commit your changes with clear, concise messages.
|
||||
3. Push your changes to your fork periodically:
|
||||
3. Push your changes to your branch periodically:
|
||||
|
||||
```bash
|
||||
git push origin <branchname>
|
||||
@@ -321,7 +288,7 @@ When you're ready to commit your changes:
|
||||
|
||||
Example:
|
||||
|
||||
```
|
||||
```md
|
||||
feat: add user authentication system
|
||||
|
||||
Implement JWT-based authentication for API endpoints.
|
||||
@@ -363,24 +330,24 @@ If you're unsure about any part of the process or need help, don't hesitate to a
|
||||
|
||||
### 6.1 Pushing Your Changes
|
||||
|
||||
1. Push your changes to your forked repository:
|
||||
1. Push your changes to the repository:
|
||||
|
||||
```bash
|
||||
git push -u origin <branchname>
|
||||
```
|
||||
|
||||
- `-u` sets the upstream, linking your local branch to the remote branch
|
||||
- `origin` specifies your forked repository as the destination
|
||||
- `origin` specifies the project repository as the destination
|
||||
- `<branchname>` is the name of your local branch
|
||||
|
||||
2. Ensure the push is successful and your changes appear in your forked repository on Codeberg.
|
||||
2. Ensure the push is successful and your changes appear in the repository on NHCarrigan's Git instance.
|
||||
|
||||
### 6.2 Creating the Pull Request
|
||||
|
||||
1. Navigate to your forked repository on Codeberg.
|
||||
1. Navigate to the repository on NHCarrigan's Git instance.
|
||||
2. You should see a prompt to create a pull request for your recently pushed branch. If not, click on the "Pull requests" tab and then the "New pull request" button.
|
||||
3. Ensure the base repository is the original project repository and the base branch is `main`.
|
||||
4. Select your fork as the head repository and your recently pushed branch as the compare branch.
|
||||
4. Select the project as the head repository and your recently pushed branch as the compare branch.
|
||||
|
||||
### 6.3 Filling Out the Pull Request
|
||||
|
||||
@@ -409,7 +376,7 @@ If you need to make changes to your pull request:
|
||||
|
||||
1. Make the required changes in your local branch.
|
||||
2. Commit the changes.
|
||||
3. Push the new commits to your fork:
|
||||
3. Push the new commits to your branch:
|
||||
|
||||
```bash
|
||||
git push origin <branchname>
|
||||
@@ -427,7 +394,7 @@ If you need to make changes to your pull request:
|
||||
### 6.8 Merging and Closing
|
||||
|
||||
- Once your pull request is approved, a maintainer will merge it into the main project.
|
||||
- After merging, you can delete your branch from your fork if you won't be using it anymore.
|
||||
- After merging, you can delete your branch from the repository if you won't be using it anymore.
|
||||
- Celebrate your contribution to the project!
|
||||
|
||||
## 7. Pull Request Reviews
|
||||
|
||||
Reference in New Issue
Block a user