Summaries' improvements

Author: alex-kulakov

Orm/Xtensive.Orm/Orm/Configuration/DatabaseConfiguration.cs

@@ -52,7 +52,7 @@ public string RealName
     /// <summary>
     /// Gets or sets type ID minimal value
     /// for types mapped to this database.
-    /// Default value is 100.
+    /// Default value is <see cref="TypeInfo.MinTypeId"/>.
     /// </summary>
     public int MinTypeId
     {

Orm/Xtensive.Orm/Orm/Configuration/DomainConfiguration.cs

@@ -68,7 +68,7 @@ public class DomainConfiguration : ConfigurationBase
 
     /// <summary>
     /// Default <see cref="ShareStorageSchemaOverNodes"/> value:
-    /// <see langword="false"/>
+    /// <see langword="false"/>.
     /// </summary>
     public const bool DefaultShareStorageSchemaOverNodes = false;
 
@@ -354,6 +354,7 @@ public ForeignKeyMode ForeignKeyMode
     /// <summary>
     /// Gets or sets a value indicating change tracking mode of full-text indexes.
     /// The property may have no effect for certain storages where there is no support for such option.
+    /// Default value is <see cref="DomainConfiguration.DefaultFullTextChangeTrackingMode"/>.
     /// </summary>
     public FullTextChangeTrackingMode FullTextChangeTrackingMode
     {
@@ -590,7 +591,7 @@ public bool ShareStorageSchemaOverNodes
     }
 
     /// <summary>
-    /// Gets or sets versioning convention.
+    /// Gets or sets rules of entity versioning.
     /// </summary>
     public VersioningConvention VersioningConvention
     {
@@ -603,6 +604,13 @@ public VersioningConvention VersioningConvention
 
     /// <summary>
     /// Enables extra check if connection is not broken on its opening.
+    /// For some RDBMSs physical connection may become broken but connection pool, which
+    /// is in charge of logical connections, is not aware of it.
+    /// In such cases connection pool provides connection
+    /// which is dead on arrival and causes exception on first use of it.
+    /// Such connection should be re-created and re-opened. The extra check
+    /// tests connection by making "first use" of it, if check failed connection
+    /// will be restored automatically.
     /// </summary>
     public bool EnsureConnectionIsAlive
     {

Orm/Xtensive.Orm/Orm/Configuration/Elements/DatabaseConfigurationElement.cs

@@ -1,6 +1,6 @@
-// Copyright (C) 2012 Xtensive LLC.
-// All rights reserved.
-// For conditions of distribution and use, see license.
+// Copyright (C) 2012-2024 Xtensive LLC.
+// This code is distributed under MIT license terms.
+// See the License.txt file in the project root for more information.
 // Created by: Denis Krjuchkov
 // Created:    2012.02.08
 
@@ -24,7 +24,7 @@ public class DatabaseConfigurationElement : ConfigurationCollectionElementBase
     public override object Identifier { get { return Name; } }
 
     /// <summary>
-    /// <see cref="DatabaseConfiguration.Name" copy="true"/>
+    /// <see cref="DatabaseConfiguration.Name" />
     /// </summary>
     [ConfigurationProperty(NameElementName, IsKey = true)]
     public string Name
@@ -34,7 +34,7 @@ public string Name
     }
 
     /// <summary>
-    /// <see cref="DatabaseConfiguration.RealName" copy="true"/>
+    /// <see cref="DatabaseConfiguration.RealName" />
     /// </summary>
     [ConfigurationProperty(RealNameElementName)]
     public string RealName
@@ -44,7 +44,7 @@ public string RealName
     }
 
     /// <summary>
-    /// <see cref="DatabaseConfiguration.MinTypeId" copy="true"/>
+    /// <see cref="DatabaseConfiguration.MinTypeId" />
     /// </summary>
     [ConfigurationProperty(MinTypeIdElementName, DefaultValue = TypeInfo.MinTypeId)]
     public int MinTypeId
@@ -54,7 +54,7 @@ public int MinTypeId
     }
 
     /// <summary>
-    /// <see cref="DatabaseConfiguration.MaxTypeId" copy="true"/>
+    /// <see cref="DatabaseConfiguration.MaxTypeId" />
     /// </summary>
     [ConfigurationProperty(MaxTypeIdElementName, DefaultValue = int.MaxValue)]
     public int MaxTypeId