From 24c4c6021e2e03b8774ec34cac107a3d43dc3e29 Mon Sep 17 00:00:00 2001 From: Marius Storhaug Date: Mon, 6 Jul 2026 08:27:36 +0200 Subject: [PATCH 1/3] Standardize README landing page --- README.md | 86 ++++++------------------------------------------------- 1 file changed, 9 insertions(+), 77 deletions(-) diff --git a/README.md b/README.md index 5d48836..b096545 100644 --- a/README.md +++ b/README.md @@ -1,95 +1,27 @@ # PSSemVer -This module introduces a SemVer 2.0.0 compatible class for PowerShell. - -## Prerequisites - -No prerequisites. +PSSemVer is a PowerShell module that adds a SemVer-compatible class and helper functions. ## Installation -To install the module and class run the following command: +Install the module from the PowerShell Gallery: ```powershell -Install-Module -Name PSSemVer +Install-PSResource -Name PSSemVer Import-Module -Name PSSemVer ``` -## Usage - -Here is a list of example that are typical use cases for the module. -This section should provide a good overview of the module's capabilities. - -### Create a new SemVer object - -```powershell -$Version = New-PSSemVer -Version 1.0.0 -``` - -### Create a new SemVer object with prerelease and build metadata - -```powershell -$Version = New-PSSemVer -Version 1.0.0 -PreRelease 'alpha' -Build '2020-01-01' -``` - -### Create a new SemVer object from a string - -```powershell -$Version = New-PSSemVer -Version '1.0.0-alpha+2020-01-01' -``` - -### Compare two SemVer objects - -```powershell -$Version1 = New-PSSemVer -Version 1.0.0 -$Version2 = New-PSSemVer -Version 1.0.1 -$Version1 -lt $Version2 ->_ true -``` - -### Increment the major version - -```powershell -$Version = New-PSSemVer -Version 1.0.0 -$Version.BumpMajor() -``` - -### Increment the minor version - -```powershell -$Version = New-PSSemVer -Version 1.0.0 -$Version.BumpMinor() -``` - -### Increment the patch version +## Documentation -```powershell -$Version = New-PSSemVer -Version 1.0.0 -$Version.BumpPatch() -``` +Documentation is published at [psmodule.io/PSSemVer](https://psmodule.io/PSSemVer/). -### Set the prerelease +Use PowerShell help and command discovery for module details: ```powershell -$Version = New-PSSemVer -Version 1.0.0 -$Version.SetPreRelease('alpha') +Get-Command -Module PSSemVer +Get-Help -Examples ``` ## Contributing -Coder or not, you can contribute to the project! We welcome all contributions. - -### For Users - -If you don't code, you still sit on valuable information that can make this project even better. If you experience that the -product does unexpected things, throw errors or is missing functionality, you can help by submitting bugs and feature requests. -Please see the issues tab on this project and submit a new issue that matches your needs. - -### For Developers - -If you do code, we'd love to have your contributions. Please read the [Contribution guidelines](CONTRIBUTING.md) for more information. -You can either help by picking up an existing issue or submit a new one if you have an idea for a new feature or improvement. - -## Links - -- [Semantic Versioning 2.0.0](https://semver.org/) +Issues and pull requests are welcome. Please use the repository issue tracker to report bugs, request features, or discuss improvements. From bf1508e0b713a52cb678a87f7ec067599cc25bcc Mon Sep 17 00:00:00 2001 From: Marius Storhaug Date: Mon, 6 Jul 2026 10:32:06 +0200 Subject: [PATCH 2/3] Address Copilot README review --- README.md | 1 + 1 file changed, 1 insertion(+) diff --git a/README.md b/README.md index b096545..f5dbd3c 100644 --- a/README.md +++ b/README.md @@ -7,6 +7,7 @@ PSSemVer is a PowerShell module that adds a SemVer-compatible class and helper f Install the module from the PowerShell Gallery: ```powershell +Install-Module -Name Microsoft.PowerShell.PSResourceGet -Scope CurrentUser Install-PSResource -Name PSSemVer Import-Module -Name PSSemVer ``` From 33c499a543cd169cb67c590445e90002a01d111b Mon Sep 17 00:00:00 2001 From: Marius Storhaug Date: Mon, 6 Jul 2026 10:32:44 +0200 Subject: [PATCH 3/3] Address Copilot README review --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index f5dbd3c..dbd200d 100644 --- a/README.md +++ b/README.md @@ -20,7 +20,7 @@ Use PowerShell help and command discovery for module details: ```powershell Get-Command -Module PSSemVer -Get-Help -Examples +Get-Help ConvertTo-PSSemVer -Examples ``` ## Contributing