Skip to content

Conversation

prithvipatil97
Copy link
Contributor

@prithvipatil97 prithvipatil97 commented Feb 3, 2025

Version(s):

RHOCP-4.18, RHOCP-4.17, RHOCP-4.16, RHOCP-4.15, RHOCP-4.14

Issue:

https://issues.redhat.com/browse/OBSDOCS-1346

Link to docs preview:

https://87992--ocpdocs-pr.netlify.app/openshift-enterprise/latest/observability/logging/logging-6.1/log6x-about-6.1.html

QE review:

  • QE has approved this change.

Additional information:

- Here is the link:  https://docs.openshift.com/container-platform/4.16/observability/logging/logging-6.1/log6x-about-6.1.html#quick-start-viaq_{context}

- Problems:
  - Prerequisites are missing.
  - Operators names are not highlighted.

- We are performing the following changes through this PR:
  - Added required Prerequisites.
  - Highlighted the Operator's names in Step 1.
@openshift-ci openshift-ci bot added the size/XS Denotes a PR that changes 0-9 lines, ignoring generated files. label Feb 3, 2025
@ocpdocs-previewbot
Copy link

* Cluster administrator permissions
* You have administrator permissions.
* You installed the OpenShift CLI (oc).
* You have access to a supported object store. For example: AWS S3, Google Cloud Storage, Azure, Swift, Minio, or OpenShift Data Foundation.
Copy link
Collaborator

Choose a reason for hiding this comment

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

🤖 [error] OpenShiftAsciiDoc.SuggestAttribute: Use the AsciiDoc attribute '{rh-storage}' rather than the plain text product term 'OpenShift Data Foundation', unless your use case is an exception.

Copy link

openshift-ci bot commented Feb 3, 2025

@prithvipatil97: 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.

@prithvipatil97
Copy link
Contributor Author

/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 Feb 3, 2025
@eromanova97
Copy link
Contributor

/remove-label peer-review-needed

/label peer-review-in-progress

@openshift-ci openshift-ci bot added peer-review-in-progress Signifies that the peer review team is reviewing this PR and removed peer-review-needed Signifies that the peer review team needs to review this PR labels Feb 4, 2025
Copy link
Contributor

@eromanova97 eromanova97 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 minor comments, otherwise looks good to me!

However, as I am new to peer review squad, please wait for @dfitzmau to review again and for the peer-review-done label before proceeding. Thank you!

.Prerequisites
* Cluster administrator permissions
* You have administrator permissions.
* You installed the OpenShift CLI (oc).
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
* You installed the OpenShift CLI (oc).
* You installed the {oc-first}.

We can use an attribute here.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Hello @eromanova97 ,
Thanks for your attention here in peer review.
I understand your point.

I apologize for the inconvenience caused.
I understand the suggested changes; I will try to commit these changes.

Thank you again,

Regard,
Prithviraj Patil

* Cluster administrator permissions
* You have administrator permissions.
* You installed the OpenShift CLI (oc).
* You have access to a supported object store. For example: AWS S3, Google Cloud Storage, Azure, Swift, Minio, or OpenShift Data Foundation.
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
* You have access to a supported object store. For example: AWS S3, Google Cloud Storage, Azure, Swift, Minio, or OpenShift Data Foundation.
* You have access to a supported object store. For example, AWS S3, Google Cloud Storage, {azure-short}, Swift, Minio, or {rh-storage}.

We can use attributes here.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Hello @eromanova97 ,
Thanks for your attention here in peer review.
I understand your point.
But I have taken this point from our standard RedHat Documentation.

https://docs.openshift.com/container-platform/4.16/observability/logging/cluster-logging-deploying.html#logging-loki-cli-install_cluster-logging-deploying

I apologize for the inconvenience caused.
I understand the suggested changes; I will try to commit these changes.

Thank you again,

Regard,
Prithviraj Patil

To use the default ViaQ data model, follow these steps:

.Prerequisites
* Cluster administrator permissions
Copy link
Contributor

Choose a reason for hiding this comment

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

One out of scope comment: I noticed that another chapter in this assembly, "Quick start with OpenTelemetry", has the same prerequisite: "Cluster administrator permissions" so it would be great to also change that to: "You have administrator permissions." for consistency, plus check if any prerequisites are missing there too.

However, I saw that there is more than one PR similar to this, so this might already be addressed elsewere, I just wanted to point that out just in case 👍

@dfitzmau
Copy link
Contributor

dfitzmau commented Feb 4, 2025

Excellent review, @eromanova97 . Thank you!

@dfitzmau dfitzmau added peer-review-done Signifies that the peer review team has reviewed this PR and removed peer-review-in-progress Signifies that the peer review team is reviewing this PR labels Feb 4, 2025
@prithvipatil97
Copy link
Contributor Author

Hello Team,
Thanks for your attention here and for completing the peer review.
I was committing the suggested changes, but in meantime we found some additional changes in the same documentation.
So, I am going to raise a new PR with all of the required changes.
Hence closing this PR.

Regards,
Prithviraj Patil

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 size/XS Denotes a PR that changes 0-9 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants