More code comments

Author: Vlad Cananau

src/ResourceManager/Dns/Commands.Dns/Models/DnsRecordSet.cs

@@ -67,6 +67,9 @@ public class DnsRecordSet
         public Hashtable[] Tags { get; set; }
     }
 
+    /// <summary>
+    /// Represents a DNS record that is part of a <see cref="DnsRecordSet"/>.
+    /// </summary>
     public abstract class DnsRecordBase
     {
         internal abstract object ToMamlRecord();
@@ -152,8 +155,14 @@ internal static DnsRecordBase FromMamlRecord(object record)
         }
     }
 
+    /// <summary>
+    /// Represents a DNS record of type A that is part of a <see cref="DnsRecordSet"/>.
+    /// </summary>
     public class ARecord :  DnsRecordBase
     {
+        /// <summary>
+        /// Gets or sets the IPv4 address of this A record in string notation
+        /// </summary>
         public string Ipv4Address { get; set; }
 
         public override string ToString()
@@ -170,8 +179,14 @@ internal override object ToMamlRecord()
         }
     }
 
+    /// <summary>
+    /// Represents a DNS record of type AAAA that is part of a <see cref="DnsRecordSet"/>.
+    /// </summary>
     public class AaaaRecord : DnsRecordBase
     {
+        /// <summary>
+        /// Gets or sets the IPv6 address of this AAAA record in string notation.
+        /// </summary>
         public string Ipv6Address { get; set; }
 
         public override string ToString()
@@ -188,8 +203,14 @@ internal override object ToMamlRecord()
         }
     }
 
+    /// <summary>
+    /// Represents a DNS record of type CNAME that is part of a <see cref="DnsRecordSet"/>.
+    /// </summary>
     public class CnameRecord : DnsRecordBase
     {
+        /// <summary>
+        /// Gets or sets the canonical name for this CNAME record without a terminating dot.
+        /// </summary>
         public string Cname { get; set; }
 
         public override string ToString()
@@ -206,8 +227,14 @@ internal override object ToMamlRecord()
         }
     }
 
+    /// <summary>
+    /// Represents a DNS record of type NS that is part of a <see cref="DnsRecordSet"/>.
+    /// </summary>
     public class NsRecord : DnsRecordBase
     {
+        /// <summary>
+        /// Gets or sets the name server name for this NS record, without a terminating dot.
+        /// </summary>
         public string Nsdname { get; set; }
 
         public override string ToString()
@@ -224,8 +251,14 @@ internal override object ToMamlRecord()
         }
     }
 
+    /// <summary>
+    /// Represents a DNS record of type TXT that is part of a <see cref="DnsRecordSet"/>.
+    /// </summary>
     public class TxtRecord : DnsRecordBase
     {
+        /// <summary>
+        /// Gets or sets the text value of this TXT record.
+        /// </summary>
         public string Value { get; set; }
 
         public override string ToString()
@@ -242,10 +275,19 @@ internal override object ToMamlRecord()
         }
     }
 
+    /// <summary>
+    /// Represents a DNS record of type MX that is part of a <see cref="DnsRecordSet"/>.
+    /// </summary>
     public class MxRecord : DnsRecordBase
     {
+        /// <summary>
+        /// Gets or sets the preference metric for this MX record.
+        /// </summary>
         public ushort Preference { get; set; }
 
+        /// <summary>
+        /// Gets or sets the domain name of the mail host, without a terminating dot
+        /// </summary>
         public string Exchange { get; set; }
 
         public override string ToString()
@@ -263,14 +305,29 @@ internal override object ToMamlRecord()
         }
     }
 
+    /// <summary>
+    /// Represents a DNS record of type SRV that is part of a <see cref="DnsRecordSet"/>.
+    /// </summary>
     public class SrvRecord : DnsRecordBase
     {
+        /// <summary>
+        /// Gets or sets the domain name of the target for this SRV record, without a terminating dot.
+        /// </summary>
         public string Target { get; set; }
 
+        /// <summary>
+        /// Gets or sets the weight metric for this SRV record.
+        /// </summary>
         public ushort Weight { get; set; }
 
+        /// <summary>
+        /// Gets or sets the port for this SRV record
+        /// </summary>
         public ushort Port { get; set; }
 
+        /// <summary>
+        /// Gets or sets the priority metric for this SRV record.
+        /// </summary>
         public ushort Priority { get; set; }
 
         public override string ToString()
@@ -290,20 +347,44 @@ internal override object ToMamlRecord()
         }
     }
 
