Dear hakkers,

We are excited to announce not only a new patch release of Akka 2.5 but also brand new akka.io website and documentation.

New documentation

One conclusion from the community survey 2016 was that the getting started experience of Akka must be improved. Therefore we have written completely new Getting Started and Quickstart guides.

A special thanks to Endre Varga who wrote most of the Getting Started guide.

You find the landing page for the documentation at https://akka.io/docs/

The documentation tooling has been changed to Paradox. The markdown syntax and the zero installation will make it easier for contributors to help out with improving the documentation. Such contributions are very welcome and you find instructions in CONTRIBUTING.md.

Akka 2.5.2

If you are using Cluster Sharding with “remembering entities” there is one important change that requires that you make a change to your code when updating to 2.5.2. To solve a critical issue #22289 that could result in duplicate entities when the extractShardId function is changed (e.g. between deployments) there is now a new message Shard.StartEntity(entityId) that the extractShardId must understand. See example in Scala or Java.

Some other notable improvements and bug fixes of Akka 2.5.2 are:

• Sharding entities not restarted after full cluster restart in ddata mode, #22868
• Bug in sharding snapshot deletion, #22916
• Report cause for Akka IO TCP CommandFailed, #22954
• BackoffSupervisor can reply to messages when child is stopped, #21213

The development branch of Akka Typed has been merged back to master and is included in Akka 2.5.2, see the blog post series starting with Akka Typed: Hello World in the new API. The APIs may still change but we are confident that most of it is now stable. We will continue the work by integrating with other parts of Akka, such as Streams, Persistence, and Cluster.

A total of 77 issues were closed since 2.5.1. The complete list of closed issues can be found on the 2.5.2 and 2.5.99-TYPED-M1 milestones on github.

Credits

For this release we had the help of 27 committers – thank you all very much!

commits  added  removed
     44   7021     4706 Patrik Nordwall
     29  20453    22586 Arnout Engelen
     18   2290     2122 Martynas Mickevičius
     10   3173     1547 Johan Andrén
      6    272      233 Konrad `ktoso` Malawski
      5    118       17 Richard Imaoka
      4    137       37 andrea
      3    862      426 Peter Vlugter
      2     37       11 Roland Kuhn
      2     26       21 Hawstein
      2     12       12 Philippus Baalman
      1    476        3 drewhk
      1     66       21 Johannes Rudolph
      1     22       22 stanislav
      1     28        9 Chris Martin
      1     18        5 Nafer Sanabria
      1      8        8 Age Mooij
      1      8        8 Lukas Phaf
      1      9        5 Zahari Dichev
      1      2        2 Masaru Nomura
      1      1        1 Bartosz Kowalik
      1      1        1 Sebastian Gavril
      1      1        1 Alena Varkockova
      1      1        1 André Laszlo
      1      1        0 Packt
      1      0        0 synox
      1      0        0 Dale Wijnand

Happy hakking!

– The Akka Team