From 3f5aacfc14dabe11f9ca0b2e59c2072628def532 Mon Sep 17 00:00:00 2001
From: Sascha Grunert <sgrunert@suse.com>
Date: Thu, 8 Aug 2019 13:45:33 +0200
Subject: [PATCH] Update the PR template for latest 'additional documentation'
 enhancements

- Clarify the ephemerality of links

Signed-off-by: Sascha Grunert <sgrunert@suse.com>
---
 .github/PULL_REQUEST_TEMPLATE.md | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
index 542493f75be..17d9988c796 100644
--- a/.github/PULL_REQUEST_TEMPLATE.md
+++ b/.github/PULL_REQUEST_TEMPLATE.md
@@ -47,8 +47,15 @@ Enter your extended release note in the block below. If the PR requires addition
 
 <!--
 This section can be blank if this pull request does not require a release note.
-Please use the following format for linking documentation or pass the
-section below:
+
+When adding links which point to resources within git repositories, like
+KEPs or supporting documentation, please reference a specific commit and avoid
+linking directly to the master branch. This ensures that links reference a
+specific point in time, rather than a document that may change over time.
+
+See here for guidance on getting permanent links to files: https://help.github.com/en/articles/getting-permanent-links-to-files
+
+Please use the following format for linking documentation:
 - [KEP]: <link>
 - [Usage]: <link>
 - [Other doc]: <link>