aws / aws/aws-cdk

`aws_ses`: Email receiving section doesn't mention DNS entry for inbound-smtp.region.amazonaws.com

Open
#28,822 2 comments 0 reactions 0 assignees View on GitHub
@aws-cdk/aws-ses documentation effort/small feature-request p3
Dominant language
TypeScript
Stars
12.9k
Forks
4.6k
Avg merge
2d 3h
Merged PRs (30d)
83

Description

### Describe the issue

When the `aws_ses.EmailIdentity` construct is created, it handles creating the necessary DNS records for us, so the [Email sending documentation](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_ses-readme.html#email-sending) doesn't have to mention DNS, but the `aws_ses.ReceiptRuleSet` construct does not handle any DNS records for us. Since the `ReceiptRuleSet` is unusable without the necessary DNS record, I think the CDK documentation should mention that some DNS records have to be created and maybe give a reference to the [Publishing an MX record for Amazon SES email receiving doc](https://docs.aws.amazon.com/ses/latest/dg/receiving-email-mx-record.html).

### Links

https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_ses-readme.html

Contributor guide

Open the contributing guide

Research direction

Open the aws-cdk-lib.aws_ses README linked in the issue and locate the Email receiving or ReceiptRuleSet documentation. Read the linked Amazon SES MX-record guide for the required DNS context. Done means the CDK documentation explains that ReceiptRuleSet does not create the necessary DNS records and points readers to the receiving-email MX-record guide.

Written by the indexing model from the issue text.

Assessment

Tech stack
aws
Domain
cloud, documentation
Issue type
Documentation
Difficulty
1/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Clearly specified
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.