
Description
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