fix bugs in diagrams & improve titles

Signed-off-by: Tim Ramlot <[email protected]>

content/docs/usage/certificate.md

@@ -378,7 +378,7 @@ data:
   ...
 ```
 
-## Inner workings diagram
+## Inner workings diagram for developers
 
 <object data="/images/request-certificate-debug/certificate-flow.svg"></object>
 

content/docs/usage/certificaterequest.md

@@ -267,6 +267,6 @@ and `bar`:
     resourceNames: ["myissuers.my-example.io/foo.myapp", "myissuers.my-example.io/bar.myapp"]
 ```
 
-## Inner workings diagram
+## Inner workings diagram for developers
 
 <object data="/images/request-certificate-debug/certificate-request-flow.svg"></object>

content/docs/usage/gateway.md

@@ -444,7 +444,7 @@ Certificate resources:
   configure `spec.privateKey.rotationPolicy` field to set the rotation policy of the private key for a Certificate.
   Valid values are `Never` and `Always`. If unset a rotation policy `Never` will be used.
 
-## Inner workings diagram
+## Inner workings diagram for developers
 
 <object data="/images/request-certificate-debug/gateway-shim-flow.svg"></object>
 

content/docs/usage/ingress.md

@@ -221,7 +221,7 @@ guide](../installation/README.md).
 
 If you do not see a `Certificate` resource being created after applying the ingress-shim annotations check that at least `cert-manager.io/issuer` or `cert-manager.io/cluster-issuer` is set. If you want to use `kubernetes.io/tls-acme: "true"` make sure to have checked all steps above and you might want to look for errors in the cert-manager pod logs if not resolved.
 
-## Inner workings diagram
+## Inner workings diagram for developers
 
 <object data="/images/request-certificate-debug/ingress-shim-flow.svg"></object>
 

content/docs/usage/kube-csr.md

