Uploaded image for project: 'Couchbase Kubernetes'
  1. Couchbase Kubernetes
  2. K8S-1991

Helm Doc Auto-generation PART 1: The Beginning

    XMLWordPrintable

Details

    • Page
    • Resolution: Done
    • Major
    • 2.2.0
    • None
    • documentation, helm
    • None
    • 1

    Description

      K8S-1897 introduced tools and a workflow to auto-generate reference documentation for custom resources. We should introduce a similar process for the Helm reference documentation.

      Currently, there is only one Helm-related reference page, and it documents the values.yaml spec. The page format is very similar to that of the custom resource pages that are generated by K8S-1897 (because they're effectively documenting the same fields and parameters).

      The following should be considered when building an auto-generation workflow for Helm reference docs:

      1. If the fields in values.yaml are basically already documented in the reference for the other custom resource (e.g. couchbasecluster, coubasebucket, couchbaseuser, etc.) then should we try and import that content automatically instead of writing duplicate descriptions for the Helm reference?
      2. Can/should the Helm reference docs be generated in the Operator repo? It seems that this would be ideal and would require the least amount of re-tooling.
      3. The existing values.yaml has some in-line documentation. Should preserve this separately from the documentation we write for the standard docs set? And can these docs be read from kubectl/helm command-line?

      Attachments

        Issue Links

          No reviews matched the request. Check your Options in the drop-down menu of this sections header.

          Activity

            People

              simon.murray Simon Murray
              eric.schneider Eric Schneider (Inactive)
              Votes:
              0 Vote for this issue
              Watchers:
              3 Start watching this issue

              Dates

                Created:
                Updated:
                Resolved:

                Gerrit Reviews

                  There are no open Gerrit changes

                  PagerDuty