Tweak C# docs for CreateTimer APIs

release_notes.md

@@ -4,5 +4,6 @@
 
 * Fix message loss bug in ContinueAsNew scenarios ([Azure/durabletask#544](https://github.com/Azure/durabletask/pull/544))
 * Allow custom connection string names when creating a DurableClient in an ASP.NET Core app (external app) (#1895)
+* Improve API documentation regarding uncancelled timers (#1903)
 
 ## Breaking Changes

src/WebJobs.Extensions.DurableTask/ContextInterfaces/IDurableOrchestrationContext.cs

@@ -328,7 +328,8 @@ public interface IDurableOrchestrationContext
         /// <remarks>
         /// All durable timers created using this method must either expire or be cancelled
         /// using the <paramref name="cancelToken"/> before the orchestrator function completes.
-        /// Otherwise the underlying framework will keep the instance alive until the timer expires.
+        ///  Otherwise the underlying framework will keep the instance in the "Running" state
+        ///  even after the orchestrator function has completed.
         /// </remarks>
         /// <typeparam name="T">The type of <paramref name="state"/>.</typeparam>
         /// <param name="fireAt">The time at which the timer should expire.</param>
@@ -343,7 +344,8 @@ public interface IDurableOrchestrationContext
         /// <remarks>
         /// All durable timers created using this method must either expire or be cancelled
         /// using the <paramref name="cancelToken"/> before the orchestrator function completes.
-        /// Otherwise the underlying framework will keep the instance alive until the timer expires.
+        ///  Otherwise the underlying framework will keep the instance in the "Running" state
+        ///  even after the orchestrator function has completed.
         /// </remarks>
         /// <param name="fireAt">The time at which the timer should expire.</param>
         /// <param name="cancelToken">The <c>CancellationToken</c> to use for cancelling the timer.</param>