+    /// <summary>
+    /// Represents a DNS record of type SOA that is part of a <see cref="DnsRecordSet"/>.
+    /// </summary>
     public class SoaRecord : DnsRecordBase
     {
+        /// <summary>
+        /// Gets or sets the domain name of the authoritative name server for this SOA record, without a temrinating dot.
+        /// </summary>
         public string Host { get; set; }
 
+        /// <summary>
+        /// Gets or sets the email for this SOA record.
+        /// </summary>
         public string Email { get; set; }
 
+        /// <summary>
+        /// Gets or sets the serial number of this SOA record.
+        /// </summary>
         public uint SerialNumber { get; set; }
 
+        /// <summary>
+        /// Gets or sets the refresh value for this SOA record.
+        /// </summary>
         public uint RefreshTime { get; set; }
 
+        /// <summary>
+        /// Gets or sets the retry time for SOA record.
+        /// </summary>
         public uint RetryTime { get; set; }
 
+        /// <summary>
+        /// Gets or sets the expire time for this SOA record.
+        /// </summary>
         public uint ExpireTime { get; set; }
 
+        /// <summary>
+        /// Gets or sets the minimum TTL for this SOA record.
+        /// </summary>
         public uint MinimumTtl { get; set; }
 
         public override string ToString()

src/ResourceManager/Dns/Commands.Dns/Records/AddAzureDnsRecordConfig.cs

@@ -23,7 +23,7 @@
 namespace Microsoft.Azure.Commands.Dns
 {
     /// <summary>
-    /// Creates a new resource.
+    /// Adds a record to a record set object.
     /// </summary>
     [Cmdlet(VerbsCommon.Add, "AzureDnsRecordConfig"), OutputType(typeof(DnsRecordSet))]
     public class AddAzureDnsRecordConfig : DnsBaseCmdlet

src/ResourceManager/Dns/Commands.Dns/Records/GetAzureDnsRescordSet.cs

@@ -24,7 +24,7 @@
 namespace Microsoft.Azure.Commands.Dns
 {
     /// <summary>
-    /// Creates a new resource.
+    /// Gets one or more existing record sets.
     /// </summary>
     [Cmdlet(VerbsCommon.Get, "AzureDnsRecordSet"), OutputType(typeof(DnsRecordSet))]
     public class GetAzureDnsRecordSet : DnsBaseCmdlet

src/ResourceManager/Dns/Commands.Dns/Records/NewAzureDnsRescordSet.cs

@@ -22,7 +22,7 @@
 namespace Microsoft.Azure.Commands.Dns
 {
     /// <summary>
-    /// Creates a new resource.
+    /// Creates a new record set.
     /// </summary>
     [Cmdlet(VerbsCommon.New, "AzureDnsRecordSet"), OutputType(typeof(DnsRecordSet))]
     public class NewAzureDnsRecordSet : DnsBaseCmdlet

src/ResourceManager/Dns/Commands.Dns/Records/RemoveAzureDnsRecordConfig.cs

@@ -23,7 +23,7 @@
 namespace Microsoft.Azure.Commands.Dns
 {
     /// <summary>
-    /// Creates a new resource.
+    /// Removes a record from a record set object.
     /// </summary>
     [Cmdlet(VerbsCommon.Remove, "AzureDnsRecordConfig"), OutputType(typeof(DnsRecordSet))]
     public class RemoveAzureDnsRecordConfig : DnsBaseCmdlet

src/ResourceManager/Dns/Commands.Dns/Records/RemoveAzureDnsRecordSet.cs

@@ -22,7 +22,7 @@
 namespace Microsoft.Azure.Commands.Dns
 {
     /// <summary>
-    /// Creates a new resource.
+    /// Deletes an existing record set.
     /// </summary>
     [Cmdlet(VerbsCommon.Remove, "AzureDnsRecordSet"), OutputType(typeof(bool))]
     public class RemoveAzureDnsRecordSet : DnsBaseCmdlet

src/ResourceManager/Dns/Commands.Dns/Records/SetAzureDnsRecordSet.cs

@@ -21,7 +21,7 @@
 namespace Microsoft.Azure.Commands.Dns
 {
     /// <summary>
-    /// Creates a new resource.
+    /// Updates an existing record set.
     /// </summary>
     [Cmdlet(VerbsCommon.Set, "AzureDnsRecordSet"), OutputType(typeof(DnsRecordSet))]
     public class SetAzureDnsRecordSet : DnsBaseCmdlet

src/ResourceManager/Dns/Commands.Dns/Zones/GetAzureDnsZone.cs

@@ -19,7 +19,7 @@
 namespace Microsoft.Azure.Commands.Dns
 {
     /// <summary>
-    /// Creates a new resource.
+    /// Gets one or more existing zones.
     /// </summary>
     [Cmdlet(VerbsCommon.Get, "AzureDnsZone"), OutputType(typeof(DnsZone))]
     public class GetAzureDnsZone : DnsBaseCmdlet

src/ResourceManager/Dns/Commands.Dns/Zones/NewAzureDnsZone.cs

@@ -21,7 +21,7 @@
 namespace Microsoft.Azure.Commands.Dns
 {
     /// <summary>
-    /// Creates a new resource.
+    /// Creates a new zone.
     /// </summary>
     [Cmdlet(VerbsCommon.New, "AzureDnsZone"), OutputType(typeof(DnsZone))]
     public class NewAzureDnsZone : DnsBaseCmdlet

src/ResourceManager/Dns/Commands.Dns/Zones/RemoveAzureDnsZone.cs

@@ -22,7 +22,7 @@
 namespace Microsoft.Azure.Commands.Dns
 {
     /// <summary>
-    /// Creates a new resource.
+    /// Deletes an existing zone.
     /// </summary>
     [Cmdlet(VerbsCommon.Remove, "AzureDnsZone"), OutputType(typeof(bool))]
     public class RemoveAzureDnsZone : DnsBaseCmdlet

src/ResourceManager/Dns/Commands.Dns/Zones/SetAzureDnsZone.cs

@@ -21,7 +21,7 @@
 namespace Microsoft.Azure.Commands.Dns
 {
     /// <summary>
-    /// Creates a new resource.
+    /// Updates an existing zone.
     /// </summary>
     [Cmdlet(VerbsCommon.Set, "AzureDnsZone"), OutputType(typeof(DnsZone))]
     public class SetAzureDnsZone : DnsBaseCmdlet