(aws-dynamodb): TableV2 should explicitly document that it translate to a CFN AWS::DynamoDB::GlobalTable

[naranj4]

Describe the issue

Most of the external documentation seems to indicate that TableV2 (and AWS::DynamoDB::GlobalTable) should be preferred going forward.

• Announcement blog post
• re:Post article
• GitHub issue regarding the confusing naming: explicitly states that TableV2 should be used going forward.

However, AWS::DynamoDB::GlobalTable is different to AWS::DynamoDB::Table and the distinction should be made in the docstring at minimum so that users are aware of the differences.

Related: #28976

Links

The existing CDK documentation does not make a clear distinction between the two constructs:

• Table
• TableV2

[khushail]

Hi @naranj4 , thanks for reaching out. Yes, there has been consistent ask about Table and TableV2 , citing different issues( like this one -#28976), and yes TableV2 translates to CfnGlobalTable and Table does to CfnTable. so it would definitely be helpful to have little bit more documentation around these concepts. So marking it as P3 as it would be good to have and contributions from community are welcome!