Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update README with 'tagging' metadata key description #138

Merged
merged 1 commit into from
Sep 21, 2022

Conversation

marcuram
Copy link
Contributor

Description of changes: Update README with tagging metadata key description and examples

By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license.

README.md Outdated
Comment on lines 42 to 44
* `tagOnCreate`: A boolean flag indicating whether this resource type supports tagging resources upon creation.
* `tagUpdatable`: A boolean flag indicating whether this resource type supports updatable tagging.
* `cloudFormationSystemTags`: A boolean flag indicating whether this resource type supports CloudFormation system tags.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

we may want to explain these a little bit more. I'll let you give a shot at phrasing this for these doc purposes, but here is what I think is missing:

Q: What do we mean by tagging resources on creation?
A: You can pass the tags into the create API, allowing for enforcement of tags based access control

Q: What is "updatable tagging"?
A: You can modify the tags using the update handler. Now that I'm thinking about this, this property is unnecessary. We can just check if the tagProperty is in createOnlyProperties

Q: What does "supports CloudFormation System Tags" mean?
A: The create handler will apply aws prefixed tags as described here

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Wording updated.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants