Add index entries for API Reference (gardener#4986)

* Add index entries for API Reference

* Fix check-generate

docs/README.md

@@ -58,6 +58,16 @@
 * [Troubleshooting guide](usage/trouble_shooting_guide.md)
 * [Trusted TLS certificate for shoot control planes](usage/trusted-tls-for-control-planes.md)
 
+## [API Reference](api-reference/README.md)
+
+* [`authentication.gardener.cloud` API Group](api-reference/authentication.md)
+* [`core.gardener.cloud` API Group](api-reference/core.md)
+* [`extensions.gardener.cloud` API Group](api-reference/extensions.md)
+* [`operations.gardener.cloud` API Group](api-reference/operations.md)
+* [`resources.gardener.cloud` API Group](api-reference/resources.md)
+* [`seedmanagement.gardener.cloud` API Group](api-reference/seedmanagement.md)
+* [`settings.gardener.cloud` API Group](api-reference/settings.md)
+
 ## Proposals
 
 * [GEP: Gardener Enhancement Proposal Description](proposals/README.md)

docs/api-reference/README.md

@@ -0,0 +1,9 @@
+# Gardener API Reference
+
+* [`authentication.gardener.cloud` API Group](authentication.md)
+* [`core.gardener.cloud` API Group](core.md)
+* [`extensions.gardener.cloud` API Group](extensions.md)
+* [`operations.gardener.cloud` API Group](operations.md)
+* [`resources.gardener.cloud` API Group](resources.md)
+* [`seedmanagement.gardener.cloud` API Group](seedmanagement.md)
+* [`settings.gardener.cloud` API Group](settings.md)

hack/clean.sh

@@ -30,5 +30,5 @@ for source_tree in $@; do
 done
 
 if [ -d "$PWD/docs/api-reference" ]; then
-  find ./docs/api-reference/ -type f -name "*.md" -exec rm '{}' \;
+  find ./docs/api-reference/ -type f -name "*.md" ! -name "README.md" -exec rm '{}' \;
 fi