docs: Refactor the Alloy introduction topics#5219
Merged
clayton-cornell merged 29 commits intomainfrom Feb 18, 2026
Merged
Conversation
Contributor
|
💻 Deploy preview available (Refactor the Alloy introduction topics): |
Contributor
|
💻 Deploy preview deleted (docs: Refactor the Alloy introduction topics). |
4 tasks
dehaansa
reviewed
Jan 23, 2026
Contributor
There was a problem hiding this comment.
Pull request overview
This PR refactors the Alloy introduction documentation to better support users who are new to Alloy. The documentation is restructured to separate informational content from setup content, with new dedicated pages explaining why and how Alloy works.
Changes:
- Adds two new introduction topics: "Why Alloy" and "How Alloy works" to help users understand when and how to use Alloy
- Moves "Supported platforms" and "Estimate resource usage" from the introduction section to the set-up section for better organization
- Restructures release information under a new reference/release-information section
- Updates the introduction index page with a YouTube video embed and improved navigation
- Standardizes bullet formatting from
*to-across multiple documentation files
Reviewed changes
Copilot reviewed 10 out of 10 changed files in this pull request and generated 3 comments.
Show a summary per file
| File | Description |
|---|---|
| docs/sources/introduction/why-alloy.md | New comprehensive guide explaining use cases and scenarios where Alloy is the right choice |
| docs/sources/introduction/how-alloy-works.md | New detailed explanation of Alloy's architecture, components, and operational patterns |
| docs/sources/introduction/_index.md | Rewritten introduction with clearer value proposition, YouTube video, and improved navigation |
| docs/sources/set-up/supported-platforms.md | Moved from introduction/ with proper aliases for backward compatibility |
| docs/sources/set-up/estimate-resource-usage.md | Moved from introduction/ with updated canonical URL and aliases |
| docs/sources/set-up/deploy.md | Standardized bullet formatting and weight adjustments |
| docs/sources/reference/release-information/_index.md | New index page for release information section |
| docs/sources/reference/release-information/release-cadence.md | Moved from introduction/ with aliases |
| docs/sources/reference/release-information/backward-compatibility.md | Moved from introduction/ with aliases and standardized bullet formatting |
| docs/sources/introduction/supported-platforms.md | File deleted (moved to set-up/) |
dehaansa
approved these changes
Feb 17, 2026
grafana-alloybot bot
pushed a commit
that referenced
this pull request
Feb 18, 2026
Refactor the Alloy introduction topics and include a link to the introduction YouTube video. This is a full rewrite of the Introduction section with a strong focus on providing information for people who are completely new to Alloy. It attempts to provide non-developer-based information that could help in a decision to try Alloy. YouTube resources are here: https://github.com/grafana/Grafana-Alloy-for-Beginners ## Review the changes here: * https://deploy-preview-alloy-5219-zb444pucvq-vp.a.run.app/docs/alloy/latest/introduction/ * https://deploy-preview-alloy-5219-zb444pucvq-vp.a.run.app/docs/alloy/latest/introduction/why-alloy/ * https://deploy-preview-alloy-5219-zb444pucvq-vp.a.run.app/docs/alloy/latest/introduction/how-alloy-works/ * https://deploy-preview-alloy-5219-zb444pucvq-vp.a.run.app/docs/alloy/latest/introduction/requirements/ * https://deploy-preview-alloy-5219-zb444pucvq-vp.a.run.app/docs/alloy/latest/set-up/supported-platforms/ * https://deploy-preview-alloy-5219-zb444pucvq-vp.a.run.app/docs/alloy/latest/set-up/estimate-resource-usage/ * https://deploy-preview-alloy-5219-zb444pucvq-vp.a.run.app/docs/alloy/latest/reference/release-information/ Do the locations for supported platforms and estimate resource usage make sense? ### Original topic content for reference: * https://grafana.com/docs/alloy/latest/introduction/ --------- Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> (cherry picked from commit 0533d38)
grafana-alloybot bot
pushed a commit
that referenced
this pull request
Feb 18, 2026
Refactor the Alloy introduction topics and include a link to the introduction YouTube video. This is a full rewrite of the Introduction section with a strong focus on providing information for people who are completely new to Alloy. It attempts to provide non-developer-based information that could help in a decision to try Alloy. YouTube resources are here: https://github.com/grafana/Grafana-Alloy-for-Beginners ## Review the changes here: * https://deploy-preview-alloy-5219-zb444pucvq-vp.a.run.app/docs/alloy/latest/introduction/ * https://deploy-preview-alloy-5219-zb444pucvq-vp.a.run.app/docs/alloy/latest/introduction/why-alloy/ * https://deploy-preview-alloy-5219-zb444pucvq-vp.a.run.app/docs/alloy/latest/introduction/how-alloy-works/ * https://deploy-preview-alloy-5219-zb444pucvq-vp.a.run.app/docs/alloy/latest/introduction/requirements/ * https://deploy-preview-alloy-5219-zb444pucvq-vp.a.run.app/docs/alloy/latest/set-up/supported-platforms/ * https://deploy-preview-alloy-5219-zb444pucvq-vp.a.run.app/docs/alloy/latest/set-up/estimate-resource-usage/ * https://deploy-preview-alloy-5219-zb444pucvq-vp.a.run.app/docs/alloy/latest/reference/release-information/ Do the locations for supported platforms and estimate resource usage make sense? ### Original topic content for reference: * https://grafana.com/docs/alloy/latest/introduction/ --------- Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> (cherry picked from commit 0533d38)
clayton-cornell
added a commit
that referenced
this pull request
Feb 18, 2026
## Backport of #5219 This PR backports #5219 to release/v1.13. ### Original PR Title docs: Refactor the Alloy introduction topics ### Original PR Author @clayton-cornell ### Description Refactor the Alloy introduction topics and include a link to the introduction YouTube video. This is a full rewrite of the Introduction section with a strong focus on providing information for people who are completely new to Alloy. It attempts to provide non-developer-based information that could help in a decision to try Alloy. YouTube resources are here: https://github.com/grafana/Grafana-Alloy-for-Beginners ## Review the changes here: * https://deploy-preview-alloy-5219-zb444pucvq-vp.a.run.app/docs/alloy/latest/introduction/ * https://deploy-preview-alloy-5219-zb444pucvq-vp.a.run.app/docs/alloy/latest/introduction/why-alloy/ * https://deploy-preview-alloy-5219-zb444pucvq-vp.a.run.app/docs/alloy/latest/introduction/how-alloy-works/ * https://deploy-preview-alloy-5219-zb444pucvq-vp.a.run.app/docs/alloy/latest/introduction/requirements/ * https://deploy-preview-alloy-5219-zb444pucvq-vp.a.run.app/docs/alloy/latest/set-up/supported-platforms/ * https://deploy-preview-alloy-5219-zb444pucvq-vp.a.run.app/docs/alloy/latest/set-up/estimate-resource-usage/ * https://deploy-preview-alloy-5219-zb444pucvq-vp.a.run.app/docs/alloy/latest/reference/release-information/ Do the locations for supported platforms and estimate resource usage make sense? ### Original topic content for reference: * https://grafana.com/docs/alloy/latest/introduction/ --- *This backport was created automatically.* Co-authored-by: Clayton Cornell <131809008+clayton-cornell@users.noreply.github.com> Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
clayton-cornell
added a commit
that referenced
this pull request
Feb 18, 2026
## Backport of #5219 This PR backports #5219 to release/v1.12. ### Original PR Author @clayton-cornell ### Description Refactor the Alloy introduction topics and include a link to the introduction YouTube video. This is a full rewrite of the Introduction section with a strong focus on providing information for people who are completely new to Alloy. It attempts to provide non-developer-based information that could help in a decision to try Alloy. YouTube resources are here: https://github.com/grafana/Grafana-Alloy-for-Beginners ## Review the changes here: * https://deploy-preview-alloy-5219-zb444pucvq-vp.a.run.app/docs/alloy/latest/introduction/ * https://deploy-preview-alloy-5219-zb444pucvq-vp.a.run.app/docs/alloy/latest/introduction/why-alloy/ * https://deploy-preview-alloy-5219-zb444pucvq-vp.a.run.app/docs/alloy/latest/introduction/how-alloy-works/ * https://deploy-preview-alloy-5219-zb444pucvq-vp.a.run.app/docs/alloy/latest/introduction/requirements/ * https://deploy-preview-alloy-5219-zb444pucvq-vp.a.run.app/docs/alloy/latest/set-up/supported-platforms/ * https://deploy-preview-alloy-5219-zb444pucvq-vp.a.run.app/docs/alloy/latest/set-up/estimate-resource-usage/ * https://deploy-preview-alloy-5219-zb444pucvq-vp.a.run.app/docs/alloy/latest/reference/release-information/ Do the locations for supported platforms and estimate resource usage make sense? ### Original topic content for reference: * https://grafana.com/docs/alloy/latest/introduction/ --- *This backport was created automatically.* Co-authored-by: Clayton Cornell <131809008+clayton-cornell@users.noreply.github.com> Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
jharvey10
pushed a commit
that referenced
this pull request
Feb 26, 2026
Refactor the Alloy introduction topics and include a link to the introduction YouTube video. This is a full rewrite of the Introduction section with a strong focus on providing information for people who are completely new to Alloy. It attempts to provide non-developer-based information that could help in a decision to try Alloy. YouTube resources are here: https://github.com/grafana/Grafana-Alloy-for-Beginners ## Review the changes here: * https://deploy-preview-alloy-5219-zb444pucvq-vp.a.run.app/docs/alloy/latest/introduction/ * https://deploy-preview-alloy-5219-zb444pucvq-vp.a.run.app/docs/alloy/latest/introduction/why-alloy/ * https://deploy-preview-alloy-5219-zb444pucvq-vp.a.run.app/docs/alloy/latest/introduction/how-alloy-works/ * https://deploy-preview-alloy-5219-zb444pucvq-vp.a.run.app/docs/alloy/latest/introduction/requirements/ * https://deploy-preview-alloy-5219-zb444pucvq-vp.a.run.app/docs/alloy/latest/set-up/supported-platforms/ * https://deploy-preview-alloy-5219-zb444pucvq-vp.a.run.app/docs/alloy/latest/set-up/estimate-resource-usage/ * https://deploy-preview-alloy-5219-zb444pucvq-vp.a.run.app/docs/alloy/latest/reference/release-information/ Do the locations for supported platforms and estimate resource usage make sense? ### Original topic content for reference: * https://grafana.com/docs/alloy/latest/introduction/ --------- Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to subscribe to this conversation on GitHub.
Already have an account?
Sign in.
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Refactor the Alloy introduction topics and include a link to the introduction YouTube video.
This is a full rewrite of the Introduction section with a strong focus on providing information for people who are completely new to Alloy. It attempts to provide non-developer-based information that could help in a decision to try Alloy.
YouTube resources are here: https://github.com/grafana/Grafana-Alloy-for-Beginners
Review the changes here:
Do the locations for supported platforms and estimate resource usage make sense?
Original topic content for reference: