Merge pull request #4437 from danwinship/update-mdtoc

Update mdtoc, fix TOC entries with backticks

Author: k8s-ci-robot

hack/update-toc.sh

@@ -19,7 +19,7 @@ set -o nounset
 set -o pipefail
 
 # keep in sync with hack/verify-toc.sh
-TOOL_VERSION=b8c54a57d69f29386d055584e595f38d65ce2a1f
+TOOL_VERSION=v1.1.0
 
 # cd to the root path
 ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd -P)"

hack/verify-toc.sh

@@ -19,7 +19,7 @@ set -o nounset
 set -o pipefail
 
 # keep in sync with hack/update-toc.sh
-TOOL_VERSION=b8c54a57d69f29386d055584e595f38d65ce2a1f
+TOOL_VERSION=v1.1.0
 
 # cd to the root path
 ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd -P)"

keps/sig-api-machinery/1101-immutable-fields/README.md

@@ -9,8 +9,8 @@
   - [Goals](#goals)
   - [Non-Goals](#non-goals)
 - [Proposal](#proposal)
-  - [OpenAPI extension <code>x-kubernetes-immutable</code>](#openapi-extension-)
-  - [OpenAPI extension <code>x-kubernetes-immutable-keys</code>](#openapi-extension--1)
+  - [OpenAPI extension <code>x-kubernetes-immutable</code>](#openapi-extension-x-kubernetes-immutable)
+  - [OpenAPI extension <code>x-kubernetes-immutable-keys</code>](#openapi-extension-x-kubernetes-immutable-keys)
   - [Publishing](#publishing)
   - [Suggested marker syntax](#suggested-marker-syntax)
   - [Future outline sketch: native resources](#future-outline-sketch-native-resources)

keps/sig-api-machinery/3488-cel-admission-control/README.md

@@ -97,9 +97,9 @@
   - [Type checking alternatives](#type-checking-alternatives)
   - [Policy definition and configuration separation alternatives](#policy-definition-and-configuration-separation-alternatives)
     - [Alternative: Duck Typed CRDs](#alternative-duck-typed-crds)
-    - [Alternative: OpenAPIv3 <code>$ref</code> in CRDs](#alternative-openapiv3--in-crds)
-    - [Alternative: <code>/matchRules</code> subresource](#alternative--subresource)
-    - [Alternative: <code>PolicyConfiguration</code> kind with config embedded](#alternative--kind-with-config-embedded)
+    - [Alternative: OpenAPIv3 <code>$ref</code> in CRDs](#alternative-openapiv3-ref-in-crds)
+    - [Alternative: <code>/matchRules</code> subresource](#alternative-matchrules-subresource)
+    - [Alternative: <code>PolicyConfiguration</code> kind with config embedded](#alternative-policyconfiguration-kind-with-config-embedded)
     - [Alternative: Generate CRDs](#alternative-generate-crds)
   - [CEL variables alternatives](#cel-variables-alternatives)
     - [Alternative: Scopes](#alternative-scopes)

keps/sig-api-machinery/4006-transition-spdy-to-websockets/README.md

@@ -88,12 +88,12 @@ tags, and then generate with `hack/update-toc.sh`.
   - [Risks and Mitigations](#risks-and-mitigations)
 - [Design Details](#design-details)
   - [Background: Streaming Protocol Basics](#background-streaming-protocol-basics)
-  - [Background: <code>RemoteCommand</code> Subprotocol](#background--subprotocol)
-  - [Background: API Server and Kubelet <code>UpgradeAwareProxy</code>](#background-api-server-and-kubelet-)
-  - [Proposal: <code>kubectl</code> WebSocket Executor and Fallback Executor](#proposal--websocket-executor-and-fallback-executor)
-  - [Proposal: New <code>RemoteCommand</code> Sub-Protocol Version - <code>v5.channel.k8s.io</code>](#proposal-new--sub-protocol-version---)
-  - [Proposal: API Server <code>StreamTranslatorProxy</code>](#proposal-api-server-)
-  - [Pre-GA: Kubelet <code>StreamTranslatorProxy</code>](#pre-ga-kubelet-)
+  - [Background: <code>RemoteCommand</code> Subprotocol](#background-remotecommand-subprotocol)
+  - [Background: API Server and Kubelet <code>UpgradeAwareProxy</code>](#background-api-server-and-kubelet-upgradeawareproxy)
+  - [Proposal: <code>kubectl</code> WebSocket Executor and Fallback Executor](#proposal-kubectl-websocket-executor-and-fallback-executor)
+  - [Proposal: New <code>RemoteCommand</code> Sub-Protocol Version - <code>v5.channel.k8s.io</code>](#proposal-new-remotecommand-sub-protocol-version---v5channelk8sio)
+  - [Proposal: API Server <code>StreamTranslatorProxy</code>](#proposal-api-server-streamtranslatorproxy)
+  - [Pre-GA: Kubelet <code>StreamTranslatorProxy</code>](#pre-ga-kubelet-streamtranslatorproxy)
   - [Test Plan](#test-plan)
       - [Prerequisite testing updates](#prerequisite-testing-updates)
       - [Unit tests](#unit-tests)

keps/sig-api-machinery/4008-crd-ratcheting/README.md

@@ -102,7 +102,7 @@ tags, and then generate with `hack/update-toc.sh`.
       - [Mitigation: Blacklisted Validations](#mitigation-blacklisted-validations)
       - [Mitigation: Conservative Ratcheting Rule](#mitigation-conservative-ratcheting-rule)
 - [Design Details](#design-details)
-  - [<code>kube-openapi</code> changes](#-changes)
+  - [<code>kube-openapi</code> changes](#kube-openapi-changes)
   - [Structural-Schema-based validation changes](#structural-schema-based-validation-changes)
     - [Correlation of Old and New](#correlation-of-old-and-new)
   - [Cel-Validator changes](#cel-validator-changes)

keps/sig-api-machinery/4153-declarative-validation/README.md

@@ -100,7 +100,7 @@ tags, and then generate with `hack/update-toc.sh`.
       - [Mitigation: Ensure Valid Old Objects Still Valid](#mitigation-ensure-valid-old-objects-still-valid)
     - [Risk: Reduced the fidelity of validation error messages](#risk-reduced-the-fidelity-of-validation-error-messages)
       - [Mitigation: Fallback to CEL](#mitigation-fallback-to-cel)
-      - [Mitigation: Explore <code>x-kubernetes</code> extension for custom error messages](#mitigation-explore--extension-for-custom-error-messages)
+      - [Mitigation: Explore <code>x-kubernetes</code> extension for custom error messages](#mitigation-explore-x-kubernetes-extension-for-custom-error-messages)
     - [Risk: Added latency to API request handling.](#risk-added-latency-to-api-request-handling)
       - [Mitigation: Avoid Conversion to Internal Type](#mitigation-avoid-conversion-to-internal-type)
       - [Mitigation: Avoid Unstructured Conversion](#mitigation-avoid-unstructured-conversion)
@@ -111,7 +111,7 @@ tags, and then generate with `hack/update-toc.sh`.
     - [Publish Complex Validation Rules](#publish-complex-validation-rules)
     - [Publish Declarative Defaults in Schema](#publish-declarative-defaults-in-schema)
     - [Support Shared Template Schemas](#support-shared-template-schemas)
-    - [Add missing <code>required</code> fields](#add-missing--fields)
+    - [Add missing <code>required</code> fields](#add-missing-required-fields)
     - [Zero-Valued Primitive Fields](#zero-valued-primitive-fields)
       - [Required Zero Fields](#required-zero-fields)
       - [Optional Zero Fields](#optional-zero-fields)
@@ -133,11 +133,11 @@ tags, and then generate with `hack/update-toc.sh`.
       - [e2e tests](#e2e-tests)
   - [Graduation Criteria](#graduation-criteria)
     - [Alpha](#alpha)
-      - [<code>DeclarativeValidationExtensionsInOpenAPI</code>](#)
-      - [<code>DeclarativeValidation</code>](#-1)
+      - [<code>DeclarativeValidationExtensionsInOpenAPI</code>](#declarativevalidationextensionsinopenapi)
+      - [<code>DeclarativeValidation</code>](#declarativevalidation)
     - [Beta](#beta)
-      - [<code>DeclarativeValidationExtensionsInOpenAPI</code>](#-2)
-      - [<code>DeclarativeValidation</code>](#-3)
+      - [<code>DeclarativeValidationExtensionsInOpenAPI</code>](#declarativevalidationextensionsinopenapi-1)
+      - [<code>DeclarativeValidation</code>](#declarativevalidation-1)
     - [GA](#ga)
   - [Upgrade / Downgrade Strategy](#upgrade--downgrade-strategy)
   - [Version Skew Strategy](#version-skew-strategy)

keps/sig-apps/1847-autoremove-statefulset-pvcs/README.md

@@ -19,10 +19,10 @@
 - [Design Details](#design-details)
   - [Objects Associated with the StatefulSet](#objects-associated-with-the-statefulset)
   - [Volume delete policy for the StatefulSet created PVCs](#volume-delete-policy-for-the-statefulset-created-pvcs)
-    - [<code>whenScaled</code> policy of <code>Delete</code>.](#-policy-of-)
-    - [<code>whenDeleted</code> policy of <code>Delete</code>.](#-policy-of--1)
+    - [<code>whenScaled</code> policy of <code>Delete</code>.](#whenscaled-policy-of-delete)
+    - [<code>whenDeleted</code> policy of <code>Delete</code>.](#whendeleted-policy-of-delete)
     - [Non-Cascading Deletion](#non-cascading-deletion)
-    - [Mutating <code>PersistentVolumeClaimRetentionPolicy</code>](#mutating-)
+    - [Mutating <code>PersistentVolumeClaimRetentionPolicy</code>](#mutating-persistentvolumeclaimretentionpolicy)
   - [Cluster role change for statefulset controller](#cluster-role-change-for-statefulset-controller)
   - [Test Plan](#test-plan)
     - [Unit tests](#unit-tests)

keps/sig-architecture/1143-node-role-labels/README.md

@@ -8,8 +8,8 @@
 - [Motivation](#motivation)
   - [Goals](#goals)
 - [Proposal](#proposal)
-  - [Use of <code>node-role.kubernetes.io/*</code> labels](#use-of--labels)
-  - [Current users of <code>node-role.kubernetes.io/*</code> within the project that must change](#current-users-of--within-the-project-that-must-change)
+  - [Use of <code>node-role.kubernetes.io/*</code> labels](#use-of-node-rolekubernetesio-labels)
+  - [Current users of <code>node-role.kubernetes.io/*</code> within the project that must change](#current-users-of-node-rolekubernetesio-within-the-project-that-must-change)
     - [Service load-balancer](#service-load-balancer)
     - [Node controller excludes master nodes from consideration for eviction](#node-controller-excludes-master-nodes-from-consideration-for-eviction)
     - [Kubernetes e2e tests](#kubernetes-e2e-tests)

keps/sig-architecture/2527-clarify-status-observations-vs-rbac/README.md

@@ -9,7 +9,7 @@
 - [Proposal](#proposal)
   - [Risks and Mitigations](#risks-and-mitigations)
 - [Design Details](#design-details)
-  - [Part 1: Loosen and clarify <code>status</code>](#part-1-loosen-and-clarify-)
+  - [Part 1: Loosen and clarify <code>status</code>](#part-1-loosen-and-clarify-status)
     - [Examples](#examples)
   - [Part 2: Clarify when it makes sense to use 2 objects](#part-2-clarify-when-it-makes-sense-to-use-2-objects)
   - [Test Plan](#test-plan)