From ca66659f75e4b33a8c97fb3841aac81efb32b1ac Mon Sep 17 00:00:00 2001 From: Mark Szymanski Date: Sat, 21 Jan 2017 22:43:56 -0600 Subject: [PATCH] Minor documentation updates --- .github/issue_template.md | 16 ++++++++++------ .github/pull_request_template.md | 6 +++--- 2 files changed, 13 insertions(+), 9 deletions(-) diff --git a/.github/issue_template.md b/.github/issue_template.md index df69b50722..8155eeb14f 100644 --- a/.github/issue_template.md +++ b/.github/issue_template.md @@ -3,24 +3,28 @@ ### Actual behaviour -Tell us what happens instead +Tell us what happens ### Expected behaviour -Tell us what should happen +Tell us what should actually happen ### Steps to reproduce -1. Please, describe _exactly_ how to reproduce the issue -2. -3. +Please supply step-by-step instructions so that anyone with the same environment can reproduce the issue. Whenever you offer a description, imagine +yourself in the shoes of someone who has never encountered this problem before and would like to know exactly how to observe it under a given set of conditions. +Here is an example: + +1. Log in to the application as the administrative user +2. Click on button X, then on the modal dialog that appears, click Y +3. Wait for 3 seconds, and note the appearance of an unexpected message ### Configuration -Copy and paste the configuration section from the Kanboard settings page or fill these fields: +Copy and paste the configuration section from the Kanboard settings page or supply values for these fields: - Kanboard version: - Database type and version: diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md index be59deacc9..9756a6e7e5 100644 --- a/.github/pull_request_template.md +++ b/.github/pull_request_template.md @@ -1,8 +1,8 @@ Before to submit your pull-request: - Be sure that the unit tests pass -- If you create a new feature, test your code, do not introduce new bugs +- If you create a new feature, test your code, and do not introduce new bugs - Avoid code duplication -- Small pull-requests are easier to review and can be merged quickly +- Remember, small pull-requests are easier to review and can be merged quickly - 1 pull-request == 1 feature/improvement -- Non necessary features should be implemented as plugin +- Nonessential features should be implemented as plugin