Update Loki README with better links and descriptions #4088
Conversation
| * [Most recent release](https://grafana.com/docs/loki/latest/) | ||
| * [Not yet released documentation](https://grafana.com/docs/loki/next/), at the tip of the main branch | ||
|
|
||
| ### Documentation of old Loki versions |
There was a problem hiding this comment.
Feels weird to keep this list around as it's not exhaustive, and we have the version dropdown in any case; maybe it's worthwhile pointing out that version selector instead?
There was a problem hiding this comment.
These older docs are not available via the dropdown, as they weren't and aren't built for being hosted on a website. Do we even want to identify them for our Loki readers? We could just omit the links. Or, would an explanatory statement about why they're listed here be helpful? Something like: "Documentation for these older versions is not available on the Grafana documentation website. Find the documentation for these older versions via these links:"
There was a problem hiding this comment.
I'm curious why they're not available via the docs site, but yes I think an explanatory statement could be good.
I also reckon we could move this way down to the bottom since it won't be germane for most users.
There was a problem hiding this comment.
I believe this was before we had the current doc site generation tooling.
Co-authored-by: Danny Kopping <dannykopping@gmail.com>
|
@dannykopping: One more review, please. I added an explanatory comment about the hosting/not hosting of the old docs. |
| * [Most recent release](https://grafana.com/docs/loki/latest/) | ||
| * [Not yet released documentation](https://grafana.com/docs/loki/next/), at the tip of the main branch | ||
|
|
||
| ### Documentation of old Loki versions |
There was a problem hiding this comment.
I believe this was before we had the current doc site generation tooling.
This PR changes the way the docs are described in links such that the README does not need to be updated as each new release is made.