Skip to content

Conversation

@jasdeepbhalla
Copy link
Contributor

Issue # (if applicable)

Closes #36585.

Reason for this change

The documentation for CrossAccountDestination contained inaccurate claims about automatic creation when using the KinesisDestination class from aws-cdk-lib/aws-logs-destinations. The documentation stated that CrossAccountDestination would be automatically created for cross-account scenarios, but the actual implementation of KinesisDestination.bind() only creates an IAM role and grants permissions - it does not create a CrossAccountDestination for cross-account usage. This was leftover documentation from when destinations were moved to aws-logs-destinations in PR #2655.

Description of changes

This PR fixes inaccurate documentation in two locations:

  1. packages/aws-cdk-lib/aws-logs/README.md:

    • Updated the text to state that CrossAccountDestination "must be explicitly created in the destination account".
  2. packages/aws-cdk-lib/aws-logs/lib/cross-account-destination.ts:

    • Updated the JSDoc comment for the CrossAccountDestination class to accurately reflect the actual behavior.

These changes ensure the documentation accurately reflects the current implementation behavior. The related functionality issue (#6884) for actually implementing cross-account support remains open as a separate concern.

Describe any new or updated permissions being added

No new or updated permissions are required. This is a documentation-only change.

Description of how you validated changes

  • Verified the documentation changes accurately describe the current behavior
  • Checked for linting errors - none found
  • Ensured consistency between the README and JSDoc documentation

Checklist


By submitting this pull request, I confirm that my contribution is made under the terms of the Apache-2.0 license

@github-actions github-actions bot added the beginning-contributor [Pilot] contributed between 0-2 PRs to the CDK label Jan 7, 2026
@aws-cdk-automation aws-cdk-automation requested a review from a team January 7, 2026 01:20
@github-actions github-actions bot added effort/small Small work item – less than a day of effort p2 labels Jan 7, 2026
@aws-cdk-automation aws-cdk-automation added the pr/needs-community-review This PR needs a review from a Trusted Community Member or Core Team Member. label Jan 7, 2026
@mergify
Copy link
Contributor

mergify bot commented Jan 8, 2026

Thank you for contributing! Your pull request will be updated from main and then merged automatically (do not update manually, and be sure to allow changes to be pushed to your fork).

@mergify
Copy link
Contributor

mergify bot commented Jan 8, 2026

Merge Queue Status

✅ The pull request has been merged at e29c216

This pull request spent 28 minutes 45 seconds in the queue, including 28 minutes 36 seconds running CI.
The checks were run in-place.

Required conditions to merge

@mergify
Copy link
Contributor

mergify bot commented Jan 8, 2026

Thank you for contributing! Your pull request will be updated from main and then merged automatically (do not update manually, and be sure to allow changes to be pushed to your fork).

@mergify mergify bot merged commit 87ad0cf into aws:main Jan 8, 2026
17 of 18 checks passed
@github-actions
Copy link
Contributor

github-actions bot commented Jan 8, 2026

Comments on closed issues and PRs are hard for our team to see.
If you need help, please open a new issue that references this one.

@github-actions github-actions bot locked as resolved and limited conversation to collaborators Jan 8, 2026
@aws-cdk-automation aws-cdk-automation removed the pr/needs-community-review This PR needs a review from a Trusted Community Member or Core Team Member. label Jan 8, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

beginning-contributor [Pilot] contributed between 0-2 PRs to the CDK effort/small Small work item – less than a day of effort p2

Projects

None yet

Development

Successfully merging this pull request may close these issues.

(aws-logs): Incorrect descriptions for involvement of CrossAccountDestination

3 participants