|
| 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