-
Notifications
You must be signed in to change notification settings - Fork 561
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 <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>
74f653f
to
a1b7b13
Compare
I rebased this PR. |
Signed-off-by: Marco Pracucci <marco@pracucci.com>
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>
I just realized the link was broken for real. It should have been |
Co-authored-by: Marco Pracucci <marco@pracucci.com>
* 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>
* 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)
* 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)
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