diff --git a/Scripts/add-firewall-rules.ps1 b/Scripts/add-firewall-rules.ps1
index d23ee984..a44881df 100755
--- a/Scripts/add-firewall-rules.ps1
+++ b/Scripts/add-firewall-rules.ps1
@@ -1,8 +1,14 @@
 <#
-.SYNTAX       add-firewall-rules.ps1 [<path-to-executables>]
-.DESCRIPTION  adds firewall rules for the given executables, administrator rights are required
-.LINK         https://github.com/fleschutz/PowerShell
-.NOTES        Author: Markus Fleschutz / License: CC0
+.SYNOPSIS
+	add-firewall-rules.ps1 [<path-to-executables>]
+.DESCRIPTION
+	Adds firewall rules for the given executables (needs administrator rights)
+.EXAMPLE
+	PS> .\add-firewall-rules.ps1 C:\MyApp\bin
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz / License: CC0
 #>
 
 #Requires -RunAsAdministrator
diff --git a/Scripts/add-memo.ps1 b/Scripts/add-memo.ps1
index 02060acf..5f66d6e4 100755
--- a/Scripts/add-memo.ps1
+++ b/Scripts/add-memo.ps1
@@ -1,8 +1,14 @@
 <#
-.SYNTAX       add-memo.ps1 [<text>]
-.DESCRIPTION  adds the given memo text to $HOME/Memos.csv
-.LINK         https://github.com/fleschutz/PowerShell
-.NOTES        Author: Markus Fleschutz / License: CC0
+.SYNOPSIS
+	add-memo.ps1 [<text>]
+.DESCRIPTION
+	Adds the given memo text to $HOME/Memos.csv
+.EXAMPLE
+	PS> .\add-memo.ps1 "Buy apples"
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz / License: CC0
 #>
 
 param($Text = "")
diff --git a/Scripts/alert.ps1 b/Scripts/alert.ps1
index 32d58748..56fd9ec3 100755
--- a/Scripts/alert.ps1
+++ b/Scripts/alert.ps1
@@ -1,8 +1,14 @@
 <#
-.SYNTAX       alert.ps1 [<message>]
-.DESCRIPTION  handle and escalate the given alert message
-.LINK         https://github.com/fleschutz/PowerShell
-.NOTES        Author: Markus Fleschutz / License: CC0
+.SYNOPSIS
+	alert.ps1 [<message>]
+.DESCRIPTION
+	Handle and escalate the given alert message
+.EXAMPLE
+	PS> .\alert.ps1 "Harddisk failure"
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz / License: CC0
 #>
 
 param($Message = "")
diff --git a/Scripts/cd-desktop.ps1 b/Scripts/cd-desktop.ps1
index 56ad8649..c6b86dda 100755
--- a/Scripts/cd-desktop.ps1
+++ b/Scripts/cd-desktop.ps1
@@ -1,8 +1,14 @@
 <#
-.SYNTAX       cd-desktop.ps1 
-.DESCRIPTION  go to the user's desktop folder
-.LINK         https://github.com/fleschutz/PowerShell
-.NOTES        Author: Markus Fleschutz / License: CC0
+.SYNOPSIS
+	cd-desktop.ps1 
+.DESCRIPTION
+	Go to the user's desktop folder
+.EXAMPLE
+	PS> .\cd-desktop.ps1 
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz / License: CC0
 #>
 
 $TargetDir = resolve-path "$HOME/Desktop"
diff --git a/Scripts/cd-docs.ps1 b/Scripts/cd-docs.ps1
index 0fdff7a4..d815b69d 100755
--- a/Scripts/cd-docs.ps1
+++ b/Scripts/cd-docs.ps1
@@ -1,8 +1,14 @@
 <#
-.SYNTAX       cd-docs.ps1 
-.DESCRIPTION  go to the user's documents folder 
-.LINK         https://github.com/fleschutz/PowerShell
-.NOTES        Author: Markus Fleschutz / License: CC0
+.SYNOPSIS
+	cd-docs.ps1 
+.DESCRIPTION
+	Go to the user's documents folder 
+.EXAMPLE
+	PS> .\cd-docs.ps1 
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz / License: CC0
 #>
 
 $TargetDir = resolve-path "$HOME/Documents"
diff --git a/Scripts/cd-downloads.ps1 b/Scripts/cd-downloads.ps1
index 9393b2d8..83d64c27 100755
--- a/Scripts/cd-downloads.ps1
+++ b/Scripts/cd-downloads.ps1
@@ -1,8 +1,14 @@
 <#
-.SYNTAX       cd-downloads.ps1 
-.DESCRIPTION  go to the user's downloads folder
-.LINK         https://github.com/fleschutz/PowerShell
-.NOTES        Author: Markus Fleschutz / License: CC0
+.SYNOPSIS
+	cd-downloads.ps1 
+.DESCRIPTION
+	go to the user's downloads folder
+.EXAMPLE
+	PS> .\cd-downloads.ps1 
+.LINK
+	https://github.com/fleschutz/PowerShell
+.NOTES
+	Author: Markus Fleschutz / License: CC0
 #>
 
 $TargetDir = resolve-path "$HOME/Downloads"