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

RHDEVDOC 5980 set medatata on target namespace #75535

Merged
merged 1 commit into from May 13, 2024

Conversation

mramendi
Copy link
Contributor

@mramendi mramendi commented May 4, 2024

Version(s):

pipelines-docs-main

Issue:

RHDEVDOCS 5980

Link to docs preview:

https://75535--ocpdocs-pr.netlify.app/openshift-pipelines/latest/install_config/customizing-configurations-in-the-tektonconfig-cr.html#op-setting-annotations-labels-namespace_customizing-configurations-in-the-tektonconfig-cr

QE review:

  • QE has approved this change.

Additional information:

NOTE TO PEER/MERGE REVIEWERS: the added module uses a concept format and not a procedure format in order to preserve uniformity with other modules in the assembly. Adding a full procedure to edit the TektonConfig CR to every module would be repetitive and would also make for a very large PR. See the preview. or else https://docs.openshift.com/pipelines/1.14/install_config/customizing-configurations-in-the-tektonconfig-cr.html#op-changing-default-service-account_customizing-configurations-in-the-tektonconfig-cr in the current documentation, for several modules that immediately precede this module

@mramendi
Copy link
Contributor Author

mramendi commented May 4, 2024

@openshift-ci openshift-ci bot added the size/M Denotes a PR that changes 30-99 lines, ignoring generated files. label May 4, 2024
@ocpdocs-previewbot
Copy link

ocpdocs-previewbot commented May 4, 2024

name: config
spec:
targetNamespaceMetadata:
labels: {"example-label"}
Copy link
Member

Choose a reason for hiding this comment

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

label should be key value pair

labels: {"example-label":"example-value"}

Copy link
Member

@jkandasa jkandasa left a comment

Choose a reason for hiding this comment

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

LGTM
We have to wait till the feature PR gets merged: tektoncd/operator#2132

@mramendi
Copy link
Contributor Author

mramendi commented May 8, 2024

/label peer-review-needed

@openshift-ci openshift-ci bot added the peer-review-needed Signifies that the peer review team needs to review this PR label May 8, 2024
@xenolinux
Copy link
Contributor

/label peer-review-in-progress

@openshift-ci openshift-ci bot added the peer-review-in-progress Signifies that the peer review team is reviewing this PR label May 8, 2024
Copy link
Contributor

@xenolinux xenolinux left a comment

Choose a reason for hiding this comment

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

I left some suggestions to consider, otherwise LGTM

Gentle reminder to squash commits and update the QE approval check box.

/remove-label peer-review-needed
/remove-label peer-review-in-progress
/label peer-review-done

Comment on lines +25 to +27
targetNamespaceMetadata:
labels: {"example-label":"example-value"}
annotations: {"example-annotation":"example-value"}
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
targetNamespaceMetadata:
labels: {"example-label":"example-value"}
annotations: {"example-annotation":"example-value"}
targetNamespaceMetadata:
labels: {"<label_name>":"<label_value>"}
annotations: {"<anotation_name>":"<anotation_value>"}

Copy link
Contributor

Choose a reason for hiding this comment

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

https://redhat-documentation.github.io/supplementary-style-guide/#user-replaced-values

Surrounded by angle brackets (< >)
Separated by underscores (_) for multi-word values

Copy link
Contributor Author

Choose a reason for hiding this comment

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

@xenolinux this would be a syntax definition while what I have is an example. The reason I went for an example is because the surrounding similar modules are examples. For example (yeah), https://75535--ocpdocs-pr.netlify.app/openshift-pipelines/latest/install_config/customizing-configurations-in-the-tektonconfig-cr.html#op-changing-default-service-account_customizing-configurations-in-the-tektonconfig-cr has "stable", not "<api_fields_level>"

Copy link
Contributor

Choose a reason for hiding this comment

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

After looking at other sections, I agree with you. +1 to keep consistency with other sections.

modules/op-setting-annotations-labels-namespace.adoc Outdated Show resolved Hide resolved

To set the labels and annotations, use the `spec.targetNamespaceMetadata` specification in the `TektonConfig` custom resource (CR).

.Example of setting labels and annotations for the `openshift-pipelines` namespace
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
.Example of setting labels and annotations for the `openshift-pipelines` namespace
.Example `TektonConfig` CR

IMO, this can be kept short because heading and description already indicate users about setting labels and annotations.
Up to you though!

Copy link
Contributor Author

Choose a reason for hiding this comment

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

There are many examples of this same CR in this module, so I do want to keep this more specific

Copy link
Contributor

Choose a reason for hiding this comment

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

Okay sounds good.

modules/op-setting-annotations-labels-namespace.adoc Outdated Show resolved Hide resolved
modules/op-setting-annotations-labels-namespace.adoc Outdated Show resolved Hide resolved
@openshift-ci openshift-ci bot added peer-review-done Signifies that the peer review team has reviewed this PR and removed peer-review-needed Signifies that the peer review team needs to review this PR peer-review-in-progress Signifies that the peer review team is reviewing this PR labels May 8, 2024
@mramendi
Copy link
Contributor Author

/label merge-review-needed

@openshift-ci openshift-ci bot added the merge-review-needed Signifies that the merge review team needs to review this PR label May 13, 2024
Copy link

openshift-ci bot commented May 13, 2024

@mramendi: all tests passed!

Full PR test history. Your PR dashboard.

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository. I understand the commands that are listed here.

@ShaunaDiaz ShaunaDiaz added this to the Continuous Release milestone May 13, 2024
@ShaunaDiaz
Copy link
Contributor

/remove-label merge-review-needed

@ShaunaDiaz ShaunaDiaz merged commit 89d4c66 into openshift:pipelines-docs-main May 13, 2024
3 checks passed
@openshift-ci openshift-ci bot removed the merge-review-needed Signifies that the merge review team needs to review this PR label May 13, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
peer-review-done Signifies that the peer review team has reviewed this PR pipelines size/M Denotes a PR that changes 30-99 lines, ignoring generated files.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

6 participants