Documentation fixes

src/Documentation/AdditionalReferenceDocumentation.shfbproj

@@ -0,0 +1,56 @@
+<?xml version="1.0" encoding="utf-8"?>
+<Project DefaultTargets="Build" xmlns="http://schemas.microsoft.com/developer/msbuild/2003" ToolsVersion="4.0">
+  <PropertyGroup>
+    <!-- The configuration and platform will be used to determine which assemblies to include from solution and
+				 project documentation sources -->
+    <Configuration Condition=" '$(Configuration)' == '' ">Debug</Configuration>
+    <Platform Condition=" '$(Platform)' == '' ">AnyCPU</Platform>
+    <SchemaVersion>2.0</SchemaVersion>
+    <ProjectGuid>1d084ab3-e5db-4a72-9daf-e51d225d5fcf</ProjectGuid>
+    <SHFBSchemaVersion>1.9.9.0</SHFBSchemaVersion>
+    <!-- AssemblyName, Name, and RootNamespace are not used by SHFB but Visual Studio adds them anyway -->
+    <AssemblyName>AdditionalReferenceDocumentation</AssemblyName>
+    <RootNamespace>AdditionalReferenceDocumentation</RootNamespace>
+    <Name>AdditionalReferenceDocumentation</Name>
+    <!-- SHFB properties -->
+    <FrameworkVersion>.NET Framework 4.0</FrameworkVersion>
+    <OutputPath>.\Help\</OutputPath>
+    <HtmlHelpName>AdditionalReferenceDocumentation</HtmlHelpName>
+    <Language>en-US</Language>
+    <TransformComponentArguments>
+      <Argument Key="logoFile" Value="Help.png" xmlns="" />
+      <Argument Key="logoHeight" Value="" xmlns="" />
+      <Argument Key="logoWidth" Value="" xmlns="" />
+      <Argument Key="logoAltText" Value="" xmlns="" />
+      <Argument Key="logoPlacement" Value="left" xmlns="" />
+      <Argument Key="logoAlignment" Value="left" xmlns="" />
+      <Argument Key="maxVersionParts" Value="" xmlns="" />
+    </TransformComponentArguments>
+    <DocumentationSources>
+      <DocumentationSource sourceFile="..\packages\Newtonsoft.Json.5.0.6\lib\net40\Newtonsoft.Json.dll" />
+      <DocumentationSource sourceFile="..\packages\Newtonsoft.Json.5.0.6\lib\net40\Newtonsoft.Json.xml" />
+      <DocumentationSource sourceFile="..\packages\SimpleRESTServices.1.3.0.1\lib\net40\SimpleRESTServices.dll" />
+      <DocumentationSource sourceFile="..\packages\SimpleRESTServices.1.3.0.1\lib\net40\SimpleRESTServices.xml" />
+    </DocumentationSources>
+  </PropertyGroup>
+  <!-- There are no properties for these groups.  AnyCPU needs to appear in order for Visual Studio to perform
+			 the build.  The others are optional common platform types that may appear. -->
+  <PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Debug|AnyCPU' ">
+  </PropertyGroup>
+  <PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Release|AnyCPU' ">
+  </PropertyGroup>
+  <PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Debug|x86' ">
+  </PropertyGroup>
+  <PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Release|x86' ">
+  </PropertyGroup>
+  <PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Debug|x64' ">
+  </PropertyGroup>
+  <PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Release|x64' ">
+  </PropertyGroup>
+  <PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Debug|Win32' ">
+  </PropertyGroup>
+  <PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Release|Win32' ">
+  </PropertyGroup>
+  <!-- Import the SHFB build targets -->
+  <Import Project="$(SHFBROOT)\SandcastleHelpFileBuilder.targets" />
+</Project>

src/Documentation/Documentation.v3.5.shfbproj

@@ -58,12 +58,12 @@
     </TransformComponentArguments>
     <ComponentConfigurations>
       <ComponentConfig id="IntelliSense Component" enabled="True">
-        <component id="IntelliSense Component" type="Microsoft.Ddue.Tools.IntelliSenseComponent" assembly="{@SandcastlePath}ProductionTools\BuildComponents.dll">
+        <component id="IntelliSense Component">
           <output includeNamespaces="false" namespacesFile="Namespaces" folder="{@OutputFolder}\..\..\Api\v3.5" />
         </component>
       </ComponentConfig>
       <ComponentConfig id="Code Block Component" enabled="True">
-        <component id="Code Block Component" type="SandcastleBuilder.Components.CodeBlockComponent" assembly="{@SHFBFolder}SandcastleBuilder.Components.dll">
+        <component id="Code Block Component">
           <basePath value="{@HtmlEncProjectFolder}" />
           <outputPaths>{@HelpFormatOutputPaths}</outputPaths>
           <allowMissingSource value="false" />
@@ -72,7 +72,7 @@
         </component>
       </ComponentConfig>
       <ComponentConfig id="API Token Resolution" enabled="True">
-        <component id="API Token Resolution" type="Microsoft.Ddue.Tools.SharedContentComponent" assembly="{@SandcastlePath}ProductionTools\BuildComponents.dll">
+        <component id="API Token Resolution">
           {@TokenFiles}
           <replace elements="/*//token" item="string(.)" />
         </component>
@@ -95,6 +95,13 @@
       <PlugInConfig id="Lightweight TOC" enabled="True">
         <configuration />
       </PlugInConfig>
+      <PlugInConfig id="Additional Reference Links" enabled="True">
+        <configuration>
+          <targets>
+            <target htmlSdkLinkType="None" help2SdkLinkType="Index" helpViewerSdkLinkType="Id" websiteSdkLinkType="None" helpFileProject="AdditionalReferenceDocumentation.shfbproj" />
+          </targets>
+        </configuration>
+      </PlugInConfig>
     </PlugInConfigurations>
     <BuildLogFile />
     <HtmlHelp1xCompilerPath />

src/Documentation/Documentation.v4.0.shfbproj

@@ -58,12 +58,12 @@
     </TransformComponentArguments>
     <ComponentConfigurations>
       <ComponentConfig id="IntelliSense Component" enabled="True">
-        <component id="IntelliSense Component" type="Microsoft.Ddue.Tools.IntelliSenseComponent" assembly="{@SandcastlePath}ProductionTools\BuildComponents.dll">
+        <component id="IntelliSense Component">
           <output includeNamespaces="false" namespacesFile="Namespaces" folder="{@OutputFolder}\..\..\Api\v4.0" />
         </component>
       </ComponentConfig>
       <ComponentConfig id="Code Block Component" enabled="True">
-        <component id="Code Block Component" type="SandcastleBuilder.Components.CodeBlockComponent" assembly="{@SHFBFolder}SandcastleBuilder.Components.dll">
+        <component id="Code Block Component">
           <basePath value="{@HtmlEncProjectFolder}" />
           <outputPaths>{@HelpFormatOutputPaths}</outputPaths>
           <allowMissingSource value="false" />
@@ -72,9 +72,10 @@
         </component>
       </ComponentConfig>
       <ComponentConfig id="API Token Resolution" enabled="True">
-        <component id="API Token Resolution" type="Microsoft.Ddue.Tools.SharedContentComponent" assembly="{@SandcastlePath}ProductionTools\BuildComponents.dll">
+        <component id="API Token Resolution">
           {@TokenFiles}
-          <replace elements="/*//token" item="string(.)" /></component>
+          <replace elements="/*//token" item="string(.)" />
+        </component>
       </ComponentConfig>
     </ComponentConfigurations>
     <CatalogName>VisualStudio11</CatalogName>
@@ -99,6 +100,13 @@
       <PlugInConfig id="Lightweight TOC" enabled="True">
         <configuration />
       </PlugInConfig>
+      <PlugInConfig id="Additional Reference Links" enabled="True">
+        <configuration>
+          <targets>
+            <target htmlSdkLinkType="None" help2SdkLinkType="Index" helpViewerSdkLinkType="Id" websiteSdkLinkType="None" helpFileProject="AdditionalReferenceDocumentation.shfbproj" />
+          </targets>
+        </configuration>
+      </PlugInConfig>
     </PlugInConfigurations>
     <ApiFilter />
     <HelpAttributes />

