Update data models (#62)

openactive · Jul 19, 2022 · 7bf6aac · 7bf6aac
1 parent 23e382d
commit 7bf6aac
Show file tree

Hide file tree

Showing 4 changed files with 11 additions and 11 deletions.
diff --git a/OpenActive.NET/models/Dataset.cs b/OpenActive.NET/models/Dataset.cs
@@ -157,11 +157,11 @@ public override string ToString()
         public new virtual List<DataDownload> Distribution { get; set; }
 
         /// <summary>
-        /// A link to documentation related to the `Dataset`, or a link to the OpenActive developer documentation if no Dataset-specific documentation is available.
+        /// A link to documentation related to the `Dataset`, or a link to the OpenActive developer documentation using `https://permalink.openactive.io/dataset-site/open-data-documentation` if no Dataset-specific documentation is available.
         /// </summary>
         /// <example>
         /// <code>
-        /// "documentation": "https://developer.openactive.io"
+        /// "documentation": "https://permalink.openactive.io/dataset-site/open-data-documentation"
         /// </code>
         /// </example>
         [DataMember(Name = "documentation", EmitDefaultValue = false, Order = 16)]

diff --git a/OpenActive.NET/models/Place.cs b/OpenActive.NET/models/Place.cs
@@ -285,7 +285,7 @@ public override string ToString()
         /// 
         /// If you are using this property, please join the discussion at proposal [#307](https://github.com/openactive/modelling-opportunity-data/issues/307).
         /// </summary>
-        [DataMember(Name = "beta:serviceOperator", EmitDefaultValue = false, Order = 1024)]
+        [DataMember(Name = "beta:serviceOperator", EmitDefaultValue = false, Order = 1023)]
         [JsonConverter(typeof(ValuesConverter))]
         public virtual Organization ServiceOperator { get; set; }
 
@@ -295,7 +295,7 @@ public override string ToString()
         /// 
         /// If you are using this property, please join the discussion at proposal [#1](https://github.com/openactive/place-types/issues/1).
         /// </summary>
-        [DataMember(Name = "beta:placeType", EmitDefaultValue = false, Order = 1025)]
+        [DataMember(Name = "beta:placeType", EmitDefaultValue = false, Order = 1024)]
         [JsonConverter(typeof(ValuesConverter))]
         public virtual List<Concept> PlaceType { get; set; }
     }

diff --git a/OpenActive.NET/models/QuantitativeValue.cs b/OpenActive.NET/models/QuantitativeValue.cs
@@ -45,7 +45,7 @@ public override string ToString()
         public override string Type => "QuantitativeValue";
 
         /// <summary>
-        /// The maximum value.
+        /// The maximum value, inclusive.
         /// </summary>
         /// <example>
         /// <code>
@@ -57,7 +57,7 @@ public override string ToString()
         public new virtual long? MaxValue { get; set; }
 
         /// <summary>
-        /// The minimum value.
+        /// The minimum value, inclusive.
         /// </summary>
         /// <example>
         /// <code>

diff --git a/OpenActive.NET/models/WebAPI.cs b/OpenActive.NET/models/WebAPI.cs
@@ -72,7 +72,7 @@ public override string ToString()
         public virtual string Description { get; set; }
 
         /// <summary>
-        /// The location of the OpenID Provider or other relevant authentication authority that must be used to access the API.
+        /// The location of the OpenID Provider that must be used to access the API.
         /// </summary>
         /// <example>
         /// <code>
@@ -98,11 +98,11 @@ public override string ToString()
         public virtual List<Uri> ConformsTo { get; set; }
 
         /// <summary>
-        /// A link to documentation related to the Dataset, or a link to the OpenActive developer documentation if no Dataset-specific documentation is available.
+        /// A link to documentation related to how to use the Open Booking API, or a link to the OpenActive developer documentation using `https://permalink.openactive.io/dataset-site/open-booking-api-documentation` if no system-specific documentation is available.
         /// </summary>
         /// <example>
         /// <code>
-        /// "documentation": "https://developer.openactive.io"
+        /// "documentation": "https://permalink.openactive.io/dataset-site/open-booking-api-documentation"
         /// </code>
         /// </example>
         [DataMember(Name = "documentation", EmitDefaultValue = false, Order = 11)]
@@ -122,7 +122,7 @@ public override string ToString()
         public virtual Uri EndpointDescription { get; set; }
 
         /// <summary>
-        /// The base URL of the Open Booking API
+        /// The Base URI of this implementation of the Open Booking API
         /// </summary>
         /// <example>
         /// <code>
@@ -134,7 +134,7 @@ public override string ToString()
         public virtual Uri EndpointUrl { get; set; }
 
         /// <summary>
-        /// The web page the broker uses to obtain access to the API, e.g. via a web form.
+        /// The URL of a web page that the Broker may use to obtain access to the API, e.g. via a web form.
         /// </summary>
         /// <example>
         /// <code>