📖 [Docs]: README pages now use the standard module landing-page format

README.md

@@ -1,18 +1,17 @@
 # Fonts
 
-This is a PowerShell module for managing fonts.
-It helps you to install, uninstall and list fonts on the system.
+Fonts is a PowerShell module for managing fonts. It helps you install, uninstall, and list fonts on the system.
 
-This module only provides the functionality to manage fonts on the system. To install popular fonts on the system,
-please review the [NerdFonts](https://github.com/PSModule/NerdFonts) and [GoogleFonts](https://github.com/PSModule/GoogleFonts) modules.
+This module only provides the functionality to manage fonts on the system. To install popular fonts, review the
+[NerdFonts](https://github.com/PSModule/NerdFonts) and [GoogleFonts](https://github.com/PSModule/GoogleFonts) modules.
 
 ## Supported platforms
 
-This module supports managing fonts on Linux, macOS and Windows operating systems.
+This module supports managing fonts on Linux, macOS, and Windows operating systems.
 
 ## Installation
 
-To install the module simply run the following command in a PowerShell terminal.
+Install the module from the PowerShell Gallery:
 
 ```powershell
 Install-PSResource -Name Fonts
@@ -21,68 +20,61 @@ Import-Module -Name Fonts
 
 ## Usage
 
-You can use this module to install, uninstall and list fonts on your system.
+Use the module to list, install, and uninstall fonts on your system.
 
-### List installed fonts
+### Example: List installed fonts
 
-This command will list all fonts installed in the user context.
+List all fonts installed in the current user context:
 
 ```powershell
 Get-Font
 ```
 
-This command will list all fonts installed in the system context.
-For Windows this means that it will list all fonts installed on the `C:\Windows\Fonts` folder.
+List all fonts installed in the system context. On Windows this lists the fonts in the `C:\Windows\Fonts` folder:
 
 ```powershell
 Get-Font -Scope AllUsers
 ```
 
-### Install a font
+### Example: Install a font
 
-To install a font in the user context, you can use the following command.
-This will install the font in the users font folder `$env:LOCALAPPDATA\Microsoft\Windows\Fonts` and update the registry to
-make it available to the current user.
+Install a font in the current user context. This installs the font in the user font folder and updates the
+registry so it is available to the current user:
 
 ```powershell
 Install-Font -Path 'C:\path\to\font.ttf'
 ```
 
-To install a font on the system you can use the following command. This will need to be run as an administrator.
-This will install the font in the `C:\Windows\Fonts` folder and update the registry to make it available to all users on the system.
+Install a font for all users. This must run as an administrator, installs the font in the `C:\Windows\Fonts`
+folder, and updates the registry so it is available to every user on the system:
 
 ```powershell
 Install-Font -Path 'C:\path\to\font.ttf' -Scope AllUsers
 ```
 
-### Uninstall a font
+### Example: Uninstall a font
 
-To uninstall a font from the user context, you can use the following command.
-This will remove the font from the users font folder `$env:LOCALAPPDATA\Microsoft\Windows\Fonts` and update the
-registry to remove it from the current user.
+Uninstall a font from the current user context. This removes the font from the user font folder and updates the
+registry to remove it from the current user:
 
 ```powershell
-Uninstall-Font -Name 'FontName' # You can tab complete the font name
+Uninstall-Font -Name 'FontName'
 ```
 
-To uninstall a font from the system you can use the following command. This will need to be run as an administrator.
-This will remove the font from the `C:\Windows\Fonts` folder and update the registry to remove it from all users on the system.
+Uninstall a font for all users. This must run as an administrator, removes the font from the `C:\Windows\Fonts`
+folder, and updates the registry to remove it from every user on the system:
 
 ```powershell
-Uninstall-Font -Name 'FontName' -Scope AllUsers # You can tab complete the font name
+Uninstall-Font -Name 'FontName' -Scope AllUsers
 ```
 
-## Contributing
+## Documentation
 
-Coder or not, you can contribute to the project! We welcome all contributions.
+Documentation is published at [psmodule.io/Fonts](https://psmodule.io/Fonts/).
 
-### For Users
+Use PowerShell help and command discovery for module details:
 
-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.
+```powershell
+Get-Command -Module Fonts
+Get-Help -Name Install-Font -Examples
+```