Hacker News new | ask | show | jobs
by lelandfe 478 days ago
> TypeScript 5.8 is out bringing with it the --erasableSyntaxOnly flag

TypeScript sure loves the "our only documentation lives in the changelog" approach to stuff, huh?

- The on-site Algolia search returns 0 results for "erasableSyntaxOnly"

- The blocked-from-search release notes[0] looks like actual documentation - but urges to check out the PR[1] "for more information," despite the PR description being essentially blank.

- The CLI options page[2] describes it thus: "Do not allow runtime constructs that are not part of ECMAScript," with no links to learn more about what that means.

Edit: actually, I take it back! Clicking the flag on the CLI page takes one to an intimidating junk drawer page... but my issues with discoverability stand: https://www.typescriptlang.org/tsconfig/#erasableSyntaxOnly

[0] https://www.typescriptlang.org/docs/handbook/release-notes/t...

[1] https://github.com/microsoft/TypeScript/pull/61011

[2] No idea why on-site search doesn't pick this up: https://www.typescriptlang.org/docs/handbook/compiler-option...

2 comments

It was released late last week wasn’t it?
It happened within hours, it can take a bit to update the docs and then get them reindexed.