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(lambda): log group docs not being rendered properly #28871

Merged
merged 1 commit into from
Jan 26, 2024

Conversation

longtv2222
Copy link
Contributor

@longtv2222 longtv2222 commented Jan 25, 2024

TSDoc for logGroup is not being rendered properly due to the use of < and >.

This affects Vscode:

Screenshot 2024-01-25 164442

And aws-cdk-lib docs as well: https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_lambda.Function.html#loggroup

Screenshot 2024-01-25 164752

Fixed by escaping < and > properly

This is probably caused by < is interpreted as opening JSX tags by MDX.

After fix:
Screenshot 2024-01-25 165425


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

@aws-cdk-automation aws-cdk-automation requested a review from a team January 25, 2024 23:49
@github-actions github-actions bot added repeat-contributor [Pilot] contributed between 3-5 PRs to the CDK p2 labels Jan 25, 2024
@aws-cdk-automation
Copy link
Collaborator

AWS CodeBuild CI Report

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

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

@longtv2222 longtv2222 marked this pull request as ready for review January 26, 2024 00:18
Copy link
Contributor

@mrgrain mrgrain left a comment

Choose a reason for hiding this comment

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

❤️

Copy link
Contributor

mergify bot commented Jan 26, 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 589c19c into aws:main Jan 26, 2024
34 checks passed
@longtv2222 longtv2222 deleted the docs-log-group-not-rendered branch January 26, 2024 15:13
Vandita2020 pushed a commit to Vandita2020/aws-cdk that referenced this pull request Jan 30, 2024
TSDoc for `logGroup` is not being rendered properly due to the use of `<` and `>`.

This affects Vscode:

![Screenshot 2024-01-25 164442](https://github.com/aws/aws-cdk/assets/61606375/9db93b8c-dcbc-437e-8c07-a5f6b30c99b7)

And `aws-cdk-lib` docs as well: https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_lambda.Function.html#loggroup

![Screenshot 2024-01-25 164752](https://github.com/aws/aws-cdk/assets/61606375/a924353e-f5c2-4355-80d8-b511bb6488a3)

Fixed by escaping `<` and `>` properly

This is probably caused by `<` is interpreted as opening `JSX` tags by `MDX`.

After fix:
![Screenshot 2024-01-25 165425](https://github.com/aws/aws-cdk/assets/61606375/c40c225b-cfac-4cf8-a102-832bc5f00213)



----

*By submitting this pull request, I confirm that my contribution is made under the terms of the Apache-2.0 license*
SankyRed pushed a commit that referenced this pull request Feb 8, 2024
TSDoc for `logGroup` is not being rendered properly due to the use of `<` and `>`.

This affects Vscode:

![Screenshot 2024-01-25 164442](https://github.com/aws/aws-cdk/assets/61606375/9db93b8c-dcbc-437e-8c07-a5f6b30c99b7)

And `aws-cdk-lib` docs as well: https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_lambda.Function.html#loggroup

![Screenshot 2024-01-25 164752](https://github.com/aws/aws-cdk/assets/61606375/a924353e-f5c2-4355-80d8-b511bb6488a3)

Fixed by escaping `<` and `>` properly

This is probably caused by `<` is interpreted as opening `JSX` tags by `MDX`.

After fix:
![Screenshot 2024-01-25 165425](https://github.com/aws/aws-cdk/assets/61606375/c40c225b-cfac-4cf8-a102-832bc5f00213)



----

*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 repeat-contributor [Pilot] contributed between 3-5 PRs to the CDK
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants