Skip to content

Conversation

@alexakreizinger
Copy link
Member

@alexakreizinger alexakreizinger commented Nov 13, 2025

this PR consolidates redundant info by combining all of the "here are links to installation guides" info in one place.

a few things of note:

  • I also moved the "Requirements" info into this consolidated doc rather than keeping it as a standalone doc, partly because it was so short and partly because having it as a standalone doc was throwing off my attempts to reconfigure the IA. (I actually want to revisit this info in the near future because I'm not sure that these really are requirements per se... they seem more like build dependencies for fluent bit itself? which may be useful info to include somewhere, but not the same thing :P)
  • I moved that tracking pixel because it was in one of the docs that got deleted post-consolidation.
  • as much as I theoretically like having the specific supported versions in a page like this, I removed them because they're hard to keep up-to-date and frankly weren't even updated/internally consistent within our existing docs—the two pages I consolidated had conflicting info. we should put that info within each relevant page, if possible (e.g., specifically ubuntu builds go in the ubuntu doc), but not all pages currently do and I'm not the person who can verify that info.
  • given the previous bullet point, I opted not to use tables in this consolidated doc because it didn't seem like we needed tables to display this comparatively simplified info. happy to revisit this if needed, though.
  • our "build from source" info is weirdly scattered—we have standalone docs dedicated to building from source, but then we also have mac/windows-specific instructions shoehorned into those docs?—but that's a problem to tackle in a future PR

Summary by CodeRabbit

  • Documentation
    • Consolidated installation content into a single "Download and install" page with narrative install workflow, build-from-source guidance, supported platforms, and package/container notes.
    • Removed legacy "Getting started" and "Requirements" installation pages.
    • Replaced OS/architecture tables with streamlined guidance and platform notes.
    • Added redirects from legacy installation links to the consolidated downloads page.

Signed-off-by: Alexa Kreizinger <alexakreizinger@gmail.com>
Signed-off-by: Alexa Kreizinger <alexakreizinger@gmail.com>
@alexakreizinger alexakreizinger requested review from a team as code owners November 13, 2025 23:19
@coderabbitai
Copy link
Contributor

coderabbitai bot commented Nov 13, 2025

Caution

Review failed

The pull request is closed.

Walkthrough

Removed two installation pages and consolidated their content into installation/downloads.md; added three redirect mappings in .gitbook.yaml; removed two TOC entries from SUMMARY.md. No code or public API changes.

Changes

Cohort / File(s) Summary
Navigation & Redirects
\.gitbook\.yaml, SUMMARY\.md
Added three redirect mappings pointing former installation paths to ./installation/downloads.md. Removed two installation TOC entries from SUMMARY.md.
Consolidated Installation Doc
installation/downloads.md
Replaced prior platform matrix and split pages with a single "Download and install Fluent Bit" narrative including header image, Requirements (compiler/CMake/Flex/Bison/Libyaml), build-from-source guidance, supported platforms and packaging, container notes, and Enterprise providers section.
Removed Pages
installation/getting-started-with-fluent-bit.md, installation/requirements.md
Deleted files that previously contained platform-specific installation tables, package instructions, and build prerequisites (content consolidated into downloads.md).

Sequence Diagram(s)

sequenceDiagram
    participant User as User (Docs)
    participant Redirect as Redirects (.gitbook.yaml)
    participant New as installation/downloads.md

    Note over User,New: Before — multiple installation pages existed
    User->>New: Request /installation/downloads.md
    New-->>User: Serve consolidated downloads page

    Note right of Redirect: After — old URLs redirected
    User->>Redirect: Request /installation/getting-started-with-fluent-bit (or /requirements /supported-platforms)
    Redirect-->>New: Forward to `installation/downloads.md`
    New-->>User: Serve consolidated downloads page
Loading

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

  • Review installation/downloads.md for completeness, accuracy of migrated content, and broken links.
  • Verify .gitbook.yaml redirect syntax and that SUMMARY.md edits preserve overall TOC integrity.

Suggested reviewers

  • cnorris-cs

Poem

I hopped through files with a nibble and grin,
Merged pages together so journeys begin,
Redirects like signposts point straight to the light,
One downloads page now—neat, tidy, and bright! 🐰✨

Pre-merge checks and finishing touches

✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title 'consolidate install/platforms/requirements info' accurately summarizes the main change: merging multiple installation-related documentation files into a single consolidated document.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

📜 Recent review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 31c1e55 and 5d3e13a.

📒 Files selected for processing (2)
  • .gitbook.yaml (1 hunks)
  • SUMMARY.md (0 hunks)

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🧹 Nitpick comments (1)
installation/downloads.md (1)

64-64: Consider spelling out "CVE" acronym.

Line 64 mentions "CVE backporting" but does not define the acronym. For readers unfamiliar with the term, consider spelling it out as "Common Vulnerabilities and Exposures (CVE) backporting" on first mention.

Apply this diff to improve clarity:

-Fluent Bit packages are also provided by [enterprise providers](https://fluentbit.io/enterprise) for older end-of-life versions, Unix systems, or for additional support and features including aspects (such as CVE backporting).
+Fluent Bit packages are also provided by [enterprise providers](https://fluentbit.io/enterprise) for older end-of-life versions, Unix systems, or for additional support and features including aspects (such as Common Vulnerabilities and Exposures (CVE) backporting).
📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 7b6b315 and 077118f.

📒 Files selected for processing (5)
  • .gitbook.yaml (1 hunks)
  • SUMMARY.md (0 hunks)
  • installation/downloads.md (1 hunks)
  • installation/getting-started-with-fluent-bit.md (0 hunks)
  • installation/requirements.md (0 hunks)
💤 Files with no reviewable changes (3)
  • installation/requirements.md
  • SUMMARY.md
  • installation/getting-started-with-fluent-bit.md
🧰 Additional context used
🪛 GitHub Check: runner / vale
installation/downloads.md

[warning] 64-64:
[vale] reported by reviewdog 🐶
[FluentBit.Acronyms] Spell out 'CVE', if it's unfamiliar to the audience.

Raw Output:
{"message": "[FluentBit.Acronyms] Spell out 'CVE', if it's unfamiliar to the audience.", "location": {"path": "installation/downloads.md", "range": {"start": {"line": 64, "column": 210}}}, "severity": "INFO"}


[warning] 15-15:
[vale] reported by reviewdog 🐶
[FluentBit.Spelling] Spelling check: 'Libyaml'?

Raw Output:
{"message": "[FluentBit.Spelling] Spelling check: 'Libyaml'?", "location": {"path": "installation/downloads.md", "range": {"start": {"line": 15, "column": 3}}}, "severity": "INFO"}

🪛 LanguageTool
installation/downloads.md

[uncategorized] ~21-~21: The operating system from Apple is written “macOS”.
Context: ...uilding Fluent Bit from source on macOS and [Windows](../i...

(MAC_OS)


[uncategorized] ~50-~50: The operating system from Apple is written “macOS”.
Context: ...macOS Fluent Bit is available on macOS. ### Windows Fluent Bit is available...

(MAC_OS)

🔇 Additional comments (3)
installation/downloads.md (3)

8-17: Requirements section consolidation looks good.

The merged requirements are clear and actionable, and noting the optional nature of certain dependencies (line 17) provides helpful context for users.


1-60: Effective consolidation with clear organization.

The new structure successfully combines installation guidance, build prerequisites, and platform coverage into a logical, narrative flow. The removal of version matrices (per PR objectives) simplifies maintenance while the added context about platform support (lines 6, 56–60) provides necessary scope clarification. The tracking pixel relocation (line 4) is in place.


19-21: All internal link references verified as correct.

All referenced installation guide files exist, and the section anchors are correctly established through the "## Compile from source" headings in both installation/downloads/macos.md (line 25) and installation/downloads/windows.md (line 309). The links ../installation/downloads/macos#compile-from-source and ../installation/downloads/windows#compile-from-source are valid.

Signed-off-by: Alexa Kreizinger <alexakreizinger@gmail.com>
Copy link
Contributor

@gguillotte gguillotte left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

…ges-and-supported-platforms

Signed-off-by: Alexa Kreizinger <alexakreizinger@gmail.com>
@alexakreizinger alexakreizinger merged commit b612519 into master Nov 14, 2025
7 of 8 checks passed
@alexakreizinger alexakreizinger deleted the alexakreizinger/sc-146101/fb-combine-packages-and-supported-platforms branch November 14, 2025 17:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants