docs: misc doc debt (#8678)

Fixes https://github.com/envoyproxy/envoy/issues/8190
Fixes https://github.com/envoyproxy/envoy/issues/7420
Fixes https://github.com/envoyproxy/envoy/issues/7331
Fixes https://github.com/envoyproxy/envoy/issues/7312
Fixes https://github.com/envoyproxy/envoy/issues/7284

Signed-off-by: Matt Klein <mklein@lyft.com>

Mirrored from https://github.com/envoyproxy/envoy @ 8e0b240b0e0abcda07b7b259178bdad60a699019

envoy/api/v2/core/protocol.proto

@@ -151,7 +151,7 @@ message Http2ProtocolOptions {
   // the whole HTTP/2 connection is terminated upon receiving invalid HEADERS frame. However,
   // when this option is enabled, only the offending stream is terminated.
   //
-  // See [RFC7540, sec. 8.1](https://tools.ietf.org/html/rfc7540#section-8.1) for details.
+  // See `RFC7540, sec. 8.1 <https://tools.ietf.org/html/rfc7540#section-8.1>`_ for details.
   bool stream_error_on_invalid_http_messaging = 12;
 }
 

envoy/api/v2/srds.proto

@@ -15,7 +15,7 @@ import "validate/validate.proto";
 
 // [#protodoc-title: HTTP scoped routing configuration]
 // * Routing :ref:`architecture overview <arch_overview_http_routing>`
-//
+
 // The Scoped Routes Discovery Service (SRDS) API distributes
 // :ref:`ScopedRouteConfiguration<envoy_api_msg.ScopedRouteConfiguration>`
 // resources. Each ScopedRouteConfiguration resource represents a "routing

envoy/api/v3alpha/core/protocol.proto

@@ -151,7 +151,7 @@ message Http2ProtocolOptions {
   // the whole HTTP/2 connection is terminated upon receiving invalid HEADERS frame. However,
   // when this option is enabled, only the offending stream is terminated.
   //
-  // See [RFC7540, sec. 8.1](https://tools.ietf.org/html/rfc7540#section-8.1) for details.
+  // See `RFC7540, sec. 8.1 <https://tools.ietf.org/html/rfc7540#section-8.1>`_ for details.
   bool stream_error_on_invalid_http_messaging = 12;
 }
 

envoy/api/v3alpha/srds.proto

@@ -15,7 +15,7 @@ import "validate/validate.proto";
 
 // [#protodoc-title: HTTP scoped routing configuration]
 // * Routing :ref:`architecture overview <arch_overview_http_routing>`
-//
+
 // The Scoped Routes Discovery Service (SRDS) API distributes
 // :ref:`ScopedRouteConfiguration<envoy_api_msg.ScopedRouteConfiguration>`
 // resources. Each ScopedRouteConfiguration resource represents a "routing