Skip to content

Conversation

Josmithr
Copy link

@Josmithr Josmithr commented Oct 7, 2025

Preserves line breaks when emitting TSDoc comments. Ensures information is not lost.

@Josmithr Josmithr changed the title feat(tsdoc): Don't strip line breaks when parsing comments feat(tsdoc): Don't strip line breaks when emitting comments Oct 7, 2025
@Josmithr Josmithr changed the title feat(tsdoc): Don't strip line breaks when emitting comments feat(tsdoc): Don't replace line breaks when emitting comments Oct 7, 2025
@octogonz
Copy link
Collaborator

octogonz commented Oct 7, 2025

This LGTM but I'm currently traveling, so I'm not able to test it.

@iclanton maybe you can try it in the playground?

{
"packageName": "@microsoft/tsdoc",
"comment": "Update emitter to not replace line breaks",
"type": "major"
Copy link
Author

Choose a reason for hiding this comment

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

I tagged this as major. I'm assuming we consider a change to the emitted format to be a breaking one.

Copy link
Member

Choose a reason for hiding this comment

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

This should probably be a minor bump. This isn't a significant behavior change.

Suggested change
"type": "major"
"type": "minor"

@Josmithr Josmithr marked this pull request as ready for review October 8, 2025 14:32
@Josmithr Josmithr mentioned this pull request Oct 8, 2025
@iclanton
Copy link
Member

iclanton commented Oct 9, 2025

@Josmithr, can you provide some examples of what this actually changes? Maybe inputs and diffs of the before/after outputs?

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.

3 participants