Skip to content

aws: documentation fixes#880

Merged
eschabell merged 6 commits into
fluent:masterfrom
PettitWesley:sandra-doc-fixes
May 28, 2026
Merged

aws: documentation fixes#880
eschabell merged 6 commits into
fluent:masterfrom
PettitWesley:sandra-doc-fixes

Conversation

@PettitWesley
Copy link
Copy Markdown
Contributor

@PettitWesley PettitWesley commented Aug 29, 2022

Summary by CodeRabbit

  • Documentation
    • Improved clarity of AWS output plugin documentation with refined instructions and wording for configuration examples.
    • Enhanced guidance for handling public ECR image pull limit errors and AWS credentials.
    • Improved formatting and organization of technical sections for better readability.

Review Change Stack

Signed-off-by: Wesley Pettit <wppttt@amazon.com>
Signed-off-by: Wesley Pettit <wppttt@amazon.com>
Signed-off-by: Wesley Pettit <wppttt@amazon.com>
Signed-off-by: Wesley Pettit <wppttt@amazon.com>
Copy link
Copy Markdown
Contributor

@DrewZhang13 DrewZhang13 left a comment

Choose a reason for hiding this comment

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

LGTM

Copy link
Copy Markdown
Contributor

@lecaros lecaros left a comment

Choose a reason for hiding this comment

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

Please review the typo

Comment thread pipeline/outputs/kinesis.md Outdated
@lecaros lecaros added the waiting-for-user Waiting for user/contributors feedback or requested changes label Aug 30, 2022
Copy link
Copy Markdown
Contributor

@matthewfala matthewfala left a comment

Choose a reason for hiding this comment

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

They look great! Just one typo maybe

Comment thread pipeline/outputs/kinesis.md Outdated
@github-actions
Copy link
Copy Markdown
Contributor

This PR is stale because it has been open 45 days with no activity. Remove stale label or comment or this will be closed in 10 days.

@github-actions github-actions Bot added the Stale label Nov 29, 2022
Comment thread pipeline/outputs/cloudwatch.md Outdated
@github-actions github-actions Bot removed the Stale label Nov 30, 2022
@lecaros lecaros added the conflict Waiting on conflict to be resolved by contributor label Dec 23, 2022
@github-actions
Copy link
Copy Markdown
Contributor

This PR is stale because it has been open 45 days with no activity. Remove stale label or comment or this will be closed in 10 days.

@github-actions github-actions Bot added the Stale label Mar 23, 2023
@lecaros lecaros requested review from a team as code owners March 25, 2025 14:34
@github-actions github-actions Bot removed the Stale label Mar 26, 2025
@github-actions
Copy link
Copy Markdown
Contributor

This PR is stale because it has been open 45 days with no activity. Remove stale label or comment or this will be closed in 10 days.

@github-actions github-actions Bot added the Stale label Jun 24, 2025
@github-actions github-actions Bot removed the Stale label Oct 1, 2025
@eschabell
Copy link
Copy Markdown
Collaborator

@PettitWesley can you resolve the conflicts and I'll get this PR merged for you?

@eschabell eschabell self-assigned this Oct 21, 2025
@eschabell eschabell requested a review from esmerel October 22, 2025 19:43
@eschabell eschabell added the waiting-on-review Waiting on a review from mainteners label Oct 22, 2025
@eschabell
Copy link
Copy Markdown
Collaborator

@esmerel can you take a look at this PR?

@esmerel
Copy link
Copy Markdown
Contributor

esmerel commented Oct 27, 2025

This one is tougher due to the interweaving of a couple of things in the cloudwatch page, I'll have to come back to this one.

@eschabell eschabell removed the waiting-for-user Waiting for user/contributors feedback or requested changes label Dec 3, 2025
Signed-off-by: Eric D. Schabell <eric@schabell.org>
@eschabell eschabell self-requested a review as a code owner May 28, 2026 20:10
@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented May 28, 2026

Warning

Review limit reached

@eschabell, we couldn't start this review because you've reached your PR review rate limit.

More reviews will be available in 13 minutes and 28 seconds. Learn how PR review limits work.

Your organization has run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans include higher PR review limits than trial, open-source, and free plans. In all cases, reviews become available again over time. During sustained high-volume PR review activity, CodeRabbit may temporarily slow when the next review becomes available.

Please see our Fair Usage Limits Policy for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 76cec94a-e6e6-4282-a40a-2ef5226ba1a1

📥 Commits

Reviewing files that changed from the base of the PR and between 674844e and bc92468.

📒 Files selected for processing (1)
  • pipeline/outputs/cloudwatch.md
📝 Walkthrough

Walkthrough

This PR refines documentation across four Fluent Bit output plugin guides: CloudWatch, Firehose, Kinesis, and S3. Changes clarify configuration examples, improve ECR troubleshooting guidance consistency, and adjust section spacing for readability.

Changes

Output Plugin Documentation Improvements

Layer / File(s) Summary
Configuration examples and guidance clarifications
pipeline/outputs/cloudwatch.md, pipeline/outputs/firehose.md, pipeline/outputs/s3.md
CloudWatch LocalStack and record_accessor examples now include introductory sentences clarifying intent. ECR troubleshooting guidance across CloudWatch, Firehose, and S3 is refined to explicitly address image pull limit errors and credentials.
Documentation section spacing adjustment
pipeline/outputs/kinesis.md
Compression section spacing adjusted so the informational hint appears immediately after the preceding paragraph.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Possibly related PRs

  • fluent/fluent-bit-docs#2318: Both PRs refine documentation wording and clarity in pipeline/outputs/cloudwatch.md related to configuration examples and output plugin setup instructions.

