comment pass

Assets/Engine/Runtime/Measurements/Puzzle.cs

@@ -8,15 +8,30 @@ using Realms;
 
 namespace EscapeRoomEngine.Engine.Runtime.Measurements
 {
+    /// <summary>
+    /// The representation of a specific puzzle in the database. This includes all measurements for this puzzle.
+    /// </summary>
     [SuppressMessage("ReSharper", "UnassignedGetOnlyAutoProperty")]
     public class Puzzle : RealmObject
     {
         [PrimaryKey]
         public int ID { get; set; }
+        /// <summary>
+        /// All puzzle measurements recorded for this puzzle.
+        /// </summary>
         public IList<PuzzleMeasurement> Measurements { get; }
 
+        /// <summary>
+        /// How much time has been spent on this puzzle in total. This is used to calculate the average time to solve this puzzle.
+        /// </summary>
         public float TotalTimeSpentOnPuzzle => Measurements.Sum(measurement => measurement.Time);
+        /// <summary>
+        /// The average time to solve this puzzle using all measurements recorded for it.
+        /// </summary>
         public float AverageTimeToSolve => Measurements.Count > 0 ? TotalTimeSpentOnPuzzle / Measurements.Count : 0f;
+        /// <summary>
+        /// The normal distribution of all recorded measurements.
+        /// </summary>
         public NormalDistribution Distribution => new(TimesAsSamples());
 
         [UsedImplicitly]