[Insights] Adding details to the deprecation / breaking-changes documentation.

Author: gucalder

src/ResourceManager/Insights/Commands.Insights/Alerts/AddAzureRmLogAlertRuleCommand.cs

@@ -90,7 +90,7 @@ private RuleCondition CreateRuleCondition()
 
         protected override AlertRuleResource CreateSdkCallParameters()
         {
-            WriteWarning("*** Add-AzureRMLogAlertRule cmdlet will be deprecated in a future release.");
+            WriteWarning("*** This cmdlet will be removed in the 5.0 release (November 2017.)");
             WriteWarning("*** Note: After October 1st using this cmdlet will no longer have any effect as this functionality is being transitioned to Activity Log Alerts. Please see https://aka.ms/migratemealerts for more information.");
 
             RuleCondition condition = this.CreateRuleCondition();

src/ResourceManager/Insights/Commands.Insights/Alerts/GetAzureRmAlertRuleCommand.cs

@@ -106,7 +106,7 @@ private static string ExtractTargetResourceId(AlertRuleResource alertRuleResourc
         /// </summary>
         protected override void ProcessRecordInternal()
         {
-            WriteWarning("The output of this cmdlet will be flattened, i.e. elimination of the properties field, in a future release to improve the user experience.");
+            WriteWarning("Output change: The output of this cmdlet will be flattened, i.e. elimination of the properties field, in the release 5.0.0 - November 2017 to improve the user experience.");
             if (string.IsNullOrWhiteSpace(this.Name))
             {
                 // Retrieve all the AlertRules for a ResourceGroup

src/ResourceManager/Insights/Commands.Insights/Alerts/RemoveAzureRmAlertRuleCommand.cs

@@ -49,7 +49,7 @@ public class RemoveAzureRmAlertRuleCommand : ManagementCmdletBase
         /// </summary>
         protected override void ProcessRecordInternal()
         {
-            WriteWarning("The type of the output will change in a future release to become a single object, not a list.");
+            WriteWarning("Output change: The type of the output will change in the release 5.0.0 - November 2017 - to return a single object containing the request Id and the status code.");
             var result = this.MonitorManagementClient.AlertRules.DeleteWithHttpMessagesAsync(resourceGroupName: this.ResourceGroup, ruleName: this.Name).Result;
 
             // Keep this response for backwards compatibility.

src/ResourceManager/Insights/Commands.Insights/Autoscale/GetAzureRmAutoscaleSettingCommand.cs

@@ -59,7 +59,7 @@ public class GetAzureRmAutoscaleSettingCommand : ManagementCmdletBase
         /// </summary>
         protected override void ProcessRecordInternal()
         {
-            WriteWarning("The AutoscaleSettingResourceName field will be deprecated in a future release since it always equals the Name field. In this version is optional.");
+            WriteWarning("Output change: The AutoscaleSettingResourceName field will be deprecated in the release 5.0.0 - November 2017 - since it always equals the Name field.");
             if (string.IsNullOrWhiteSpace(this.Name))
             {
                 // Retrieve all the Autoscale settings for a resource group

src/ResourceManager/Insights/Commands.Insights/LogProfiles/RemoveAzureRmLogProfileCommand.cs

@@ -40,7 +40,7 @@ public class RemoveAzureRmLogProfileCommand : ManagementCmdletBase
 
         protected override void ProcessRecordInternal()
         {
-            WriteWarning("The type of the output will change to return a single object containing the request Id and the status code.");
+            WriteWarning("Output change: The type of the output will change in the release 5.0.0 - November 2017 - to return a single object containing the request Id and the status code.");
             Rest.Azure.AzureOperationResponse result = this.MonitorManagementClient.LogProfiles.DeleteWithHttpMessagesAsync(logProfileName: this.Name, cancellationToken: CancellationToken.None).Result;
 
             /*

src/ResourceManager/Insights/Commands.Insights/LogsCmdletBase.cs

@@ -165,7 +165,7 @@ protected string ProcessParameters()
         {
             string queryFilter = this.ProcessGeneralParameters();
             var result = this.ProcessParticularParameters(queryFilter);
-            WriteWarning("Deprecation: The field EventChannels from the EventData object is being deprecated since it now returns a constant value (Admin,Operation)");
+            WriteWarning("Output change: The field EventChannels from the EventData object is being deprecated in the release 5.0.0 - November 2017 - since it now returns a constant value (Admin,Operation)");
             return result;
         }
 

src/ResourceManager/Insights/Commands.Insights/UsageMetrics/GetAzureRmUsageCommand.cs

@@ -136,7 +136,7 @@ private static IEnumerable<PSUsageMetric> ExtractCollectionFromResult(IEnumerato
         /// </summary>
         protected override void ProcessRecordInternal()
         {
-            WriteWarning("Get-AzureRmUsage will be deprecated in a future release.");
+            WriteWarning("*** This cmdlet will be removed in the 5.0 release (November 2017.)");
 
             var queryFilter = new ODataQuery<UsageMetric>(this.ProcessParameters());
             string apiVersion = this.ApiVersion ?? DefaultApiVersion;

src/ResourceManager/Insights/documentation/upcoming-breaking-changes.md

@@ -27,6 +27,32 @@
 
 # Upcoming Breaking Changes
 
+## Release 5.0.0 - November 2017
+
+    The following cmdlets will be deprecated in this release
+
+    **Add-AzureRMLogAlertRule**
+    - After October 1st using this cmdlet will no longer have any effect as this functionality is being transitioned to Activity Log Alerts. Please see https://aka.ms/migratemealerts for more information.
+
+    **Get-AzureRMUsage**
+
+    The following cmdlets will show some potentially breaking change, but will NOT be deprecated
+
+    **Get-AzureRmAlertHistory**
+    **Get-AzureRmAutoscaleHistory**
+    **Get-AzureRmLogs**
+    - Output change: The field EventChannels from the EventData object (returned by these cmdlets) is being deprecated in the release 5.0.0 - November 2017 - since it now returns a constant value (Admin,Operation.)
+
+    **Get-AzureRmAlertRule**
+    - Output change: The output of this cmdlet will be flattened, i.e. elimination of the properties field, to improve the user experience.
+
+    **Get-AzureRmAutoscaleSetting**
+    - Output change: The AutoscaleSettingResourceName field will be deprecated since it always equals the Name field.
+
+    **Remove-AzureRmAlertRule**
+    **Remove-AzureRmLogProfile**
+    - Output change: The type of the output will change to return a single object containing the request Id and the status code.
+
 ## Release 3.0.0
 
     The following cmdlets were affected this release: