v1.3.0 release

- Final update to documentation

Author: tpcarman

.github/ISSUE_TEMPLATE/bug_report.md

@@ -21,11 +21,9 @@ A clear and concise description of what you expected to happen.
 If applicable, add screenshots to help explain your problem.
 
 **System (please provide the following information about the system from which you are trying to generate a report):**
- - OS: [e.g. Windows 10]
- - PowerShell version [Provide output from the following command: `$PSVersionTable.PSVersion`]
- - Vendor PowerShell Module name and version [e.g. VMware PowerCLI 11.2]
- - AsBuiltReport.Core module version [e.g. 1.0.0]
- - AsBuiltReport module name and version [e.g. AsBuiltReport.VMware.vSphere 1.0.0]
+ - Operating System: [e.g. Windows 10, macOS 12, Ubuntu 20.04]
+ - PowerShell version [Provide output from the following command: `$PSVersionTable`]
+ - AsBuiltReport.Core module version [Provide output from the following command: `Get-Module -ListAvailable AsBuiltReport.Core`]
 
 **Additional context**
 Add any other context about the problem here.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -5,7 +5,7 @@ about: Suggest an idea for this project
 ---
 
 **Is your feature request related to a problem? Please describe.**
-A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+A clear and concise description of what the problem is. e.g. I'm always frustrated when [...]
 
 **Describe the solution you'd like**
 A clear and concise description of what you want to happen.

.github/PULL_REQUEST_TEMPLATE.md

@@ -31,4 +31,4 @@
 - [ ] My code follows the code style of this project.
 - [ ] My change requires a change to the documentation.
 - [ ] I have updated the documentation accordingly.
-- [ ] I have read the [**CONTRIBUTING**](https://www.asbuiltreport.com/about/contributing/) page.
+- [ ] I have read the [**CONTRIBUTING**](/CONTRIBUTING.md) page.

AsBuiltReport.Core.psd1

@@ -28,7 +28,7 @@
     # CompanyName = ''
 
     # Copyright statement for this module
-    Copyright = '(c) 2020 Tim Carman. All rights reserved.'
+    Copyright = '(c) 2022 Tim Carman. All rights reserved.'
 
     # Description of the functionality provided by this module
     Description = 'A PowerShell module which provides the core framework for generating As-Built documentation for many common datacentre systems.'

CHANGELOG.md

@@ -7,11 +7,11 @@
 ### Changed
 - Updated `RequiredModules` for PScribo 0.10.0
 - Updated installation instructions in `README.md`
-- Updated `CONTRIBUTING.md`
+- Updated contributing guide in `CONTRIBUTING.md`
 - Updated PSScriptAnalyzer settings
-- Updated Pull Request and Bug Report templates
-- Updated comment based help
-- Improved functionality for PowerShell 7
+- Updated GitHub issue templates
+- Updated comment based help for AsBuiltReport cmdlets
+- Improved command functionality for macOS and Linux users
 
 ## [1.2.0] - 2022-02-11
 ### Added

CONTRIBUTING.md

@@ -157,7 +157,7 @@ Use [PSScriptAnalyzer](https://github.com/PowerShell/PSScriptAnalyzer) to check
 - Maintain a change log as per [these guidelines](https://keepachangelog.com/en/1.0.0/). The change log should be named `CHANGELOG.md`.
 
 ❌ DO NOT
-<!-- - Do not include code within report scripts to install or import PowerShell modules. Dependencies should be documented under the `System Requirements` and `Module Installation` sections of the `README`. -->
+- Do not include code within report scripts to install or import PowerShell modules. Dependencies should either be documented under the `System Requirements` and `Module Installation` sections of the `README`, or added to the `RequiredModules` section within the report module manifest.
 - Do not include functions within report scripts. Individual script files should be created as a private function and be stored in the `\Src\Private` folder.
 
 ### License

README.md

@@ -230,8 +230,8 @@ New-AsBuiltReport -Report 'Cisco.UCSManager' -Target '192.168.1.100' -Username '
 New-AsBuiltReport -Report 'Nutanix.PrismElement' -Target '192.168.1.100' -Username 'admin' -Password 'admin' -Format HTML -AsBuiltConfigFilePath 'C:\scripts\asbuilt.json' -OutputFolderPath 'H:\Documents\' -Filename 'My Nutanix Configuration'
 ```
 
-## :pencil: Notes
-- Table Of Contents (TOC) may be missing in Word formatted report
+## :x: Known Issues
+- **Table Of Contents (TOC) is missing in Word formatted report**
 
     When opening a Microsoft Word (DOCX) report for the first time, you will be prompted with the following warning;
 
@@ -243,4 +243,8 @@ New-AsBuiltReport -Report 'Nutanix.PrismElement' -Target '192.168.1.100' -Userna
 
     Always reply Yes to this message when prompted by Microsoft Word to ensure the Table of Contents is updated.
 
-    Save the document to prevent future prompts when opening the document.
+    Save the document to prevent future prompts when opening the document.
+
+- **Images are missing from reports generated using Linux or macOS**
+
+    Unfortunately due to [breaking changes](https://learn.microsoft.com/en-gb/dotnet/core/compatibility/core-libraries/6.0/system-drawing-common-windows-only) in .NET 6, images are no longer supported for reports generated using Linux or macOS.