Skip to content

Commit cc19342

Browse files
authored
Create CONTRIBUTING.md
1 parent 5f931ad commit cc19342

1 file changed

Lines changed: 64 additions & 0 deletions

File tree

CONTRIBUTING.md

Lines changed: 64 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,64 @@
1+
# How to contribute
2+
3+
Community contributions are essential part of any open source project. The community has access to a large number of unique configurations which would be extremely difficult for the core maintainers to reproduce. We want to keep it as easy as possible to contribute changes that get things working in your environment. There are a few guidelines that we need contributors to follow so that we can have a chance of keeping on top of things.
4+
5+
Make sure you have a [GitHub account](https://github.com/signup/free) to start with.
6+
7+
## Level 1 contributions: easy ways to contribute
8+
There are several ways to contribute, depending on your background, level of expertise and willingness to spend some time. Everybody should be able to contribute on a minimal level:
9+
* Create or document issues
10+
* Create or improve documentation
11+
* Be a tester
12+
13+
### Create issues
14+
Anybody with a GutHub account can create new issues. Please verify that a simlar issue has not been created before. Clearly describe the issue you encounter.
15+
16+
### Create or improve documentation
17+
Create an issue with suggestions for document improvements. If you have an idea about the new documenation, add that text (prefereably in markdown format) in the issue as proposed new or improved documentation.
18+
19+
### Be a tester
20+
Download an install version of the extension and test it in your own environment. If you are reviewing issues, try to reproduce issues that have been created and enhance documentation of the issue to reproduce any bugs.
21+
22+
If there is a new version of an extension, be one of the first to test that new version on a fresh install and as an upgrade of a previous version. Report your findings as issues.
23+
24+
# Level 2 contributions: Provide improved or new code
25+
If you are commited as community member and have programming skills, there is more that you can do:
26+
* Create code fixes
27+
* Create new functionality
28+
29+
We asume that you have some basic Git(Hub) knowledge and know how to work with fork, clone, create issue, commit, push, pull requests
30+
31+
## Get started with code contributions
32+
33+
### Fork the repository on GitHub
34+
If this is your first time working with the repository, you will need to fork the repository to get your system configured for local development.
35+
36+
If you are new to Dnn Development, you can start by watching this video playlist which explains how to setup the required tools, your development environment and submit pull requests for modules, the Platform and the Persona Bar.
37+
[How to make a pull requests playlist](https://www.youtube.com/playlist?list=PLIx1M8IdVvqZ0bnODGqJyxvONNPj5BzMP)
38+
39+
* Click fork on the project. You will get a fork of the repository in your own GitHub account
40+
* Clone your fork locally with `git clone
41+
* Add the *upstream connection* to the original repository, so you can rebase and update your fork with `git remote add upstream` to the base (the original) repository
42+
* To update your fork to the latest, you can then run `git fetch upstream` followed by `git push`
43+
44+
## Making Changes
45+
* Create a topic branch from where you want to base your work. This is usually a branch linked to the *issue #* your are trying to solve
46+
* Make commits of logical units
47+
* When ready to publish your changes, you can with `git push -u origin my_contribution`
48+
* Make sure your pull request description tags the GitHub issue ID, so it is clear what issue you have fixed
49+
* Make sure your commit messages are in the proper format
50+
51+
## Submitting changes
52+
* Push your changes to a topic branch in your fork of the repository
53+
* Submit a pull request to the original (upstream( repository
54+
* The committers will handle updating the associated issue in the DNN Tracker to ensure it gets the necessary code review and QA
55+
56+
## Acceptance of your changes
57+
* We have a group of fellow developers that review pull requests submitted by developers like yourself
58+
* If your changes look good, then changes are merged to an appropriate release
59+
* You should get an email notification as we complete processing of your pull request
60+
61+
# Level 3 contributions: Become a repository custodian
62+
If you are really commited, want to work with highly commited team members (like yourself?) and want to contibute by taking care of one or more repositories, you might want to become a *repository custodian*.
63+
64+
Contact one of the team members of the organisation and discuss the opportunities.

0 commit comments

Comments
 (0)