aws/aws-cdk
Ver no GitHubsns: Add details to `aws_cdk.aws_sns/Topic.html` documentation
Open
#35.736 aberto em 14 de out. de 2025
@aws-cdk/aws-snsdocumentationeffort/smallgood first issuep2
Métricas do repositório
- Stars
- (10.710 stars)
- Métricas de merge de PR
- (Mesclagem média 13d 14h) (134 fundiu PRs em 30d)
Description
Describe the issue
In comparison to the SQS queue documentation, the SNS topic documentation is lacking depth.
Particular examples:
- https://docs.aws.amazon.com/cdk/api/v2/python/aws_cdk.aws_sns/Topic.html#aws_cdk.aws_sns.Topic.grant_publish -- bad documentation (no explanations of what permissions exactly are granted)
- https://docs.aws.amazon.com/cdk/api/v2/python/aws_cdk.aws_sqs/Queue.html#aws_cdk.aws_sqs.Queue.grant_consume_messages -- good documentation (this is for SQS queues, just for comparison)
I stumbled upon this when researching whether topic.grant_publish() grants correct permissions in case of SSE (server-side encrypted) SNS topics.
Similarly, method descriptions like grant_subscribe(), add_subscription() would benefit from more details -- what exactly these methods generate in the final CloudFormation template.
Links
https://docs.aws.amazon.com/cdk/api/v2/python/aws_cdk.aws_sns/Topic.html