Skip to content

Update README instructions#18869

Merged
nataliasitko merged 7 commits intomainfrom
table-gen-update
Feb 24, 2026
Merged

Update README instructions#18869
nataliasitko merged 7 commits intomainfrom
table-gen-update

Conversation

@nataliasitko
Copy link
Copy Markdown
Contributor

@nataliasitko nataliasitko commented Feb 2, 2026

Description

Changes proposed in this pull request:

  • Update instructions on how to generate CRD tables

Related issue(s)

@nataliasitko nataliasitko requested review from a team and k15r as code owners February 2, 2026 08:14
Comment thread hack/table-gen/README.md Outdated
Comment thread hack/table-gen/README.md Outdated
Co-authored-by: Małgorzata Świeca <malgorzata.swieca@sap.com>
Comment thread hack/table-gen/README.md Outdated
Comment thread hack/table-gen/README.md Outdated
```
```makefile
.PHONY: crd-docs-gen
crd-docs-gen: $(TABLE_GEN) manifests
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

TABLE_GEN is an alias for the actual binary to call. That is specific to the makefile where you copied it from. If you are using make, you still need to build the binary somewhere and then call it here. Maybe put a sentence upfront that assumes that you builded the tool with a binary name "table-gen" and then use that name instead.
Also the "manifests" pre-condition you should remove as it is specific

Comment thread hack/table-gen/README.md Outdated

```
<!-- TABLE-START -->
2. Add a new target to your module's Makefile with the table generator commands:
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I prefer to switch the 2. with the 3. step, sounds more reasonable to me

Comment thread hack/table-gen/README.md Outdated
Comment thread hack/table-gen/README.md Outdated
Comment thread hack/table-gen/README.md Outdated
- **--crd-filename**: Path to the CRD YAML file
- **--md-filename**: Path to the Markdown file where the table will be inserted

You can create different labels, group them under one, and add your target to the `generate` command. For a complete example, see the [Telemetry module's Makefile](https://github.com/kyma-project/telemetry-manager/blob/main/Makefile#L185).
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There is no "label" concept in makefiles and "grouping". Let's maybe drop this and just refer to the example for a complete example.

nataliasitko and others added 2 commits February 24, 2026 09:03
Co-authored-by: Andreas Thaler <andreas.thaler01@sap.com>
Removed redundant text about creating labels in the README.
@nataliasitko nataliasitko merged commit ad49f21 into main Feb 24, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants