Add and rework alerts

content/en/schemas/_index.md

@@ -6,8 +6,9 @@ no_list: true
 body_class: ot-schemas-404
 #
 # Note:
-#   This page can be served from either `/schemas` or `/schemas`.
-#   This is why the paths to sub-pages `list` and `latest` are absolute below.
+#   This page can be served from either `/schemas` or `/schemas/`.
+#   We've ensured that the paths to the `list` and `latest` work in
+#   both cases by making the path absolute.
 #
 ---
 
@@ -19,8 +20,13 @@ these:
 - More information about [Telemetry Schemas] in general, or [OpenTelemetry
   Schema] in particular.
 
-> **Note**: The path `/schemas/` is reserved for the possible future use of
-> serving a machine-readable list of schemas.
+{{% alert title="<i class=\"fa-solid fa-triangle-exclamation\"></i> Warning" color="warning" %}}
+
+The paths `/schemas` and `/schemas/` reserved for the possible future use of
+serving a machine-readable (`application/*`) list of schemas. This page, its
+content, and formatting are **non-normative** and **subject to change**.
+
+{{% /alert %}}
 
 [OpenTelemetry Schema]: /docs/specs/otel/schemas/#opentelemetry-schema
 [Telemetry Schemas]: /docs/specs/otel/schemas/

content/en/schemas/list.md

@@ -5,6 +5,13 @@ type: docs
 body_class: ot-schema-list
 ---
 
+{{% alert title="<i class=\"fa-solid fa-triangle-exclamation\"></i> Warning" color="warning" %}}
+
+This page, its content, and formatting are **non-normative** and **subject to
+change**. In particular it is not meant for automated processing.
+
+{{% /alert %}}
+
 The OpenTelemetry schemas hosted on this site are listed below. To learn more
 about schemas, see [Telemetry Schemas][].
 

layouts/index.redirects

@@ -49,8 +49,8 @@
 
 /schemas         /schemas/? 404!
 /schemas/latest  /schemas/{{ $latestSchemaFile.Name }}
-/schemas/list    /schemas/list/ 200
-/schemas/*       /schemas/? 404  # Report 404 for anything else that's missing
+/schemas/list    /schemas/list/ 200 # Explicit rule to avoid the next catch all
+/schemas/*       /schemas/? 404     # Report 404 for anything else that's missing
 
 {{/*
   Social-media image redirects. As mentioned in