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

docs: add numbering to headers to help navigation and readability #639

Merged
merged 3 commits into from
May 13, 2024

Conversation

smccarthy-ie
Copy link
Contributor

@smccarthy-ie smccarthy-ie commented May 10, 2024

Mainly adding numbered headings to help keep track of where you are in procedures, and minor copy edits only. No changes to technical content.

Please cherry pick to v0.7 also. Thanks

@smccarthy-ie smccarthy-ie requested a review from a team as a code owner May 10, 2024 15:00
@@ -1,43 +1,45 @@
# Secure, protect, and connect APIs with Kuadrant
# Secure, protect, and connect APIs with Kuadrant on OpenShift
Copy link
Collaborator

Choose a reason for hiding this comment

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

hmm this is making me think. The only OpenShift specific things here is the reference to the install. Could probably update this to also suggest the quick starts that install kind clusters. Would be nice to have this guide as the "one to rule them all"

Copy link
Collaborator

Choose a reason for hiding this comment

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

I will create a follow up for that #640

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Thanks @maleck13 Yes, agree that a single generic guide would be best and easier to maintain.

We currently have two guides with the same heading name. This PR updates both heading names to distinguish between OpenShift and Kubernetes for now, which matches the approach taken in the site TOC.

See https://docs.kuadrant.io/0.7.0/kuadrant-operator/doc/user-guides/secure-protect-connect-single-multi-cluster/

Copy link
Collaborator

@maleck13 maleck13 left a comment

Choose a reason for hiding this comment

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

changes look good. Once merged will cherry pick to the 0.7 branch

@smccarthy-ie
Copy link
Contributor Author

Thanks @maleck13 Can you merge this one also? I don't have write access to Merge button :)

@maleck13 maleck13 merged commit 39ecfe8 into Kuadrant:main May 13, 2024
6 checks passed
maleck13 added a commit that referenced this pull request May 13, 2024
* docs: add numbering to headers to help navigation and readability, minor edits

* docs: add line break to fix bullet list format on kuadrant docs site

* Update doc/user-guides/secure-protect-connect-single-multi-cluster.md

Co-authored-by: Craig Brookes <maleck13@users.noreply.github.com>

---------

Co-authored-by: Craig Brookes <maleck13@users.noreply.github.com>
maleck13 added a commit that referenced this pull request May 13, 2024
* docs: add numbering to headers to help navigation and readability, minor edits

* docs: add line break to fix bullet list format on kuadrant docs site

* Update doc/user-guides/secure-protect-connect-single-multi-cluster.md

Co-authored-by: Craig Brookes <maleck13@users.noreply.github.com>

---------

Co-authored-by: Craig Brookes <maleck13@users.noreply.github.com>
maleck13 added a commit that referenced this pull request May 13, 2024
* docs: add numbering to headers to help navigation and readability, minor edits

* docs: add line break to fix bullet list format on kuadrant docs site

* Update doc/user-guides/secure-protect-connect-single-multi-cluster.md

Co-authored-by: Craig Brookes <maleck13@users.noreply.github.com>

---------

Co-authored-by: Craig Brookes <maleck13@users.noreply.github.com>
maleck13 added a commit that referenced this pull request May 13, 2024
…dability (#639) (#642)

* docs: add numbering to headers to help navigation and readability (#639)

* docs: add numbering to headers to help navigation and readability, minor edits

* docs: add line break to fix bullet list format on kuadrant docs site

* Update doc/user-guides/secure-protect-connect-single-multi-cluster.md

Co-authored-by: Craig Brookes <maleck13@users.noreply.github.com>

---------

Co-authored-by: Craig Brookes <maleck13@users.noreply.github.com>

* add latest catalog version

---------

Co-authored-by: Stephen McCarthy <29098561+smccarthy-ie@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants