[Docs]: Need more description what ses_domain_identity_verification does

[EugenKon]

Documentation Link

https://registry.terraform.io/providers/hashicorp/aws/latest/docs/resources/ses_domain_identity_verification

Description

This is not clear which part of domain identity verification it belongs:

• https://docs.aws.amazon.com/ses/latest/dg/creating-identities.html#verify-domain-procedure
• https://docs.aws.amazon.com/workmail/latest/adminguide/domain_verification.html

Also this documentation lacks information about outcome when this "resource" is used.

References

No response

Would you like to implement a fix?

None

[github-actions[bot]]

Community Note

Voting for Prioritization

• Please vote on this issue by adding a 👍 reaction to the original post to help the community and maintainers prioritize this request.
• Please see our prioritization guide for information on how we prioritize.
• Please do not leave "+1" or other comments that do not add relevant new information or questions, they generate extra noise for issue followers and do not help prioritize the request.

Volunteering to Work on This Issue

• If you are interested in working on this issue, please leave a comment.
• If this would be your first contribution, please review the contribution guide.

[justinretzolk]

Hey @EugenKon 👋 Thank you for taking the time to raise this! This resource doesn't represent a "real" resource in AWS; it's just used to help with the verification workflow. The example shows the most common usage, as described in the resource description:

Most commonly, this resource is used together with aws_route53_record and aws_ses_domain_identity to request an SES domain identity, deploy the required DNS verification records, and wait for verification to complete.

In that example, this resource handles the "and wait for verification to complete" part; it's used to represent a successful verification.