Merge branch 'improvement/ViewModels-XmlDocs' into develop

Minor improvements to XML Docs within the `OnTopic.ViewModels` project. For instance, preferred the more specific name `model` for view models, instead of describing them as data transfer objects.

Author: JeremyCaney

OnTopic.ViewModels/BindingModels/AssociatedTopicBindingModel.cs

@@ -10,10 +10,10 @@
 namespace OnTopic.ViewModels.BindingModels {
 
   /*============================================================================================================================
-  | CLASS: ASSOCIATED TOPIC BINDING MODEL
+  | BINDING MODEL: ASSOCIATED TOPIC
   \---------------------------------------------------------------------------------------------------------------------------*/
   /// <summary>
-  ///   Provides a generic data transfer topic for binding an association of a binding model to an existing <see cref="Topic"/>.
+  ///   Provides a model for binding an association of a <see cref="ITopicBindingModel"/> to another <see cref="Topic"/>.
   /// </summary>
   /// <remarks>
   ///   While implementors may choose to create a custom <see cref="IAssociatedTopicBindingModel"/> implementation, the out-of-
@@ -27,7 +27,7 @@ public record AssociatedTopicBindingModel : IAssociatedTopicBindingModel {
     | PROPERTY: UNIQUE KEY
     \-------------------------------------------------------------------------------------------------------------------------*/
     /// <summary>
-    ///   Gets or sets the topic's <see cref="UniqueKey"/> attribute, the unique text identifier for the topic.
+    ///   Gets the topic's <see cref="UniqueKey"/> attribute, the unique text identifier for the topic.
     /// </summary>
     /// <requires description="The value from the getter must not be null." exception="T:System.ArgumentNullException">
     ///   value is not null

OnTopic.ViewModels/BindingModels/RelatedTopicBindingModel.cs

@@ -10,10 +10,10 @@
 namespace OnTopic.ViewModels.BindingModels {
 
   /*============================================================================================================================
-  | CLASS: RELATED TOPIC BINDING MODEL
+  | BINDING MODEL: RELATED TOPIC
   \---------------------------------------------------------------------------------------------------------------------------*/
   /// <summary>
-  ///   Provides a generic data transfer topic for binding a relationship of a binding model to an existing <see cref="Topic"/>.
+  ///   Provides a model for binding a relationship of a <see cref="ITopicBindingModel"/> to an existing <see cref="Topic"/>.
   /// </summary>
   /// <remarks>
   ///   While implementors may choose to create a custom <see cref="IAssociatedTopicBindingModel"/> implementation, the out-of-

OnTopic.ViewModels/Collections/TopicViewModelCollection.cs

@@ -16,8 +16,8 @@ namespace OnTopic.ViewModels.Collections {
   | VIEW MODEL: TOPIC COLLECTION
   \---------------------------------------------------------------------------------------------------------------------------*/
   /// <summary>
-  ///   Provides a basic collection interface for use with data transfer objects implementing <see cref="ITopicViewModel"/>,
-  ///   including <see cref="TopicViewModel"/> and derivatives.
+  ///   Provides a basic collection interface for use with models implementing <see cref="ITopicViewModel"/>, including <see
+  ///   cref="TopicViewModel"/> and derivatives.
   /// </summary>
   /// <remarks>
   ///   Typically, view models should be created as part of the presentation layer. The <see cref="Models"/> namespace contains

OnTopic.ViewModels/ContentListTopicViewModel.cs

@@ -12,7 +12,7 @@ namespace OnTopic.ViewModels {
   | VIEW MODEL: CONTENT LIST TOPIC
   \---------------------------------------------------------------------------------------------------------------------------*/
   /// <summary>
-  ///   Provides a strongly-typed data transfer object for feeding views with information about a content list topic.
+  ///   Provides a strongly-typed model for feeding views with information about a <c>ContentList</c> topic.
   /// </summary>
   /// <remarks>
   ///   Typically, view models should be created as part of the presentation layer. The <see cref="Models"/> namespace contains

OnTopic.ViewModels/IndexTopicViewModel.cs

@@ -10,7 +10,7 @@ namespace OnTopic.ViewModels {
   | VIEW MODEL: INDEX TOPIC
   \---------------------------------------------------------------------------------------------------------------------------*/
   /// <summary>
-  ///   Provides a strongly-typed data transfer object for feeding views with information about an index topic.
+  ///   Provides a strongly-typed model for feeding views with information about an <c>Index</c> topic.
   /// </summary>
   /// <remarks>
   ///   Typically, view models should be created as part of the presentation layer. The <see cref="Models"/> namespace contains

OnTopic.ViewModels/Items/ContentItemTopicViewModel.cs

@@ -11,7 +11,8 @@ namespace OnTopic.ViewModels.Items {
   | VIEW MODEL: CONTENT ITEM TOPIC
   \---------------------------------------------------------------------------------------------------------------------------*/
   /// <summary>
-  ///   Provides a strongly-typed data transfer object for feeding views with information about a content item topic.
+  ///   Provides a strongly-typed model for feeding views with information about a <c>ContentItem</c> topic, as used in the <see
+  ///   cref="ContentListTopicViewModel"/> model, and its derivatives.
   /// </summary>
   /// <remarks>
   ///   Typically, view models should be created as part of the presentation layer. The <see cref="Models"/> namespace contains

OnTopic.ViewModels/Items/ItemTopicViewModel.cs

@@ -10,7 +10,7 @@ namespace OnTopic.ViewModels.Items {
   | VIEW MODEL: ITEM TOPIC
   \---------------------------------------------------------------------------------------------------------------------------*/
   /// <summary>
-  ///   Provides a strongly-typed data transfer object for feeding views with information about an item topic.
+  ///   Provides a strongly-typed model for feeding views with information about an <c>Item</c> topic.
   /// </summary>
   /// <remarks>
   ///   Typically, view models should be created as part of the presentation layer. The <see cref="Models"/> namespace contains

OnTopic.ViewModels/Items/ListTopicViewModel.cs

@@ -11,7 +11,7 @@ namespace OnTopic.ViewModels.Items {
   | VIEW MODEL: LIST
   \---------------------------------------------------------------------------------------------------------------------------*/
   /// <summary>
-  ///   Provides a strongly-typed data transfer object for modeling a nested topic list.
+  ///   Provides a strongly-typed model for modeling a <c>List</c> topic, as used for nested topics.
   /// </summary>
   /// <remarks>
   ///   <para>

OnTopic.ViewModels/Items/LookupListItemTopicViewModel.cs

@@ -10,7 +10,7 @@ namespace OnTopic.ViewModels.Items {
   | VIEW MODEL: LOOKUP LIST ITEM TOPIC
   \---------------------------------------------------------------------------------------------------------------------------*/
   /// <summary>
-  ///   Provides a strongly-typed data transfer object for feeding views with information about lookup list item topic.
+  ///   Provides a strongly-typed model for feeding views with information about <c>LookupListItem</c> topic.
   /// </summary>
   /// <remarks>
   ///   Typically, view models should be created as part of the presentation layer. The <see cref="Models"/> namespace contains

OnTopic.ViewModels/Items/SlideTopicViewModel.cs

@@ -10,7 +10,8 @@ namespace OnTopic.ViewModels.Items {
   | VIEW MODEL: SLIDE TOPIC
   \---------------------------------------------------------------------------------------------------------------------------*/
   /// <summary>
-  ///   Provides a strongly-typed data transfer object for feeding views with information about a slide topic.
+  ///   Provides a strongly-typed model for feeding views with information about a <c>Slide</c> topic, as used in e.g. <see cref
+  ///   ="SlideshowTopicViewModel"/>.
   /// </summary>
   /// <remarks>
   ///   Typically, view models should be created as part of the presentation layer. The <see cref="Models"/> namespace contains