openshift-docs icon indicating copy to clipboard operation
openshift-docs copied to clipboard

TELCODOCS-1932: Implement peer review feedback post-GA

Open amolnar-gh opened this issue 1 year ago • 10 comments

Version(s): 4.16, 4.17

Issue: https://issues.redhat.com/browse/TELCODOCS-1932

Link to docs preview:

  • https://78320--ocpdocs-pr.netlify.app/openshift-enterprise/latest/edge_computing/image_based_upgrade/cnf-image-based-upgrade-base.html
  • https://78320--ocpdocs-pr.netlify.app/openshift-enterprise/latest/edge_computing/image_based_upgrade/cnf-understanding-image-based-upgrade.html
  • https://78320--ocpdocs-pr.netlify.app/openshift-enterprise/latest/edge_computing/image_based_upgrade/preparing_for_image_based_upgrade/cnf-image-based-upgrade-generate-seed.html
  • https://78320--ocpdocs-pr.netlify.app/openshift-enterprise/latest/edge_computing/image_based_upgrade/preparing_for_image_based_upgrade/cnf-image-based-upgrade-install-operators.html
  • https://78320--ocpdocs-pr.netlify.app/openshift-enterprise/latest/edge_computing/image_based_upgrade/preparing_for_image_based_upgrade/cnf-image-based-upgrade-prep-resources.html
  • https://78320--ocpdocs-pr.netlify.app/openshift-enterprise/latest/edge_computing/image_based_upgrade/preparing_for_image_based_upgrade/cnf-image-based-upgrade-shared-container-partition.html
  • https://78320--ocpdocs-pr.netlify.app/openshift-enterprise/latest/edge_computing/image_based_upgrade/preparing_for_image_based_upgrade/ztp-image-based-upgrade-prep-resources.html
  • https://78320--ocpdocs-pr.netlify.app/openshift-enterprise/latest/edge_computing/image_based_upgrade/ztp-image-based-upgrade.html

QE review:

  • [ ] QE has approved this change.

Additional information: There were quite a few peer review suggestions throughout the 10 PRs that apply to the whole IBU content. I aim to address all these issues post-GA:

  • Remove Optional in titles
  • Match section ID with file name
  • Fix consistency of titles in xrefs
  • Use common attributes in titles and xref titles
  • Fix cnf vs ztp in IDs
  • Remove FeatureName as it's not needed for GA feature
  • Update image titles
  • Use double quotes instead of underscores for references titles

amolnar-gh avatar Jul 01 '24 15:07 amolnar-gh

🤖 Wed Jul 10 09:04:46 - Prow CI generated the docs preview:

https://78320--ocpdocs-pr.netlify.app/ https://78320--ocpdocs-pr.netlify.app/openshift-enterprise/latest/edge_computing/image_based_upgrade/cnf-image-based-upgrade-base.html https://78320--ocpdocs-pr.netlify.app/openshift-enterprise/latest/edge_computing/image_based_upgrade/cnf-understanding-image-based-upgrade.html https://78320--ocpdocs-pr.netlify.app/openshift-enterprise/latest/edge_computing/image_based_upgrade/preparing_for_image_based_upgrade/cnf-image-based-upgrade-generate-seed.html https://78320--ocpdocs-pr.netlify.app/openshift-enterprise/latest/edge_computing/image_based_upgrade/preparing_for_image_based_upgrade/cnf-image-based-upgrade-install-operators.html https://78320--ocpdocs-pr.netlify.app/openshift-enterprise/latest/edge_computing/image_based_upgrade/preparing_for_image_based_upgrade/cnf-image-based-upgrade-prep-resources.html https://78320--ocpdocs-pr.netlify.app/openshift-enterprise/latest/edge_computing/image_based_upgrade/preparing_for_image_based_upgrade/cnf-image-based-upgrade-shared-container-partition.html https://78320--ocpdocs-pr.netlify.app/openshift-enterprise/latest/edge_computing/image_based_upgrade/preparing_for_image_based_upgrade/ztp-image-based-upgrade-prep-resources.html https://78320--ocpdocs-pr.netlify.app/openshift-enterprise/latest/edge_computing/image_based_upgrade/ztp-image-based-upgrade.html

ocpdocs-previewbot avatar Jul 01 '24 15:07 ocpdocs-previewbot

@amolnar-rh: This pull request references TELCODOCS-1707 which is a valid jira issue.

Warning: The referenced jira issue has an invalid target version for the target branch this PR targets: expected the story to target the "4.17.0" version, but no target version was set.

