Merge pull request #24 from StartAutomating/LightScriptImprovements

Light script improvements

Author: StartAutomating

Add-HueLight.ps1

@@ -1,4 +1,21 @@
 function Add-HueLight {
+    <#
+    .SYNOPSIS
+        Adds lights to Hue
+    .DESCRIPTION
+        Adds new lights to a Hue Bridge.
+    .EXAMPLE
+        Add-HueLight # Search for new lights
+    .EXAMPLE
+        Add-HueLight -DeviceID $serialNumber # Add a new light by serial number.
+    .EXAMPLE
+        Add-HueLight        # Search for new lights
+        Get-HueLight -New   # Get-HueLight -New will return the new lights
+    .LINK
+        Get-HueLight
+    .LINK
+        Set-HueLight
+    #>
 
     [CmdletBinding(SupportsShouldProcess)]
 

Add-HueLight.ps1.ps1

@@ -1,5 +1,22 @@
 function Add-HueLight
 {
+    <#
+    .SYNOPSIS
+        Adds lights to Hue
+    .DESCRIPTION
+        Adds new lights to a Hue Bridge.
+    .EXAMPLE
+        Add-HueLight # Search for new lights
+    .EXAMPLE
+        Add-HueLight -DeviceID $serialNumber # Add a new light by serial number.
+    .EXAMPLE
+        Add-HueLight        # Search for new lights
+        Get-HueLight -New   # Get-HueLight -New will return the new lights
+    .LINK
+        Get-HueLight
+    .LINK
+        Set-HueLight
+    #>
     [Rest("lights",
         Invoker="Send-HueBridge",
         Method='POST',

CHANGELOG.md

@@ -1,3 +1,9 @@
+## 0.2.4.1
+* Adding help for Add-HueLight (#23)
+* Fixing other markdown documentation layout issues
+---
+
+
 ## 0.2.4
 * Adding Add-HueLight (#18)
 * Adding Get-HueLight -New (#21)

LightScript.HelpOut.ps1

@@ -8,6 +8,5 @@ if ($LightScriptLoaded) {
     "::error:: LightScript not loaded" |Out-Host
 }
 if ($LightScriptLoaded) {
-    Save-MarkdownHelp -Module $LightScriptLoaded.Name -PassThru |
-        Add-Member ScriptProperty CommitMessage { "Updating $($this.Name)" } -Force -PassThru
+    Save-MarkdownHelp -Module $LightScriptLoaded.Name -PassThru
 }

LightScript.psd1

@@ -1,5 +1,5 @@
 @{
-    ModuleVersion = '0.2.4'
+    ModuleVersion = '0.2.4.1'
     RootModule = 'LightScript.psm1'
     Description = 'Smarter Lighting with PowerShell'
     FormatsToProcess = 'LightScript.format.ps1xml'
@@ -14,6 +14,11 @@
             LicenseURI = 'https://github.com/StartAutomating/LightScript/blob/main/LICENSE'
             IconURI    = 'https://github.com/StartAutomating/LightScript/blob/main/Assets/LightScript.png'
             ReleaseNotes = @'
+## 0.2.4.1
+* Adding help for Add-HueLight (#23)
+* Fixing other markdown documentation layout issues
+---
+
 ## 0.2.4
 * Adding Add-HueLight (#18)
 * Adding Get-HueLight -New (#21)

docs/Add-HueLight.md

@@ -2,52 +2,64 @@
 Add-HueLight
 ------------
 ### Synopsis
+Adds lights to Hue
 
-Add-HueLight [[-DeviceID] <string[]>] [-WhatIf] [-Confirm] [<CommonParameters>]
+---
+### Description
 
+Adds new lights to a Hue Bridge.
 
 ---
-### Description
+### Related Links
+* [Get-HueLight](Get-HueLight.md)
+* [Set-HueLight](Set-HueLight.md)
 ---
-### Parameters
-#### **Confirm**
--Confirm is an automatic variable that is created when a command has ```[CmdletBinding(SupportsShouldProcess)]```.
--Confirm is used to -Confirm each operation.
-    
-If you pass ```-Confirm:$false``` you will not be prompted.
-    
-    
-If the command sets a ```[ConfirmImpact("Medium")]``` which is lower than ```$confirmImpactPreference```, you will not be prompted unless -Confirm is passed.
+### Examples
+#### EXAMPLE 1
+```PowerShell
+Add-HueLight # Search for new lights
+```
+
+#### EXAMPLE 2
+```PowerShell
+Add-HueLight -DeviceID $serialNumber # Add a new light by serial number.
+```
 
+#### EXAMPLE 3
+```PowerShell
+Add-HueLight        # Search for new lights
+Get-HueLight -New   # Get-HueLight -New will return the new lights
+```
+
+---
+### Parameters
 #### **DeviceID**
 
+One or more Device Identifiers (serial numbers ).
+Use this parameter when adding lights that have already been assigned to another bridge.
+
+
+
 |Type            |Requried|Postion|PipelineInput|
 |----------------|--------|-------|-------------|
-|```[string[]]```|false   |0      |false        |
+|```[String[]]```|false   |1      |false        |
 ---
 #### **WhatIf**
 -WhatIf is an automatic variable that is created when a command has ```[CmdletBinding(SupportsShouldProcess)]```.
 -WhatIf is used to see what would happen, or return operations without executing them
----
-### Inputs
-None
-
-
----
-### Outputs
-System.Object
-
+#### **Confirm**
+-Confirm is an automatic variable that is created when a command has ```[CmdletBinding(SupportsShouldProcess)]```.
+-Confirm is used to -Confirm each operation.
+    
+If you pass ```-Confirm:$false``` you will not be prompted.
+    
+    
+If the command sets a ```[ConfirmImpact("Medium")]``` which is lower than ```$confirmImpactPreference```, you will not be prompted unless -Confirm is passed.
 
 ---
 ### Syntax
 ```PowerShell
-syntaxItem
-```
-```PowerShell
-----------
-```
-```PowerShell
-{@{name=Add-HueLight; CommonParameters=True; parameter=System.Object[]}}
+Add-HueLight [[-DeviceID] <String[]>] [-WhatIf] [-Confirm] [<CommonParameters>]
 ```
 ---
 

docs/Add-HueRoom.md

@@ -89,6 +89,9 @@ Valid Values:
 * Recreation
 * Terrace
 * Toilet
+
+
+
 |Type          |Requried|Postion|PipelineInput        |
 |--------------|--------|-------|---------------------|
 |```[String]```|false   |named  |true (ByPropertyName)|
@@ -106,6 +109,9 @@ Valid Values:
 * LightGroup
 * Entertainment
 * Zone
+
+
+
 |Type          |Requried|Postion|PipelineInput        |
 |--------------|--------|-------|---------------------|
 |```[String]```|false   |named  |true (ByPropertyName)|

docs/Add-HueSensor.md

@@ -59,6 +59,9 @@ Valid Values:
 * LightLevel
 * GenericFlag
 * GenericStatus
+
+
+
 |Type          |Requried|Postion|PipelineInput        |
 |--------------|--------|-------|---------------------|
 |```[String]```|true    |2      |true (ByPropertyName)|

docs/CHANGELOG.md

@@ -1,3 +1,9 @@
+## 0.2.4.1
+* Adding help for Add-HueLight (#23)
+* Fixing other markdown documentation layout issues
+---
+
+
 ## 0.2.4
 * Adding Add-HueLight (#18)
 * Adding Get-HueLight -New (#21)

docs/Get-NanoLeaf.md

@@ -95,6 +95,9 @@ Valid Values:
 
 * Rhythm
 * Color
+
+
+
 |Type          |Requried|Postion|PipelineInput|
 |--------------|--------|-------|-------------|
 |```[String]```|false   |named  |false        |