Add inline doc to Compute Api

Author: carolynvs

src/corelib/Compute/v2_1/FlavorReference.cs

@@ -9,7 +9,9 @@
 
 namespace OpenStack.Compute.v2_1
 {
-    /// <summary />
+    /// <summary>
+    /// Reference to a flavor resource.
+    /// </summary>
     public class FlavorReference : IHaveExtraData, IServiceResource
     {
         /// <summary>
@@ -18,7 +20,6 @@ public class FlavorReference : IHaveExtraData, IServiceResource
         [JsonProperty("id")]
         public Identifier Id { get; set; }
 
-        /// <summary />
         [JsonExtensionData]
         IDictionary<string, JToken> IHaveExtraData.Data { get; set; } = new Dictionary<string, JToken>();
 

src/corelib/Compute/v2_1/NamespaceDoc.cs

@@ -0,0 +1,13 @@
+namespace OpenStack.Compute.v2_1
+{
+    using System.Runtime.CompilerServices;
+
+    /// <summary>
+    /// The <see cref="OpenStack.Compute.v2_1"/> namespace defines provider-independent
+    /// interfaces and implementations for the OpenStack Compute v2.1 API.
+    /// </summary>
+    [CompilerGenerated]
+    internal class NamespaceDoc
+    {
+    }
+}

src/corelib/Compute/v2_1/Operator/NamespaceDoc.cs

@@ -0,0 +1,12 @@
+using System.Runtime.CompilerServices;
+
+namespace OpenStack.Compute.v2_1.Operator
+{
+    /// <summary>
+    /// The <see cref="Operator"/> namespace defines additional functionality that is restricted to cloud operators only.
+    /// </summary>
+    [CompilerGenerated]
+    internal class NamespaceDoc
+    {
+    }
+}

src/corelib/Compute/v2_1/Serialization/AddressType.cs

@@ -3,7 +3,7 @@
 namespace OpenStack.Compute.v2_1.Serialization
 {
     /// <summary>
-    /// Server address type.
+    /// Server address types.
     /// </summary>
     /// <exclude />
     public class AddressType<T> : StringEnumeration

src/corelib/Compute/v2_1/Serialization/ImageType.cs

@@ -3,7 +3,7 @@
 namespace OpenStack.Compute.v2_1.Serialization
 {
     /// <summary>
-    /// The server image type
+    /// Server image types.
     /// </summary>
     /// <exclude />
     public class ImageType<T> : StringEnumeration

src/corelib/Compute/v2_1/ServerBlockDeviceMapping.cs

@@ -3,7 +3,7 @@
 namespace OpenStack.Compute.v2_1
 {
     /// <summary>
-    /// Enables you to boot a server from a volume when you specify additional parameters.
+    /// Defines how to boot a server from a volume.
     /// </summary>
     /// <remarks>
     /// If you specify the volume status, you must set it to available. In the OpenStack Block Storage database, the volume attach_status must be detached. 
@@ -17,7 +17,7 @@ public class ServerBlockDeviceMapping
         public int BootIndex { get; set; }
 
         /// <summary>
-        /// Defines the order in which a hypervisor tries devices when it attempts to boot the guest from storage.
+        /// A path to the device for the volume that you want to use to boot the server.
         /// </summary>
         [JsonProperty("device_name")]
         public string DeviceName { get; set; }

src/corelib/Compute/v2_1/ServerVolume.cs

@@ -3,17 +3,23 @@
 
 namespace OpenStack.Compute.v2_1
 {
-    /// <summary />
+    /// <summary>
+    /// Represents a volume attached to a server.
+    /// </summary>
     [JsonConverterWithConstructor(typeof(RootWrapperConverter), "volumeAttachment")]
     public class ServerVolume : ServerVolumeReference
     {
         private Identifier _serverId;
 
-        /// <summary />
+        /// <summary>
+        /// A path to the device for the volume attached to the server.
+        /// </summary>
         [JsonProperty("device")]
         public string DeviceName { get; set; }
 
-        /// <summary />
+        /// <summary>
+        /// The server identifier.
+        /// </summary>
         [JsonProperty("serverId")]
         public Identifier ServerId
         {
@@ -25,7 +31,9 @@ public Identifier ServerId
             }
         }
 
-        /// <summary />
+        /// <summary>
+        /// The volume identifier.
+        /// </summary>
         [JsonProperty("volumeId")]
         public Identifier VolumeId { get; set; }
     }

src/corelib/Compute/v2_1/ServerVolumeDefinition.cs

@@ -3,21 +3,26 @@
 
 namespace OpenStack.Compute.v2_1
 {
-    /// <summary />
+    /// <summary>
+    /// Defines how to attach a volume to a server.
+    /// </summary>
     [JsonConverterWithConstructor(typeof(RootWrapperConverter), "volumeAttachment")]
     public class ServerVolumeDefinition
     {
-    /// <summary />
+        /// <summary>
+        /// Initializes a new instance of the <see cref="ServerVolumeDefinition"/> class.
+        /// </summary>
+        /// <param name="volumeId">The volume identifier.</param>
         public ServerVolumeDefinition(Identifier volumeId)
         {
             VolumeId = volumeId;
         }
 
-        /// <summary />
+        /// <inheritdoc cref="ServerVolume.DeviceName" />
         [JsonProperty("device")]
         public string DeviceName { get; set; }
 
-        /// <summary />
+        /// <inheritdoc cref="ServerVolume.VolumeId" />
         [JsonProperty("volumeId")]
         public Identifier VolumeId { get; set; }
     }

src/corelib/Compute/v2_1/ServerVolumeExtensions.cs

@@ -3,16 +3,18 @@
 
 namespace OpenStack.Synchronous
 {
-    /// <summary />
+    /// <summary>
+    /// Provides synchronous extention methods for a <see cref="ServerVolume"/> instance.
+    /// </summary>
     public static class ServerVolumeExtensions
     {
-        /// <summary />
+        /// <inheritdoc cref="ServerVolumeReference.GetServerVolumeAsync" />
         public static ServerVolume GetServerVolume(this ServerVolumeReference volume)
         {
             return volume.GetServerVolumeAsync().ForceSynchronous();
         }
 
-        /// <summary />
+        /// <inheritdoc cref="ServerVolumeReference.DetachAsync" />
         public static void Detach(this ServerVolumeReference volume)
         {
             volume.DetachAsync().ForceSynchronous();

src/corelib/Compute/v2_1/ServerVolumeReference.cs

@@ -11,14 +11,20 @@
 
 namespace OpenStack.Compute.v2_1
 {
-    /// <summary />
+    /// <summary>
+    /// Reference to a volume attachment to a server.
+    /// </summary>
     public class ServerVolumeReference : IHaveExtraData, IChildResource
     {
-        /// <summary />
+        /// <summary>
+        /// The associated server.
+        /// </summary>
         [JsonIgnore]
         protected ServerReference ServerRef { get; set; }
 
-        /// <summary />
+        /// <summary>
+        /// The attachment identifier.
+        /// </summary>
         public Identifier Id { get; set; }
 
         object IServiceResource.Owner { get; set; }
@@ -39,7 +45,6 @@ void IChildResource.SetParent(string parentId)
             SetParent(new ServerReference {Id = parentId});
         }
 
-        /// <summary />
         [JsonExtensionData]
         IDictionary<string, JToken> IHaveExtraData.Data { get; set; } = new Dictionary<string, JToken>();
 
@@ -52,7 +57,7 @@ protected void AssertParentIsSet([CallerMemberName]string callerName = "")
             throw new InvalidOperationException(string.Format($"{callerName} can only be used on instances which were constructed by the ComputeService. Use ComputeService.{callerName} instead."));
         }
 
-        /// <summary />
+        /// <inheritdoc cref="ComputeApi.GetServerVolumeAsync{T}" />
         /// <exception cref="InvalidOperationException">When this instance was not constructed by the <see cref="ComputeService"/>, as it is missing the appropriate internal state to execute service calls.</exception>
         public async Task<ServerVolume> GetServerVolumeAsync(CancellationToken cancellationToken = default(CancellationToken))
         {
@@ -64,7 +69,7 @@ protected void AssertParentIsSet([CallerMemberName]string callerName = "")
             return result;
         }
 
-        /// <summary />
+        /// <inheritdoc cref="ComputeApi.DetachVolumeAsync" />
         /// <exception cref="InvalidOperationException">When this instance was not constructed by the <see cref="ComputeService"/>, as it is missing the appropriate internal state to execute service calls.</exception>
         public async Task DetachAsync(CancellationToken cancellationToken = default(CancellationToken))
         {