Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add CRD pattern docs for each group #3147

Merged
merged 4 commits into from
Jul 19, 2023
Merged

Conversation

theunrepentantgeek
Copy link
Member

What this PR does / why we need it:

Adds detail for each group identifying the CRD pattern parameter required for installation of those resources.

Partially addresses #3142

Special notes for your reviewer:

Implemented by adding a new documentation fragment to show for each group, and by modifying the handling for all fragments to treat them as templates, allowing substitution of values.

How does this PR make you feel:
gif

If applicable:

  • this PR contains documentation

@theunrepentantgeek theunrepentantgeek self-assigned this Jul 19, 2023
@theunrepentantgeek theunrepentantgeek added this to the v2.3.0 milestone Jul 19, 2023
@theunrepentantgeek theunrepentantgeek force-pushed the feature/crd-pattern-docs branch from 2e48fb7 to 2900354 Compare July 19, 2023 04:38
@theunrepentantgeek theunrepentantgeek changed the title Feature/crd pattern docs Add CRD pattern docs for each group Jul 19, 2023
Copy link
Collaborator

@super-harsh super-harsh left a comment

Choose a reason for hiding this comment

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

LGTM! Although, I'm not sure how many users would know where to find this pattern during installation. A suggestion is to add a Note on crd management doc page on how and where to find the group pattern.

@theunrepentantgeek
Copy link
Member Author

I hope that users will spot the additional docs as they skim the list of supported resources, and then they'll know to loop back and update their installation. Adding more information to the CRD management page is also a good idea, I'll add that to my list.

@theunrepentantgeek theunrepentantgeek force-pushed the feature/crd-pattern-docs branch from 2900354 to 8899ac5 Compare July 19, 2023 06:01
@codecov-commenter
Copy link

Codecov Report

Merging #3147 (8899ac5) into main (e748005) will increase coverage by 0.00%.
The diff coverage is 48.38%.

@@           Coverage Diff           @@
##             main    #3147   +/-   ##
=======================================
  Coverage   54.19%   54.19%           
=======================================
  Files        1419     1419           
  Lines      608072   608092   +20     
=======================================
+ Hits       329522   329554   +32     
+ Misses     224549   224546    -3     
+ Partials    54001    53992    -9     
Impacted Files Coverage Δ
...ernal/codegen/pipeline/report_resource_versions.go 51.04% <48.38%> (-0.62%) ⬇️

... and 32 files with indirect coverage changes

@theunrepentantgeek theunrepentantgeek merged commit 0eb6054 into main Jul 19, 2023
@theunrepentantgeek theunrepentantgeek deleted the feature/crd-pattern-docs branch July 19, 2023 06:37
@matthchr matthchr modified the milestones: v2.4.0, v2.3.0 Jul 24, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
Development

Successfully merging this pull request may close these issues.

4 participants