From f217839362e88be9b32117e82537abcdd51709c8 Mon Sep 17 00:00:00 2001 From: mikeller Date: Sun, 8 Mar 2020 14:27:25 +1300 Subject: [PATCH] Updated more documentation to match the template. --- .github/issue_template.md | 12 +++++++----- .github/pull_request_template.md | 4 ++-- CONTRIBUTING.md | 2 +- LICENSE | 8 ++++---- 4 files changed, 14 insertions(+), 12 deletions(-) diff --git a/.github/issue_template.md b/.github/issue_template.md index b2c6264b5..6a35e4609 100644 --- a/.github/issue_template.md +++ b/.github/issue_template.md @@ -1,11 +1,13 @@ # If your issue looks like a hardware fault or a configuration problem please don't raise an issue here. -## Please consider using other user support options such as asking the manufacturer of the hardware you are using, RCGroups: https://rcgroups.com/forums/showthread.php?t=2464844, or Slack (registration at https://slack.betaflight.com/) or other user support forums & groups (e.g. facebook). +## Please consider using other user support options such as asking the manufacturer of the hardware you are using, RCGroups: https://rcgroups.com/forums/showthread.php?t=2464844, or Slack (registration at https://slack.betaflight.com/) or other user support forums & groups (e.g. Facebook). ## If you believe there is an issue with the firmware itself please follow these steps: 1. Describe your problem; 2. Include ways to reproduce the problem; -3. Provide information about your flightcontroller and other components including how they are connected/wired; -4. Add the used configuration and firmware version; -5. Create a `diff` and post it here in a code block. Put ``` (three backticks) at the start and end of the `diff` block (instructions on how to do a diff: https://oscarliang.com/use-diff-not-dump-betaflight/); and -6. Remove this Text :). +3. Provide as much information as possible about your hardware and software, including: +- what hardware / software you are using; +- the version of all the software used; +- how things are connected / wired up. +4. Create a `diff` and post it here in a code block. Put ``` (three backticks) at the start and end of the `diff` block (instructions on how to do a diff: https://oscarliang.com/use-diff-not-dump-betaflight/); +5. Remove this Text :). diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md index 48849c206..cfcf39bd3 100644 --- a/.github/pull_request_template.md +++ b/.github/pull_request_template.md @@ -17,7 +17,7 @@ In order to be prepared for this move, the following new requirements for pull r ## Important considerations when opening a pull request: -1. Make sure you do not make the changes you want open a pull request on the `master` branch of your fork, or open the pull request from the `master` branch of your fork. Some of our integrations will fail if you do this, resulting in your pull request not being accepted. If this is your first pull request, it is probably a good idea to first read up on how opening pull requests work (https://opensource.com/article/19/7/create-pull-request-github is a good introduction); +1. Make sure you do not make the changes you want to open a pull request for on the `master` branch of your fork, or open the pull request from the `master` branch of your fork. Some of our integrations will fail if you do this, resulting in your pull request not being accepted. If this is your first pull request, it is probably a good idea to first read up on how opening pull requests work (https://opensource.com/article/19/7/create-pull-request-github is a good introduction); 2. Pull requests will only be accepted if they are opened against the `master` branch of our repository. Pull requests opened against other branches without prior consent from the maintainers will be closed; @@ -29,7 +29,7 @@ In order to be prepared for this move, the following new requirements for pull r 6. All pull requests are reviewed. Be ready to receive constructive criticism, and to learn and improve your coding style. Also, be ready to clarify anything that isn't already sufficiently explained in the code and text of the pull request, and to defend your ideas. -7. We use continuous integration (CI) with [Travis](https://travis-ci.com/betaflight) to build build all targets and run the test suite for every pull request. Pull requests that fail any of the builds or fail tests will most likely not be reviewed before they are fixed to build successfully and pass the tests. In order to get a quick idea if there are things that need fixing **before** opening a pull request or pushing an update into an existing pull request, run `make pre-push` to run a representative subset of the CI build. _Note: This is not an exhaustive test(which will take hours to run on any desktop type system), so even if this passes the CI build might still fail._ +7. We use continuous integration (CI) with [Travis](https://travis-ci.com/betaflight) to build all targets and run the test suite for every pull request. Pull requests that fail any of the builds or fail tests will most likely not be reviewed before they are fixed to build successfully and pass the tests. In order to get a quick idea if there are things that need fixing **before** opening a pull request or pushing an update into an existing pull request, run `make pre-push` to run a representative subset of the CI build. _Note: This is not an exhaustive test(which will take hours to run on any desktop type system), so even if this passes the CI build might still fail._ 8. If your pull request is a fix for one or more issues that are open in GitHub, add a comment to your pull request, and add the issue numbers of the issues that are fixed in the form `Fixes #`. This will cause the issues to be closed when the pull request is merged; diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 42abcacd4..bad6bbd9a 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -10,4 +10,4 @@ Please search for existing issues *before* creating new ones. # Developers -Please refer to the development section in the `docs/development` folder. +Please refer to the development section in the [this folder](https://github.com/betaflight/betaflight/tree/master/docs/development). diff --git a/LICENSE b/LICENSE index 94a9ed024..f288702d2 100644 --- a/LICENSE +++ b/LICENSE @@ -1,7 +1,7 @@ GNU GENERAL PUBLIC LICENSE Version 3, 29 June 2007 - Copyright (C) 2007 Free Software Foundation, Inc. + Copyright (C) 2007 Free Software Foundation, Inc. Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. @@ -645,7 +645,7 @@ the "copyright" line and a pointer to where the full notice is found. GNU General Public License for more details. You should have received a copy of the GNU General Public License - along with this program. If not, see . + along with this program. If not, see . Also add information on how to contact you by electronic and paper mail. @@ -664,11 +664,11 @@ might be different; for a GUI interface, you would use an "about box". You should also get your employer (if you work as a programmer) or school, if any, to sign a "copyright disclaimer" for the program, if necessary. For more information on this, and how to apply and follow the GNU GPL, see -. +. The GNU General Public License does not permit incorporating your program into proprietary programs. If your program is a subroutine library, you may consider it more useful to permit linking proprietary applications with the library. If this is what you want to do, use the GNU Lesser General Public License instead of this License. But first, please read -. +.