src/corelib/Core/Collections/NamespaceDoc.cs

@@ -0,0 +1,13 @@
+namespace net.openstack.Core.Collections
+{
+    using System.Runtime.CompilerServices;
+
+    /// <summary>
+    /// The <see cref="net.openstack.Core.Collections"/> namespace contains interfaces and
+    /// classes that extend the collections support provided by the base class library.
+    /// </summary>
+    [CompilerGenerated]
+    internal class NamespaceDoc
+    {
+    }
+}

src/corelib/Core/Collections/ReadOnlyDictionary`2.cs

@@ -171,6 +171,7 @@ ICollection IDictionary.Values
             }
         }
 
+        /// <inheritdoc/>
         bool ICollection<KeyValuePair<TKey, TValue>>.IsReadOnly
         {
             get
@@ -179,6 +180,7 @@ bool ICollection<KeyValuePair<TKey, TValue>>.IsReadOnly
             }
         }
 
+        /// <inheritdoc/>
         bool IDictionary.IsFixedSize
         {
             get
@@ -187,6 +189,7 @@ bool IDictionary.IsFixedSize
             }
         }
 
+        /// <inheritdoc/>
         bool IDictionary.IsReadOnly
         {
             get
@@ -195,6 +198,7 @@ bool IDictionary.IsReadOnly
             }
         }
 
+        /// <inheritdoc/>
         bool ICollection.IsSynchronized
         {
             get
@@ -203,6 +207,7 @@ bool ICollection.IsSynchronized
             }
         }
 
+        /// <inheritdoc/>
         object ICollection.SyncRoot
         {
             get
@@ -239,6 +244,7 @@ public bool ContainsKey(TKey key)
             return _dictionary.ContainsKey(key);
         }
 
+        /// <inheritdoc/>
         bool IDictionary.Contains(object key)
         {
             if (key == null)
@@ -286,56 +292,67 @@ public bool TryGetValue(TKey key, out TValue value)
             return _dictionary.TryGetValue(key, out value);
         }
 
+        /// <inheritdoc/>
         void IDictionary<TKey, TValue>.Add(TKey key, TValue value)
         {
             throw new NotSupportedException();
         }
 
+        /// <inheritdoc/>
         void IDictionary.Add(object key, object value)
         {
             throw new NotSupportedException();
         }
 
+        /// <inheritdoc/>
         bool IDictionary<TKey, TValue>.Remove(TKey key)
         {
             throw new NotSupportedException();
         }
 
+        /// <inheritdoc/>
         void IDictionary.Remove(object key)
         {
             throw new NotSupportedException();
         }
 
+        /// <inheritdoc/>
         void ICollection<KeyValuePair<TKey, TValue>>.Add(KeyValuePair<TKey, TValue> item)
         {
             throw new NotSupportedException();
         }
 
+        /// <inheritdoc/>
         void ICollection<KeyValuePair<TKey, TValue>>.Clear()
         {
             throw new NotSupportedException();
         }
 
+        /// <inheritdoc/>
         bool ICollection<KeyValuePair<TKey, TValue>>.Contains(KeyValuePair<TKey, TValue> item)
         {
             throw new NotImplementedException();
         }
 
+        /// <inheritdoc/>
         void ICollection<KeyValuePair<TKey, TValue>>.CopyTo(KeyValuePair<TKey, TValue>[] array, int arrayIndex)
         {
             throw new NotImplementedException();
         }
 
+        /// <inheritdoc/>
         bool ICollection<KeyValuePair<TKey, TValue>>.Remove(KeyValuePair<TKey, TValue> item)
         {
             throw new NotSupportedException();
         }
 
+        /// <inheritdoc/>
         void IDictionary.Clear()
         {
             throw new NotSupportedException();
         }
 
+        /// <inheritdoc/>
         void ICollection.CopyTo(Array array, int index)
         {
             throw new NotImplementedException();
@@ -379,6 +396,7 @@ public int Count
                 }
             }
 
+            /// <inheritdoc/>
             bool ICollection<TKey>.IsReadOnly
             {
                 get
@@ -387,6 +405,7 @@ bool ICollection<TKey>.IsReadOnly
                 }
             }
 
+            /// <inheritdoc/>
             bool ICollection.IsSynchronized
             {
                 get
@@ -395,6 +414,7 @@ bool ICollection.IsSynchronized
                 }
             }
 
+            /// <inheritdoc/>
             object ICollection.SyncRoot
             {
                 get
@@ -422,6 +442,7 @@ public void CopyTo(TKey[] array, int arrayIndex)
                 _keys.CopyTo(array, arrayIndex);
             }
 
+            /// <inheritdoc/>
             void ICollection.CopyTo(Array array, int index)
             {
                 throw new NotImplementedException();
@@ -442,21 +463,25 @@ IEnumerator IEnumerable.GetEnumerator()
                 return GetEnumerator();
             }
 
-            bool ICollection<TKey>.Contains(TKey value)
+            /// <inheritdoc/>
+            bool ICollection<TKey>.Contains(TKey item)
             {
-                return _keys.Contains(value);
+                return _keys.Contains(item);
             }
 
-            void ICollection<TKey>.Add(TKey value)
+            /// <inheritdoc/>
+            void ICollection<TKey>.Add(TKey item)
             {
                 throw new NotSupportedException();
             }
 
-            bool ICollection<TKey>.Remove(TKey value)
+            /// <inheritdoc/>
+            bool ICollection<TKey>.Remove(TKey item)
             {
                 throw new NotSupportedException();
             }
 
+            /// <inheritdoc/>
             void ICollection<TKey>.Clear()
             {
                 throw new NotSupportedException();
@@ -501,6 +526,7 @@ public int Count
                 }
             }
 
+            /// <inheritdoc/>
             bool ICollection<TValue>.IsReadOnly
             {
                 get
@@ -509,6 +535,7 @@ bool ICollection<TValue>.IsReadOnly
                 }
             }
 
+            /// <inheritdoc/>
             bool ICollection.IsSynchronized
             {
                 get
@@ -517,6 +544,7 @@ bool ICollection.IsSynchronized
                 }
             }
 
+            /// <inheritdoc/>
             object ICollection.SyncRoot
             {
                 get
@@ -544,6 +572,7 @@ public void CopyTo(TValue[] array, int arrayIndex)
                 _values.CopyTo(array, arrayIndex);
             }
 
+            /// <inheritdoc/>
             void ICollection.CopyTo(Array array, int index)
             {
                 throw new NotImplementedException();
@@ -564,21 +593,25 @@ IEnumerator IEnumerable.GetEnumerator()
                 return GetEnumerator();
             }
 
-            bool ICollection<TValue>.Contains(TValue value)
+            /// <inheritdoc/>
+            bool ICollection<TValue>.Contains(TValue item)
             {
-                return _values.Contains(value);
+                return _values.Contains(item);
             }
 
-            void ICollection<TValue>.Add(TValue value)
+            /// <inheritdoc/>
+            void ICollection<TValue>.Add(TValue item)
             {
                 throw new NotSupportedException();
             }
 
-            bool ICollection<TValue>.Remove(TValue value)
+            /// <inheritdoc/>
+            bool ICollection<TValue>.Remove(TValue item)
             {
                 throw new NotSupportedException();
             }
 
+            /// <inheritdoc/>
             void ICollection<TValue>.Clear()
             {
                 throw new NotSupportedException();

src/corelib/Core/Domain/AuthenticationType.cs

@@ -30,6 +30,7 @@ private AuthenticationType(string name) : base(name)
         /// Gets the <see cref="AuthenticationType"/> instance with the specified name.
         /// </summary>
         /// <param name="name">The name.</param>
+        /// <returns>The unique <see cref="AuthenticationType"/> instance with the specified name.</returns>
         /// <exception cref="ArgumentNullException">If <paramref name="name"/> is <see langword="null"/>.</exception>
         /// <exception cref="ArgumentException">If <paramref name="name"/> is empty.</exception>
         public static AuthenticationType FromName(string name)