Update reference docs. (#3218)

content/docs/reference/config/istio.authentication.v1alpha1/index.html

@@ -615,7 +615,7 @@ fully qualified domain name will be resolved in a platform specific manner.</p>
 <p>Specifies the ports. Note that this is the port(s) exposed by the service, not workload ports.
 For example, if a service is defined as below, then <code>8000</code> should be used, not <code>9000</code>.</p>
 
-<pre><code>kind: Service
+<pre><code class="language-yaml">kind: Service
 metadata:
   ...
 spec:

content/docs/reference/config/policy-and-telemetry/adapters/apigee/index.html

@@ -10,15 +10,17 @@ support_link: https://apigee.com/about/support/portal
 source_link: https://github.com/apigee/istio-mixer-adapter
 latest_release_link: https://github.com/apigee/istio-mixer-adapter/releases
 helm_chart_link:
-istio_versions: "1.0.0, 1.0.2"
+istio_versions: "1.0.0, 1.0.2, 1.0.3, 1.0.4, 1.0.5"
 supported_templates: authorization, analytics
 number_of_entries: 3
 ---
 <p>The Apigee Mixer adapter provides Apigee&rsquo;s distributed authentication and quota policy checks
-as well as the ingestion of Istio telemetry for analysis and reporting.
-Complete Apigee documentation on the concepts and usage of this adapter is also available on the
-<a href="https://docs.apigee.com/api-platform/istio-adapter/concepts">Apigee Adapter for Istio</a> site.
-For more information and product support, please <a href="https://apigee.com/about/support/portal">contact Apigee support</a>.</p>
+as well as the ingestion of Istio telemetry for analysis and reporting.</p>
+
+<p>Important: The adapter is provided in an enhanced Mixer image. The default Mixer image must be replaced and the
+proper CRDs must be applied in order to use these features. Complete Apigee documentation on the concepts and usage
+of this adapter is available on the <a href="https://docs.apigee.com/api-platform/istio-adapter/concepts">Apigee Adapter for Istio</a>
+site. For more information and product support, please <a href="https://apigee.com/about/support/portal">contact Apigee support</a>.</p>
 
 <p>This adapter supports the <a href="/docs/reference/config/policy-and-telemetry/templates/authorization/">authorization template</a>
 and Apigee&rsquo;s <a href="/docs/reference/config/policy-and-telemetry/templates/analytics/">analytics template</a>.</p>

content/docs/reference/config/policy-and-telemetry/adapters/opa/index.html

@@ -20,7 +20,7 @@ that provides sophisticated access control mechanisms.</p>
 
 <p>Example configuration:</p>
 
-<pre><code>policy:
+<pre><code class="language-yaml">policy:
   - |+
     package mixerauthz
     policy = [

content/docs/reference/config/policy-and-telemetry/templates/listentry/index.html

@@ -13,7 +13,7 @@ with the <a href="/docs/reference/config/policy-and-telemetry/adapters/list/">li
 
 <p>Example config:</p>
 
-<pre><code>apiVersion: &quot;config.istio.io/v1alpha2&quot;
+<pre><code class="language-yaml">apiVersion: &quot;config.istio.io/v1alpha2&quot;
 kind: listentry
 metadata:
   name: appversion

content/docs/reference/config/policy-and-telemetry/templates/quota/index.html

@@ -12,7 +12,7 @@ number_of_entries: 1
 
 <p>Example config:</p>
 
-<pre><code>apiVersion: &quot;config.istio.io/v1alpha2&quot;
+<pre><code class="language-yaml">apiVersion: &quot;config.istio.io/v1alpha2&quot;
 kind: quota
 metadata:
   name: requestcount