Documentation and unit test updates.

Author: johnnewman-square

Workflow/Sources/WorkflowHost.swift

@@ -94,14 +94,14 @@ public final class WorkflowHost<WorkflowType: Workflow> {
     ///
     /// This property can be used when fine-grained control over the rendering
     /// of a `WorkflowHost` is needed, like cases where a container maintains
-    /// its hosts and propagates their output & renderings to the main Workflow
+    /// hosts and propagates their output & renderings to the main Workflow
     /// tree. Without this mechanism, detached hosts may render extra times:
     /// once for the applied action and again when the main tree renders.
     @_spi(WorkflowHostManagement)
     public var managedRenderings: Bool = false
 
-    /// Executes `update(workflow:)` when `managedRenderings` is `true`, and
-    /// temporarily allows the `rootNode` to be rendered.
+    /// Executes `update(workflow:)`, temporarily allowing the `rootNode` to be
+    /// rendered when `managedRenderings` is `true`.
     @_spi(WorkflowHostManagement)
     public func managedUpdate(workflow: WorkflowType) {
         let previousValue = managedRenderings

Workflow/Tests/WorkflowHostTests.swift

@@ -98,15 +98,32 @@ extension WorkflowHostTests {
         host.managedRenderings = true
         XCTAssertEqual(host.rendering.value, 1)
 
-        // Example of a traditional render pass not rendering the underlying
-        // workflow when its renderings are managed. This render pass may also
+        // Example of a standard render pass. This will not render the hosted
+        // workflow when renderings are managed. This render pass could also
         // come from an action applied to the workflow.
         host.update(workflow: TestWorkflow(step: .second))
         XCTAssertEqual(host.rendering.value, 1)
 
-        // A managed update will render the workflow.
+        // A managed update will always render the workflow.
         host.managedUpdate(workflow: TestWorkflow(step: .second))
         XCTAssertEqual(host.rendering.value, 2)
+
+        // Ensure that the flag is still enabled.
+        XCTAssertTrue(host.managedRenderings)
+    }
+
+    func test_managed_renderings_when_not_set() {
+        let host = WorkflowHost(
+            workflow: TestWorkflow(step: .first)
+        )
+        XCTAssertEqual(host.rendering.value, 1)
+
+        // A managed update will always render the workflow.
+        host.managedUpdate(workflow: TestWorkflow(step: .second))
+        XCTAssertEqual(host.rendering.value, 2)
+
+        // Ensure that the flag wasn't inadvertently enabled.
+        XCTAssertFalse(host.managedRenderings)
     }
 }