Skip to content

docs(lambda): log group docs not being rendered properly#28871

Merged
mergify[bot] merged 1 commit intoaws:mainfrom
longtv2222:docs-log-group-not-rendered
Jan 26, 2024
Merged

docs(lambda): log group docs not being rendered properly#28871
mergify[bot] merged 1 commit intoaws:mainfrom
longtv2222:docs-log-group-not-rendered

Conversation

@longtv2222
Copy link
Copy Markdown
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
Copy Markdown
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
Copy Markdown
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.

❤️

@mergify
Copy link
Copy Markdown
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
@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