Skip to content

Commit ee93d5b

Browse files
committed
chore: add contributing.md
1 parent ee1f173 commit ee93d5b

File tree

1 file changed

+51
-0
lines changed

1 file changed

+51
-0
lines changed

CONTRIBUTING.md

+51
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,51 @@
1+
# How to contribute to Docke Registry UI
2+
3+
I ([Jones Magloire](https://joxit.dev/)) created the Docker Registry UI from scratch, but I can't succeed without contributions from community members like you! Contributions come in many different shapes and sizes. In this file we provide guidance around two of the most common types of contributions: opening issues and opening pull requests.
4+
5+
Please read also the [Code Of Conduct](https://github.com/Joxit/docker-registry-ui/blob/main/CODE_OF_CONDUCT.md).
6+
7+
## Submitting Issues
8+
9+
### Did you find a bug?
10+
11+
* **Ensure the bug was not already reported** by searching on GitHub under [Issues](https://github.com/joxit/docker-registry-ui/issues).
12+
13+
* If you're unable to find an open issue addressing the problem, [open a new one](https://github.com/joxit/docker-registry-ui/issues/new). Be sure to
14+
* Use the [**Bug Report Template**](https://github.com/Joxit/docker-registry-ui/issues/new?assignees=&labels=&template=bug_report.md&title=)
15+
* Include a **title and clear description**
16+
* Write as much relevant information as possible
17+
* Add your **full configuration** (Docker Registry UI **AND** Docker Server) or a **screenshots** demonstrating the expected behavior that is not occurring
18+
19+
## Submitting Pull Request
20+
21+
### Do you intend to add a new feature or change an existing one?
22+
23+
* Suggest your change in a new issue using the [**Feature Request Template**](https://github.com/Joxit/docker-registry-ui/issues/new?assignees=&labels=&template=feature_request.md&title=) and start writing code.
24+
25+
* Run the interface on your computer first with `npm start`.
26+
27+
### Did you write a patch that fixes a bug?
28+
29+
* Open a new [GitHub pull request](https://github.com/Joxit/docker-registry-ui/compare) with the patch.
30+
31+
* Ensure the PR description clearly describes the problem and solution. Include the relevant issue number if applicable.
32+
33+
* Before submitting, please read the [Coding conventions](#coding-conventions) first.
34+
35+
### Did you fix whitespace, format code, or make a purely cosmetic patch?
36+
37+
Changes that are cosmetic in nature and do not add anything substantial to the stability, functionality, or testability of Docker Registry UI will generally not be accepted.
38+
39+
## Coding conventions
40+
41+
* I use prettier with custom preset, use `npm format` before any PR
42+
43+
* I use [semver](https://semver.org/) for package versioning
44+
45+
* I use Github Actions for publishing docker images and releases
46+
47+
* I indent with two spaces
48+
49+
Thank you for your help! :heart:
50+
51+
[Joxit](https://joxit.dev/)

0 commit comments

Comments
 (0)