Skip to content

docs(s3): add example to s3 bucket documentation#21110

Merged
mergify[bot] merged 4 commits intoaws:mainfrom
daschaa:s3_add_example
Jul 14, 2022
Merged

docs(s3): add example to s3 bucket documentation#21110
mergify[bot] merged 4 commits intoaws:mainfrom
daschaa:s3_add_example

Conversation

@daschaa
Copy link
Copy Markdown
Contributor

@daschaa daschaa commented Jul 12, 2022

Fixes #20374

Adds an example to the S3 Bucket docstring.


All Submissions:

Adding new Unconventional Dependencies:

  • This PR adds new unconventional dependencies following the process described here

New Features

  • Have you added the new feature to an integration test?
    • Did you use yarn integ to deploy the infrastructure and generate the snapshot (i.e. yarn integ without --dry-run)?

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

@gitpod-io
Copy link
Copy Markdown

gitpod-io bot commented Jul 12, 2022

@github-actions github-actions bot added effort/small Small work item – less than a day of effort p2 labels Jul 12, 2022
@aws-cdk-automation aws-cdk-automation requested a review from a team July 12, 2022 19:42
@daschaa
Copy link
Copy Markdown
Contributor Author

daschaa commented Jul 12, 2022

@peterwoodworth I have now added a pull request with an example, but as we discussed, I don't know how it renders it 😅 It would be nice to get some feedback from you how it looks like.
And if you might have suggestions for more parameters for the example, I'd be happy too 😄 I think just the bucket name might be a bit too less?

Thanks in advance! ❤️

Copy link
Copy Markdown
Contributor

@peterwoodworth peterwoodworth left a comment

Choose a reason for hiding this comment

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

This is how it's supposed to be formatted! good job 🙂

It appears that there's extra spaces / indentation, could you make sure that the start of the example new s3.Bucket... is the same indentation as the @ example line?

As for props - I'd request that we do not specify the bucketName. We actually recommend against this as best practice, see here

I honestly wouldn't mind if we don't have props, but take a look through the overview page. Anything related to encryption, blocking public access, bucket deletion, etc would be great to have here.

Also be sure to put a semicolon at the end of the bucket declaration!

@TheRealAmazonKendra TheRealAmazonKendra changed the title docs(s3): adds example to s3 bucket documentation docs(s3): add example to s3 bucket documentation Jul 14, 2022
@mergify mergify bot dismissed peterwoodworth’s stale review July 14, 2022 05:13

Pull request has been modified.

@daschaa
Copy link
Copy Markdown
Contributor Author

daschaa commented Jul 14, 2022

@peterwoodworth Thank you for your detailed answers! I have added the requested changes. I hope it's ok like that, otherwise I would appreciate your feedback :)

@TheRealAmazonKendra
Copy link
Copy Markdown
Contributor

Oops. Looks like the spacing with the imports got a bit messed up with this revision.

@daschaa
Copy link
Copy Markdown
Contributor Author

daschaa commented Jul 14, 2022

@TheRealAmazonKendra 🤦🏼 I don't know how this happened. I fixed it with yarn lint --fix :) I hope its ok now :)

Copy link
Copy Markdown
Contributor

@TheRealAmazonKendra TheRealAmazonKendra left a comment

Choose a reason for hiding this comment

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

Looks good! Thanks for the change!

@mergify
Copy link
Copy Markdown
Contributor

mergify bot commented Jul 14, 2022

Thank you for contributing! Your pull request will be updated from main and then merged automatically (do not update manually, and be sure to allow changes to be pushed to your fork).

@aws-cdk-automation
Copy link
Copy Markdown
Collaborator

AWS CodeBuild CI Report

  • CodeBuild project: AutoBuildv2Project1C6BFA3F-wQm2hXv2jqQv
  • Commit ID: 9be20eb
  • Result: SUCCEEDED
  • Build Logs (available for 30 days)

Powered by github-codebuild-logs, available on the AWS Serverless Application Repository

@mergify mergify bot merged commit 424b157 into aws:main Jul 14, 2022
@mergify
Copy link
Copy Markdown
Contributor

mergify bot commented Jul 14, 2022

Thank you for contributing! Your pull request will be updated from main and then merged automatically (do not update manually, and be sure to allow changes to be pushed to your fork).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

effort/small Small work item – less than a day of effort p2

Projects

None yet

Development

Successfully merging this pull request may close these issues.

aws-s3: wrong code example for Bucket construct

4 participants