-
Notifications
You must be signed in to change notification settings - Fork 1.8k
WIP: Dummy content for a new peer reviewer to practice #63087
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
Conversation
|
Hi @xenolinux, |
|
🤖 Updated build preview is available at: 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. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
| 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. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
| * 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. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
| * The OpenShift CLI installed. | |
| * You must have the OpenShift CLI (`oc`) installed. |
| + | ||
| [source,terminal] | ||
| ---- | ||
| oc describe mcp/worker-rt |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
| oc describe mcp/worker-rt | |
| $ oc describe mcp/worker-rt |
There was a problem hiding this comment.
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.
| + | ||
| [source,terminal,subs="+quotes"] | ||
| ---- | ||
| $ oc label mcp _<mcp-name>_ _<mcp_name>_="" |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
| $ 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"] |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
| [id="cnf-about-the-profile-creator-tool"] | |
| [id="cnf-about-the-profile-creator-tool_{context}"] |
There was a problem hiding this comment.
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.
| [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. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
| 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::[] |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
| toc::[] | |
| toc::[] |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
You must have a blank line here before the toc.
| @@ -0,0 +1,23 @@ | |||
| [id="cnf-create-performance-profiles] | |||
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
| [id="cnf-create-performance-profiles] | |
| :_content-type: ASSEMBLY | |
| [id="cnf-create-performance-profiles] |
There was a problem hiding this comment.
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.
|
|
||
|
|
||
| [role="_additional-resources"] | ||
| = Additional Resources |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
| = Additional Resources | |
| [id="additional-resources_dumy-assembly"] | |
| = Additional Resources |
You must provide id for additional resources section
abhatt-rh
left a comment
There was a problem hiding this 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) | |||
|
|
|||
There was a problem hiding this comment.
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 |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
| oc describe mcp/worker-rt | |
| $ oc describe mcp/worker-rt |
| oc describe mcp/worker-rt | ||
| ---- | ||
| + | ||
| [source,bash] |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
| [source,bash] | |
| [source,terminal] |
| oc adm must-gather | ||
| ---- | ||
|
|
||
| . (Optional)- Create a compressed file from the must-gather directory: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
| . (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. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
| * Calling a wrapper script. | |
| * Calling a wrapper script |
| @@ -0,0 +1,23 @@ | |||
| [id="cnf-create-performance-profiles] | |||
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
| [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. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
| 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. |
There was a problem hiding this comment.
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 |
There was a problem hiding this comment.
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, |
There was a problem hiding this comment.
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.
b4f3abf to
8a5e823
Compare
|
/remove-label do-not-merge/work-in-progress |
|
@abhatt-rh: The label(s) In response to this:
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. |
|
/remove-label do-not-merge |
|
@abhatt-rh: The label(s) In response to this:
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: The following test failed, say
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. |
|
Issues go stale after 90d of inactivity. Mark the issue as fresh by commenting If this issue is safe to close now please do so with /lifecycle stale |
|
Stale issues rot after 30d of inactivity. Mark the issue as fresh by commenting If this issue is safe to close now please do so with /lifecycle rotten |
|
Rotten issues close after 30d of inactivity. Reopen the issue by commenting /close |
|
@openshift-bot: Closed this PR. In response to this:
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. |
Dummy content for a onboarding peer reviewer
Version: main
QE review: