Your help is greatly appreciated! This project, as all other open-source projects, thrives through an active community. But: With great power comes great responsibility. So we have devised a few ground rules that should be followed when contributing.
How can you contribute?
There are a couple of ways you can help us out.
- Issues: The easiest way to contribute is to identify that something is broken or that a feature is missing and create an issue from it. Even better would be fixing an open issue that has no assignee yet. You can of course do both - find something that is missing and fix it yourself!
- Reviews: With more contributions coming in we will likely see more pull requests. Reviewing them is not always the most fun, but it is very necessary and would help a lot.
Opening issues is very easy. Head to our Issues tab and open one if it does not exist already. If an issue exists that might have something to do with yours, e.g. is the basis for something your are requesting, please link this issue to yours.
Bugs, errors and catastrophies
If you encounter an error during a lab setup, there are some basic details we need to be able to help you.
- The script you used. Feel free to strip out any incriminating details, but it must be able to be executed
- The verbose and error output of the script! Either set
$VerbosePreference = 'Continue'or use the verbose switch for Install-Lab.
Fixing an issue
Fixing issues also does not require a lot of administrative work. The basic steps are:
- Leave a comment to tell us that you are working on it
- Fork our repository, and base your changes off of the 'develop' branch. Please create a new branch from develop which contains your changes. How you call it? We don't care.
- Fix the issue! No biggie...
- Make sure you have pushed your commits to your new branch and then create a pull request
- Sit back and wait for us to take credit for your code - just kidding. All the fame and glory is yours.
We are using GitHub's internal capabilites for our code reviews. Either we, the AutomatedLab team, or you, the community, can review the changes and add comments. The author of the pull request can then go through all issues, fix them and add commits to his branch, which will show up in the pull request. When all issues are fixed and there is nothing else to do, we will gladly merge your pull request.