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

Use menuTitle for more user-friendly lists of topics #2290

Merged
merged 6 commits into from
Jul 5, 2022

Conversation

jdbaldry
Copy link
Member

What this PR does

Uses the menuTitle parameter of the section shortcode to reduce stuttering throughout the documentation.
Titles include "Grafana Mimir" as context when the page turns up on search engine results but when you are in the documentation, this is already implied.

Checklist

  • Documentation added

@jdbaldry jdbaldry added the type/docs Improvements or additions to documentation label Jun 30, 2022
@jdbaldry jdbaldry requested review from osg-grafana and pracucci June 30, 2022 11:20
Copy link
Contributor

@osg-grafana osg-grafana left a comment

Choose a reason for hiding this comment

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

Thank you, @jdbaldry. This is wonderful!

Copy link
Contributor

@jhesketh jhesketh left a comment

Choose a reason for hiding this comment

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

Change in general lgtm, but one of the links is wrong (see linter).

@jdbaldry
Copy link
Member Author

jdbaldry commented Jul 4, 2022

Thanks for the review!

The link is technically valid but is incorrectly determined by the tool to be invalid.
Once the updated doc-validator tool is in use (PR #2307), CI should pass.

@jhesketh
Copy link
Contributor

jhesketh commented Jul 4, 2022

Ah, I see 👍. It might be worth putting in the PR message a link to the dependant PR. Eg:

Depends on: #2307

Copy link
Collaborator

@pracucci pracucci left a comment

Choose a reason for hiding this comment

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

Thanks! I just left a nit.

jdbaldry added 3 commits July 5, 2022 09:08
Grafana Mimir is already inferred by context

Signed-off-by: Jack Baldry <[email protected]>
I believe the section was intended to enumerate the components but
it is empty as there are no subdirectories of this page.

Signed-off-by: Jack Baldry <[email protected]>
@pracucci pracucci force-pushed the jdb/2022-06-menuTitle branch from 74f653f to a1b7b13 Compare July 5, 2022 07:08
@pracucci
Copy link
Collaborator

pracucci commented Jul 5, 2022

I rebased this PR.

@pracucci
Copy link
Collaborator

pracucci commented Jul 5, 2022

The link is technically valid but is incorrectly determined by the tool to be invalid. Once the updated doc-validator tool is in use (PR #2307), CI should pass.

I rebased but the link is still reported. I fixed the link to move on. We can look at it separately, even if I think it's a nice property being explicit with what we want to link (the index file).

Signed-off-by: Marco Pracucci <[email protected]>
@pracucci
Copy link
Collaborator

pracucci commented Jul 5, 2022

The link is technically valid but is incorrectly determined by the tool to be invalid. Once the updated doc-validator tool is in use (PR #2307), CI should pass.

I rebased but the link is still reported. I fixed the link to move on. We can look at it separately, even if I think it's a nice property being explicit with what we want to link (the index file).

I just realized the link was broken for real. It should have been ../components/. Anyway I pushed a fix.

@pracucci pracucci added this to the 2.2 milestone Jul 5, 2022
Co-authored-by: Marco Pracucci <[email protected]>
@pracucci pracucci merged commit 6f5e325 into main Jul 5, 2022
@pracucci pracucci deleted the jdb/2022-06-menuTitle branch July 5, 2022 08:59
masonmei pushed a commit to udmire/mimir that referenced this pull request Jul 11, 2022
* Use menuTitle for more user-friendly lists of topics

Signed-off-by: Jack Baldry <[email protected]>

* Reduce stuttering in menu titles

Grafana Mimir is already inferred by context

Signed-off-by: Jack Baldry <[email protected]>

* Replace empty section with link to components

I believe the section was intended to enumerate the components but
it is empty as there are no subdirectories of this page.

Signed-off-by: Jack Baldry <[email protected]>

* Fixed link reported by doc-validator

Signed-off-by: Marco Pracucci <[email protected]>

* Fixed link

Signed-off-by: Marco Pracucci <[email protected]>

* Apply code review suggestions

Co-authored-by: Marco Pracucci <[email protected]>

Co-authored-by: Marco Pracucci <[email protected]>
grafanabot pushed a commit that referenced this pull request Jul 11, 2022
* Use menuTitle for more user-friendly lists of topics

Signed-off-by: Jack Baldry <[email protected]>

* Reduce stuttering in menu titles

Grafana Mimir is already inferred by context

Signed-off-by: Jack Baldry <[email protected]>

* Replace empty section with link to components

I believe the section was intended to enumerate the components but
it is empty as there are no subdirectories of this page.

Signed-off-by: Jack Baldry <[email protected]>

* Fixed link reported by doc-validator

Signed-off-by: Marco Pracucci <[email protected]>

* Fixed link

Signed-off-by: Marco Pracucci <[email protected]>

* Apply code review suggestions

Co-authored-by: Marco Pracucci <[email protected]>

Co-authored-by: Marco Pracucci <[email protected]>
(cherry picked from commit 6f5e325)
dimitarvdimitrov pushed a commit that referenced this pull request Jul 11, 2022
* Use menuTitle for more user-friendly lists of topics

Signed-off-by: Jack Baldry <[email protected]>

* Reduce stuttering in menu titles

Grafana Mimir is already inferred by context

Signed-off-by: Jack Baldry <[email protected]>

* Replace empty section with link to components

I believe the section was intended to enumerate the components but
it is empty as there are no subdirectories of this page.

Signed-off-by: Jack Baldry <[email protected]>

* Fixed link reported by doc-validator

Signed-off-by: Marco Pracucci <[email protected]>

* Fixed link

Signed-off-by: Marco Pracucci <[email protected]>

* Apply code review suggestions

Co-authored-by: Marco Pracucci <[email protected]>

Co-authored-by: Marco Pracucci <[email protected]>

Co-authored-by: Jack Baldry <[email protected]>

(cherry picked from commit 6f5e325)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
backport release-2.2 type/docs Improvements or additions to documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants