ory / k8s

Kubernetes Helm Charts for the ORY ecosystem.

Home Page:https://k8s.ory.sh/helm

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Docs: Kratos Helm chart doc is not rendered correctly on k8s.ory.sh

MichaelMarner opened this issue · comments

Preflight checklist

Describe the bug

The hosted Helm docs for Kratos:

https://k8s.ory.sh/helm/kratos.html

Do not render the sample yaml correctly. Specifically, the section about supplying an identity schema with a file using --set-file, should look like this:

# values.yaml
kratos:
  identitySchemas:
    <schema-name>.schema.json: |-
      {{ .Values.<your-key> }}

Github renders this correctly, as shown here:

https://github.com/ory/k8s/blob/master/docs/helm/kratos.md#identity-schemas

However, the vital {{.Values<your-key<}} is not rendered at all on the generated HTML:

Screenshot 2023-03-07 at 10 42 02 pm

Reproducing the bug

N/A - This is an error in the generated documentation.

Relevant log output

N/A

Relevant configuration

N/A

Version

N/A

On which operating system are you observing this issue?

None

In which environment are you deploying?

None

Additional Context

No response

@MichaelMarner thank you! :)

Can confirm that this is still an issue, and very confusing for those who are not super familiar with helm. :D

Uhm, could it be browser depended 🤔? On my end i see the following
image

Looks the same on both Firefox and chrome based Opera

@Demonsthere I think you are looking at the "wrong" thing:

Screenshot 2023-12-01 at 16 16 04

I just checked in Firefox and Chrome on a Mac, and Brave on iOS. It looks like this.

Yeah, it's the github pages based rendering 😞 The file renders correctly as a md, and even local md -> html shows it correctly. I have tried updating the pages theme, but it looks the same. Don't really know what we can do here 😞

Add a note that it may not render correctly? :D (aka quickfix)