microsoft / microsoft/TypeScript

Start following semantic versioning

Open
#56,916 20 comments 1 reaction 0 assignees View on GitHub

Nobody has claimed this yet.

Discussion
Dominant language
Go
Stars
111k
Forks
14.4k
Avg merge
1d 19h
Merged PRs (30d)
117

Description

🔍 Search Terms

semantic versioning

✅ Viability Checklist
⭐ Suggestion

Start following semantic versioning from now on.

I know TypeScript currently doesn't follow semantic versining, and push breaking changes for every minor version. I could not find any mention as to why it is the case.

There is no reason TypeScript cannot follow semantic versioning. There is simply no other major library that doesn't follow semantic versioning in NPM ecosystem. There is also no problem with pushing major version every other months. It just means the version will be incrementing a lot quicker. It means it follows the ecosystem's standard and more predictable for a lot of people.

📃 Motivating Example
  • Version update is more predictable and follows standard of the Node.js/npm ecosystem.
  • You no longer have to change ^x.y.z to ~x.y.z every time you run npm i -D typescript
💻 Use Cases
  1. What do you want to use this for?
    • More predictable and standard versioning when installing TypeScript
  2. What shortcomings exist with current approaches?
    • Non-standard versioning in the ecosystem
  3. What workarounds are you using in the meantime?
    • Change ^ to ~ in the version specifier

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

The issue names no files, tests, or entry points. Read the existing discussion and the project's release/versioning process first; done would require an agreed plan for adopting semantic versioning rather than a localized code change.

Written by the indexing model from the issue text.

Assessment

Tech stack
javascript, typescript
Domain
release
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
20/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.