fix: Refactor async chapter

Author: dbrattli

.vscode/settings.json

@@ -1,15 +1,23 @@
 {
     "cSpell.words": [
+        "aiohttp",
+        "alfonsogarciacaro",
+        "Buildalyzer",
         "coro",
         "destructures",
         "elif",
         "eprintln",
         "fabletext",
+        "failwithf",
         "Fantomas",
         "fastapi",
         "Feliz",
         "getcwd",
+        "getenv",
         "Hashnode",
+        "listdir",
+        "nativeint",
+        "ncave",
         "pathlib",
         "pyname",
         "Pyxpecto",

Fable.Literate.Tests/Fable.Literate.Tests.fsproj

@@ -14,7 +14,7 @@
     <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.8.0" />
     <PackageReference Include="YoloDev.Expecto.TestSdk" Version="0.14.3" />
     <PackageReference Include="Fable.Core" Version="5.0.0-beta.4" />
-    <PackageReference Include="Fable.Python" Version="5.0.0-alpha.21.0" />
+    <PackageReference Include="Fable.Python" Version="5.0.0-alpha.21.5" />
   </ItemGroup>
 
   <ItemGroup>

chapters/AsyncProgramming.fs

@@ -60,19 +60,13 @@ There are several ways to execute an async workflow:
 *)
 
 let runAsyncExample () =
+    // Run synchronously (blocking) - simplest approach
+    let result = fetchDataAsync () |> Async.RunSynchronously
+
     // Start immediately (non-blocking) - Ignore discards the result
     fetchDataAsync () |> Async.Ignore |> Async.StartImmediate
 
-    // Run synchronously (blocking)
-    let result = fetchDataAsync () |> Async.RunSynchronously
-
-    // Start with explicit continuations
-    Async.StartWithContinuations(
-        fetchDataAsync (),
-        (fun result -> printfn $"Success: {result}"),
-        (fun ex -> printfn $"Error: {ex.Message}"),
-        (fun cancelled -> printfn "Cancelled")
-    )
+    result
 
 (**
 ### Combining Async Operations
@@ -351,6 +345,22 @@ let runWithTimeout () =
             return None
     }
 
+(**
+### Advanced: StartWithContinuations
+
+For fine-grained control over success, error, and cancellation outcomes, use
+`Async.StartWithContinuations`. This is useful when you need different handling paths
+for each case:
+*)
+
+let runWithContinuations () =
+    Async.StartWithContinuations(
+        fetchDataAsync (),
+        (fun result -> printfn $"Success: {result}"),
+        (fun ex -> printfn $"Error: {ex.Message}"),
+        (fun _cancelled -> printfn "Cancelled")
+    )
+
 (**
 ## When to Use What
 

chapters/Introduction.fs

@@ -3,6 +3,9 @@ module Introduction
 (**
 # Introduction to Fable.Python
 
+> This post is part of the [F# Advent Calendar 2025](https://sergeytihon.com/2025/11/03/f-advent-calendar-in-english-2025/).
+Thank you, Sergey Tihon, for organizing this wonderful tradition that brings the F# community together every year!
+
 Welcome to this guide on [Fable.Python](https://github.com/fable-compiler/Fable.Python/) -
 a compiler that transforms F# code into Python.
 
@@ -99,11 +102,8 @@ the `area` function.
 
 ## What's Next?
 
-In the following chapters, we'll cover:
-
-- **Getting Started** - Setting up your development environment
-- **Bindings** - Working with Python libraries from F#
-- **Compatibility** - Understanding what F# features are supported
+In the following chapters, we'll explore setting up your environment,
+working with Python libraries, and understanding F# compatibility with Fable.
 
 Let's begin.
 *)

fable-python.fsproj

@@ -7,7 +7,7 @@
 
   <ItemGroup>
     <PackageReference Include="Fable.Core" Version="5.0.0-beta.4" />
-    <PackageReference Include="Fable.Python" Version="5.0.0-alpha.21.0" />
+    <PackageReference Include="Fable.Python" Version="5.0.0-alpha.21.5" />
   </ItemGroup>
 
   <ItemGroup>