akkadotnet · Aaronontheweb · May 20, 2022 · Feb 17, 2022 · Feb 17, 2022 · Feb 17, 2022
diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
@@ -1,5 +1,77 @@
-#### 1.4.34 February 14 2022 ####
-**Placeholder for nightlies**
+#### 1.5.0-beta1 April 20 2022 ####
+**Placeholder for first beta release of Akka.NET v1.5**
+
+#### 1.4.37 April 14 2022 ####
+Akka.NET v1.4.37 is a minor release that contains some minor bug fixes.
+
+* [Persistence.Query: Change AllEvents query failure log severity from Debug to Error](https://github.com/akkadotnet/akka.net/pull/5835)
+* [Coordination: Harden LeaseProvider instance Activator exception handling](https://github.com/akkadotnet/akka.net/pull/5838)
+* [Akka: Make ActorSystemImpl.Abort skip the CoordinatedShutdown check](https://github.com/akkadotnet/akka.net/pull/5839)
+
+If you want to see the [full set of changes made in Akka.NET v1.4.37, click here](https://github.com/akkadotnet/akka.net/milestone/68?closed=1).
+
+| COMMITS | LOC+ | LOC- | AUTHOR              |
+|---------|------|------|---------------------|
+| 3       | 15   | 4    | Gregorius Soedharmo |
+| 1       | 2    | 2    | dependabot[bot]     |
+
+#### 1.4.36 April 4 2022 ####
+Akka.NET v1.4.36 is a minor release that contains some bug fixes. Most of the changes have been aimed at improving our web documentation and code cleanup to modernize some of our code.
+
+* [Akka: Bump Hyperion to 0.12.2](https://github.com/akkadotnet/akka.net/pull/5805)
+
+__Bug fixes__:
+* [Akka: Fix CoordinatedShutdown memory leak](https://github.com/akkadotnet/akka.net/pull/5816)
+* [Akka: Fix TcpConnection error handling and death pact de-registration](https://github.com/akkadotnet/akka.net/pull/5817)
+
+If you want to see the [full set of changes made in Akka.NET v1.4.36, click here](https://github.com/akkadotnet/akka.net/milestone/67?closed=1).
+
+| COMMITS | LOC+ | LOC- | AUTHOR              |
+|---------|------|------|---------------------|
+| 5       | 274  | 33   | Gregorius Soedharmo |
+| 4       | 371  | 6    | Ebere Abanonu       |
+| 3       | 9    | 3    | Aaron Stannard      |
+| 1       | 34   | 38   | Ismael Hamed        |
+| 1       | 2    | 3    | Adrian Leonhard     |
+
+#### 1.4.35 March 18 2022 ####
+Akka.NET v1.4.35 is a minor release that contains some bug fixes. Most of the changes have been aimed at improving our web documentation and code cleanup to modernize some of our code.
+
+__Bug fixes__:
+* [Akka: Fixed IActorRef leak inside EventStream](https://github.com/akkadotnet/akka.net/pull/5720)
+* [Akka: Fixed ActorSystemSetup.And forgetting registered types](https://github.com/akkadotnet/akka.net/issues/5728)
+* [Akka.Persistence.Query.Sql: Fixed Query PersistenceIds query bug](https://github.com/akkadotnet/akka.net/pull/5715)
+* [Akka.Streams: Add MapMaterializedValue for SourceWithContext and FlowWithContext](https://github.com/akkadotnet/akka.net/pull/5711)
+
+If you want to see the [full set of changes made in Akka.NET v1.4.35, click here](https://github.com/akkadotnet/akka.net/milestone/66?closed=1).
+
+| COMMITS | LOC+ | LOC- | AUTHOR              |
+|---------|------|------|---------------------|
+| 6       | 2178 | 174  | Aaron Stannard      |
+| 2       | 43   | 33   | Gregorius Soedharmo |
+| 1       | 71   | 19   | Ismael Hamed        |
+| 1       | 1    | 1    | dependabot[bot]     |
+
+#### 1.4.34 March 7 2022 ####
+Akka.NET v1.4.34 is a minor release that contains some bug fixes. Most of the changes have been aimed at improving our web documentation and code cleanup to modernize some of our code. 
+
+__Bug fixes__:
+* [Akka: Added support to pass a state object into CircuitBreaker to reduce allocations](https://github.com/akkadotnet/akka.net/pull/5650)
+* [Akka.DistributedData: ORSet merge operation performance improvement](https://github.com/akkadotnet/akka.net/pull/5686)
+* [Akka.Streams: FlowWithContext generic type parameters have been reordered to make them easier to read](https://github.com/akkadotnet/akka.net/pull/5648)
+
+__Improvements__:
+* [Akka: PipeTo can be configured to retain async threading context](https://github.com/akkadotnet/akka.net/pull/5684)
+
+If you want to see the [full set of changes made in Akka.NET v1.4.34, click here](https://github.com/akkadotnet/akka.net/milestone/65?closed=1).
+
+| COMMITS | LOC+   | LOC-  | AUTHOR              |
+|---------|--------|-------|---------------------|
+| 12      | 1177   | 718   | Ebere Abanonu       |
+| 6       | 192    | 47    | Gregorius Soedharmo |
+| 3       | 255    | 167   | Ismael Hamed        |
+| 1       | 3      | 0     | Aaron Stannard      |
+| 1       | 126    | 10    | Drew                |
 
 #### 1.4.33 February 14 2022 ####
 Akka.NET v1.4.33 is a minor release that contains some bug fixes. Most of the changes have been aimed at improving our web documentation and code cleanup to modernize some of our code. The most important bug fix is the actor Props memory leak when actors are cached inside Akka.Remote. 

diff --git a/build-system/pr-validation.yaml b/build-system/pr-validation.yaml
@@ -30,7 +30,7 @@ jobs:
       - task: Npm@1
         inputs:
           command: "custom"
-          customCommand: "install -g cspell"
+          customCommand: "install -g cspell@5.17.0"
       - task: CmdLine@2
         inputs:
           script: 'cspell --config ./docs/cSpell.json "docs/**/*.md"'
@@ -135,6 +135,17 @@ jobs:
 #      artifactName: "docfx_test-$(Build.BuildId)"
 #      run_if: eq(variables['Build.Reason'], 'PullRequest')
 
+  - template: azure-pipeline.template.yaml
+    parameters:
+      name: "docfx_test"
+      displayName: "DocFX warning check"
+      vmImage: "windows-2019"
+      scriptFileName: build.cmd
+      scriptArgs: docfx
+      outputDirectory: "TestResults"
+      artifactName: "docfx_test-$(Build.BuildId)"
+      run_if: eq(variables['Build.Reason'], 'PullRequest')
+
   - template: azure-pipeline.template.yaml
     parameters:
       name: "net_5_tests_windows"

diff --git a/docs/articles/actors/coordinated-shutdown.md b/docs/articles/actors/coordinated-shutdown.md
@@ -8,79 +8,7 @@ There's an `ActorSystem` extension called `CoordinatedShutdown` that will stop c
 
 The default phases and their orderings are defined in the default HOCON configuration as `akka.coordinated-shutdown.phases`, and they are defined below:
 
-```hocon
-phases {
-
-  # The first pre-defined phase that applications can add tasks to.
-  # Note that more phases can be be added in the application's
-  # configuration by overriding this phase with an additional 
-  # depends-on.
-  before-service-unbind {
-  }
-
-  # Stop accepting new incoming requests in for example HTTP.
-  service-unbind {
-    depends-on = [before-service-unbind]
-  }
-
-  # Wait for requests that are in progress to be completed.
-  service-requests-done {
-    depends-on = [service-unbind]
-  }
-
-  # Final shutdown of service endpoints.
-  service-stop {
-    depends-on = [service-requests-done]
-  }
-
-  # Phase for custom application tasks that are to be run
-  # after service shutdown and before cluster shutdown.
-  before-cluster-shutdown {
-    depends-on = [service-stop]
-  }
-
-  # Graceful shutdown of the Cluster Sharding regions.
-  cluster-sharding-shutdown-region {
-    timeout = 10 s
-    depends-on = [before-cluster-shutdown]
-  }
-
-  # Emit the leave command for the node that is shutting down.
-  cluster-leave {
-    depends-on = [cluster-sharding-shutdown-region]
-  }
-
-  # Shutdown cluster singletons
-  cluster-exiting {
-    timeout = 10 s
-    depends-on = [cluster-leave]
-  }
-
-  # Wait until exiting has been completed
-  cluster-exiting-done {
-    depends-on = [cluster-exiting]
-  }
-
-  # Shutdown the cluster extension
-  cluster-shutdown {
-    depends-on = [cluster-exiting-done]
-  }
-
-  # Phase for custom application tasks that are to be run
-  # after cluster shutdown and before ActorSystem termination.
-  before-actor-system-terminate {
-    depends-on = [cluster-shutdown]
-  }
-
-  # Last phase. See terminate-actor-system and exit-jvm above.
-  # Don't add phases that depends on this phase because the 
-  # dispatcher and scheduler of the ActorSystem have been shutdown. 
-  actor-system-terminate {
-    timeout = 10 s
-    depends-on = [before-actor-system-terminate]
-  }
-}
-```
+[!code-hocon[Pigeon.conf](../../../src/core/Akka/Configuration/Pigeon.conf#L1019-L1091)]
 
 ## Custom Phases
 

diff --git a/docs/articles/actors/di-core.md b/docs/articles/actors/di-core.md
@@ -6,7 +6,7 @@ title: DI Core
 # Akka.DI.Core
 
 > [!WARNING]
-> As of [Akka.NET v1.4.15](https://github.com/akkadotnet/akka.net/releases/tag/1.4.15), Akka.DI.Core and all of the libraries that implement it are deprecated. Going forward Akka.NET users are encouraged to use the [Akka.DependencyInjection library](xref:dependency-injection) instead, which uses the Microsoft.Extensions.DependencyInjection interfaces to integration DI directly into your Akka.NET actors.
+> As of [Akka.NET v1.4.15](https://github.com/akkadotnet/akka.net/releases/tag/1.4.15), Akka.DI.Core and all of the libraries that implement it are deprecated. Going forward Akka.NET users are encouraged to use the [Akka.DependencyInjection library](xref:dependency-injection) instead, which uses the Microsoft.Extensions.DependencyInjection interfaces to integrate DI directly into your Akka.NET actors.
 
 **Actor Producer Extension** library is used to create a Dependency Injection Container for the [Akka.NET](https://github.com/akkadotnet/akka.net) framework.
 

diff --git a/docs/articles/actors/finite-state-machine.md b/docs/articles/actors/finite-state-machine.md
@@ -99,31 +99,15 @@ The `stateFunction` argument is a `delegate State<TState, TData> StateFunction(E
 
 Each `FSM` needs a starting point, which is declared using
 
-```csharp
-StartWith(state, data[, timeout])
-```
+[!code-csharp[Main](../../../src/core/Akka.Docs.Tests/Actors/FiniteStateMachine/ExampleFSMActor.cs?name=StartWith)]
 
 The optionally given timeout argument overrides any specification given for the desired initial state. If you want to cancel a default timeout, use `null`.
 
 ### Unhandled Events
 
 If a state doesn't handle a received event a warning is logged. If you want to do something else in this case you can specify that with `WhenUnhandled(stateFunction)`:
 
-```csharp
-WhenUnhandled(state =>
-{
-    if (state.FsmEvent is Queue x)
-    {
-        _log.Info("Received unhandled event: " + x);
-        return Stay();
-    }
-    else
-    {
-        _log.Warning("Received unknown event: " + state.FsmEvent);
-        return Goto(new Error());
-    }
-});
-```
+[!code-csharp[Main](../../../src/core/Akka.Docs.Tests/Actors/FiniteStateMachine/ExampleFSMActor.cs?name=UnhandledHandler)]
 
 Within this handler the state of the `FSM` may be queried using the stateName method.
 
@@ -163,23 +147,7 @@ OnTransition(handler)
 
 which associates actions with a transition instead of with a state and event. The handler is a delegate `void TransitionHandler(TState initialState, TState nextState)` function which takes a pair of states as input; no resulting state is needed as it is not possible to modify the transition in progress.
 
-```csharp
-OnTransition((initialState, nextState) =>
-{
-    if (initialState == State.Active && nextState == State.Idle)
-    {
-        SetTimer("timeout", new Tick(), TimeSpan.FromSeconds(1), repeat: true);
-    } 
-    else if (initialState == State.Active)
-    {
-        CancelTimer("timeout");
-    }
-    else if (nextState == State.Idle)
-    {
-        _log.Info("entering Idle from " + initialState);
-    }
-});
-```
+[!code-csharp[Main](../../../src/core/Akka.Docs.Tests/Actors/FiniteStateMachine/ExampleFSMActor.cs?name=TransitionHandler)]
 
 The handlers registered with this method are stacked, so you can intersperse `OnTransition` blocks with when blocks as suits your design. It should be noted, however, that all handlers will be invoked for each transition, not only the first matching one. This is designed specifically so you can put all transition handling for a certain aspect into one place without having to worry about earlier declarations shadowing later ones; the actions are still executed in declaration order, though.
 

diff --git a/docs/articles/networking/io.md → docs/articles/actors/io.md b/docs/articles/networking/io.md → docs/articles/actors/io.md
diff --git a/docs/articles/actors/toc.yml b/docs/articles/actors/toc.yml
@@ -0,0 +1,29 @@
+- name: ReceiveActor API
+  href: receive-actor-api.md
+- name: UntypedActor API
+  href: untyped-actor-api.md
+- name: Routers
+  href: routers.md
+- name: Dispatchers
+  href: dispatchers.md
+- name: Mailboxes
+  href: mailboxes.md
+- name: Scheduling Future and Recurring Messages
+  href: schedulers.md
+- name: Akka.IO
+  href: io.md
+- name: Inbox
+  href: inbox.md
+- name: Finite State Machines
+  href: finite-state-machine.md
+- name: Fault Tolerance
+  href: fault-tolerance.md
+- name: Dependency Injection
+  href: dependency-injection.md
+- name: Dependency Injection Core
+  href: di-core.md
+- name: Testing Actor Systems
+  href: testing-actor-systems.md
+- name: Coordinated Shutdown
+  href: coordinated-shutdown.md
+
diff --git a/docs/articles/clustering/cluster-overview.md b/docs/articles/clustering/cluster-overview.md
@@ -11,7 +11,7 @@ A cluster represents a fault-tolerant, elastic, decentralized peer-to-peer netwo
 
 ## What Does Akka.Cluster Do?
 
-The best way to begin introducing Akka.Cluster is with brief overview of what it does. Akka.Cluster is the [package](https://www.nuget.org/packages/Akka.Cluster/1.0.3.11-beta) that brings clustering support to Akka.NET, and it accomplishes this by adding the following capabilities to Akka.NET:
+The best way to begin introducing Akka.Cluster is with brief overview of what it does. Akka.Cluster is the [package](https://www.nuget.org/packages/Akka.Cluster/) that brings clustering support to Akka.NET, and it accomplishes this by adding the following capabilities to Akka.NET:
 
 * Makes it easy to create peer-to-peer networks of Akka.NET applications
 * Allows peers to automatically discover new nodes and removed dead ones automatically with no configuration changes
@@ -236,6 +236,7 @@ A node might also exit the cluster gracefully, preventing it from being marked a
 <iframe width="560" height="315" src="https://www.youtube.com/embed/mUTKvGyxbOA" frameborder="0" allowfullscreen></iframe>
 <!-- markdownlint-enable MD033 -->
 
+* [Cluster Member Roles](xref:member-roles)
 * [How to Create Scalable Clustered Akka.NET Apps Using Akka.Cluster](https://petabridge.com/blog/intro-to-akka-cluster/)
 * [Video: Introduction to Akka.Cluster](https://www.youtube.com/watch?v=mUTKvGyxbOA)
 * [Gossip Protocol](https://en.wikipedia.org/wiki/Gossip_protocol)