Semantic Versioning

[ghost]

Request for better semantic versioning page

I like this guide but to an idiot (like me who is starting to learn C# as a grade 8 student,) I don't know what an incompatible API change is and would like some examples. Another thing that doesn't make sense is "when you add functionality in a backwards-compatible manner", does that mean every time I make a change where you have to update the app I change the Major version?

All I know about Semantic Versioning is that a BIG update is a new Major version like v1.0.0. An added feature (like new items to buy in-game or new bad guys to defeat) is a Minor version like v0.1.0. And a patch/bug fix, is like a patch/bug fix, fixing a small bug where you can't see an enemy for example. But my problem is knowing when to make a Major version and what "when you add functionality in a backwards-compatible manner" means.

• Explain why this article is needed... Because I am a beginner at programming and semantic versioning
• Suggest a location in the Table of Contents... Added to here

Console.WriteLine("Thank you for your time!");

Edit by @BillWagner to add the document details block.

---

Document Details

⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

• ID: b3e468f2-2cc4-a461-4e67-47e7aeff555d
• Version Independent ID: 5e2ade07-13fa-ddfc-377a-f6aa52738b4e
• Content: C# Versioning - C# Guide
• Content Source: docs/csharp/versioning.md
• Product: dotnet-csharp
• Technology: csharp-advanced-concepts
• GitHub Login: @BillWagner
• Microsoft Alias: wiwagn

[BillWagner]

closing and reopening to apply new labels.

[BillWagner]

I've added this to our backlog.