Incorporate review comments-4. Update the help files + add output type

Author: Filiz Topatan

src/Blueprint/Blueprint/Cmdlets/BlueprintDefinition/ImportAzureRMBlueprint.cs

@@ -19,7 +19,7 @@
 
 namespace Microsoft.Azure.Commands.Blueprint.Cmdlets
 {
-    [Cmdlet("Import", ResourceManager.Common.AzureRMConstants.AzureRMPrefix + "BlueprintWithArtifact", SupportsShouldProcess = true, DefaultParameterSetName = ParameterSetNames.ImportBlueprintParameterSet)]
+    [Cmdlet("Import", ResourceManager.Common.AzureRMConstants.AzureRMPrefix + "BlueprintWithArtifact", SupportsShouldProcess = true, DefaultParameterSetName = ParameterSetNames.ImportBlueprintParameterSet), OutputType(typeof(bool))]
     public class ImportAzureRmBlueprint : BlueprintDefinitionCmdletBase
     {
         #region Parameters

src/Blueprint/Blueprint/help/Az.Blueprint.md

@@ -12,40 +12,40 @@ The topics in this section document the Azure PowerShell cmdlets for Azure Bluep
 
 ## Az.Blueprint Cmdlets
 ### [Export-AzBlueprintWithArtifact](Export-AzBlueprintWithArtifact.md)
-Export specified blueprint to the specified output location as a JSON file. 
+Export specified blueprint definition to the specified output location as a JSON file. 
 
 ### [Get-AzBlueprint](Get-AzBlueprint.md)
 Get one or more blueprint definitions.
 
 ### [Get-AzBlueprintArtifact](Get-AzBlueprintArtifact.md)
-Get artifact from a blueprint.
+Get artifact from a blueprint definition.
 
 ### [Get-AzBlueprintAssignment](Get-AzBlueprintAssignment.md)
 Get one or more blueprint assignments.
 
 ### [Import-AzBlueprintWithArtifact](Import-AzBlueprintWithArtifact.md)
-Import a blueprint file in JSON format to a blueprint object and save it within the specified subscription or management group.
+Import a blueprint definition file in JSON format and save it to a blueprint object within the specified subscription or management group.
 
 ### [New-AzBlueprint](New-AzBlueprint.md)
-Create a new blueprint and save it within the specified subscription or management group.
+Create a new blueprint definition and save it within the specified subscription or management group.
 
 ### [New-AzBlueprintArtifact](New-AzBlueprintArtifact.md)
-Create a new artifact and save it within a blueprint.
+Create a new artifact and save it within a blueprint definition.
 
 ### [New-AzBlueprintAssignment](New-AzBlueprintAssignment.md)
 Assign a blueprint definition to a subscription.
 
 ### [Publish-AzBlueprint](Publish-AzBlueprint.md)
-Publish a new version of a blueprint.
+Publish a new version of a blueprint definition.
 
 ### [Remove-AzBlueprintAssignment](Remove-AzBlueprintAssignment.md)
 Remove a blueprint assignment from a subscription.
 
 ### [Set-AzBlueprint](Set-AzBlueprint.md)
-Update a new blueprint and save it within the specified subscription or management group.
+Update a blueprint and save it within the specified subscription or management group.
 
 ### [Set-AzBlueprintArtifact](Set-AzBlueprintArtifact.md)
-Update an artifact in a blueprint.
+Update an artifact in a blueprint definition.
 
 ### [Set-AzBlueprintAssignment](Set-AzBlueprintAssignment.md)
 Update an existing blueprint assignment.

src/Blueprint/Blueprint/help/Export-AzBlueprintWithArtifact.md

@@ -8,7 +8,7 @@ schema: 2.0.0
 # Export-AzBlueprintWithArtifact
 
 ## SYNOPSIS
-Export specified blueprint to the specified output location as a JSON file. 
+Export specified blueprint definition to the specified output location as a JSON file. 
 
 ## SYNTAX
 
@@ -18,7 +18,7 @@ Export-AzBlueprintWithArtifact -Blueprint <PSBlueprintBase> -OutputPath <String>
 ```
 
 ## DESCRIPTION
-Export a blueprint with it's artifact and save to disk.
+Export a blueprint definition with its artifacts and save to disk.
 
 ## EXAMPLES
 
@@ -28,12 +28,12 @@ PS C:\> $bp = Get-AzBlueprint -Name SimpleBlueprint
 PS C:\> Export-AzBlueprintWithArtifact -Blueprint $bp -Version 1.0 -OutputPath C:\Blueprints
 ```
 
-Export a blueprint with it's artifact and save to disk.
+Export a blueprint definition with its artifacts and save to disk.
 
 ## PARAMETERS
 
 ### -Blueprint
-The Blueprint definition object to export.
+The blueprint definition object to export.
 
 ```yaml
 Type: PSBlueprintBase

src/Blueprint/Blueprint/help/Get-AzBlueprintArtifact.md

@@ -8,7 +8,7 @@ schema: 2.0.0
 # Get-AzBlueprintArtifact
 
 ## SYNOPSIS
-Get artifact from a blueprint.
+Retrieve artifacts from a blueprint definition.
 
 ## SYNTAX
 
@@ -18,7 +18,7 @@ Get-AzBlueprintArtifact [-Name <String>] -Blueprint <PSBlueprintBase> [-Blueprin
 ```
 
 ## DESCRIPTION
-Retrieve a blueprint artifact with its properties.
+Retrieve artifacts from a blueprint definition. If a blueprint definition version is not specified, the draft version is retrieved. In the case where there is no draft version, the latest published blueprint definition is returned.
 
 ## EXAMPLES
 
@@ -50,7 +50,7 @@ Name               : 0e1593da-47d5-4b75-800c-9a797dd23192
 
 ```
 
-Retrieve a blueprint artifact with its properties. If blueprint version is not specified, draft version is retrieved. In the case where there is no draft version, latest published blueprint returned.
+Retrieve artifacts from a blueprint definition.. 
 
 ## PARAMETERS
 

src/Blueprint/Blueprint/help/Import-AzBlueprintWithArtifact.md

@@ -18,7 +18,7 @@ Import-AzBlueprintWithArtifact -Name <String> [-SubscriptionId <String>] [-Manag
 ```
 
 ## DESCRIPTION
-Import a blueprint with its artifacts. 
+Import a blueprint definition with its artifacts. 
 
 ## EXAMPLES
 
@@ -27,7 +27,7 @@ Import a blueprint with its artifacts.
 PS C:\> Import-AzBlueprintWithArtifact -Name SimpleBlueprint -SubscriptionId 00000000-1111-0000-1111-000000000000 -InputPath  C:\Blueprints
 ```
 
-Import a blueprint with its artifacts and save within a subscription.
+Import a blueprint definition with its artifacts and save within a subscription.
 
 ## PARAMETERS
 

src/Blueprint/Blueprint/help/New-AzBlueprint.md

@@ -8,7 +8,7 @@ schema: 2.0.0
 # New-AzBlueprint
 
 ## SYNOPSIS
-Create a new blueprint and save it within the specified subscription or management group.
+Create a new blueprint definition and save it within the specified subscription or management group.
 
 ## SYNTAX
 
@@ -25,7 +25,7 @@ New-AzBlueprint -Name <String> -ManagementGroupId <String> -BlueprintFile <Strin
 ```
 
 ## DESCRIPTION
-Create a new blueprint. There are two main ways to create a blueprint: either by providing a blueprint JSON file or providing 
+Create a new blueprint definition. 
 
 ## EXAMPLES
 
@@ -44,7 +44,7 @@ Parameters        : {enforcetaganditsvalue_tagName, enforcetaganditsvalue_tagVal
 ResourceGroups    : {AppNetworkRG}
 ```
 
-Create a new blueprint within the specified subscription.
+Create a new blueprint definition within the specified subscription.
 
 ## PARAMETERS
 

src/Blueprint/Blueprint/help/New-AzBlueprintArtifact.md

@@ -9,7 +9,7 @@ schema: 2.0.0
 # New-AzBlueprintArtifact
 
 ## SYNOPSIS
-Create a new artifact and save it within a blueprint.
+Create a new artifact and save it within a blueprint definition.
 
 ## SYNTAX
 
@@ -44,8 +44,8 @@ New-AzBlueprintArtifact -Name <String> -Type <PSArtifactKind> -Blueprint <PSBlue
 ```
 
 ## DESCRIPTION
-Create a new template artifact. There are two ways to create an artifact: either through an artifact JSON as an input file or through providing inline parameters for the artifact. 
-while former doesn't require type of the artifact to be provided latter method requires user to provide the type of the artifact through -Type parameter.
+Create a new artifact. There are two ways to create an artifact: either through an artifact JSON as an input file or through providing inline parameters for the artifact. 
+While the JSON method doesn't require type of the artifact to be provided inline parameter method requires user to provide the type of the artifact through -Type parameter.
 
 ## EXAMPLES
 
@@ -65,7 +65,7 @@ Type               : Microsoft.Blueprint/blueprints/artifacts
 Name               : PolicyAssignmentStorageTag
 ```
 
-Create a new template artifact through an artifact JSON file.
+Create a new artifact through an artifact JSON file.
 
 ### Example 2
 ```powershell

src/Blueprint/Blueprint/help/Publish-AzBlueprint.md

@@ -18,7 +18,7 @@ Publish-AzBlueprint -Version <String> -Blueprint <PSBlueprint> [-DefaultProfile
 ```
 
 ## DESCRIPTION
-Publish a new version of a blueprint.
+Publish a new version of a blueprint definition.
 
 ## EXAMPLES
 
@@ -36,7 +36,7 @@ TargetScope    : Subscription
 Parameters     : {[tagName, Microsoft.Azure.Commands.Blueprint.Models.PSParameterValue], [tagValue, Microsoft.Azure.Commands.Blueprint.Models.PSParameterValue]}
 ResourceGroups : {storageRG}
 ```
-Publish a new version of a blueprint.
+Publish a new version of a blueprint definition.
 
 ## PARAMETERS
 

src/Blueprint/Blueprint/help/Set-AzBlueprint.md

@@ -8,7 +8,7 @@ schema: 2.0.0
 # Set-AzBlueprint
 
 ## SYNOPSIS
-Update a blueprint.
+Update a blueprint definition.
 
 ## SYNTAX
 
@@ -25,7 +25,7 @@ Set-AzBlueprint -Name <String> -ManagementGroupId <String> -BlueprintFile <Strin
 ```
 
 ## DESCRIPTION
-Update a blueprint and save it within the specified subscription or management group.
+Update a blueprint definition and save it within the specified subscription or management group.
 
 ## EXAMPLES
 
@@ -44,7 +44,7 @@ Parameters        : {enforcetaganditsvalue_tagName, enforcetaganditsvalue_tagVal
 ResourceGroups    : {AppNetworkRG}
 ```
 
-Update a blueprint with new parameters.
+Update a blueprint definition with new parameters.
 
 ## PARAMETERS
 

src/Blueprint/Blueprint/help/Set-AzBlueprintArtifact.md

@@ -8,7 +8,7 @@ schema: 2.0.0
 # Set-AzBlueprintArtifact
 
 ## SYNOPSIS
-Update an artifact in a blueprint.
+Update an artifact in a blueprint definition.
 
 ## SYNTAX
 
@@ -45,7 +45,7 @@ Set-AzBlueprintArtifact -Name <String> -Type <PSArtifactKind> -Blueprint <PSBlue
 
 ## DESCRIPTION
 Update an artifact. There are two ways to update an artifact: either through an artifact JSON as an input file or through providing inline parameters for the artifact. 
-while former doesn't require type of the artifact to be provided latter method requires user to provide the type of the artifact through -Type parameter.
+While the JSON method doesn't require type of the artifact to be provided inline parameter method requires user to provide the type of the artifact through -Type parameter.
 
 ## EXAMPLES
 
@@ -331,7 +331,7 @@ Accept wildcard characters: False
 
 ### -Type
 Type of the artifact.
-There are 3 tpes supported: RoleAssignmentArtifact, PolicyAssignmentArtifact, TemplateArtifact.
+There are 3 types supported: RoleAssignmentArtifact, PolicyAssignmentArtifact, TemplateArtifact.
 
 ```yaml
 Type: PSArtifactKind