add documentation about auto-generating auto-documentation

Change-Id: I6bfa6a7e8d83d211f4e52865e033b9911f607c58

test/instrumentation/README.md

@@ -25,3 +25,16 @@ To update the golden test list, you can run:
 ```console
 ./test/instrumentation/test-update.sh
 ```
+
+To update the list of documented metrics (which you need to run first before 
+upgrading the documentation markdown file).
+
+```console
+./test/instrumentation/update-documentation-metrics.sh
+```
+
+To update the documented list of metrics for k8s/website, please run:
+
+```console
+./test/instrumentation/update-documentation.sh
+```

test/instrumentation/documentation/main.go

@@ -53,12 +53,12 @@ These are the metrics which are exported in Kubernetes components (i.e. kube-api
 <table class="table">
 <thead>
 	<tr>
-		<td>Name</td>
+		<td width="20%">Name</td>
-		<td>Stability Level</td>
+		<td width="12%">Stability Level</td>
-		<td>Type</td>
+		<td width="12%">Type</td>
-		<td width="20%">Help</td>
+		<td width="30%">Help</td>
-		<td>Labels</td>
+		<td width="13%">Labels</td>
-		<td>Const Labels</td>
+		<td width="13%">Const Labels</td>
 	</tr>
 </thead>
 <tbody>

test/instrumentation/testdata/documentation.md

@@ -15,12 +15,12 @@ These are the metrics which are exported in Kubernetes components (i.e. kube-api
 <table class="table">
 <thead>
 	<tr>
-		<td>Name</td>
+		<td width="20%">Name</td>
-		<td>Stability Level</td>
+		<td width="12%">Stability Level</td>
-		<td>Type</td>
+		<td width="12%">Type</td>
-		<td width="20%">Help</td>
+		<td width="30%">Help</td>
-		<td>Labels</td>
+		<td width="13%">Labels</td>
-		<td>Const Labels</td>
+		<td width="13%">Const Labels</td>
 	</tr>
 </thead>
 <tbody>