Uploaded image for project: 'OpenShift Service Mesh'
  1. OpenShift Service Mesh
  2. OSSM-6398

Document Sail operator APIs in community docs (e.g. Istio, IstioRevision, etc)

XMLWordPrintable

    • Icon: Story Story
    • Resolution: Unresolved
    • Icon: Blocker Blocker
    • OSSM 3.0-TP1
    • OSSM 3.0-TP1
    • Project Sail
    • None
    • False
    • None
    • False

      We should add documentation covering all CRDs that are specific to the Sail operator (e.g. a config reference) - including a brief description of what each field is for. For example, "Istio", "IstioRevision" and any other CRDs we created.

      This does not need to cover upstream Istio configuration fields, though a pointers or links to upstream Istio configuration references would be helpful where applicable (e.g. what goes in the values field, etc).

      This can be generated or maintained in any manner, but needs to be accessible from the main Sail operator readme.

      The target readers of this documentation includes:

      • Istio community members and others potential community users
      • Red Hat doc writers, who may reuse the content for our product docs
      • Customer users looking to gain experience with the Sail operator (this request came from a customer)

      Note: This could help with: https://issues.redhat.com/browse/OSSM-5895

      Acceptance Criteria:

      • As part of `make gen`, generate an API reference from our CRDs/docstrings

            Unassigned Unassigned
            jlongmui@redhat.com Jamie Longmuir
            Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

              Created:
              Updated: