Skip to content

docs: Add NOTES.txt and document the values only the schema mentioned - #753

Merged
lfrancke merged 1 commit into
mainfrom
push-yuuvxpvplorx
Aug 28, 2026
Merged

docs: Add NOTES.txt and document the values only the schema mentioned#753
lfrancke merged 1 commit into
mainfrom
push-yuuvxpvplorx

Conversation

@lfrancke

@lfrancke lfrancke commented Aug 21, 2026

Copy link
Copy Markdown
Member

Two "documentation" things:

  • A NOTEST.txt file: This is printed to stdout after every installation using helm install
  • helm show values shows the values file but not the schema. We already document some of the properties in a "commented" out fashion. This also adds the remaining ones so they are easier to discover

@lfrancke lfrancke self-assigned this Aug 21, 2026
@lfrancke lfrancke moved this to Development: Waiting for Review in Stackable Engineering Aug 21, 2026
@lfrancke
lfrancke force-pushed the push-yuuvxpvplorx branch 2 times, most recently from d937d32 to 98dc381 Compare August 21, 2026 16:30
dervoeti
dervoeti previously approved these changes Aug 27, 2026
@dervoeti dervoeti moved this from Development: Waiting for Review to Development: In Review in Stackable Engineering Aug 27, 2026
helm show values does not read values.schema.json and there is no
helm show schema, so image.repository, image.productRepository, image.tag and
priorityClassName could not be discovered from the CLI at all. They are added to
values.yaml as commented examples, the convention the file already uses.

No chart printed anything after helm install. NOTES.txt now says what was
installed and where the documentation is, explains why no CRDs appear, and warns
when maintenance.customResourceDefinitions.maintain is false, where the chart
ships no CRDs and the operator does not create them either.

Declares global in the schema. Helm injects global into every subchart's values
before validating them, even when the parent chart sets none, so
additionalProperties: false at the root made this chart fail to render inside any
umbrella chart. The chart does not read the value. Reported on
kafka-operator#1013.

nodeSelector, tolerations and affinity place the operator pod only, which the
resources description already says for sizing and these three did not say for
placement.

Corrects the serviceAccount.name comment, which described the behaviour from
before #742.
@lfrancke

Copy link
Copy Markdown
Member Author

Applied the same globals change you found in kafka

@lfrancke
lfrancke requested a review from dervoeti August 27, 2026 20:33
@lfrancke
lfrancke enabled auto-merge August 28, 2026 06:53
@lfrancke
lfrancke added this pull request to the merge queue Aug 28, 2026
@lfrancke lfrancke moved this from Development: In Review to Development: Done in Stackable Engineering Aug 28, 2026
@github-merge-queue
github-merge-queue Bot removed this pull request from the merge queue due to no response for status checks Aug 28, 2026
@lfrancke
lfrancke added this pull request to the merge queue Aug 28, 2026
Merged via the queue into main with commit 145c2c6 Aug 28, 2026
13 checks passed
@lfrancke
lfrancke deleted the push-yuuvxpvplorx branch August 28, 2026 10:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: Development: Done

Development

Successfully merging this pull request may close these issues.

2 participants