Skip to content

expand README files for examples #1946

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

Merged
merged 8 commits into from
Jun 6, 2022
Merged

expand README files for examples #1946

merged 8 commits into from
Jun 6, 2022

Conversation

khorne3
Copy link
Contributor

@khorne3 khorne3 commented Jun 1, 2022

Currently features the following so that no one sees empty files:

  • How to use it
  • Any gotchas

I'm open to any and all changes suggested. I'm tracking #1321 for future additions regarding troubleshooting

@khorne3 khorne3 requested a review from bpmct June 1, 2022 14:53
Copy link
Member

@bpmct bpmct left a comment

Choose a reason for hiding this comment

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

Nice, thanks for doing this! This is a larger question beyond this PR, but:

  1. do you have thoughts on how the product can refer to these docs during template creation? We have found that in many cases, we want to recommend users make edits to the TF instead of using the built-in example to manage access/secrets in their preferred way.
  2. I noticed some of this info is repeated based on the cloud configuration, not the template itself. Perhaps not a big deal yet, but we may be able to find another solution once we build a static docs site

@khorne3
Copy link
Contributor Author

khorne3 commented Jun 1, 2022

@bpmct let me think a bit re: your questions and I'll get back to you!

Co-authored-by: Ben Potter <ben@coder.com>
@khorne3
Copy link
Contributor Author

khorne3 commented Jun 2, 2022

Re: #1: I think some of the usage instructions are too long for us to consistently populate to the CLI, but maybe a link to instructions. I don't know if this is a bit too janky

Re: #2: yeah, if we could find a way to use templating to populate in repeated info, that would be really nice

@khorne3 khorne3 marked this pull request as ready for review June 3, 2022 14:53
@khorne3 khorne3 requested a review from bpmct June 3, 2022 14:53
@khorne3 khorne3 merged commit 318e979 into main Jun 6, 2022
@khorne3 khorne3 deleted the examples branch June 6, 2022 18:03
kylecarbs pushed a commit that referenced this pull request Jun 10, 2022
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.

2 participants