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

docs(core): update old recommendations in core README #28535

Merged
merged 8 commits into from
Jan 3, 2024

Conversation

laurelmay
Copy link
Contributor

splitArn is the correct updated version of parseArn. It's now
necessary to use ArnFormat not a literal string for the format of the
ARN resource for splitArn and formatArn.


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

`splitArn` is the correct updated version of `parseArn`. It's now
necessary to use `ArnFormat` not a literal string for the format of the
ARN resource for `splitArn` and `formatArn`.

Finally, to fit with the recommendations to use a singleton pattern for
custom resource handlers, the docs for Lambda are changed to recommend
just using a `SingletonFunction`.
@github-actions github-actions bot added the star-contributor [Pilot] contributed between 25-49 PRs to the CDK label Dec 31, 2023
@aws-cdk-automation aws-cdk-automation requested a review from a team December 31, 2023 02:27
@github-actions github-actions bot added the p2 label Dec 31, 2023
Copy link
Collaborator

@aws-cdk-automation aws-cdk-automation left a comment

Choose a reason for hiding this comment

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

The pull request linter has failed. See the aws-cdk-automation comment below for failure reasons. If you believe this pull request should receive an exemption, please comment and provide a justification.

A comment requesting an exemption should contain the text Exemption Request. Additionally, if clarification is needed add Clarification Request to a comment.

@laurelmay laurelmay changed the title doc(core): update old recommendations in core README docs(core): update old recommendations in core README Dec 31, 2023
@aws-cdk-automation aws-cdk-automation dismissed their stale review December 31, 2023 02:39

✅ Updated pull request passes all PRLinter validations. Dismissing previous PRLinter review.

kaizencc
kaizencc previously approved these changes Jan 2, 2024
@laurelmay
Copy link
Contributor Author

@Mergifyio update

Copy link
Contributor

mergify bot commented Jan 2, 2024

update

✅ Branch has been successfully updated

@mergify mergify bot dismissed kaizencc’s stale review January 2, 2024 18:07

Pull request has been modified.

kaizencc
kaizencc previously approved these changes Jan 2, 2024
@laurelmay
Copy link
Contributor Author

Okay so it looks like I need to make some small changes to the fixtures. But also it seems like aws-cdk-lib/README.md and aws-cdk-lib/core/README.md are not currently in sync. So I'm going to try to take care of that here too.

I'll probably also work on a separate PR to add a prlinter rule for that?

@laurelmay
Copy link
Contributor Author

I am also curious whether they both actually need to exist? It does seem like aws-cdk-lib/README.md has gotten more of these kinds of "chore" syntax fixes while core/README.md gets actual content updates. But https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib-readme.html#app-context is the "parent" README file.

Copy link
Contributor

mergify bot commented Jan 3, 2024

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).

@mergify mergify bot dismissed kaizencc’s stale review January 3, 2024 07:21

Pull request has been modified.

@aws-cdk-automation aws-cdk-automation added the pr/needs-community-review This PR needs a review from a Trusted Community Member or Core Team Member. label Jan 3, 2024
Copy link
Contributor

@kaizencc kaizencc left a comment

Choose a reason for hiding this comment

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

Hmm you're right. My best guess is that we want to keep this behavior so that both show up in the generated docs. So I'm happy with this update and also something in the future to ensure they stay in sync.

It shouldn't be in prlint though. I think it can just be a special case of awslint where we check that these two files match.

Copy link
Contributor

@kaizencc kaizencc left a comment

Choose a reason for hiding this comment

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

Hmm you're right. My best guess is that we want to keep this behavior so that both show up in the generated docs. So I'm happy with this update and also something in the future to ensure they stay in sync.

It shouldn't be in prlint though. I think it can just be a special case of awslint where we check that these two files match.

@aws-cdk-automation aws-cdk-automation removed the pr/needs-community-review This PR needs a review from a Trusted Community Member or Core Team Member. label Jan 3, 2024
@aws-cdk-automation
Copy link
Collaborator

AWS CodeBuild CI Report

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

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

Copy link
Contributor

mergify bot commented Jan 3, 2024

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).

@mergify mergify bot merged commit b625510 into aws:main Jan 3, 2024
13 checks passed
paulhcsun pushed a commit to paulhcsun/aws-cdk that referenced this pull request Jan 5, 2024
`splitArn` is the correct updated version of `parseArn`. It's now
necessary to use `ArnFormat` not a literal string for the format of the
ARN resource for `splitArn` and `formatArn`.

----

*By submitting this pull request, I confirm that my contribution is made under the terms of the Apache-2.0 license*
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
p2 star-contributor [Pilot] contributed between 25-49 PRs to the CDK
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants