Documentation improvement- "Resource" block syntax

[adi-garg]

Terraform Version

Terraform v1.3.6
on windows_amd64
+ provider registry.terraform.io/hashicorp/aws v4.42.0

Affected Pages

https://developer.hashicorp.com/terraform/language/resources/syntax#resource-syntax

What is the docs issue?

1.Need showing how to reference the sample block
2.Need clarification on local resource name within Terraform vs actual resource name in the Cloud

Proposal

The resource type and name together serve as an identifier for a given resource and so must be unique within a module.

It may help to clarify this using same example:
The above resource may be referenced using aws_instance.web

Further it may help clarify about naming:
In the example above,web is NOT the actual infrastructure ec2/VM name. Actual name used for the cloud resource is defined inside the resource block.This is done usually using tags in AWS and using a dedicated name argument in Azure.

References

No response

[crw]

Thanks for this request! I will pass this along to the docs team.

[TonyBhargav]

hi @crw , I would like to work on this documentation as a part of academic course work ,It would be a great opportunity for me to learn about the project architecture and design as well. Could you please assign it to me

[crw]

@TonyBhargav you are welcome to contribute to the documentation. We do not assign issues to community members, please open a PR with your suggested changes. Thanks!