samples docs

Author: danielgerlag

ReleaseNotes/1.2.8.md

@@ -0,0 +1,23 @@
+# Workflow Core 1.2.8
+
+* Added .Schedule() API, to future date a block of steps to run in parallel to the rest of the workflow.
+
+This following example will execute the block of steps after 3 days
+```c#
+builder                
+    .StartWith<HelloWorld>()
+    .Schedule(data => TimeSpan.FromDays(3)).Do(block => 
+        block.StartWith<DoSomething>()
+        .Then<DoSomethingElse>())
+    .Then<GoodbyeWorld>();
+```
+
+* Added inline action steps API
+
+```c#
+builder                
+    .StartWith(context => Console.WriteLine("Hello!"))
+    .Then(context => Console.WriteLine("Bye!"));
+```
+
+* Discontinued support for .NET 4.5.2 (.NET 4.6 is .NET Standard 1.3 compatible)

WorkflowCore.sln

@@ -1,7 +1,7 @@
 
 Microsoft Visual Studio Solution File, Format Version 12.00
 # Visual Studio 15
-VisualStudioVersion = 15.0.26228.4
+VisualStudioVersion = 15.0.26430.12
 MinimumVisualStudioVersion = 10.0.40219.1
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "src", "src", "{EF47161E-E399-451C-BDE8-E92AAD3BD761}"
 EndProject
@@ -88,6 +88,8 @@ Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "WorkflowCore.Sample13", "sr
 EndProject
 Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "WorkflowCore.Providers.Azure", "src\providers\WorkflowCore.Providers.Azure\WorkflowCore.Providers.Azure.csproj", "{A2374B7C-4198-40B3-B8FE-FAC3DB3F2539}"
 EndProject
+Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "ReleaseNotes", "ReleaseNotes", "{38ECB00C-3F3B-4442-8408-ACE3B37FFAA8}"
+EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
 		Debug|Any CPU = Debug|Any CPU

src/WorkflowCore/Interface/IStepBuilder.cs

@@ -119,10 +119,25 @@ public interface IStepBuilder<TData, TStepBody>
         /// <returns></returns>
         IStepBuilder<TData, Delay> Delay(Expression<Func<TData, TimeSpan>> period);
 
+        /// <summary>
+        /// Execute a block of steps, once for each item in a collection in a parallel foreach
+        /// </summary>
+        /// <param name="collection"></param>
+        /// <returns></returns>
         IContainerStepBuilder<TData, Foreach, Foreach> ForEach(Expression<Func<TData, IEnumerable>> collection);
 
+        /// <summary>
+        /// Repeat a block of steps until a condition becomes true
+        /// </summary>
+        /// <param name="condition"></param>
+        /// <returns></returns>
         IContainerStepBuilder<TData, While, While> While(Expression<Func<TData, bool>> condition);
 
+        /// <summary>
+        /// Execute a block of steps if a condition is true
+        /// </summary>
+        /// <param name="condition"></param>
+        /// <returns></returns>
         IContainerStepBuilder<TData, If, If> If(Expression<Func<TData, bool>> condition);
 
         /// <summary>
@@ -132,8 +147,17 @@ public interface IStepBuilder<TData, TStepBody>
         /// <returns></returns>
         IContainerStepBuilder<TData, When, OutcomeSwitch> When(Expression<Func<TData, object>> outcomeValue, string label = null);
 
+        /// <summary>
+        /// Execute multiple blocks of steps in parallel
+        /// </summary>
+        /// <returns></returns>
         IParallelStepBuilder<TData, Sequence> Parallel();
 
+        /// <summary>
+        /// Schedule a block of steps to execute in parallel sometime in the future
+        /// </summary>
+        /// <param name="time"></param>
+        /// <returns></returns>
         IContainerStepBuilder<TData, Schedule, TStepBody> Schedule(Expression<Func<TData, TimeSpan>> time);
     }
 }

src/samples/WorkflowCore.Sample09/README.md

@@ -9,6 +9,7 @@ builder
 	.ForEach(data => new List<int>() { 1, 2, 3, 4 })
 		.Do(x => x
 			.StartWith<DisplayContext>()
+				.Input(step => step.Item, (data, context) => context.Item)
 			.Then<DoSomething>())
 	.Then<SayGoodbye>();
 ```
@@ -21,20 +22,8 @@ builder
 	.ForEach(data => data.MyCollection)
 		.Do(x => x
 			.StartWith<DisplayContext>()
+				.Input(step => step.Item, (data, context) => context.Item)
 			.Then<DoSomething>())
 	.Then<SayGoodbye>();
 
 ```
-
-Access the iteration item from the step execution context
-
-```c#
-public class DisplayContext : StepBody
-{        
-    public override ExecutionResult Run(IStepExecutionContext context)
-    {
-        Console.WriteLine($"Working on item {context.Item}");
-        return ExecutionResult.Next();
-    }
-}
-```