@@ -172,6 +172,6 @@ are not approved by default, so you will likely need to approve it manually:
 $ kubectl certificate approve <name>
 ```
 
-## Inner workings diagram
+## Inner workings diagram for developers
 
 <object data="/images/request-certificate-debug/certificate-signing-request-flow.svg"></object>

public/images/request-certificate-debug/gateway-shim-flow.drawio

@@ -1,6 +1,6 @@
-<mxfile host="app.diagrams.net" modified="2023-09-07T13:11:24.675Z" agent="Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/116.0.0.0 Safari/537.36" etag="uY4319KJFZV_AFAf-Mg5" version="21.7.2" type="device">
+<mxfile host="app.diagrams.net" modified="2023-10-17T11:29:03.826Z" agent="Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/118.0.0.0 Safari/537.36" etag="GI42g75oc1MrfQfK2TkA" version="22.0.4" type="device">
   <diagram id="AW3OrBCQwjyOdo3bwChp" name="Page-1">
-    <mxGraphModel dx="819" dy="1616" grid="1" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="1" pageScale="1" pageWidth="827" pageHeight="1169" math="0" shadow="0">
+    <mxGraphModel dx="698" dy="1547" grid="1" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="1" pageScale="1" pageWidth="827" pageHeight="1169" math="0" shadow="0">
       <root>
         <mxCell id="0" />
         <mxCell id="1" parent="0" />
@@ -66,8 +66,8 @@
             <mxPoint x="810" y="160" as="targetPoint" />
           </mxGeometry>
         </mxCell>
-        <mxCell id="gfwWATJFP_jRYh0Kxk0O-12" value="kind: Certificate&lt;br&gt;spec:&lt;br&gt;&amp;nbsp; issuerRef:&amp;nbsp;&lt;b style=&quot;border-color: var(--border-color);&quot;&gt;issuer-1&lt;/b&gt;&lt;br&gt;&amp;nbsp; secretName:&amp;nbsp;&lt;b style=&quot;border-color: var(--border-color);&quot;&gt;cert&lt;/b&gt;-1&lt;br&gt;status:&lt;br&gt;&amp;nbsp; revision: 1&lt;br&gt;&amp;nbsp; conditions:&lt;br&gt;&amp;nbsp; &amp;nbsp; - type: &lt;b&gt;Ready&lt;/b&gt;&lt;br&gt;&amp;nbsp; &amp;nbsp; &amp;nbsp; status: &lt;b&gt;&quot;True&quot;&lt;/b&gt;&lt;br&gt;&amp;nbsp; &amp;nbsp; &amp;nbsp; reason: &lt;b&gt;Issued&lt;/b&gt;&lt;br&gt;&amp;nbsp; &amp;nbsp; - type: Issuing&lt;br&gt;&amp;nbsp; &amp;nbsp; &amp;nbsp; status: &quot;True&quot;&lt;br&gt;&amp;nbsp; &amp;nbsp; &amp;nbsp; reason: Pending&lt;br&gt;&amp;nbsp; certificate: |&lt;b&gt;&lt;br&gt;&lt;/b&gt;&amp;nbsp; &amp;nbsp; -----BEGIN CERTIFICATE-----&lt;br&gt;&amp;nbsp; &amp;nbsp; (leaf)&lt;br&gt;&amp;nbsp; &amp;nbsp; -----END CERTIFICATE-----&lt;br&gt;&amp;nbsp; &amp;nbsp; -----BEGIN CERTIFICATE-----&lt;br&gt;&amp;nbsp; &amp;nbsp; (intermediate)&lt;br&gt;&amp;nbsp; &amp;nbsp; -----END CERTIFICATE-----&lt;b&gt;&lt;br&gt;&lt;/b&gt;" style="text;html=1;strokeColor=#82b366;fillColor=#d5e8d4;align=left;verticalAlign=top;whiteSpace=wrap;rounded=0;fontFamily=Courier New;spacingTop=0;spacingBottom=0;spacing=5;" parent="1" vertex="1">
-          <mxGeometry x="77.5" y="337" width="234.87" height="303" as="geometry" />
+        <mxCell id="gfwWATJFP_jRYh0Kxk0O-12" value="kind: Certificate&lt;br&gt;spec:&lt;br&gt;&amp;nbsp; issuerRef:&amp;nbsp;&lt;b style=&quot;border-color: var(--border-color);&quot;&gt;issuer-1&lt;/b&gt;&lt;br&gt;&amp;nbsp; secretName:&amp;nbsp;&lt;b&gt;&lt;span style=&quot;border-color: var(--border-color);&quot;&gt;cert&lt;/span&gt;-1&lt;/b&gt;&lt;br&gt;status:&lt;br&gt;&amp;nbsp; revision: 1&lt;br&gt;&amp;nbsp; conditions:&lt;br&gt;&amp;nbsp; &amp;nbsp; - type: &lt;b&gt;Ready&lt;/b&gt;&lt;br&gt;&amp;nbsp; &amp;nbsp; &amp;nbsp; status: &lt;b&gt;&quot;True&quot;&lt;/b&gt;&lt;br&gt;&amp;nbsp; &amp;nbsp; &amp;nbsp; reason: &lt;b&gt;Issued&lt;/b&gt;&lt;br&gt;&amp;nbsp; &amp;nbsp; - type: Issuing&lt;br&gt;&amp;nbsp; &amp;nbsp; &amp;nbsp; status: &quot;False&quot;&lt;br&gt;&amp;nbsp; &amp;nbsp; &amp;nbsp; reason: Issued&lt;b&gt;&lt;br&gt;&lt;/b&gt;" style="text;html=1;strokeColor=#82b366;fillColor=#d5e8d4;align=left;verticalAlign=top;whiteSpace=wrap;rounded=0;fontFamily=Courier New;spacingTop=0;spacingBottom=0;spacing=5;" parent="1" vertex="1">
+          <mxGeometry x="77.5" y="337" width="234.87" height="203" as="geometry" />
         </mxCell>
         <mxCell id="gfwWATJFP_jRYh0Kxk0O-16" value="" style="endArrow=none;html=1;fontFamily=Courier New;fontColor=#757575;strokeColor=#000000;endFill=0;startArrow=classic;startFill=1;" parent="1" target="SW6BRf9NdE8UDbDrH991-2" edge="1">
           <mxGeometry width="50" height="50" relative="1" as="geometry">
@@ -97,7 +97,7 @@
           </mxCell>
         </UserObject>
         <UserObject label="" link="/docs/usage/certificate/" linkTarget="_blank" id="G6DhhnYIuvKHuKb8DNrd-2">
-          <mxCell style="shape=image;verticalLabelPosition=bottom;labelBackgroundColor=default;verticalAlign=top;aspect=fixed;imageAspect=0;image=data:image/svg+xml,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCA0OCA0OCIgaGVpZ2h0PSI0OCIgd2lkdGg9IjQ4Ij48cGF0aCBkPSJNMzggMzhIMTBWMTBoMTRWNkgxMGMtMi4yMSAwLTQgMS43OS00IDR2MjhjMCAyLjIxIDEuNzkgNCA0IDRoMjhjMi4yMSAwIDQtMS43OSA0LTRWMjRoLTR2MTR6TTI4IDZ2NGg3LjE3TDE1LjUxIDI5LjY2bDIuODMgMi44M0wzOCAxMi44M1YyMGg0VjZIMjh6IiBmaWxsPSIjRkZGRiIvPjwvc3ZnPg==;" vertex="1" parent="1">
+          <mxCell style="shape=image;verticalLabelPosition=bottom;labelBackgroundColor=default;verticalAlign=top;aspect=fixed;imageAspect=0;image=data:image/svg+xml,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCA0OCA0OCIgaGVpZ2h0PSI0OCIgd2lkdGg9IjQ4Ij48cGF0aCBkPSJNMzggMzhIMTBWMTBoMTRWNkgxMGMtMi4yMSAwLTQgMS43OS00IDR2MjhjMCAyLjIxIDEuNzkgNCA0IDRoMjhjMi4yMSAwIDQtMS43OSA0LTRWMjRoLTR2MTR6TTI4IDZ2NGg3LjE3TDE1LjUxIDI5LjY2bDIuODMgMi44M0wzOCAxMi44M1YyMGg0VjZIMjh6IiBmaWxsPSIjRkZGRiIvPjwvc3ZnPg==;" parent="1" vertex="1">
             <mxGeometry x="385.5" y="204" width="27.5" height="27.5" as="geometry" />
           </mxCell>
         </UserObject>