Skip to content

Latest commit

 

History

History
50 lines (36 loc) · 3.5 KB

CONTRIBUTING.md

File metadata and controls

50 lines (36 loc) · 3.5 KB

Contribution Guide

This document describes some points about the contribution process for mcHF firmware and bootloader.

The maintainer of this GitHub is DF8OE.

The project is free for non-commercial use and is being developed within an open community. Maintainer merges pull-requests, fixes critical bugs and manages releases. Participation is appreciated.

Getting Started

Head over to the Wiki to get instructions for setting up your build environment

Git is easy once you know how to operate it. Until then these documents are good reads:

  • Atlassian Tutorial on git - Very nice, not too complex. Does not cover github specifics.
  • The Git Book - Lots of details, has special github section. Not always as beginner-friendly as Atlassian
  • Ask us: There is the M0NKA Yahoo Group, the german language mcHF board . And if nothing of this works for you and you have made the smartest improvment but can't share it: use the issue tracker to post a request for help.

Pull-requests

If you fixed or added something useful to the project, you can send pull-request. It will be reviewed by coders and/or maintainer and accepted, or commented for rework, or declined.

We love pull requests. Here's a quick guide:

  • Make sure you have a GitHub account and read more about pull requests
  • Fork it in GitHub
  • Clone it locally to your PC (github clone ...)
  • Add the main repository as "main" (git remote add main https://github.com/df8oe/mchf-github.git)
  • Checkout the branch you want to modify (git checkout devel-DF8OE)
  • Create your feature branch (git branch my-new-feature)
  • Commit your changes and provide good explaination in the commit message (git commit -m)
  • If it took a while to complete the changes, consider rebasing (git fetch main; git rebase main/devel-DF8OE) before pushing
  • Push the branch to your GitHub repository (git push)
  • It is strongly recommended that you do an operational test using a mcHF before you start a pull request.
  • Create new pull request at http://www.github.com/df8oe/mchf-github . Make sure to select the right branch (devel-DF8OE) as target.

Bugs

If you found an error, mistype or any other flawback in the project, please report about it using Issues. The more details you provide, the easier it can be reproduced and the faster it can be fixed.

Features

It you've got an idea about a new feature, it's most likely that you have do implement it on your own. If you cannot implement the feature, but it is very important, you can add a task in issues and tag it with "REQUEST:". Feature requests are discussed and may be realized shortly, later or never - there is no guarantee that requests will be accepted.

WIKI

To keep slowly changing documents up-2-date it will be great if you help to set up such documents in the WIKI area. They are quick-&-easy access to newcomers and will pleasure building and reduce questions which repeat frequently. The following documents can be accessed in the WIKI area:

  • Operating manual
  • Adjustment and configuration manual
  • Modification list
  • Guides for setup of firmware development software
  • Technical specifications