In response to this:

Version(s): 4.16, 4.17

Issue:

Link to docs preview:

  • https://78320--ocpdocs-pr.netlify.app/openshift-enterprise/latest/edge_computing/image_based_upgrade/cnf-image-based-upgrade-base.html
  • https://78320--ocpdocs-pr.netlify.app/openshift-enterprise/latest/edge_computing/image_based_upgrade/cnf-understanding-image-based-upgrade.html
  • https://78320--ocpdocs-pr.netlify.app/openshift-enterprise/latest/edge_computing/image_based_upgrade/preparing_for_image_based_upgrade/cnf-image-based-upgrade-generate-seed.html
  • https://78320--ocpdocs-pr.netlify.app/openshift-enterprise/latest/edge_computing/image_based_upgrade/preparing_for_image_based_upgrade/cnf-image-based-upgrade-install-operators.html
  • https://78320--ocpdocs-pr.netlify.app/openshift-enterprise/latest/edge_computing/image_based_upgrade/preparing_for_image_based_upgrade/cnf-image-based-upgrade-prep-resources.html
  • https://78320--ocpdocs-pr.netlify.app/openshift-enterprise/latest/edge_computing/image_based_upgrade/preparing_for_image_based_upgrade/cnf-image-based-upgrade-shared-container-partition.html
  • https://78320--ocpdocs-pr.netlify.app/openshift-enterprise/latest/edge_computing/image_based_upgrade/preparing_for_image_based_upgrade/ztp-image-based-upgrade-prep-resources.html
  • https://78320--ocpdocs-pr.netlify.app/openshift-enterprise/latest/edge_computing/image_based_upgrade/ztp-image-based-upgrade.html

QE review:

  • [ ] QE has approved this change.

Additional information: There were quite a few peer review suggestions throughout the 10 PRs that apply to the whole IBU content. I aim to address all these issues post-GA:

  • Remove Optional in titles
  • Match section ID with file name
  • Fix consistency of titles in xrefs
  • Use common attributes in titles and xref titles
  • Fix cnf vs ztp in IDs
  • Remove FeatureName as it's not needed for GA feature

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 openshift-eng/jira-lifecycle-plugin repository.

openshift-ci-robot avatar Jul 01 '24 15:07 openshift-ci-robot

@amolnar-rh: This pull request references TELCODOCS-1707 which is a valid jira issue.

Warning: The referenced jira issue has an invalid target version for the target branch this PR targets: expected the story to target the "4.17.0" version, but no target version was set.

In response to this:

Version(s): 4.16, 4.17

Issue:

Link to docs preview:

  • https://78320--ocpdocs-pr.netlify.app/openshift-enterprise/latest/edge_computing/image_based_upgrade/cnf-image-based-upgrade-base.html
  • https://78320--ocpdocs-pr.netlify.app/openshift-enterprise/latest/edge_computing/image_based_upgrade/cnf-understanding-image-based-upgrade.html
  • https://78320--ocpdocs-pr.netlify.app/openshift-enterprise/latest/edge_computing/image_based_upgrade/preparing_for_image_based_upgrade/cnf-image-based-upgrade-generate-seed.html
  • https://78320--ocpdocs-pr.netlify.app/openshift-enterprise/latest/edge_computing/image_based_upgrade/preparing_for_image_based_upgrade/cnf-image-based-upgrade-install-operators.html
  • https://78320--ocpdocs-pr.netlify.app/openshift-enterprise/latest/edge_computing/image_based_upgrade/preparing_for_image_based_upgrade/cnf-image-based-upgrade-prep-resources.html
  • https://78320--ocpdocs-pr.netlify.app/openshift-enterprise/latest/edge_computing/image_based_upgrade/preparing_for_image_based_upgrade/cnf-image-based-upgrade-shared-container-partition.html
  • https://78320--ocpdocs-pr.netlify.app/openshift-enterprise/latest/edge_computing/image_based_upgrade/preparing_for_image_based_upgrade/ztp-image-based-upgrade-prep-resources.html
  • https://78320--ocpdocs-pr.netlify.app/openshift-enterprise/latest/edge_computing/image_based_upgrade/ztp-image-based-upgrade.html

QE review:

  • [ ] QE has approved this change.

Additional information: There were quite a few peer review suggestions throughout the 10 PRs that apply to the whole IBU content. I aim to address all these issues post-GA:

  • Remove Optional in titles
  • Match section ID with file name
  • Fix consistency of titles in xrefs
  • Use common attributes in titles and xref titles
  • Fix cnf vs ztp in IDs
  • Remove FeatureName as it's not needed for GA feature
  • Update image titles
  • Use double quotes instead of underscores for references titles

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 openshift-eng/jira-lifecycle-plugin repository.

openshift-ci-robot avatar Jul 01 '24 16:07 openshift-ci-robot

/test validate-asciidoc

amolnar-gh avatar Jul 03 '24 08:07 amolnar-gh

/label peer-review-needed

amolnar-gh avatar Jul 03 '24 14:07 amolnar-gh

Hi @amolnar-rh . The build has failed. Maybe drop the images path for 696_OpenShift_Lifecycle_Agent_0624_0.png ? A symlink might already exist.

dfitzmau avatar Jul 03 '24 16:07 dfitzmau

@amolnar-rh: This pull request references TELCODOCS-1932 which is a valid jira issue.

Warning: The referenced jira issue has an invalid target version for the target branch this PR targets: expected the bug to target the "4.17.0" version, but no target version was set.

In response to this:

Version(s): 4.16, 4.17

Issue:

Link to docs preview:

  • https://78320--ocpdocs-pr.netlify.app/openshift-enterprise/latest/edge_computing/image_based_upgrade/cnf-image-based-upgrade-base.html
  • https://78320--ocpdocs-pr.netlify.app/openshift-enterprise/latest/edge_computing/image_based_upgrade/cnf-understanding-image-based-upgrade.html
  • https://78320--ocpdocs-pr.netlify.app/openshift-enterprise/latest/edge_computing/image_based_upgrade/preparing_for_image_based_upgrade/cnf-image-based-upgrade-generate-seed.html
  • https://78320--ocpdocs-pr.netlify.app/openshift-enterprise/latest/edge_computing/image_based_upgrade/preparing_for_image_based_upgrade/cnf-image-based-upgrade-install-operators.html
  • https://78320--ocpdocs-pr.netlify.app/openshift-enterprise/latest/edge_computing/image_based_upgrade/preparing_for_image_based_upgrade/cnf-image-based-upgrade-prep-resources.html
  • https://78320--ocpdocs-pr.netlify.app/openshift-enterprise/latest/edge_computing/image_based_upgrade/preparing_for_image_based_upgrade/cnf-image-based-upgrade-shared-container-partition.html
  • https://78320--ocpdocs-pr.netlify.app/openshift-enterprise/latest/edge_computing/image_based_upgrade/preparing_for_image_based_upgrade/ztp-image-based-upgrade-prep-resources.html
  • https://78320--ocpdocs-pr.netlify.app/openshift-enterprise/latest/edge_computing/image_based_upgrade/ztp-image-based-upgrade.html

QE review:

  • [ ] QE has approved this change.

Additional information: There were quite a few peer review suggestions throughout the 10 PRs that apply to the whole IBU content. I aim to address all these issues post-GA:

  • Remove Optional in titles
  • Match section ID with file name
  • Fix consistency of titles in xrefs
  • Use common attributes in titles and xref titles
  • Fix cnf vs ztp in IDs
  • Remove FeatureName as it's not needed for GA feature
  • Update image titles
  • Use double quotes instead of underscores for references titles

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 openshift-eng/jira-lifecycle-plugin repository.

openshift-ci-robot avatar Jul 04 '24 10:07 openshift-ci-robot

Hi @amolnar-rh . Please let me know when you want me to continue with the review. Build passed. Congrats!

dfitzmau avatar Jul 04 '24 15:07 dfitzmau

@dfitzmau Please go ahead with the review! :)

amolnar-gh avatar Jul 05 '24 06:07 amolnar-gh

/label merge-review-needed

amolnar-gh avatar Jul 09 '24 14:07 amolnar-gh

@amolnar-rh: 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.

openshift-ci[bot] avatar Jul 10 '24 09:07 openshift-ci[bot]

Everything LGTM, merging now

skopacz1 avatar Jul 10 '24 13:07 skopacz1

/cherrypick enterprise-4.16

skopacz1 avatar Jul 10 '24 13:07 skopacz1

/cherrypick enterprise-4.17

skopacz1 avatar Jul 10 '24 13:07 skopacz1

@skopacz1: new pull request created: #78724

In response to this:

/cherrypick enterprise-4.16

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.

@skopacz1: new pull request created: #78725

In response to this:

/cherrypick enterprise-4.17

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.