Make the KEP PRR template more structured markdown

I have found that, in reviewing KEPs, a few problems:

* It's not clear which text is the template and which is the user's
response

* Users are not removing template text and seed questions

* Line-wrap on **bold** syntax is broken

This commit converts the doc to use #### markdown instead, and makes all
template text into comments, like the rest of the doc.

Author: thockin

hack/update-toc.sh

@@ -19,7 +19,7 @@ set -o nounset
 set -o pipefail
 
 # keep in sync with hack/verify-toc.sh
-TOOL_VERSION=ee652eb78c047a7b6c7417d9324a97bb05689563
+TOOL_VERSION=b8c54a57d69f29386d055584e595f38d65ce2a1f
 
 # cd to the root path
 ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd -P)"
@@ -38,9 +38,11 @@ trap exitHandler EXIT
 # perform go get in a temp dir as we are not tracking this version in a go module
 # if we do the go get in the repo, it will create / update a go.mod and go.sum
 cd "${TMP_DIR}"
-GO111MODULE=on GOBIN="${TMP_DIR}" go get "github.com/tallclair/mdtoc@${TOOL_VERSION}"
+GO111MODULE=on GOBIN="${TMP_DIR}" go get "sigs.k8s.io/mdtoc@${TOOL_VERSION}"
 export PATH="${TMP_DIR}:${PATH}"
 cd "${ROOT}"
 
 # Update tables of contents if necessary.
-find keps -name '*.md' | grep -Fxvf hack/.notableofcontents | xargs mdtoc --inplace
+find keps -name '*.md' \
+    | grep -Fxvf hack/.notableofcontents \
+    | xargs mdtoc --inplace --max-depth=5

hack/verify-toc.sh

@@ -19,7 +19,7 @@ set -o nounset
 set -o pipefail
 
 # keep in sync with hack/update-toc.sh
-TOOL_VERSION=ee652eb78c047a7b6c7417d9324a97bb05689563
+TOOL_VERSION=b8c54a57d69f29386d055584e595f38d65ce2a1f
 
 # cd to the root path
 ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd -P)"
@@ -38,10 +38,12 @@ trap exitHandler EXIT
 # perform go get in a temp dir as we are not tracking this version in a go module
 # if we do the go get in the repo, it will create / update a go.mod and go.sum
 cd "${TMP_DIR}"
-GO111MODULE=on GOBIN="${TMP_DIR}" go get "github.com/tallclair/mdtoc@${TOOL_VERSION}"
+GO111MODULE=on GOBIN="${TMP_DIR}" go get "sigs.k8s.io/mdtoc@${TOOL_VERSION}"
 export PATH="${TMP_DIR}:${PATH}"
 cd "${ROOT}"
 
 echo "Checking table of contents are up to date..."
 # Verify tables of contents are up-to-date
-find keps -name '*.md' | grep -Fxvf hack/.notableofcontents | xargs mdtoc --inplace --dryrun
+find keps -name '*.md' \
+    | grep -Fxvf hack/.notableofcontents \
+    | xargs mdtoc --inplace --max-depth=5 --dryrun