Skip to content

Clarify Comment Syntax#19

Merged
DecimalTurn merged 3 commits intomainfrom
comment
Apr 15, 2026
Merged

Clarify Comment Syntax#19
DecimalTurn merged 3 commits intomainfrom
comment

Conversation

@DecimalTurn
Copy link
Copy Markdown
Member

Addreses #9 and some other potential confusion with comment syntax.

Note that the name "Multi-line" was kept as section title since that's the terminology used in EcmaScript.

This PR will:

  • add terminology for line endings and insignificant whitespace
  • state that comments are informational only and must not affect consumed JSON values
  • clarify single-line comment behavior to end at line ending
  • expand single-line example to show a case at the end of a line
  • expand multi-line example to show a case within a line
  • mention that nested "block" comments aren't supported

@hattesen, I added you as co-author of 03b0dfd since I used your snippet to illustrate the invalid nesting syntax. I can remove the mention if you prefer before merging.

DecimalTurn and others added 3 commits March 28, 2026 23:40
- add terminology for line endings and insignificant whitespace
- state that comments are informational only and must not affect consumed JSON values
clarify single-line comment behavior to end at line ending
- expand single-line example to show case at the end of a line
Co-authored-by: hattesen <hattesen@users.noreply.github.com>
@DecimalTurn DecimalTurn marked this pull request as ready for review March 29, 2026 15:02
@github-actions
Copy link
Copy Markdown

github-actions bot commented Mar 29, 2026

PR Preview Action v1.6.3
Preview removed because the pull request was closed.
2026-04-15 19:40 UTC

@DecimalTurn DecimalTurn mentioned this pull request Mar 29, 2026
@DecimalTurn DecimalTurn merged commit 6c5a330 into main Apr 15, 2026
1 check passed
@DecimalTurn DecimalTurn deleted the comment branch April 15, 2026 19:40
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.

1 participant