Update readme

README.md

@@ -1,70 +1,146 @@
 # PSMockModule
 
-[![badge-build-azuredevops-build-img][]][badge-build-azuredevops-build-src] [![badge-version-github-tag-img][]][badge-version-github-tag-src] [![badge-version-powershellgallery-releases-img][]][badge-version-powershellgallery-releases-src]
+[![badge-build-azuredevops-build-img][]][badge-build-azuredevops-build-src] [![badge-version-github-release-img][]][badge-version-github-release-src] [![badge-version-powershellgallery-releases-img][]][badge-version-powershellgallery-releases-src]
 
 [badge-build-azuredevops-build-img]: https://img.shields.io/azure-devops/build/theohbrothers/PSMockModule/7/master.svg?label=build&logo=azure-pipelines&style=flat-square
 [badge-build-azuredevops-build-src]: https://dev.azure.com/theohbrothers/PSMockModule/_build?definitionId=7
-[badge-version-github-tag-img]: https://img.shields.io/github/v/tag/theohbrothers/PSMockModule?style=flat-square
-[badge-version-github-tag-src]: https://github.com/theohbrothers/PSMockModule/releases
+[badge-version-github-release-img]: https://img.shields.io/github/v/release/theohbrothers/PSMockModule?style=flat-square
+[badge-version-github-release-src]: https://github.com/joeltimothyoh/PSMockModule/releases
 [badge-version-powershellgallery-releases-img]: https://img.shields.io/powershellgallery/v/PSMockModule?logo=powershell&logoColor=white&label=PSGallery&labelColor=&style=flat-square
 [badge-version-powershellgallery-releases-src]: https://www.powershellgallery.com/packages/PSMockModule/
 
-A mock powershell module for templating and reference.
+## Introduction
+
+A mock PowerShell module for templating and reference.
+
+- [Windows PowerShell](https://docs.microsoft.com/en-us/powershell/scripting/install/installing-windows-powershell?view=powershell-5.1) or [PowerShell Core](https://github.com/powershell/powershell#-powershell).
 
 ## Installation
 
-First, register [`PSGallery`](https://www.powershellgallery.com/) as a PowerShell repository:
+First, ensure [`PSGallery`](https://www.powershellgallery.com/) is registered as a PowerShell repository:
 
 ```powershell
-Register-PSRepository -Default
+Register-PSRepository -Default -Verbose
 ```
 
 To install the module:
 
 ```powershell
-# For the current user
-Install-Module -Name PSMockModule -Repository PSGallery -Scope CurrentUser
+# Latest, for the current user
+Install-Module -Name PSMockModule -Repository PSGallery -Scope CurrentUser -Verbose
+
+# Specific version, for the current user
+Install-Module -Name PSMockModule -Repository PSGallery -RequiredVersion x.x.x -Scope CurrentUser -Verbose
 
-# For all users
-Install-Module -Name PSMockModule -Repository PSGallery -Scope AllUsers
+# Latest, for all users
+Install-Module -Name PSMockModule -Repository PSGallery -Scope AllUsers -Verbose
 ```
 
 ## Usage
 
+### Functions
+
+To run Mock-Function1:
+
 ```powershell
-# Runs Mock-Function1
-Mock-Function1
+Mock-Function1 -Verbose
+```
 
-# Runs Mock-Function2
-Mock-Function2
+To run Mock-Function2:
+
+```powershell
+Mock-Function2 -Verbose
+```
+
+To list all available functions of the module:
+
+```powershell
+Get-Command -Module PSMockModule
 ```
 
 ## Administration
 
-To import the module:
+### Versions
+
+To list versions of the module on `PSGallery`:
 
 ```powershell
-# Import the installed version
+# Latest
+Find-Module -Name PSMockModule -Repository PSGallery -Verbose
+
+# All versions
+Find-Module -Name PSMockModule -Repository PSGallery -AllVersions -Verbose
+```
+
+To update the module (**Existing versions are left intact**):
+
+```powershell
+# Latest
+Update-Module -Name PSMockModule -Verbose
+
+# Specific version
+Update-Module -Name PSMockModule -RequiredVersion x.x.x -Verbose
+```
+
+To uninstall the module:
+
+```powershell
+# Latest
+Uninstall-Module -Name PSMockModule -Verbose
+
+# All versions
+Uninstall-Module -Name PSMockModule -AllVersions -Verbose
+
+# To uninstall all other versions other than x.x.x
+Get-Module -Name PSMockModule -ListAvailable | ? { $_.Version -ne 'x.x.x' } | % { Uninstall-Module -Name $_.Name -RequiredVersion $_.Version -Verbose }
+
+# Tip: Simulate uninstalls with -WhatIf
+```
+
+### Repositories
+
+To get all registered PowerShell repositories:
+
+```powershell
+Get-PSRepository -Verbose
+```
+
+To set the installation policy for the `PSGallery` repository:
+
+```powershell
+# PSGallery (trusted)
+Set-PSRepository -Name PSGallery -InstallationPolicy Trusted -Verbose
+
+# PSGallery (untrusted)
+Set-PSRepository -Name PSGallery -InstallationPolicy Untrusted -Verbose
+```
+
+### Development
+
+To import / re-import the module:
+
+```powershell
+# Installed version
 Import-Module -Name PSMockModule -Force -Verbose
 
-# Import the project version
+# Project version
 Import-Module .\src\PSMockModule\PSMockModule.psm1 -Force -Verbose
 ```
 
-To list all available functions:
+To remove imported functions of the module:
 
 ```powershell
-Get-Command -Module PSMockModule
+Remove-Module -Name PSMockModule -Verbose
 ```
 
-To list all installed versions:
+To list imported versions of the module:
 
 ```powershell
-Get-Module -Name PSMockModule -ListAvailable
+Get-Module -Name PSMockModule
 ```
 
-To update the module:
+To list all installed versions of the module available for import:
 
 ```powershell
-Update-Module -Name PSMockModule -Verbose
+Get-Module -Name PSMockModule -ListAvailable -Verbose
 ```