Skip to content

Contributing

Eric Crooks edited this page Oct 24, 2021 · 3 revisions

Contributors are always welcomed!

Before contributing, please familiarize yourself with the Rules that Drash Land follows.

Commit Messages

We follow https://www.conventionalcommits.org/.

Reporting Bugs

A bug is a demonstrable problem that is caused by the code. Good bug reports are extremely helpful, so thank you!

Requesting New Features

We welcome all feature requests, but please take a moment to determine whether or not your idea fits with the scope and aims of the project. It is up to you to convince the maintainers of the merits of your feature request. Please provide as much detail and context as possible. Also, provide a use case for the feature. Providing a use case is required.

Creating a Pull Request

Please ask first before embarking on any significant pull request (e.g., implementing features, refactoring code, etc.). Otherwise, you risk spending a lot of time working on something that the maintainers might not want to merge.

Please make sure your pull request addresses the issue at hand without extra code bloat. Do not create a pull request with a complex solution to a simple problem.

  1. Fork the project you want to work on.
  2. Clone your fork.
    git clone https://github.com/<your-username>/<repo-name>.git
  3. Go into your newly cloned directory.
    cd repo-name
  4. Configure your remotes.
    # Assign the original repo to a remote called "upstream"
    git remote add upstream https://github.com/drashland/<repo-name>.git
  5. If you cloned a while ago, get the latest changes from upstream:
    git checkout master
    git pull upstream master
  6. Create a new branch (off of the master branch) to contain your additions, modifications, and/or deletions:
    git checkout -b <<issue-number>-branch-name>
  7. Push your branch up to your fork:
    git push origin <<issue-number>-branch-name>
  8. Ensure you have met all of the Rules listed in this document.
  9. Open a Pull Request with a clear title and description against the master branch and follow the instructions in the pull request template.

Code Style Guidelines

Code should follow Deno Style Guide with a few exceptions:

  • Copyright headers are not required.
  • Do not use Deno.test() when testing. Use Rhum. Rhum should already be in all Drash Land projects (with the exception of dmm -- dmm should not use Rhum).

License

By submitting a your code to the Drash Land organization, you agree to allow the maintainers to license your work under the terms of the MIT License.

Clone this wiki locally