-
Notifications
You must be signed in to change notification settings - Fork 544
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
Conversation
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.
Thank you, @jdbaldry. This is wonderful!
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.
Change in general lgtm, but one of the links is wrong (see linter).
Thanks for the review! The link is technically valid but is incorrectly determined by the tool to be invalid. |
Ah, I see 👍. It might be worth putting in the PR message a link to the dependant PR. Eg:
|
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.
Thanks! I just left a nit.
docs/sources/operators-guide/monitoring-grafana-mimir/_index.md
Outdated
Show resolved
Hide resolved
Signed-off-by: Jack Baldry <[email protected]>
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]>
74f653f
to
a1b7b13
Compare
I rebased this PR. |
Signed-off-by: Marco Pracucci <[email protected]>
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]>
I just realized the link was broken for real. It should have been |
Co-authored-by: Marco Pracucci <[email protected]>
* 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]>
* 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)
* 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)
What this PR does
Uses the
menuTitle
parameter of thesection
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