doc: improve documentation in Timers (#271)

Improve errors and missing data in the documentations from the timer
implementation from
- #270

Co-authored-by: Valentin Breuß <[email protected]>

Author: vbreuss

Source/Testably.Abstractions.Testing/TimeSystem/ITimerMock.cs

@@ -15,7 +15,7 @@ public interface ITimerMock : ITimer
 	/// </summary>
 	/// <param name="executionCount">The number of execution cycles the thread is blocked.</param>
 	/// <param name="timeout">
-	///     The timeout for blocking the current thread.<br />
+	///     The timeout in milliseconds for blocking the current thread.<br />
 	///     Throws an <see cref="TimeoutException" /> when the timeout is expired.
 	/// </param>
 	/// <param name="callback">
@@ -28,6 +28,7 @@ public interface ITimerMock : ITimer
 	///     When the <paramref name="timeout" /> expires before the timer is executed
 	///     <paramref name="executionCount" /> times.
 	/// </exception>
-	ITimerMock Wait(int executionCount = 1, int timeout = 10000,
+	ITimerMock Wait(int executionCount = 1,
+		int timeout = 10000,
 		Action<ITimerMock>? callback = null);
 }

Source/Testably.Abstractions.Testing/TimeSystem/TimerMock.cs

@@ -152,7 +152,7 @@ public bool Dispose(WaitHandle notifyObject)
 				e.Set();
 				break;
 			default:
-				throw new NotSupportedException("The wait handle is not of any supported type!");
+				throw new NotSupportedException($"The wait handle '{nameof(notifyObject)}' is of type '{notifyObject.GetType()}' which is not supported!");
 		}
 
 		return true;
@@ -166,7 +166,7 @@ public ITimerMock Wait(
 	{
 		if (executionCount <= 0)
 		{
-			throw new ArgumentOutOfRangeException(nameof(executionCount));
+			throw new ArgumentOutOfRangeException(nameof(executionCount), "Execution count must be greater than zero.");
 		}
 
 		if (timeout < -1)

Source/Testably.Abstractions.Testing/TimeSystem/TimerStrategy.cs

@@ -6,7 +6,8 @@
 public class TimerStrategy : ITimerStrategy
 {
 	/// <summary>
-	///     The default time strategy uses <see cref="TimerMode.StartImmediately" />.
+	///     The default timer strategy uses <see cref="TimerMode.StartImmediately" /> and
+	///     does not swallow exceptions.
 	/// </summary>
 	public static ITimerStrategy Default { get; }
 		= new TimerStrategy();