From ec7a9e0e24ea0965bf76eb78d8f2bcf8d0d16205 Mon Sep 17 00:00:00 2001
From: Misty Stanley-Jones <misty@docker.com>
Date: Fri, 21 Oct 2016 10:42:46 -0700
Subject: [PATCH 1/2] Shorten the templates a bit

Signed-off-by: Misty Stanley-Jones <misty@docker.com>
---
 .github/ISSUE_TEMPLATE.md        | 32 +++++++---------------
 .github/PULL_REQUEST_TEMPLATE.md | 47 ++++++++++----------------------
 2 files changed, 24 insertions(+), 55 deletions(-)

diff --git a/.github/ISSUE_TEMPLATE.md b/.github/ISSUE_TEMPLATE.md
index 3d971314ec..b07ede6eff 100644
--- a/.github/ISSUE_TEMPLATE.md
+++ b/.github/ISSUE_TEMPLATE.md
@@ -1,39 +1,27 @@
 ### Problem description
 
-<!-- Provide a brief description of the problem with
-the documentation.
-
-If this is an issue with Docker itself, rather than
-the Docker documentation, this may not be the right
-place to file the issue. Consider filing it in the
-specific project's repository or asking a question
-on forums.docker.com.
-
-You can delete these comments as you are filling out
-the template. -->
+<!-- Provide a brief description of the problem you found. only documentation
+     issues should be filed here. For general questions, go to
+     https://forums.docker.com/. -->
 
 ### Problem location
 
-<!-- Help us find the problem quickly by choosing one
-     of these. Put an x between the brackets of your
-     choice, like [x]. -->
+<!-- Help us find the problem quickly by choosing one of these. -->
 
-- [ ] I saw the problem on the following URL:
+- I saw the problem on the following URL: <URL>
 
-- [ ] I couldn't find the information I wanted. I expected to find it near the following URL:
+- I couldn't find the information I wanted. I expected to find it near the following URL: <URL>
 
-- [ ] Other:
+- Other: <DETAILS>
 
 ### Project version(s) affected
 
-<!-- If this problem only affects specific versions of a
-project (like Docker Engine 1.13), mention it here. The fix
-may need to take that into account. -->
+<!-- If this problem only affects specific versions of a project (like Docker
+     Engine 1.13), mention it here. The fix may need to take that into account. -->
 
 ### Suggestions for a fix
 
-<!--If you have specific ideas for how the problem
-can be addressed, let us know.-->
+<!--If you have specific ideas for how the problem can be addressed, let us know. -->
 
 
 
diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
index d2813f381f..403812517b 100644
--- a/.github/PULL_REQUEST_TEMPLATE.md
+++ b/.github/PULL_REQUEST_TEMPLATE.md
@@ -1,52 +1,33 @@
-<!--Thanks for your contribution. Please use the following
-guidelines to help us review it. You can remove these comments
-as you fill out this template. -->
+<!--Thanks for your contribution. See [CONTRIBUTING](CONTRIBUTING.md)
+    for this project's contribution guidelines. -->
 
-<!--DO NOT edit files and directories listed in .NOT_EDITED_HERE.txt
-as these are maintained in upstream repos and added to the central
-docs repo periodically. Your PR will fail automated checks if it
-includes changes to these files or directories.-->
-
-<!-- **Squash your commits**: Please use an
-interactive rebase (https://help.github.com/articles/about-git-rebase/)
-to squash (combine) multiple commits into a single commit, to keep the
-commit history clean. The exception is when commits from multiple
-contributors exist in the same pull request. In that case, one commit
-per contributor is preferred, to keep the history clean but also give
-credit for the work to all contributors. -->
+<!--DO NOT edit files and directories listed in .NOT_EDITED_HERE.txt.
+    These are maintained in upstream repos and changes here will be lost.-->
 
 ### Describe the proposed changes
 
-<!-- Tell us what you did and why. You can leave this off if
-the PR title is descriptive. -->
+<!-- Tell us what you did and why. You can leave this off if the PR title
+     is descriptive. The commit message will be added to the end of this form.-->
 
 ### Project version
 
-<!-- If this change only applies to a certain version of a project
-(like Docker Engine 1.13), note that here. Also, consider adding
-that info to the docs in your change, such as by adding
-"In Docker 1.13 and higher..." or similar. -->
-
-<!-- Also, DO NOT base your work on master if your change is only
-relevant to an unreleased version of a project. Instead, base
-your work on the `vnext-<PROJECT>` branch, which will be merged
-into master when that project has a new release.-->
+<!-- If this change only applies to a future version of a project (like
+     Docker Engine 1.13), note that here and base your work on the `vnext-`
+     branch for your project. -->
 
 ### Related issue
 
-<!-- If this relates to an issue or PR in this repo, refer to it
-like #1234 -->
+<!-- If this relates to an issue or PR in this repo, refer to it like
+     #1234, or 'Fixes #1234' or 'Closes #1234'. -->
 
 ### Related issue or PR in another project
 
-<!-- Provide one or more links to issues or pull requests in
-other repositories. For instance, a link to the PR that
-introduces a code change that this PR is documenting. -->
+<!-- Links to issues or pull requests in other repositories if applicable. -->
 
 ### Please take a look
 
-<!-- Use this section to at-mention specific individuals who should take a
-look at this PR. For instance, @exampleuser123-->
+<!-- At-mention specific individuals or groups who should take a
+     look at this PR. For instance, @exampleuser123 -->
 
 
 <!-- To improve this template, edit .github/PULL_REQUEST_TEMPLATE.md. -->

From 3add12f17d4ae4da151220fbf4c272f58a6bc01b Mon Sep 17 00:00:00 2001
From: LRubin <lrubin@docker.com>
Date: Fri, 21 Oct 2016 13:51:36 -0700
Subject: [PATCH 2/2] Update ISSUE_TEMPLATE.md

grammar rewords/simplifications and a typo
---
 .github/ISSUE_TEMPLATE.md | 12 +++++-------
 1 file changed, 5 insertions(+), 7 deletions(-)

diff --git a/.github/ISSUE_TEMPLATE.md b/.github/ISSUE_TEMPLATE.md
index b07ede6eff..e643696f57 100644
--- a/.github/ISSUE_TEMPLATE.md
+++ b/.github/ISSUE_TEMPLATE.md
@@ -1,14 +1,13 @@
 ### Problem description
 
-<!-- Provide a brief description of the problem you found. only documentation
-     issues should be filed here. For general questions, go to
-     https://forums.docker.com/. -->
+<!-- Briefly describe the problem that you found. Only documentation issues should be filed here. 
+     For general questions, go to https://forums.docker.com/. -->
 
 ### Problem location
 
 <!-- Help us find the problem quickly by choosing one of these. -->
 
-- I saw the problem on the following URL: <URL>
+- I saw a problem on the following URL: <URL>
 
 - I couldn't find the information I wanted. I expected to find it near the following URL: <URL>
 
@@ -17,12 +16,11 @@
 ### Project version(s) affected
 
 <!-- If this problem only affects specific versions of a project (like Docker
-     Engine 1.13), mention it here. The fix may need to take that into account. -->
+     Engine 1.13), tell us here. The fix may need to take that into account. -->
 
 ### Suggestions for a fix
 
-<!--If you have specific ideas for how the problem can be addressed, let us know. -->
-
+<!--If you have specific ideas about how we can fix this, let us know. -->
 
 
 <!-- To improve this template, edit the .github/ISSUE_TEMPLATE.md file -->