Suggested labels

5.0

Suggested reviewers

  • eschabell
  • esmerel

Poem

🐰 Through docs we hop with clarity in sight,
Examples shine and ECR steps ring right,
From spacing clean to guidance clear and true,
The output plugins gleam in springtime hue! 📚✨

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title 'aws: documentation fixes' accurately summarizes the main change - it addresses documentation corrections across AWS output plugins (CloudWatch, Kinesis, S3) as confirmed by file summaries and PR objectives.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

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.

@eschabell
Copy link
Copy Markdown
Collaborator

@PettitWesley fixed all the conflicts.

@eschabell eschabell removed the conflict Waiting on conflict to be resolved by contributor label May 28, 2026
Copy link
Copy Markdown
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 (2)
pipeline/outputs/s3.md (1)

618-618: ⚡ Quick win

Inconsistent wording with other AWS plugin docs.

This line uses "try signing in to public ECR" while cloudwatch.md (line 410) and firehose.md (line 169) both use "try logging into public ECR". Since this PR aims to improve consistency across AWS plugin documentation, consider using the same verb phrase across all files.

📝 Suggested consistency fix
-If you see errors for image pull limits, try signing in to public ECR with your AWS credentials:
+If you see errors for image pull limits, try logging into public ECR with your AWS credentials:
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@pipeline/outputs/s3.md` at line 618, The sentence in pipeline/outputs/s3.md
uses "try signing in to public ECR" which is inconsistent with cloudwatch.md and
firehose.md; update that exact line to use the same phrasing "try logging into
public ECR" so wording matches the other AWS plugin docs and maintain
consistency across documentation.
pipeline/outputs/cloudwatch.md (1)

410-410: 💤 Low value

Grammar correction looks good, but consider consistency across files.

The grammar fix from "try log into" to "try logging into" is correct. However, note that s3.md line 618 uses "try signing in to" instead of "try logging into". For consistency across all AWS plugin documentation, consider using the same verb phrase.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@pipeline/outputs/cloudwatch.md` at line 410, Choose a consistent verb phrase
for AWS plugin docs and update occurrences to match it: replace the fragment
"try logging into" or "try signing in to" across documentation so all files use
the same phrasing (pick one, e.g., "try signing in to"). Specifically search for
the sentence variants in cloudwatch.md ("try logging into") and s3.md ("try
signing in to") and make them identical across all AWS plugin docs, keeping
surrounding punctuation and casing consistent.
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@pipeline/outputs/cloudwatch.md`:
- Around line 195-196: Replace the misleading introductory sentence "Recall that
the Kubernetes filter can add metadata which will look like the following:" with
a phrase that accurately introduces the YAML output configuration block that
follows (e.g., "Here's an example output configuration using the Kubernetes
metadata:") so the text correctly sets up the configuration template shown in
the subsequent lines; update the sentence near the existing Kubernetes metadata
discussion accordingly (the block that precedes the output configuration
template) to maintain clear context.

---

Nitpick comments:
In `@pipeline/outputs/cloudwatch.md`:
- Line 410: Choose a consistent verb phrase for AWS plugin docs and update
occurrences to match it: replace the fragment "try logging into" or "try signing
in to" across documentation so all files use the same phrasing (pick one, e.g.,
"try signing in to"). Specifically search for the sentence variants in
cloudwatch.md ("try logging into") and s3.md ("try signing in to") and make them
identical across all AWS plugin docs, keeping surrounding punctuation and casing
consistent.

In `@pipeline/outputs/s3.md`:
- Line 618: The sentence in pipeline/outputs/s3.md uses "try signing in to
public ECR" which is inconsistent with cloudwatch.md and firehose.md; update
that exact line to use the same phrasing "try logging into public ECR" so
wording matches the other AWS plugin docs and maintain consistency across
documentation.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 3e103f53-5b0a-4946-9fa2-15435d2d5b08

📥 Commits

Reviewing files that changed from the base of the PR and between cab5957 and 674844e.

📒 Files selected for processing (4)
  • pipeline/outputs/cloudwatch.md
  • pipeline/outputs/firehose.md
  • pipeline/outputs/kinesis.md
  • pipeline/outputs/s3.md
💤 Files with no reviewable changes (1)
  • pipeline/outputs/kinesis.md

Comment thread pipeline/outputs/cloudwatch.md Outdated
  - Restore opening ```yaml fence and pipeline: key removed in a prior edit,
    which left the LocalStack YAML example rendering as plain text
  - Remove informal 'Recall that...' sentence inserted before Kubernetes
    record_accessor example

    Applies to fluent#880

Signed-off-by: Eric D. Schabell <eric@schabell.org>
Copy link
Copy Markdown
Collaborator

@eschabell eschabell left a comment

Choose a reason for hiding this comment

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

@PettitWesley thanks for the docs PR, merging.

@eschabell eschabell merged commit 82ab6af into fluent:master May 28, 2026
8 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

waiting-on-review Waiting on a review from mainteners

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants