tc39 / tc39/ecmarkup

Should ASCII apostrophes be replaced with U+2019 RIGHT SINGLE QUOTATION MARK `’`?

Open
#703 1 comment 1 reaction 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
TypeScript
Stars
245
Forks
80
Avg merge
10h 46m
Merged PRs (30d)
2

Description

Related to #701, there are also instances of U+0027 APOSTROPHE (') in ECMA-262 and ECMA-402 that could be replaced with the so-called "punctuation apostrophe":

  • 's possessives
  • bare plural possessives (workers'/events'/etc.)
  • contractions (don't/we've/etc.)
  • year groups (OOPSLA '97)

ECMA-402 also has one use of ' for quoting (in CanonicalizeUValue: «recommended that implementations use the 'u' extension data»), but that can be avoided by rewording.

I think ecmarkup would just replace any non-code ', assuming that it is not part of a quoting pair—and we have the <!-- emu-format ignore --> escape hatch for any future sites in which that assumption doesn't hold.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reading ecmarkup's handling of non-code apostrophes and the discussion in related issue #701. Check the affected ECMA-262 and ECMA-402 text, then verify that non-code U+0027 apostrophes are replaced while quoting pairs and the emu-format ignore escape hatch remain supported.

Written by the indexing model from the issue text.

Assessment

Tech stack
typescript
Domain
documentation
Issue type
Feature
Difficulty
3/5
Estimated time
1-2 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
55/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.