Improve docs and logs

CHANGELOG.md

@@ -2,6 +2,11 @@
 
 ## [Unreleased]
 
+## [1.0.2] - 2023-10-19
+
+- Improve docs
+- Improve logs
+
 ## [1.0.1] - 2023-10-19
 
 - Add failIfNoActiveSubStage to stage

Fun.Build/Changelog.fs

@@ -6,6 +6,13 @@ open System.Text
 
 type Changelog =
 
+    /// <summary>
+    /// Get latest version info from the CHANGELOG.md file
+    /// </summary>
+    /// <param name="directory">Directory which contains the changelog file</param>
+    /// <param name="changelogFileName">Default is CHANGELOG.md</param>
+    /// <param name="isPreview">Check if the line contains keyword 'preview'</param>
+    /// <param name="isValidVersion">By default always return true</param>
     static member GetLastVersion(directory, ?changelogFileName, ?isPreview, ?isValidVersion) =
         let changelogFileName = defaultArg changelogFileName "CHANGELOG.md"
         let lines = File.ReadLines(Path.Combine(directory, changelogFileName)).GetEnumerator()

Fun.Build/StageContextExtensions.fs

@@ -164,7 +164,10 @@ module StageContextExtensionsInternal =
                             | Step.StepOfStage s -> s.IsActive { s with ParentContext = parentContext }
                             | _ -> false
                         )
-                    if not hasActiveStep then raise (PipelineFailedException "No active sub stages")
+                    if not hasActiveStep then
+                        AnsiConsole.MarkupLineInterpolated
+                            $"[red]Pipeline is failed because there is no active sub stages but stage ({stage.GetNamePath()}) requires at least one[/]"
+                        raise (PipelineFailedException "No active sub stages")
 
                 let stageSW = Stopwatch.StartNew()
                 let isParallel = stage.IsParallel stage

README.md

@@ -19,7 +19,7 @@ Every **step** is just a **async<Result<unit, string>>**, string is for the erro
 ## Minimal example and conventions
 
 ```fsharp
-#r "nuget: Fun.Build, 1.0.1"
+#r "nuget: Fun.Build, 1.0.2"
 open Fun.Build
 
 pipeline "demo" {
@@ -66,7 +66,7 @@ dotnet fsi build.fsx -- -p your_pipeline -h
 Below example covered most of the apis and usage example, take it as the documents😊:
 
 ```fsharp
-#r "nuget: Fun.Build, 1.0.1"
+#r "nuget: Fun.Build, 1.0.2"
 
 open Fun.Result
 open Fun.Build