Skip to content

Commit

Permalink
feat: improve contribution documentation (#37)
Browse files Browse the repository at this point in the history
  • Loading branch information
TommoLeedsy authored Jan 2, 2024
1 parent be4eb16 commit 4343de4
Show file tree
Hide file tree
Showing 2 changed files with 89 additions and 0 deletions.
33 changes: 33 additions & 0 deletions .github/PULL_REQUEST_TEMPLATE/pull_request_template.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
## Pull Request

### Description

[Provide a concise description of the changes introduced by this pull request.]

### Related Issue

[If your pull request is related to any issue(s), mention them here.]

### Changes Made

[List the specific changes made in this pull request.]

### Testing Done

[Describe the testing that you have done to validate your changes. Include details on the test environment and any test cases performed.]

### Checklist

- [ ] I have read and followed the project's [contribution guidelines](../../CONTRIBUTING.md).
- [ ] My code follows the project's coding standards.
- [ ] I have added relevant documentation or updated existing documentation.
- [ ] I have tested my changes and ensured they do not introduce new issues.
- [ ] I have added test cases to cover my changes.

### Reviewer Guidance

[Provide any specific guidance or instructions for reviewers.]

### Additional Notes

[Any additional information or context that might be helpful for the reviewers.]
56 changes: 56 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,56 @@
# Contribution Guidelines

## Prerequisites

### Finding an issue to work on

If you are looking for an issue to work on, you can check the [issues](https://github.com/LS6-Events/astra/issues) page. If you find an issue you would like to work on, you can assign yourself to it by commenting on the issue and the maintainers will assign it to you.
If you have an idea for a new feature, you can start by [opening an issue](https://github.com/LS6-Events/astra/issues/new) and describe the feature you would like to implement, this will then be review by a maintainer and if approved you can begin your work and create a pull request.

### Setup your environment locally

_Some commands will assume you have the Github CLI installed, if you haven't, consider [installing it](https://github.com/cli/cli#installation), but you can always use the Web UI if you prefer that instead._

In order to contribute to this project, you will need to fork the repository:

```bash
gh repo fork LS6-Events/astra
```

then, clone it to your local machine:

```bash
gh repo clone <your-github-name>/astra
```

## How to Contribute

### Create a feature branch

```bash
git checkout -b <feat/fix/chore/docs>/<issue-number><short-description>
```

### Implement your changes

When making commits, make sure to follow the [conventional commit](https://www.conventionalcommits.org/en/v1.0.0/) guidelines, i.e. prepending the message with `feat:`, `fix:`, `chore:`, `docs:`, etc... You can use `git status` to double check which files have not yet been staged for commit:

```bash
git add <file(s)> && git commit -m "feat/fix/chore/docs: commit message"
```

### Push your changes

```bash
git push origin <branch-name>
```

### Create a pull request

Once you have pushed your changes, you can create a pull request by running:

```bash
gh pr create --base main --head <branch-name>
```

**NOTE**: All pull requests should target the `main` branch.

0 comments on commit 4343de4

Please sign in to comment.