Docs: updates for file-based menu (#28500)

* initial

* cleanup

* remove bad aliases

* cleanup, fix links

* add docs-file-based-command

* update docs

* update readme

* fix broken links

* fix spelling

Co-authored-by: Diana Payton <52059945+oddlittlebird@users.noreply.github.com>

docs/sources/auth/generic-oauth.md

@@ -2,11 +2,6 @@
 title = "OAuth authentication"
 description = "Grafana OAuthentication Guide "
 keywords = ["grafana", "configuration", "documentation", "oauth"]
-type = "docs"
-[menu.docs]
-name = "Generic OAuth"
-identifier = "generic_oauth"
-parent = "authentication"
 weight = 500
 +++
 
@@ -47,8 +42,8 @@ tls_client_ca =
 
 Set `api_url` to the resource that returns [OpenID UserInfo](https://connect2id.com/products/server/docs/api/userinfo) compatible information.
 
-You can also specify the SSL/TLS configuration used by the client. 
-- Set `tls_client_cert` to the path of the certificate. 
+You can also specify the SSL/TLS configuration used by the client.
+- Set `tls_client_cert` to the path of the certificate.
 - Set `tls_client_key` to the path containing the key.
 - Set `tls_client_ca` to the path containing a trusted certificate authority list.
 
@@ -75,7 +70,7 @@ See [JMESPath examples](#jmespath-examples) for more information.
 
 Customize user login using `login_attribute_path` configuration option. Order of operations is as follows:
 
-1. Grafana evaluates the `login_attribute_path` JMESPath expression against the ID token. 
+1. Grafana evaluates the `login_attribute_path` JMESPath expression against the ID token.
 1. If Grafana finds no value, then Grafana evaluates expression against the JSON data obtained from UserInfo endpoint. The UserInfo endpoint URL is specified in the `api_url` configuration option.
 
 You can customize the attribute name used to extract the ID token from the returned OAuth token with the `id_token_attribute_name` option.