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
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.

Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
Grafana Mimir is already inferred by context

Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
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 <jack.baldry@grafana.com>
@pracucci
Copy link
Collaborator

pracucci commented Jul 5, 2022

I rebased this PR.

Signed-off-by: Marco Pracucci <marco@pracucci.com>
@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 <marco@pracucci.com>
@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 <marco@pracucci.com>
@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 <jack.baldry@grafana.com>

* Reduce stuttering in menu titles

Grafana Mimir is already inferred by context

Signed-off-by: Jack Baldry <jack.baldry@grafana.com>

* 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 <jack.baldry@grafana.com>

* Fixed link reported by doc-validator

Signed-off-by: Marco Pracucci <marco@pracucci.com>

* Fixed link

Signed-off-by: Marco Pracucci <marco@pracucci.com>

* Apply code review suggestions

Co-authored-by: Marco Pracucci <marco@pracucci.com>

Co-authored-by: Marco Pracucci <marco@pracucci.com>
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 <jack.baldry@grafana.com>

* Reduce stuttering in menu titles

Grafana Mimir is already inferred by context

Signed-off-by: Jack Baldry <jack.baldry@grafana.com>

* 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 <jack.baldry@grafana.com>

* Fixed link reported by doc-validator

Signed-off-by: Marco Pracucci <marco@pracucci.com>

* Fixed link

Signed-off-by: Marco Pracucci <marco@pracucci.com>

* Apply code review suggestions

Co-authored-by: Marco Pracucci <marco@pracucci.com>

Co-authored-by: Marco Pracucci <marco@pracucci.com>
(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 <jack.baldry@grafana.com>

* Reduce stuttering in menu titles

Grafana Mimir is already inferred by context

Signed-off-by: Jack Baldry <jack.baldry@grafana.com>

* 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 <jack.baldry@grafana.com>

* Fixed link reported by doc-validator

Signed-off-by: Marco Pracucci <marco@pracucci.com>

* Fixed link

Signed-off-by: Marco Pracucci <marco@pracucci.com>

* Apply code review suggestions

Co-authored-by: Marco Pracucci <marco@pracucci.com>

Co-authored-by: Marco Pracucci <marco@pracucci.com>

Co-authored-by: Jack Baldry <jack.baldry@grafana.com>

(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.

None yet

5 participants