Skip to content

Conversation

@abhatt-rh
Copy link
Contributor

@abhatt-rh abhatt-rh commented Aug 2, 2023

Dummy content for a onboarding peer reviewer

Version: main

QE review:

  • QE has approved this change.

@openshift-ci openshift-ci bot added do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. size/M Denotes a PR that changes 30-99 lines, ignoring generated files. labels Aug 2, 2023
@abhatt-rh
Copy link
Contributor Author

Hi @xenolinux,
Requesting your review for this PR :)

@ocpdocs-previewbot
Copy link

ocpdocs-previewbot commented Aug 2, 2023

🤖 Updated build preview is available at:
https://63087--docspreview.netlify.app

Build log: https://circleci.com/gh/ocpdocs-previewbot/openshift-docs/28570

[id="gathering-data-about-your-cluster-using-must-gather_{context}"]
= Gathering data about your cluster using the must-gather command

The Performance Profile Creator (PPC) tool requires `must-gather` data. As a cluster administrator, run the must-gather command to capture information about your cluster.
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
The Performance Profile Creator (PPC) tool requires `must-gather` data. As a cluster administrator, run the must-gather command to capture information about your cluster.
The Performance Profile Creator (PPC) tool requires the `must-gather` data. As a cluster administrator, run the `must-gather` command to capture information about your {product-title} cluster.


.Prerequisites

* Access to the cluster as a user with the `cluster-admin` role.
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
* Access to the cluster as a user with the `cluster-admin` role.
* You must have access to a {product-title} cluster as a user with the `cluster-admin` role.

.Prerequisites

* Access to the cluster as a user with the `cluster-admin` role.
* The OpenShift CLI installed.
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
* The OpenShift CLI installed.
* You must have the OpenShift CLI (`oc`) installed.

+
[source,terminal]
----
oc describe mcp/worker-rt
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
oc describe mcp/worker-rt
$ oc describe mcp/worker-rt

Copy link
Contributor

Choose a reason for hiding this comment

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

At the start of the command, the $ sign must be used if a command is being run by a user instead of a root.

https://github.com/openshift/openshift-docs/blob/main/contributing_to_docs/doc_guidelines.adoc#code-blocks-command-syntax-and-example-output

+
[source,terminal,subs="+quotes"]
----
$ oc label mcp _<mcp-name>_ _<mcp_name>_=""
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
$ oc label mcp _<mcp-name>_ _<mcp_name>_=""
$ oc label mcp <mcp_name> <mcp_name>=""

// * scalability_and_performance/cnf-create-performance-profiles.adoc

:_content-type: CONCEPT
[id="cnf-about-the-profile-creator-tool"]
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
[id="cnf-about-the-profile-creator-tool"]
[id="cnf-about-the-profile-creator-tool_{context}"]

Copy link
Contributor

Choose a reason for hiding this comment

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

{context} is missing
Context used for identifying headers in modules that is the same as the anchor ID. Example: cli-developer-commands.

https://github.com/openshift/openshift-docs/blob/main/contributing_to_docs/doc_guidelines.adoc#assembly-file-metadata

[id="cnf-about-the-profile-creator-tool"]
= About the Performance Profile Creator

The PPC is a command-line tool, delivered with the Node Tuning Operator, used to create the performance profile.
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
The PPC is a command-line tool, delivered with the Node Tuning Operator, used to create the performance profile.
The Performance Profile Creator (PPC) is a command-line tool, delivered with the Node Tuning Operator (NTO), used to create the performance profile.

= Creating a performance profile
include::_attributes/common-attributes.adoc[]
:context: cnf-create-performance-profiles
toc::[]
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
toc::[]
toc::[]

Copy link
Contributor

Choose a reason for hiding this comment

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

@@ -0,0 +1,23 @@
[id="cnf-create-performance-profiles]
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
[id="cnf-create-performance-profiles]
:_content-type: ASSEMBLY
[id="cnf-create-performance-profiles]

Copy link
Contributor

Choose a reason for hiding this comment

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

The content type for the file. Replace with the actual type of the module, CONCEPT, REFERENCE, or PROCEDURE. Place this attribute before the anchor ID or, if present, the conditional that contains the anchor ID.

https://github.com/openshift/openshift-docs/blob/main/contributing_to_docs/doc_guidelines.adoc#module-file-metadata



[role="_additional-resources"]
= Additional Resources
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
= Additional Resources
[id="additional-resources_dumy-assembly"]
= Additional Resources

https://github.com/openshift/openshift-docs/blob/main/contributing_to_docs/doc_guidelines.adoc#additional-resources-sections

You must provide id for additional resources section

Copy link
Contributor Author

@abhatt-rh abhatt-rh left a comment

Choose a reason for hiding this comment

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

Added follow-up comments

@@ -0,0 +1,57 @@
// Module included in the following assemblies:
// Epic CNF-792 (4.8)

Copy link
Contributor Author

Choose a reason for hiding this comment

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

add a comment about the assembly where this module is used

+
[source,terminal]
----
oc describe mcp/worker-rt
Copy link
Contributor Author

Choose a reason for hiding this comment

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

Suggested change
oc describe mcp/worker-rt
$ oc describe mcp/worker-rt

oc describe mcp/worker-rt
----
+
[source,bash]
Copy link
Contributor Author

Choose a reason for hiding this comment

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

Suggested change
[source,bash]
[source,terminal]

oc adm must-gather
----

. (Optional)- Create a compressed file from the must-gather directory:
Copy link
Contributor Author

Choose a reason for hiding this comment

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

Suggested change
. (Optional)- Create a compressed file from the must-gather directory:
. Optional: Create a compressed file from the must-gather directory:


* Invoking `podman`.

* Calling a wrapper script.
Copy link
Contributor Author

Choose a reason for hiding this comment

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

Suggested change
* Calling a wrapper script.
* Calling a wrapper script

@@ -0,0 +1,23 @@
[id="cnf-create-performance-profiles]
Copy link
Contributor Author

Choose a reason for hiding this comment

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

Suggested change
[id="cnf-create-performance-profiles]
[id="cnf-create-performance-profiles"]

ID is missing closing quote

:context: cnf-create-performance-profiles
toc::[]

Learn about the PPC and how you can use it to create a performance profile.
Copy link
Contributor Author

Choose a reason for hiding this comment

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

Suggested change
Learn about the PPC and how you can use it to create a performance profile.
Learn about the Performance Profile Creator (PPC) and how you can use it to create a performance profile.

Expand on first use

[NOTE]
====
Currently, disabling CPU load balancing is not supported by cgroup v2. As a result,
you might not get the desired behavior from performance profiles if you have cgroup v2 enabeld. Enabling cgroup v2 is not recommended if you are using performace profiles.
Copy link
Contributor Author

Choose a reason for hiding this comment

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

remove hard wrapping



[role="_additional-resources"]
= Additional Resources
Copy link
Contributor Author

Choose a reason for hiding this comment

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

use h2. each module should have only a single h1


[role="_additional-resources"]
= Additional Resources
* For more information about the `must-gather` tool,
Copy link
Contributor Author

Choose a reason for hiding this comment

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

Remove hard wrapping and see OCP doc guidelines for https://github.com/openshift/openshift-docs/blob/main/contributing_to_docs/doc_guidelines.adoc#additional-resources-sections

You must not include paragraphs in the section. Use an unordered list.

@abhatt-rh abhatt-rh assigned abhatt-rh and unassigned abhatt-rh Oct 6, 2023
@abhatt-rh abhatt-rh closed this Oct 18, 2023
@abhatt-rh abhatt-rh reopened this Oct 18, 2023
@abhatt-rh abhatt-rh force-pushed the dummy-pr branch 3 times, most recently from b4f3abf to 8a5e823 Compare October 18, 2023 11:24
@abhatt-rh abhatt-rh removed the do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. label Oct 18, 2023
@openshift-ci openshift-ci bot added size/L Denotes a PR that changes 100-499 lines, ignoring generated files. and removed size/M Denotes a PR that changes 30-99 lines, ignoring generated files. labels Oct 18, 2023
@abhatt-rh abhatt-rh added the do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. label Oct 18, 2023
@abhatt-rh
Copy link
Contributor Author

/remove-label do-not-merge/work-in-progress

@openshift-ci
Copy link

openshift-ci bot commented Oct 19, 2023

@abhatt-rh: The label(s) /remove-label do-not-merge/work-in-progress cannot be applied. These labels are supported: acknowledge-critical-fixes-only, platform/aws, platform/azure, platform/baremetal, platform/google, platform/libvirt, platform/openstack, ga, tide/merge-method-merge, tide/merge-method-rebase, tide/merge-method-squash, px-approved, docs-approved, qe-approved, downstream-change-needed, rebase/manual, approved, backport-risk-assessed, bugzilla/valid-bug, cherry-pick-approved, cloud-experts, cnv, dev-tools, distributed-tracing, ims, jira/valid-bug, merge-review-in-progress, merge-review-needed, mtc, multi-arch, oadp, peer-review-done, peer-review-in-progress, peer-review-needed, rhacs, rhv, sd-docs, serverless, service-mesh, sme-review-done, sme-review-needed, staff-eng-approved, telco. Is this label configured under labels -> additional_labels or labels -> restricted_labels in plugin.yaml?

In response to this:

/remove-label do-not-merge/work-in-progress

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/test-infra repository.

@abhatt-rh
Copy link
Contributor Author

/remove-label do-not-merge

@openshift-ci
Copy link

openshift-ci bot commented Oct 19, 2023

@abhatt-rh: The label(s) /remove-label do-not-merge cannot be applied. These labels are supported: acknowledge-critical-fixes-only, platform/aws, platform/azure, platform/baremetal, platform/google, platform/libvirt, platform/openstack, ga, tide/merge-method-merge, tide/merge-method-rebase, tide/merge-method-squash, px-approved, docs-approved, qe-approved, downstream-change-needed, rebase/manual, approved, backport-risk-assessed, bugzilla/valid-bug, cherry-pick-approved, cloud-experts, cnv, dev-tools, distributed-tracing, ims, jira/valid-bug, merge-review-in-progress, merge-review-needed, mtc, multi-arch, oadp, peer-review-done, peer-review-in-progress, peer-review-needed, rhacs, rhv, sd-docs, serverless, service-mesh, sme-review-done, sme-review-needed, staff-eng-approved, telco. Is this label configured under labels -> additional_labels or labels -> restricted_labels in plugin.yaml?

In response to this:

/remove-label do-not-merge

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/test-infra repository.

@openshift-ci
Copy link

openshift-ci bot commented Jan 9, 2024

@abhatt-rh: The following test failed, say /retest to rerun all failed tests or /retest-required to rerun all mandatory failed tests:

Test name Commit Details Required Rerun command
ci/prow/validate-asciidoc cc0fce0 link true /test validate-asciidoc

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/test-infra repository. I understand the commands that are listed here.

@openshift-bot
Copy link

Issues go stale after 90d of inactivity.

Mark the issue as fresh by commenting /remove-lifecycle stale.
Stale issues rot after an additional 30d of inactivity and eventually close.
Exclude this issue from closing by commenting /lifecycle frozen.

If this issue is safe to close now please do so with /close.

/lifecycle stale

@openshift-ci openshift-ci bot added the lifecycle/stale Denotes an issue or PR has remained open with no activity and has become stale. label Apr 10, 2024
@openshift-bot
Copy link

Stale issues rot after 30d of inactivity.

Mark the issue as fresh by commenting /remove-lifecycle rotten.
Rotten issues close after an additional 30d of inactivity.
Exclude this issue from closing by commenting /lifecycle frozen.

If this issue is safe to close now please do so with /close.

/lifecycle rotten
/remove-lifecycle stale

@openshift-ci openshift-ci bot added lifecycle/rotten Denotes an issue or PR that has aged beyond stale and will be auto-closed. and removed lifecycle/stale Denotes an issue or PR has remained open with no activity and has become stale. labels May 10, 2024
@openshift-bot
Copy link

Rotten issues close after 30d of inactivity.

Reopen the issue by commenting /reopen.
Mark the issue as fresh by commenting /remove-lifecycle rotten.
Exclude this issue from closing again by commenting /lifecycle frozen.

/close

@openshift-ci openshift-ci bot closed this Jun 10, 2024
@openshift-ci
Copy link

openshift-ci bot commented Jun 10, 2024

@openshift-bot: Closed this PR.

In response to this:

Rotten issues close after 30d of inactivity.

Reopen the issue by commenting /reopen.
Mark the issue as fresh by commenting /remove-lifecycle rotten.
Exclude this issue from closing again by commenting /lifecycle frozen.

/close

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.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. lifecycle/rotten Denotes an issue or PR that has aged beyond stale and will be auto-closed. size/L Denotes a PR that changes 100-499 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants