TransitGatewayAttachment vs TransitGatewayVpcAttachment?

Looking at the documentation of AWS::EC2::TransitGatewayAttachment and AWS::EC2::TransitGatewayVpcAttachment it looks that first is a subset of later. If TransitGatewayVpcAttachmentis kept only for backwards compatibility, would it make sense to add a note into documentation stating this is obsolete version, and there is better alternative available?

• https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-transitgatewayattachment.html
• https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-transitgatewayvpcattachment.html