From 54ef3138473daac8850f5418839936546f65fb16 Mon Sep 17 00:00:00 2001
From: Chong Shen Ng <chong.shen@flower.ai>
Date: Wed, 27 Nov 2024 12:33:12 +0000
Subject: [PATCH 001/104] refactor(examples) Update authentication example
 (#4589)

Co-authored-by: jafermarq <javier@flower.ai>
---
 examples/flower-authentication/README.md      | 33 +++++++------------
 examples/flower-authentication/pyproject.toml | 12 +++----
 2 files changed, 17 insertions(+), 28 deletions(-)

diff --git a/examples/flower-authentication/README.md b/examples/flower-authentication/README.md
index 4f312608503d..323362060c5a 100644
--- a/examples/flower-authentication/README.md
+++ b/examples/flower-authentication/README.md
@@ -10,7 +10,7 @@ framework: [torch, torchvision]
 > 🧪 = This example covers experimental features that might change in future versions of Flower.
 > Please consult the regular PyTorch examples ([quickstart](https://github.com/adap/flower/tree/main/examples/quickstart-pytorch), [advanced](https://github.com/adap/flower/tree/main/examples/advanced-pytorch)) to learn how to use Flower with PyTorch.
 
-The following steps describe how to start a long-running Flower server (SuperLink+SuperExec) and a long-running Flower clients (SuperNode) with authentication enabled. The task is to train a simple CNN for image classification using PyTorch.
+The following steps describe how to start a long-running Flower server (SuperLink) and a long-running Flower clients (SuperNode) with authentication enabled. The task is to train a simple CNN for image classification using PyTorch.
 
 ## Project Setup
 
@@ -65,13 +65,13 @@ The script also generates a CSV file that includes each of the generated (client
 ./generate.sh {your_number_of_clients}
 ```
 
-## Start the long-running Flower server-side (SuperLink+SuperExec)
+## Start the long-running Flower server (SuperLink)
 
-Starting long-running Flower server-side components (SuperLink+SuperExec) and enable authentication is very easy; all you need to do is type
+Starting long-running Flower server component (SuperLink) and enable authentication is very easy; all you need to do is type
 `--auth-list-public-keys` containing file path to the known `client_public_keys.csv`, `--auth-superlink-private-key`
 containing file path to the SuperLink's private key `server_credentials`, and `--auth-superlink-public-key` containing file path to the SuperLink's public key `server_credentials.pub`. Notice that you can only enable authentication with a secure TLS connection.
 
-Let's first launche the `SuperLink`:
+Let's first launch the `SuperLink`:
 
 ```bash
 flower-superlink \
@@ -83,20 +83,9 @@ flower-superlink \
     --auth-superlink-public-key keys/server_credentials.pub
 ```
 
-Then launch the `SuperExec`:
+At this point your server-side is idling. Next, let's connect two `SuperNode`s, and then we'll start a run.
 
-```bash
-flower-superexec \
-    --ssl-ca-certfile certificates/ca.crt \
-    --ssl-certfile certificates/server.pem \
-    --ssl-keyfile certificates/server.key \
-    --executor-config "root-certificates='certificates/ca.crt'" \
-    --executor flwr.superexec.deployment:executor
-```
-
-At this point your server-side is idling. First, let's connect two `SuperNodes`, and then we'll start a run.
-
-## Start the long-running Flower client-side (SuperNode)
+## Start the long-running Flower client (SuperNode)
 
 > \[!NOTE\]
 > Typically each `SuperNode` runs in a different entity/organization which has access to a dataset. In this example we are going to artificially create N dataset splits and saved them into a new directory called `datasets/`. Then, each `SuperNode` will be pointed to the dataset it should load via the `--node-config` argument. We provide a script that does the download, partition and saving of CIFAR-10.
@@ -110,10 +99,10 @@ In a new terminal window, start the first long-running Flower client (SuperNode)
 ```bash
 flower-supernode \
     --root-certificates certificates/ca.crt \
-    --superlink 127.0.0.1:9092 \
     --auth-supernode-private-key keys/client_credentials_1 \
     --auth-supernode-public-key keys/client_credentials_1.pub \
-    --node-config 'dataset-path="datasets/cifar10_part_1"'
+    --node-config 'dataset-path="datasets/cifar10_part_1"' \
+    --clientappio-api-address="0.0.0.0:9094"
 ```
 
 In yet another new terminal window, start the second long-running Flower client:
@@ -121,10 +110,10 @@ In yet another new terminal window, start the second long-running Flower client:
 ```bash
 flower-supernode \
     --root-certificates certificates/ca.crt \
-    --superlink 127.0.0.1:9092 \
     --auth-supernode-private-key keys/client_credentials_2 \
     --auth-supernode-public-key keys/client_credentials_2.pub \
-    --node-config 'dataset-path="datasets/cifar10_part_2"'
+    --node-config 'dataset-path="datasets/cifar10_part_2"' \
+    --clientappio-api-address="0.0.0.0:9095"
 ```
 
 If you generated more than 2 client credentials, you can add more clients by opening new terminal windows and running the command
@@ -142,7 +131,7 @@ above. Don't forget to specify the correct client private and public keys for ea
 
 ## Run the Flower App
 
-With both the long-running server-side (SuperLink+SuperExec) and two SuperNodes up and running, we can now start run. Note that the command below points to a federation named `my-federation`. Its entry point is defined in the `pyproject.toml`.
+With both the long-running server (SuperLink) and two SuperNodes up and running, we can now start the run. Note that the command below points to a federation named `my-federation`. Its entry point is defined in the `pyproject.toml`.
 
 ```bash
 flwr run . my-federation
diff --git a/examples/flower-authentication/pyproject.toml b/examples/flower-authentication/pyproject.toml
index 2dfaf616527f..963fb2af3564 100644
--- a/examples/flower-authentication/pyproject.toml
+++ b/examples/flower-authentication/pyproject.toml
@@ -8,10 +8,10 @@ version = "1.0.0"
 description = "Federated Learning with PyTorch and authenticated Flower "
 license = "Apache-2.0"
 dependencies = [
-    "flwr==1.12.0",
-    "flwr-datasets[vision]>=0.3.0",
-    "torch==2.2.1",
-    "torchvision==0.17.1",
+    "flwr>=1.13.1",
+    "flwr-datasets[vision]>=0.4.0",
+    "torch>=2.5.0,<3.0.0",
+    "torchvision>=0.20.1,<0.21.0",
 ]
 
 [tool.hatch.build.targets.wheel]
@@ -32,8 +32,8 @@ learning-rate = 0.1
 batch-size = 32
 
 [tool.flwr.federations]
-default = "superexec"
+default = "my-federation"
 
 [tool.flwr.federations.my-federation]
-address = "127.0.0.1:9093" # Address of the SuperExec
+address = "127.0.0.1:9093" # Address of the Exec API
 root-certificates = "certificates/ca.crt"

From a875480d13196d28437a51915822192077511c3e Mon Sep 17 00:00:00 2001
From: "github-actions[bot]"
 <41898282+github-actions[bot]@users.noreply.github.com>
Date: Thu, 28 Nov 2024 13:28:36 +0100
Subject: [PATCH 002/104] Update text and language files (#4596)

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
---
 doc/locales/fr/LC_MESSAGES/framework-docs.po  | 1708 +++++++++--------
 doc/locales/ko/LC_MESSAGES/framework-docs.po  | 1668 ++++++++--------
 .../pt_BR/LC_MESSAGES/framework-docs.po       | 1659 ++++++++--------
 .../zh_Hans/LC_MESSAGES/framework-docs.po     | 1706 ++++++++--------
 4 files changed, 3666 insertions(+), 3075 deletions(-)

diff --git a/doc/locales/fr/LC_MESSAGES/framework-docs.po b/doc/locales/fr/LC_MESSAGES/framework-docs.po
index 0895987d1d84..6b0a297dd720 100644
--- a/doc/locales/fr/LC_MESSAGES/framework-docs.po
+++ b/doc/locales/fr/LC_MESSAGES/framework-docs.po
@@ -3,7 +3,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Flower Docs\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2024-11-22 08:46+0000\n"
+"POT-Creation-Date: 2024-11-28 00:32+0000\n"
 "PO-Revision-Date: 2023-09-05 17:54+0000\n"
 "Last-Translator: Charles Beauville <charles@flower.ai>\n"
 "Language: fr\n"
@@ -3474,10 +3474,10 @@ msgstr "Démarrage rapide fastai"
 #: ../../source/docker/run-quickstart-examples-docker-compose.rst:119
 #: ../../source/docker/run-quickstart-examples-docker-compose.rst:121
 #: ../../source/docker/run-quickstart-examples-docker-compose.rst:125
-#: ../../source/ref-changelog.md:214 ../../source/ref-changelog.md:580
-#: ../../source/ref-changelog.md:857 ../../source/ref-changelog.md:921
-#: ../../source/ref-changelog.md:979 ../../source/ref-changelog.md:1048
-#: ../../source/ref-changelog.md:1110
+#: ../../source/ref-changelog.md:236 ../../source/ref-changelog.md:602
+#: ../../source/ref-changelog.md:879 ../../source/ref-changelog.md:943
+#: ../../source/ref-changelog.md:1001 ../../source/ref-changelog.md:1070
+#: ../../source/ref-changelog.md:1132
 msgid "None"
 msgstr "Aucun"
 
@@ -14836,7 +14836,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/ref-api/flwr.server.strategy.FedAdagrad.rst:2
-#: ../../source/ref-changelog.md:1412
+#: ../../source/ref-changelog.md:1434
 msgid "FedAdagrad"
 msgstr "FedAdagrad"
 
@@ -16650,78 +16650,186 @@ msgstr "Changelog"
 
 #: ../../source/ref-changelog.md:3
 #, fuzzy
-msgid "Unreleased"
-msgstr "Inédit"
+msgid "v1.13.1 (2024-11-26)"
+msgstr "v1.4.0 (2023-04-21)"
+
+#: ../../source/ref-changelog.md:5 ../../source/ref-changelog.md:37
+#: ../../source/ref-changelog.md:138 ../../source/ref-changelog.md:208
+#: ../../source/ref-changelog.md:240 ../../source/ref-changelog.md:344
+#: ../../source/ref-changelog.md:442 ../../source/ref-changelog.md:542
+#: ../../source/ref-changelog.md:606 ../../source/ref-changelog.md:699
+#: ../../source/ref-changelog.md:799 ../../source/ref-changelog.md:883
+#: ../../source/ref-changelog.md:947 ../../source/ref-changelog.md:1005
+#: ../../source/ref-changelog.md:1074 ../../source/ref-changelog.md:1143
+msgid "Thanks to our contributors"
+msgstr "Merci à nos contributeurs"
+
+#: ../../source/ref-changelog.md:7 ../../source/ref-changelog.md:39
+#: ../../source/ref-changelog.md:140 ../../source/ref-changelog.md:210
+#: ../../source/ref-changelog.md:242 ../../source/ref-changelog.md:346
+#: ../../source/ref-changelog.md:444 ../../source/ref-changelog.md:544
+#: ../../source/ref-changelog.md:608 ../../source/ref-changelog.md:701
+#: ../../source/ref-changelog.md:801 ../../source/ref-changelog.md:885
+#: ../../source/ref-changelog.md:949 ../../source/ref-changelog.md:1007
+msgid ""
+"We would like to give our special thanks to all the contributors who made"
+" the new version of Flower possible (in `git shortlog` order):"
+msgstr ""
+"Nous tenons à remercier tout particulièrement tous les contributeurs qui "
+"ont rendu possible la nouvelle version de Flower (dans l'ordre `git "
+"shortlog`) :"
+
+#: ../../source/ref-changelog.md:9
+msgid ""
+"`Adam Narozniak`, `Charles Beauville`, `Heng Pan`, `Javier`, `Robert "
+"Steiner` <!---TOKEN_v1.13.1-->"
+msgstr ""
 
-#: ../../source/ref-changelog.md:5 ../../source/ref-changelog.md:21
-#: ../../source/ref-changelog.md:122 ../../source/ref-changelog.md:224
-#: ../../source/ref-changelog.md:328 ../../source/ref-changelog.md:426
-#: ../../source/ref-changelog.md:526 ../../source/ref-changelog.md:590
-#: ../../source/ref-changelog.md:683 ../../source/ref-changelog.md:783
-#: ../../source/ref-changelog.md:867 ../../source/ref-changelog.md:931
-#: ../../source/ref-changelog.md:989 ../../source/ref-changelog.md:1058
-#: ../../source/ref-changelog.md:1187 ../../source/ref-changelog.md:1229
-#: ../../source/ref-changelog.md:1296 ../../source/ref-changelog.md:1362
-#: ../../source/ref-changelog.md:1407 ../../source/ref-changelog.md:1446
-#: ../../source/ref-changelog.md:1479 ../../source/ref-changelog.md:1529
+#: ../../source/ref-changelog.md:11 ../../source/ref-changelog.md:43
+#: ../../source/ref-changelog.md:144 ../../source/ref-changelog.md:246
+#: ../../source/ref-changelog.md:350 ../../source/ref-changelog.md:448
+#: ../../source/ref-changelog.md:548 ../../source/ref-changelog.md:612
+#: ../../source/ref-changelog.md:705 ../../source/ref-changelog.md:805
+#: ../../source/ref-changelog.md:889 ../../source/ref-changelog.md:953
+#: ../../source/ref-changelog.md:1011 ../../source/ref-changelog.md:1080
+#: ../../source/ref-changelog.md:1209 ../../source/ref-changelog.md:1251
+#: ../../source/ref-changelog.md:1318 ../../source/ref-changelog.md:1384
+#: ../../source/ref-changelog.md:1429 ../../source/ref-changelog.md:1468
+#: ../../source/ref-changelog.md:1501 ../../source/ref-changelog.md:1551
 msgid "What's new?"
 msgstr "Quoi de neuf ?"
 
-#: ../../source/ref-changelog.md:7
+#: ../../source/ref-changelog.md:13
 #, fuzzy
-msgid "Other changes"
-msgstr "Changements incompatibles"
+msgid ""
+"**Fix `SimulationEngine` Executor for SuperLink** "
+"([#4563](https://github.com/adap/flower/pull/4563), "
+"[#4568](https://github.com/adap/flower/pull/4568), "
+"[#4570](https://github.com/adap/flower/pull/4570))"
+msgstr ""
+"**Mettre à jour les exemples de code** "
+"([#1291](https://github.com/adap/flower/pull/1291), "
+"[#1286](https://github.com/adap/flower/pull/1286), "
+"[#1282](https://github.com/adap/flower/pull/1282))"
 
-#: ../../source/ref-changelog.md:9 ../../source/ref-changelog.md:388
+#: ../../source/ref-changelog.md:15
+msgid ""
+"Resolved an issue that prevented SuperLink from functioning correctly "
+"when using the `SimulationEngine` executor."
+msgstr ""
+
+#: ../../source/ref-changelog.md:17
 #, fuzzy
-msgid "Documentation improvements"
-msgstr "Améliorations facultatives"
+msgid ""
+"**Improve FAB build and install** "
+"([#4571](https://github.com/adap/flower/pull/4571))"
+msgstr ""
+"**Nouvelle stratégie de FedMedian** "
+"([#1461](https://github.com/adap/flower/pull/1461))"
 
-#: ../../source/ref-changelog.md:11 ../../source/ref-changelog.md:88
-#: ../../source/ref-changelog.md:178 ../../source/ref-changelog.md:212
-#: ../../source/ref-changelog.md:292 ../../source/ref-changelog.md:408
-#: ../../source/ref-changelog.md:504 ../../source/ref-changelog.md:578
-#: ../../source/ref-changelog.md:653 ../../source/ref-changelog.md:765
-#: ../../source/ref-changelog.md:855 ../../source/ref-changelog.md:919
-#: ../../source/ref-changelog.md:977 ../../source/ref-changelog.md:1046
-#: ../../source/ref-changelog.md:1108 ../../source/ref-changelog.md:1127
-#: ../../source/ref-changelog.md:1283 ../../source/ref-changelog.md:1354
-#: ../../source/ref-changelog.md:1391 ../../source/ref-changelog.md:1434
-msgid "Incompatible changes"
-msgstr "Changements incompatibles"
+#: ../../source/ref-changelog.md:19
+msgid ""
+"An updated FAB build and install process produces smaller FAB files and "
+"doesn't rely on `pip install` any more. It also resolves an issue where "
+"all files were unnecessarily included in the FAB file. The `flwr` CLI "
+"commands now correctly pack only the necessary files, such as `.md`, "
+"`.toml` and `.py`, ensuring more efficient and accurate packaging."
+msgstr ""
 
-#: ../../source/ref-changelog.md:13
+#: ../../source/ref-changelog.md:21
 #, fuzzy
-msgid "v1.13.0 (2024-11-20)"
-msgstr "v1.4.0 (2023-04-21)"
+msgid ""
+"**Update** `embedded-devices` **example** "
+"([#4381](https://github.com/adap/flower/pull/4381))"
+msgstr ""
+"**Ajouter une nouvelle stratégie `FedProx`** "
+"([#1619](https://github.com/adap/flower/pull/1619))"
 
-#: ../../source/ref-changelog.md:15 ../../source/ref-changelog.md:116
-#: ../../source/ref-changelog.md:186 ../../source/ref-changelog.md:218
-#: ../../source/ref-changelog.md:322 ../../source/ref-changelog.md:420
-#: ../../source/ref-changelog.md:520 ../../source/ref-changelog.md:584
-#: ../../source/ref-changelog.md:677 ../../source/ref-changelog.md:777
-#: ../../source/ref-changelog.md:861 ../../source/ref-changelog.md:925
-#: ../../source/ref-changelog.md:983 ../../source/ref-changelog.md:1052
-#: ../../source/ref-changelog.md:1121
-msgid "Thanks to our contributors"
-msgstr "Merci à nos contributeurs"
+#: ../../source/ref-changelog.md:23
+msgid "The example now uses the `flwr run` command and the Deployment Engine."
+msgstr ""
 
-#: ../../source/ref-changelog.md:17 ../../source/ref-changelog.md:118
-#: ../../source/ref-changelog.md:188 ../../source/ref-changelog.md:220
-#: ../../source/ref-changelog.md:324 ../../source/ref-changelog.md:422
-#: ../../source/ref-changelog.md:522 ../../source/ref-changelog.md:586
-#: ../../source/ref-changelog.md:679 ../../source/ref-changelog.md:779
-#: ../../source/ref-changelog.md:863 ../../source/ref-changelog.md:927
-#: ../../source/ref-changelog.md:985
+#: ../../source/ref-changelog.md:25
+#, fuzzy
 msgid ""
-"We would like to give our special thanks to all the contributors who made"
-" the new version of Flower possible (in `git shortlog` order):"
+"**Update Documentation** "
+"([#4566](https://github.com/adap/flower/pull/4566), "
+"[#4569](https://github.com/adap/flower/pull/4569), "
+"[#4560](https://github.com/adap/flower/pull/4560), "
+"[#4556](https://github.com/adap/flower/pull/4556), "
+"[#4581](https://github.com/adap/flower/pull/4581), "
+"[#4537](https://github.com/adap/flower/pull/4537), "
+"[#4562](https://github.com/adap/flower/pull/4562), "
+"[#4582](https://github.com/adap/flower/pull/4582))"
 msgstr ""
-"Nous tenons à remercier tout particulièrement tous les contributeurs qui "
-"ont rendu possible la nouvelle version de Flower (dans l'ordre `git "
-"shortlog`) :"
+"**Tutoriel amélioré** ([#1468](https://github.com/adap/flower/pull/1468),"
+" [#1470](https://github.com/adap/flower/pull/1470), "
+"[#1472](https://github.com/adap/flower/pull/1472), "
+"[#1473](https://github.com/adap/flower/pull/1473), "
+"[#1474](https://github.com/adap/flower/pull/1474), "
+"[#1475](https://github.com/adap/flower/pull/1475))"
 
-#: ../../source/ref-changelog.md:19
+#: ../../source/ref-changelog.md:27
+msgid ""
+"Enhanced documentation across various aspects, including updates to "
+"translation workflows, Docker-related READMEs, and recommended datasets. "
+"Improvements also include formatting fixes for dataset partitioning docs "
+"and better references to resources in the datasets documentation index."
+msgstr ""
+
+#: ../../source/ref-changelog.md:29
+#, fuzzy
+msgid ""
+"**Update Infrastructure and CI/CD** "
+"([#4577](https://github.com/adap/flower/pull/4577), "
+"[#4578](https://github.com/adap/flower/pull/4578), "
+"[#4558](https://github.com/adap/flower/pull/4558), "
+"[#4551](https://github.com/adap/flower/pull/4551), "
+"[#3356](https://github.com/adap/flower/pull/3356), "
+"[#4559](https://github.com/adap/flower/pull/4559), "
+"[#4575](https://github.com/adap/flower/pull/4575))"
+msgstr ""
+"**Tutoriel amélioré** ([#1468](https://github.com/adap/flower/pull/1468),"
+" [#1470](https://github.com/adap/flower/pull/1470), "
+"[#1472](https://github.com/adap/flower/pull/1472), "
+"[#1473](https://github.com/adap/flower/pull/1473), "
+"[#1474](https://github.com/adap/flower/pull/1474), "
+"[#1475](https://github.com/adap/flower/pull/1475))"
+
+#: ../../source/ref-changelog.md:31
+#, fuzzy
+msgid ""
+"**General improvements** "
+"([#4557](https://github.com/adap/flower/pull/4557), "
+"[#4564](https://github.com/adap/flower/pull/4564), "
+"[#4573](https://github.com/adap/flower/pull/4573), "
+"[#4561](https://github.com/adap/flower/pull/4561), "
+"[#4579](https://github.com/adap/flower/pull/4579), "
+"[#4572](https://github.com/adap/flower/pull/4572))"
+msgstr ""
+"**Mise à jour de la documentation** "
+"([#1629](https://github.com/adap/flower/pull/1629), "
+"[#1628](https://github.com/adap/flower/pull/1628), "
+"[#1620](https://github.com/adap/flower/pull/1620), "
+"[#1618](https://github.com/adap/flower/pull/1618), "
+"[#1617](https://github.com/adap/flower/pull/1617), "
+"[#1613](https://github.com/adap/flower/pull/1613), "
+"[#1614](https://github.com/adap/flower/pull/1614))"
+
+#: ../../source/ref-changelog.md:33 ../../source/ref-changelog.md:102
+#: ../../source/ref-changelog.md:198 ../../source/ref-changelog.md:301
+#: ../../source/ref-changelog.md:408
+msgid ""
+"As always, many parts of the Flower framework and quality infrastructure "
+"were improved and updated."
+msgstr ""
+
+#: ../../source/ref-changelog.md:35
+#, fuzzy
+msgid "v1.13.0 (2024-11-20)"
+msgstr "v1.4.0 (2023-04-21)"
+
+#: ../../source/ref-changelog.md:41
 msgid ""
 "`Adam Narozniak`, `Charles Beauville`, `Chong Shen Ng`, `Daniel J. "
 "Beutel`, `Daniel Nata Nugraha`, `Dimitris Stripelis`, `Heng Pan`, "
@@ -16729,7 +16837,7 @@ msgid ""
 "Lindskog`, `Yan Gao`, `Yao Xu`, `wwjang` <!---TOKEN_v1.13.0-->"
 msgstr ""
 
-#: ../../source/ref-changelog.md:23
+#: ../../source/ref-changelog.md:45
 #, fuzzy
 msgid ""
 "**Introduce `flwr ls` command** "
@@ -16742,30 +16850,30 @@ msgstr ""
 "[#1544](https://github.com/adap/flower/pull/1544), "
 "[#1584](https://github.com/adap/flower/pull/1584))"
 
-#: ../../source/ref-changelog.md:25
+#: ../../source/ref-changelog.md:47
 msgid ""
 "The `flwr ls` command is now available to display details about all runs "
 "(or one specific run). It supports the following usage options:"
 msgstr ""
 
-#: ../../source/ref-changelog.md:27
+#: ../../source/ref-changelog.md:49
 msgid "`flwr ls --runs [<app>] [<federation>]`: Lists all runs."
 msgstr ""
 
-#: ../../source/ref-changelog.md:28
+#: ../../source/ref-changelog.md:50
 msgid ""
 "`flwr ls --run-id <run-id> [<app>] [<federation>]`: Displays details for "
 "a specific run."
 msgstr ""
 
-#: ../../source/ref-changelog.md:30
+#: ../../source/ref-changelog.md:52
 msgid ""
 "This command provides information including the run ID, FAB ID and "
 "version, run status, elapsed time, and timestamps for when the run was "
 "created, started running, and finished."
 msgstr ""
 
-#: ../../source/ref-changelog.md:32
+#: ../../source/ref-changelog.md:54
 #, fuzzy
 msgid ""
 "**Fuse SuperLink and SuperExec** "
@@ -16785,7 +16893,7 @@ msgstr ""
 "[#1065](https://github.com/adap/flower/pull/1065), "
 "[#1090](https://github.com/adap/flower/pull/1090))"
 
-#: ../../source/ref-changelog.md:34
+#: ../../source/ref-changelog.md:56
 msgid ""
 "SuperExec has been integrated into SuperLink, enabling SuperLink to "
 "directly manage ServerApp processes (`flwr-serverapp`). The `flwr` CLI "
@@ -16795,7 +16903,7 @@ msgid ""
 "{subprocess,process}` flag."
 msgstr ""
 
-#: ../../source/ref-changelog.md:36
+#: ../../source/ref-changelog.md:58
 #, fuzzy
 msgid ""
 "**Introduce `flwr-serverapp` command** "
@@ -16817,7 +16925,7 @@ msgstr ""
 "[#1474](https://github.com/adap/flower/pull/1474), "
 "[#1475](https://github.com/adap/flower/pull/1475))"
 
-#: ../../source/ref-changelog.md:38
+#: ../../source/ref-changelog.md:60
 msgid ""
 "The `flwr-serverapp` command has been introduced as a CLI entry point "
 "that runs a `ServerApp` process. This process communicates with SuperLink"
@@ -16825,7 +16933,7 @@ msgid ""
 "and more flexible deployment."
 msgstr ""
 
-#: ../../source/ref-changelog.md:40
+#: ../../source/ref-changelog.md:62
 #, fuzzy
 msgid ""
 "**Improve simulation engine and introduce `flwr-simulation` command** "
@@ -16844,7 +16952,7 @@ msgstr ""
 "[#1065](https://github.com/adap/flower/pull/1065), "
 "[#1090](https://github.com/adap/flower/pull/1090))"
 
-#: ../../source/ref-changelog.md:42
+#: ../../source/ref-changelog.md:64
 msgid ""
 "The simulation engine has been significantly improved, resulting in "
 "dramatically faster simulations. Additionally, the `flwr-simulation` "
@@ -16852,7 +16960,7 @@ msgid ""
 "dedicated entry point for running simulations."
 msgstr ""
 
-#: ../../source/ref-changelog.md:44
+#: ../../source/ref-changelog.md:66
 #, fuzzy
 msgid ""
 "**Improve SuperLink message management** "
@@ -16863,7 +16971,7 @@ msgstr ""
 "([#1344](https://github.com/adap/flower/pull/1344), "
 "[#1347](https://github.com/adap/flower/pull/1347))"
 
-#: ../../source/ref-changelog.md:46
+#: ../../source/ref-changelog.md:68
 msgid ""
 "SuperLink now validates the destination node ID of instruction messages "
 "and checks the TTL (time-to-live) for reply messages. When pulling reply "
@@ -16872,7 +16980,7 @@ msgid ""
 "reply message exists but has expired."
 msgstr ""
 
-#: ../../source/ref-changelog.md:48
+#: ../../source/ref-changelog.md:70
 #, fuzzy
 msgid ""
 "**Introduce FedDebug baseline** "
@@ -16881,7 +16989,7 @@ msgstr ""
 "**Ajouter une nouvelle stratégie `FedProx`** "
 "([#1619](https://github.com/adap/flower/pull/1619))"
 
-#: ../../source/ref-changelog.md:50
+#: ../../source/ref-changelog.md:72
 msgid ""
 "FedDebug is a framework that enhances debugging in Federated Learning by "
 "enabling interactive inspection of the training process and automatically"
@@ -16891,7 +16999,7 @@ msgid ""
 "documentation](https://flower.ai/docs/baselines/feddebug.html)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:52
+#: ../../source/ref-changelog.md:74
 msgid ""
 "**Update documentation** "
 "([#4511](https://github.com/adap/flower/pull/4511), "
@@ -16936,7 +17044,7 @@ msgid ""
 "[#4533](https://github.com/adap/flower/pull/4533))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:54
+#: ../../source/ref-changelog.md:76
 msgid ""
 "Many documentation pages and tutorials have been updated to improve "
 "clarity, fix typos, incorporate user feedback, and stay aligned with the "
@@ -16950,7 +17058,7 @@ msgid ""
 "aggregation-protocols.html) page has also been updated."
 msgstr ""
 
-#: ../../source/ref-changelog.md:56
+#: ../../source/ref-changelog.md:78
 #, fuzzy
 msgid ""
 "**Update examples and templates** "
@@ -16973,7 +17081,7 @@ msgstr ""
 "[#1770](https://github.com/adap/flower/pull/1770), "
 "[#1733](https://github.com/adap/flower/pull/1733))"
 
-#: ../../source/ref-changelog.md:58
+#: ../../source/ref-changelog.md:80
 msgid ""
 "Multiple examples and templates have been updated to enhance usability "
 "and correctness. The updates include the `30-minute-tutorial`, "
@@ -16981,7 +17089,7 @@ msgid ""
 "and the FlowerTune template."
 msgstr ""
 
-#: ../../source/ref-changelog.md:60
+#: ../../source/ref-changelog.md:82
 #, fuzzy
 msgid ""
 "**Improve Docker support** "
@@ -17006,7 +17114,7 @@ msgstr ""
 "[#1613](https://github.com/adap/flower/pull/1613), "
 "[#1614](https://github.com/adap/flower/pull/1614))"
 
-#: ../../source/ref-changelog.md:62
+#: ../../source/ref-changelog.md:84
 msgid ""
 "Docker images and configurations have been updated, including updating "
 "Docker Compose files to version 1.13.0, refactoring the Docker build "
@@ -17014,7 +17122,7 @@ msgid ""
 " 6.9.0, and improving Docker documentation."
 msgstr ""
 
-#: ../../source/ref-changelog.md:64
+#: ../../source/ref-changelog.md:86
 #, fuzzy
 msgid ""
 "**Allow app installation without internet access** "
@@ -17025,14 +17133,14 @@ msgstr ""
 "([#1344](https://github.com/adap/flower/pull/1344), "
 "[#1347](https://github.com/adap/flower/pull/1347))"
 
-#: ../../source/ref-changelog.md:66
+#: ../../source/ref-changelog.md:88
 msgid ""
 "The `flwr build` command now includes a wheel file in the FAB, enabling "
 "Flower app installation in environments without internet access via `flwr"
 " install`."
 msgstr ""
 
-#: ../../source/ref-changelog.md:68
+#: ../../source/ref-changelog.md:90
 #, fuzzy
 msgid ""
 "**Improve `flwr log` command** "
@@ -17047,7 +17155,7 @@ msgstr ""
 "[#1301](https://github.com/adap/flower/pull/1301), "
 "[#1310](https://github.com/adap/flower/pull/1310))"
 
-#: ../../source/ref-changelog.md:70
+#: ../../source/ref-changelog.md:92
 #, fuzzy
 msgid ""
 "**Refactor SuperNode for better maintainability and efficiency** "
@@ -17062,7 +17170,7 @@ msgstr ""
 "[#1301](https://github.com/adap/flower/pull/1301), "
 "[#1310](https://github.com/adap/flower/pull/1310))"
 
-#: ../../source/ref-changelog.md:72
+#: ../../source/ref-changelog.md:94
 #, fuzzy
 msgid ""
 "**Support NumPy `2.0`** "
@@ -17071,7 +17179,7 @@ msgstr ""
 "**Support Python 3.10** "
 "([#1320](https://github.com/adap/flower/pull/1320))"
 
-#: ../../source/ref-changelog.md:74
+#: ../../source/ref-changelog.md:96
 #, fuzzy
 msgid ""
 "**Update infrastructure and CI/CD** "
@@ -17092,7 +17200,7 @@ msgstr ""
 "[#1613](https://github.com/adap/flower/pull/1613), "
 "[#1614](https://github.com/adap/flower/pull/1614))"
 
-#: ../../source/ref-changelog.md:76
+#: ../../source/ref-changelog.md:98
 #, fuzzy
 msgid ""
 "**Bugfixes** ([#4404](https://github.com/adap/flower/pull/4404), "
@@ -17115,7 +17223,7 @@ msgstr ""
 "[#1613](https://github.com/adap/flower/pull/1613), "
 "[#1614](https://github.com/adap/flower/pull/1614))"
 
-#: ../../source/ref-changelog.md:78
+#: ../../source/ref-changelog.md:100
 msgid ""
 "**General improvements** "
 "([#4454](https://github.com/adap/flower/pull/4454), "
@@ -17171,25 +17279,18 @@ msgid ""
 "[#4481](https://github.com/adap/flower/pull/4481))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:80 ../../source/ref-changelog.md:176
-#: ../../source/ref-changelog.md:279 ../../source/ref-changelog.md:386
-msgid ""
-"As always, many parts of the Flower framework and quality infrastructure "
-"were improved and updated."
-msgstr ""
-
-#: ../../source/ref-changelog.md:82 ../../source/ref-changelog.md:281
-#: ../../source/ref-changelog.md:398 ../../source/ref-changelog.md:490
-#: ../../source/ref-changelog.md:1473
+#: ../../source/ref-changelog.md:104 ../../source/ref-changelog.md:303
+#: ../../source/ref-changelog.md:420 ../../source/ref-changelog.md:512
+#: ../../source/ref-changelog.md:1495
 msgid "Deprecations"
 msgstr "Dépréciations"
 
-#: ../../source/ref-changelog.md:84
+#: ../../source/ref-changelog.md:106
 #, fuzzy
 msgid "**Deprecate Python 3.9**"
 msgstr "**Créer le PR**"
 
-#: ../../source/ref-changelog.md:86
+#: ../../source/ref-changelog.md:108
 msgid ""
 "Flower is deprecating support for Python 3.9 as several of its "
 "dependencies are phasing out compatibility with this version. While no "
@@ -17197,7 +17298,20 @@ msgid ""
 "upgrading to a supported Python version."
 msgstr ""
 
-#: ../../source/ref-changelog.md:90
+#: ../../source/ref-changelog.md:110 ../../source/ref-changelog.md:200
+#: ../../source/ref-changelog.md:234 ../../source/ref-changelog.md:314
+#: ../../source/ref-changelog.md:430 ../../source/ref-changelog.md:526
+#: ../../source/ref-changelog.md:600 ../../source/ref-changelog.md:675
+#: ../../source/ref-changelog.md:787 ../../source/ref-changelog.md:877
+#: ../../source/ref-changelog.md:941 ../../source/ref-changelog.md:999
+#: ../../source/ref-changelog.md:1068 ../../source/ref-changelog.md:1130
+#: ../../source/ref-changelog.md:1149 ../../source/ref-changelog.md:1305
+#: ../../source/ref-changelog.md:1376 ../../source/ref-changelog.md:1413
+#: ../../source/ref-changelog.md:1456
+msgid "Incompatible changes"
+msgstr "Changements incompatibles"
+
+#: ../../source/ref-changelog.md:112
 #, fuzzy
 msgid ""
 "**Remove `flower-superexec` command** "
@@ -17206,7 +17320,7 @@ msgstr ""
 "**Supprimez KerasClient** "
 "([#857](https://github.com/adap/flower/pull/857))"
 
-#: ../../source/ref-changelog.md:92
+#: ../../source/ref-changelog.md:114
 msgid ""
 "The `flower-superexec` command, previously used to launch SuperExec, is "
 "no longer functional as SuperExec has been merged into SuperLink. "
@@ -17214,7 +17328,7 @@ msgid ""
 " initiated."
 msgstr ""
 
-#: ../../source/ref-changelog.md:94
+#: ../../source/ref-changelog.md:116
 #, fuzzy
 msgid ""
 "**Remove `flower-server-app` command** "
@@ -17223,13 +17337,13 @@ msgstr ""
 "**Supprimez KerasClient** "
 "([#857](https://github.com/adap/flower/pull/857))"
 
-#: ../../source/ref-changelog.md:96
+#: ../../source/ref-changelog.md:118
 msgid ""
 "The `flower-server-app` command has been removed. To start a Flower app, "
 "please use the `flwr run` command instead."
 msgstr ""
 
-#: ../../source/ref-changelog.md:98
+#: ../../source/ref-changelog.md:120
 #, fuzzy
 msgid ""
 "**Remove `app` argument from `flower-supernode` command** "
@@ -17238,14 +17352,14 @@ msgstr ""
 "**Supprimez KerasClient** "
 "([#857](https://github.com/adap/flower/pull/857))"
 
-#: ../../source/ref-changelog.md:100
+#: ../../source/ref-changelog.md:122
 msgid ""
 "The usage of `flower-supernode <app-dir>` has been removed. SuperNode "
 "will now load the FAB delivered by SuperLink, and it is no longer "
 "possible to directly specify an app directory."
 msgstr ""
 
-#: ../../source/ref-changelog.md:102
+#: ../../source/ref-changelog.md:124
 #, fuzzy
 msgid ""
 "**Remove support for non-app simulations** "
@@ -17254,13 +17368,13 @@ msgstr ""
 "**Améliorer la prise en charge des GPU dans les simulations** "
 "([#1555](https://github.com/adap/flower/pull/1555))"
 
-#: ../../source/ref-changelog.md:104
+#: ../../source/ref-changelog.md:126
 msgid ""
 "The simulation engine (via `flower-simulation`) now exclusively supports "
 "passing an app."
 msgstr ""
 
-#: ../../source/ref-changelog.md:106
+#: ../../source/ref-changelog.md:128
 #, fuzzy
 msgid ""
 "**Rename CLI arguments for `flower-superlink` command** "
@@ -17269,14 +17383,14 @@ msgstr ""
 "**Supprimez KerasClient** "
 "([#857](https://github.com/adap/flower/pull/857))"
 
-#: ../../source/ref-changelog.md:108
+#: ../../source/ref-changelog.md:130
 msgid ""
 "The `--driver-api-address` argument has been renamed to `--serverappio-"
 "api-address` in the `flower-superlink` command to reflect the renaming of"
 " the `Driver` service to the `ServerAppIo` service."
 msgstr ""
 
-#: ../../source/ref-changelog.md:110
+#: ../../source/ref-changelog.md:132
 #, fuzzy
 msgid ""
 "**Rename CLI arguments for `flwr-serverapp` and `flwr-clientapp` "
@@ -17285,7 +17399,7 @@ msgstr ""
 "**Supprimez KerasClient** "
 "([#857](https://github.com/adap/flower/pull/857))"
 
-#: ../../source/ref-changelog.md:112
+#: ../../source/ref-changelog.md:134
 msgid ""
 "The CLI arguments have been renamed for clarity and consistency. "
 "Specifically, `--superlink` for `flwr-serverapp` is now `--serverappio-"
@@ -17293,12 +17407,12 @@ msgid ""
 "`--clientappio-api-address`."
 msgstr ""
 
-#: ../../source/ref-changelog.md:114
+#: ../../source/ref-changelog.md:136
 #, fuzzy
 msgid "v1.12.0 (2024-10-14)"
 msgstr "v1.1.0 (2022-10-31)"
 
-#: ../../source/ref-changelog.md:120
+#: ../../source/ref-changelog.md:142
 msgid ""
 "`Adam Narozniak`, `Audris`, `Charles Beauville`, `Chong Shen Ng`, `Daniel"
 " J. Beutel`, `Daniel Nata Nugraha`, `Heng Pan`, `Javier`, `Jiahao Tan`, "
@@ -17306,7 +17420,7 @@ msgid ""
 "Gao`, `xiliguguagua` <!---TOKEN_v1.12.0-->"
 msgstr ""
 
-#: ../../source/ref-changelog.md:124
+#: ../../source/ref-changelog.md:146
 #, fuzzy
 msgid ""
 "**Introduce SuperExec log streaming** "
@@ -17322,7 +17436,7 @@ msgstr ""
 "[#1065](https://github.com/adap/flower/pull/1065), "
 "[#1090](https://github.com/adap/flower/pull/1090))"
 
-#: ../../source/ref-changelog.md:126
+#: ../../source/ref-changelog.md:148
 msgid ""
 "Flower now supports log streaming from a remote SuperExec using the `flwr"
 " log` command. This new feature allows you to monitor logs from SuperExec"
@@ -17330,7 +17444,7 @@ msgid ""
 "<federation>`)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:128
+#: ../../source/ref-changelog.md:150
 #, fuzzy
 msgid ""
 "**Improve `flwr new` templates** "
@@ -17347,14 +17461,14 @@ msgstr ""
 "[#1474](https://github.com/adap/flower/pull/1474), "
 "[#1475](https://github.com/adap/flower/pull/1475))"
 
-#: ../../source/ref-changelog.md:130
+#: ../../source/ref-changelog.md:152
 msgid ""
 "The `flwr new` command templates for MLX, NumPy, sklearn, JAX, and "
 "PyTorch have been updated to improve usability and consistency across "
 "frameworks."
 msgstr ""
 
-#: ../../source/ref-changelog.md:132
+#: ../../source/ref-changelog.md:154
 #, fuzzy
 msgid ""
 "**Migrate ID handling to use unsigned 64-bit integers** "
@@ -17367,7 +17481,7 @@ msgstr ""
 "[#1286](https://github.com/adap/flower/pull/1286), "
 "[#1282](https://github.com/adap/flower/pull/1282))"
 
-#: ../../source/ref-changelog.md:134
+#: ../../source/ref-changelog.md:156
 msgid ""
 "Node IDs, run IDs, and related fields have been migrated from signed "
 "64-bit integers (`sint64`) to unsigned 64-bit integers (`uint64`). To "
@@ -17378,7 +17492,7 @@ msgid ""
 "`uint64`."
 msgstr ""
 
-#: ../../source/ref-changelog.md:136
+#: ../../source/ref-changelog.md:158
 #, fuzzy
 msgid ""
 "**Add Flower architecture explanation** "
@@ -17387,7 +17501,7 @@ msgstr ""
 "**Documentation restructurée** "
 "([#1387](https://github.com/adap/flower/pull/1387))"
 
-#: ../../source/ref-changelog.md:138
+#: ../../source/ref-changelog.md:160
 msgid ""
 "A new [Flower architecture explainer](https://flower.ai/docs/framework"
 "/explanation-flower-architecture.html) page introduces Flower components "
@@ -17395,7 +17509,7 @@ msgid ""
 "documentation if you're interested."
 msgstr ""
 
-#: ../../source/ref-changelog.md:140
+#: ../../source/ref-changelog.md:162
 #, fuzzy
 msgid ""
 "**Introduce FedRep baseline** "
@@ -17404,7 +17518,7 @@ msgstr ""
 "**Ajouter une nouvelle stratégie `FedProx`** "
 "([#1619](https://github.com/adap/flower/pull/1619))"
 
-#: ../../source/ref-changelog.md:142
+#: ../../source/ref-changelog.md:164
 msgid ""
 "FedRep is a federated learning algorithm that learns shared data "
 "representations across clients while allowing each to maintain "
@@ -17414,7 +17528,7 @@ msgid ""
 "([arxiv](https://arxiv.org/abs/2102.07078))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:144
+#: ../../source/ref-changelog.md:166
 #, fuzzy
 msgid ""
 "**Improve FlowerTune template and LLM evaluation pipelines** "
@@ -17447,7 +17561,7 @@ msgstr ""
 "[#1305](https://github.com/adap/flower/pull/1305), "
 "[#1307](https://github.com/adap/flower/pull/1307))"
 
-#: ../../source/ref-changelog.md:146
+#: ../../source/ref-changelog.md:168
 msgid ""
 "Refined evaluation pipelines, metrics, and documentation for the upcoming"
 " FlowerTune LLM Leaderboard across multiple domains including Finance, "
@@ -17456,7 +17570,7 @@ msgid ""
 "exciting challenge!"
 msgstr ""
 
-#: ../../source/ref-changelog.md:148
+#: ../../source/ref-changelog.md:170
 #, fuzzy
 msgid ""
 "**Enhance Docker Support and Documentation** "
@@ -17482,7 +17596,7 @@ msgstr ""
 "[#1474](https://github.com/adap/flower/pull/1474), "
 "[#1475](https://github.com/adap/flower/pull/1475))"
 
-#: ../../source/ref-changelog.md:150
+#: ../../source/ref-changelog.md:172
 msgid ""
 "Upgraded Ubuntu base image to 24.04, added SBOM and gcc to Docker images,"
 " and comprehensively updated [Docker "
@@ -17490,7 +17604,7 @@ msgid ""
 "including quickstart guides and distributed Docker Compose instructions."
 msgstr ""
 
-#: ../../source/ref-changelog.md:152
+#: ../../source/ref-changelog.md:174
 #, fuzzy
 msgid ""
 "**Introduce Flower glossary** "
@@ -17501,7 +17615,7 @@ msgstr ""
 "([#1621](https://github.com/adap/flower/pull/1621), "
 "[#1764](https://github.com/adap/flower/pull/1764))"
 
-#: ../../source/ref-changelog.md:154
+#: ../../source/ref-changelog.md:176
 msgid ""
 "Added the [Federated Learning glossary](https://flower.ai/glossary/) to "
 "the Flower repository, located under the `flower/glossary/` directory. "
@@ -17511,7 +17625,7 @@ msgid ""
 "become a Flower contributor!"
 msgstr ""
 
-#: ../../source/ref-changelog.md:156
+#: ../../source/ref-changelog.md:178
 #, fuzzy
 msgid ""
 "**Implement Message Time-to-Live (TTL)** "
@@ -17530,7 +17644,7 @@ msgstr ""
 "[#1613](https://github.com/adap/flower/pull/1613), "
 "[#1614](https://github.com/adap/flower/pull/1614))"
 
-#: ../../source/ref-changelog.md:158
+#: ../../source/ref-changelog.md:180
 msgid ""
 "Added comprehensive TTL support for messages in Flower's SuperLink. "
 "Messages are now automatically expired and cleaned up based on "
@@ -17538,7 +17652,7 @@ msgid ""
 " default in the high-level API)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:160
+#: ../../source/ref-changelog.md:182
 #, fuzzy
 msgid ""
 "**Improve FAB handling** "
@@ -17553,14 +17667,14 @@ msgstr ""
 "[#1301](https://github.com/adap/flower/pull/1301), "
 "[#1310](https://github.com/adap/flower/pull/1310))"
 
-#: ../../source/ref-changelog.md:162
+#: ../../source/ref-changelog.md:184
 msgid ""
 "An 8-character hash is now appended to the FAB file name. The `flwr "
 "install` command installs FABs with a more flattened folder structure, "
 "reducing it from 3 levels to 1."
 msgstr ""
 
-#: ../../source/ref-changelog.md:164
+#: ../../source/ref-changelog.md:186
 #, fuzzy
 msgid ""
 "**Update documentation** "
@@ -17577,7 +17691,7 @@ msgstr ""
 "[#1065](https://github.com/adap/flower/pull/1065), "
 "[#1090](https://github.com/adap/flower/pull/1090))"
 
-#: ../../source/ref-changelog.md:166
+#: ../../source/ref-changelog.md:188
 msgid ""
 "Updated quickstart tutorials (PyTorch Lightning, TensorFlow, Hugging "
 "Face, Fastai) to use the new `flwr run` command and removed default title"
@@ -17585,7 +17699,7 @@ msgid ""
 "added to FAQ."
 msgstr ""
 
-#: ../../source/ref-changelog.md:168
+#: ../../source/ref-changelog.md:190
 #, fuzzy
 msgid ""
 "**Update example projects** "
@@ -17607,7 +17721,7 @@ msgstr ""
 "[#1613](https://github.com/adap/flower/pull/1613), "
 "[#1614](https://github.com/adap/flower/pull/1614))"
 
-#: ../../source/ref-changelog.md:170
+#: ../../source/ref-changelog.md:192
 msgid ""
 "Refreshed multiple example projects including vertical FL, PyTorch "
 "(advanced), Pandas, Secure Aggregation, and XGBoost examples. Optimized "
@@ -17615,7 +17729,7 @@ msgid ""
 "simulation examples."
 msgstr ""
 
-#: ../../source/ref-changelog.md:172
+#: ../../source/ref-changelog.md:194
 #, fuzzy
 msgid ""
 "**Update translations** "
@@ -17636,7 +17750,7 @@ msgstr ""
 "[#1613](https://github.com/adap/flower/pull/1613), "
 "[#1614](https://github.com/adap/flower/pull/1614))"
 
-#: ../../source/ref-changelog.md:174
+#: ../../source/ref-changelog.md:196
 msgid ""
 "**General improvements** "
 "([#4239](https://github.com/adap/flower/pull/4239), "
@@ -17683,7 +17797,7 @@ msgid ""
 "[#4333](https://github.com/adap/flower/pull/4333))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:180
+#: ../../source/ref-changelog.md:202
 #, fuzzy
 msgid ""
 "**Drop Python 3.8 support and update minimum version to 3.9** "
@@ -17705,7 +17819,7 @@ msgstr ""
 "[#1613](https://github.com/adap/flower/pull/1613), "
 "[#1614](https://github.com/adap/flower/pull/1614))"
 
-#: ../../source/ref-changelog.md:182
+#: ../../source/ref-changelog.md:204
 msgid ""
 "Python 3.8 support was deprecated in Flower 1.9, and this release removes"
 " support. Flower now requires Python 3.9 or later (Python 3.11 is "
@@ -17713,23 +17827,23 @@ msgid ""
 "minimum supported version. Flower now supports Python 3.9 to 3.12."
 msgstr ""
 
-#: ../../source/ref-changelog.md:184
+#: ../../source/ref-changelog.md:206
 #, fuzzy
 msgid "v1.11.1 (2024-09-11)"
 msgstr "v1.3.0 (2023-02-06)"
 
-#: ../../source/ref-changelog.md:190
+#: ../../source/ref-changelog.md:212
 msgid ""
 "`Charles Beauville`, `Chong Shen Ng`, `Daniel J. Beutel`, `Heng Pan`, "
 "`Javier`, `Robert Steiner`, `Yan Gao` <!---TOKEN_v1.11.1-->"
 msgstr ""
 
-#: ../../source/ref-changelog.md:192
+#: ../../source/ref-changelog.md:214
 #, fuzzy
 msgid "Improvements"
 msgstr "Améliorations facultatives"
 
-#: ../../source/ref-changelog.md:194
+#: ../../source/ref-changelog.md:216
 #, fuzzy
 msgid ""
 "**Implement** `keys/values/items` **methods for** `TypedDict` "
@@ -17738,7 +17852,7 @@ msgstr ""
 "**Make** `get_parameters` **configurable** "
 "([#1242](https://github.com/adap/flower/pull/1242))"
 
-#: ../../source/ref-changelog.md:196
+#: ../../source/ref-changelog.md:218
 #, fuzzy
 msgid ""
 "**Fix parsing of** `--executor-config` **if present** "
@@ -17747,7 +17861,7 @@ msgstr ""
 "**Ajouter une nouvelle stratégie `FedProx`** "
 "([#1619](https://github.com/adap/flower/pull/1619))"
 
-#: ../../source/ref-changelog.md:198
+#: ../../source/ref-changelog.md:220
 #, fuzzy
 msgid ""
 "**Adjust framework name in templates docstrings** "
@@ -17756,7 +17870,7 @@ msgstr ""
 "**Nouvel exemple de code scikit-learn** "
 "([#748](https://github.com/adap/flower/pull/748))"
 
-#: ../../source/ref-changelog.md:200
+#: ../../source/ref-changelog.md:222
 #, fuzzy
 msgid ""
 "**Update** `flwr new` **Hugging Face template** "
@@ -17765,7 +17879,7 @@ msgstr ""
 "**Nouvel exemple de code pour les Transformers à visage embrassant** "
 "([#863](https://github.com/adap/flower/pull/863))"
 
-#: ../../source/ref-changelog.md:202
+#: ../../source/ref-changelog.md:224
 #, fuzzy
 msgid ""
 "**Fix** `flwr new` **FlowerTune template** "
@@ -17774,7 +17888,7 @@ msgstr ""
 "**Nouvel exemple de code CoreML pour iOS** "
 "([#1289](https://github.com/adap/flower/pull/1289))"
 
-#: ../../source/ref-changelog.md:204
+#: ../../source/ref-changelog.md:226
 #, fuzzy
 msgid ""
 "**Add buffer time after** `ServerApp` **thread initialization** "
@@ -17783,7 +17897,7 @@ msgstr ""
 "**Ajouter des mesures de formation à** `History` **objet pendant les "
 "simulations** ([#1696](https://github.com/adap/flower/pull/1696))"
 
-#: ../../source/ref-changelog.md:206
+#: ../../source/ref-changelog.md:228
 #, fuzzy
 msgid ""
 "**Handle unsuitable resources for simulation** "
@@ -17792,7 +17906,7 @@ msgstr ""
 "**Ajouter un nouveau guide pratique pour le suivi des simulations** "
 "([#1649](https://github.com/adap/flower/pull/1649))"
 
-#: ../../source/ref-changelog.md:208
+#: ../../source/ref-changelog.md:230
 #, fuzzy
 msgid ""
 "**Update example READMEs** "
@@ -17801,7 +17915,7 @@ msgstr ""
 "**Introduire une nouvelle ligne de base pour les fleurs : FedAvg "
 "FEMNIST** ([#1655](https://github.com/adap/flower/pull/1655))"
 
-#: ../../source/ref-changelog.md:210
+#: ../../source/ref-changelog.md:232
 #, fuzzy
 msgid ""
 "**Update SuperNode authentication docs** "
@@ -17810,12 +17924,12 @@ msgstr ""
 "**Ajouter une nouvelle stratégie `FedProx`** "
 "([#1619](https://github.com/adap/flower/pull/1619))"
 
-#: ../../source/ref-changelog.md:216
+#: ../../source/ref-changelog.md:238
 #, fuzzy
 msgid "v1.11.0 (2024-08-30)"
 msgstr "v1.3.0 (2023-02-06)"
 
-#: ../../source/ref-changelog.md:222
+#: ../../source/ref-changelog.md:244
 msgid ""
 "`Adam Narozniak`, `Charles Beauville`, `Chong Shen Ng`, `Daniel J. "
 "Beutel`, `Daniel Nata Nugraha`, `Danny`, `Edoardo Gabrielli`, `Heng Pan`,"
@@ -17824,7 +17938,7 @@ msgid ""
 "TOKEN_v1.11.0-->"
 msgstr ""
 
-#: ../../source/ref-changelog.md:226
+#: ../../source/ref-changelog.md:248
 msgid ""
 "**Deliver Flower App Bundle (FAB) to SuperLink and SuperNodes** "
 "([#4006](https://github.com/adap/flower/pull/4006), "
@@ -17851,14 +17965,14 @@ msgid ""
 "[#3619](https://github.com/adap/flower/pull/3619))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:228
+#: ../../source/ref-changelog.md:250
 msgid ""
 "Dynamic code updates are here! `flwr run` can now ship and install the "
 "latest version of your `ServerApp` and `ClientApp` to an already-running "
 "federation (SuperLink and SuperNodes)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:230
+#: ../../source/ref-changelog.md:252
 msgid ""
 "How does it work? `flwr run` bundles your Flower app into a single FAB "
 "(Flower App Bundle) file. It then ships this FAB file, via the SuperExec,"
@@ -17868,11 +17982,11 @@ msgid ""
 "projects!) dynamically."
 msgstr ""
 
-#: ../../source/ref-changelog.md:232
+#: ../../source/ref-changelog.md:254
 msgid "`flwr run` is all you need."
 msgstr ""
 
-#: ../../source/ref-changelog.md:234
+#: ../../source/ref-changelog.md:256
 #, fuzzy
 msgid ""
 "**Introduce isolated** `ClientApp` **execution** "
@@ -17907,30 +18021,30 @@ msgstr ""
 "[#1564](https://github.com/adap/flower/pull/1564), "
 "[#1566](https://github.com/adap/flower/pull/1566))"
 
-#: ../../source/ref-changelog.md:236
+#: ../../source/ref-changelog.md:258
 msgid ""
 "The SuperNode can now run your `ClientApp` in a fully isolated way. In an"
 " enterprise deployment, this allows you to set strict limits on what the "
 "`ClientApp` can and cannot do."
 msgstr ""
 
-#: ../../source/ref-changelog.md:238
+#: ../../source/ref-changelog.md:260
 msgid "`flower-supernode` supports three `--isolation` modes:"
 msgstr ""
 
-#: ../../source/ref-changelog.md:240
+#: ../../source/ref-changelog.md:262
 msgid ""
 "Unset: The SuperNode runs the `ClientApp` in the same process (as in "
 "previous versions of Flower). This is the default mode."
 msgstr ""
 
-#: ../../source/ref-changelog.md:241
+#: ../../source/ref-changelog.md:263
 msgid ""
 "`--isolation=subprocess`: The SuperNode starts a subprocess to run the "
 "`ClientApp`."
 msgstr ""
 
-#: ../../source/ref-changelog.md:242
+#: ../../source/ref-changelog.md:264
 msgid ""
 "`--isolation=process`: The SuperNode expects an externally-managed "
 "process to run the `ClientApp`. This external process is not managed by "
@@ -17939,7 +18053,7 @@ msgid ""
 "`flwr/clientapp` Docker image."
 msgstr ""
 
-#: ../../source/ref-changelog.md:244
+#: ../../source/ref-changelog.md:266
 #, fuzzy
 msgid ""
 "**Improve Docker support for enterprise deployments** "
@@ -17956,17 +18070,17 @@ msgstr ""
 "[#1065](https://github.com/adap/flower/pull/1065), "
 "[#1090](https://github.com/adap/flower/pull/1090))"
 
-#: ../../source/ref-changelog.md:246
+#: ../../source/ref-changelog.md:268
 msgid ""
 "Flower 1.11 ships many Docker improvements that are especially useful for"
 " enterprise deployments:"
 msgstr ""
 
-#: ../../source/ref-changelog.md:248
+#: ../../source/ref-changelog.md:270
 msgid "`flwr/supernode` comes with a new Alpine Docker image."
 msgstr ""
 
-#: ../../source/ref-changelog.md:249
+#: ../../source/ref-changelog.md:271
 msgid ""
 "`flwr/clientapp` is a new image to be used with the `--isolation=process`"
 " option. In this mode, SuperNode and `ClientApp` run in two different "
@@ -17976,19 +18090,19 @@ msgid ""
 "enterprise settings."
 msgstr ""
 
-#: ../../source/ref-changelog.md:250
+#: ../../source/ref-changelog.md:272
 msgid ""
 "New all-in-one Docker Compose enables you to easily start a full Flower "
 "Deployment Engine on a single machine."
 msgstr ""
 
-#: ../../source/ref-changelog.md:251
+#: ../../source/ref-changelog.md:273
 msgid ""
 "Completely new Docker documentation: "
 "https://flower.ai/docs/framework/docker/index.html"
 msgstr ""
 
-#: ../../source/ref-changelog.md:253
+#: ../../source/ref-changelog.md:275
 #, fuzzy
 msgid ""
 "**Improve SuperNode authentication** "
@@ -18001,13 +18115,13 @@ msgstr ""
 "[#1286](https://github.com/adap/flower/pull/1286), "
 "[#1282](https://github.com/adap/flower/pull/1282))"
 
-#: ../../source/ref-changelog.md:255
+#: ../../source/ref-changelog.md:277
 msgid ""
 "SuperNode auth has been improved in several ways, including improved "
 "logging, improved testing, and improved error handling."
 msgstr ""
 
-#: ../../source/ref-changelog.md:257
+#: ../../source/ref-changelog.md:279
 #, fuzzy
 msgid ""
 "**Update** `flwr new` **templates** "
@@ -18030,13 +18144,13 @@ msgstr ""
 "[#1613](https://github.com/adap/flower/pull/1613), "
 "[#1614](https://github.com/adap/flower/pull/1614))"
 
-#: ../../source/ref-changelog.md:259
+#: ../../source/ref-changelog.md:281
 msgid ""
 "All `flwr new` templates have been updated to show the latest recommended"
 " use of Flower APIs."
 msgstr ""
 
-#: ../../source/ref-changelog.md:261
+#: ../../source/ref-changelog.md:283
 #, fuzzy
 msgid ""
 "**Improve Simulation Engine** "
@@ -18054,14 +18168,14 @@ msgstr ""
 "[#1065](https://github.com/adap/flower/pull/1065), "
 "[#1090](https://github.com/adap/flower/pull/1090))"
 
-#: ../../source/ref-changelog.md:263
+#: ../../source/ref-changelog.md:285
 msgid ""
 "The Flower Simulation Engine comes with several updates, including "
 "improved run config support, verbose logging, simulation backend "
 "configuration via `flwr run`, and more."
 msgstr ""
 
-#: ../../source/ref-changelog.md:265
+#: ../../source/ref-changelog.md:287
 #, fuzzy
 msgid ""
 "**Improve** `RecordSet` "
@@ -18074,7 +18188,7 @@ msgstr ""
 "[#1286](https://github.com/adap/flower/pull/1286), "
 "[#1282](https://github.com/adap/flower/pull/1282))"
 
-#: ../../source/ref-changelog.md:267
+#: ../../source/ref-changelog.md:289
 msgid ""
 "`RecordSet` is the core object to exchange model parameters, "
 "configuration values and metrics between `ClientApp` and `ServerApp`. "
@@ -18082,7 +18196,7 @@ msgid ""
 "related `*Record` types."
 msgstr ""
 
-#: ../../source/ref-changelog.md:269
+#: ../../source/ref-changelog.md:291
 #, fuzzy
 msgid ""
 "**Update documentation** "
@@ -18113,14 +18227,14 @@ msgstr ""
 "[#1305](https://github.com/adap/flower/pull/1305), "
 "[#1307](https://github.com/adap/flower/pull/1307))"
 
-#: ../../source/ref-changelog.md:271
+#: ../../source/ref-changelog.md:293
 msgid ""
 "Many parts of the documentation, including the main tutorial, have been "
 "migrated to show new Flower APIs and other new Flower features like the "
 "improved Docker support."
 msgstr ""
 
-#: ../../source/ref-changelog.md:273
+#: ../../source/ref-changelog.md:295
 msgid ""
 "**Migrate code example to use new Flower APIs** "
 "([#3758](https://github.com/adap/flower/pull/3758), "
@@ -18146,11 +18260,11 @@ msgid ""
 "[#3313](https://github.com/adap/flower/pull/3313))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:275
+#: ../../source/ref-changelog.md:297
 msgid "Many code examples have been migrated to use new Flower APIs."
 msgstr ""
 
-#: ../../source/ref-changelog.md:277
+#: ../../source/ref-changelog.md:299
 msgid ""
 "**Update Flower framework, framework internals and quality "
 "infrastructure** ([#4018](https://github.com/adap/flower/pull/4018), "
@@ -18192,7 +18306,7 @@ msgid ""
 "[#4038](https://github.com/adap/flower/pull/4038))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:283
+#: ../../source/ref-changelog.md:305
 #, fuzzy
 msgid ""
 "**Deprecate accessing `Context` via `Client.context`** "
@@ -18201,7 +18315,7 @@ msgstr ""
 "**Supprimer les installations supplémentaires no-op dépréciées** "
 "([#973](https://github.com/adap/flower/pull/973))"
 
-#: ../../source/ref-changelog.md:285
+#: ../../source/ref-changelog.md:307
 msgid ""
 "Now that both `client_fn` and `server_fn` receive a `Context` object, "
 "accessing `Context` via `Client.context` is deprecated. `Client.context` "
@@ -18210,7 +18324,7 @@ msgid ""
 " instance in `client_fn`:"
 msgstr ""
 
-#: ../../source/ref-changelog.md:294
+#: ../../source/ref-changelog.md:316
 #, fuzzy
 msgid ""
 "**Update CLIs to accept an app directory instead of** `ClientApp` **and**"
@@ -18223,7 +18337,7 @@ msgstr ""
 "[#1544](https://github.com/adap/flower/pull/1544), "
 "[#1584](https://github.com/adap/flower/pull/1584))"
 
-#: ../../source/ref-changelog.md:296
+#: ../../source/ref-changelog.md:318
 msgid ""
 "The CLI commands `flower-supernode` and `flower-server-app` now accept an"
 " app directory as argument (instead of references to a `ClientApp` or "
@@ -18233,7 +18347,7 @@ msgid ""
 "`flwr new`."
 msgstr ""
 
-#: ../../source/ref-changelog.md:298
+#: ../../source/ref-changelog.md:320
 #, fuzzy
 msgid ""
 "**Disable** `flower-client-app` **CLI command** "
@@ -18242,11 +18356,11 @@ msgstr ""
 "**Introduire une nouvelle ligne de base pour les fleurs : FedAvg "
 "FEMNIST** ([#1655](https://github.com/adap/flower/pull/1655))"
 
-#: ../../source/ref-changelog.md:300
+#: ../../source/ref-changelog.md:322
 msgid "`flower-client-app` has been disabled. Use `flower-supernode` instead."
 msgstr ""
 
-#: ../../source/ref-changelog.md:302
+#: ../../source/ref-changelog.md:324
 #, fuzzy
 msgid ""
 "**Use spaces instead of commas for separating config args** "
@@ -18255,17 +18369,17 @@ msgstr ""
 "**Métriques personnalisées pour le serveur et les stratégies** "
 "([#717](https://github.com/adap/flower/pull/717))"
 
-#: ../../source/ref-changelog.md:304
+#: ../../source/ref-changelog.md:326
 msgid ""
 "When passing configs (run config, node config) to Flower, you now need to"
 " separate key-value pairs using spaces instead of commas. For example:"
 msgstr ""
 
-#: ../../source/ref-changelog.md:310
+#: ../../source/ref-changelog.md:332
 msgid "Previously, you could pass configs using commas, like this:"
 msgstr ""
 
-#: ../../source/ref-changelog.md:316
+#: ../../source/ref-changelog.md:338
 #, fuzzy
 msgid ""
 "**Remove** `flwr example` **CLI command** "
@@ -18274,18 +18388,18 @@ msgstr ""
 "**Supprimez KerasClient** "
 "([#857](https://github.com/adap/flower/pull/857))"
 
-#: ../../source/ref-changelog.md:318
+#: ../../source/ref-changelog.md:340
 msgid ""
 "The experimental `flwr example` CLI command has been removed. Use `flwr "
 "new` to generate a project and then run it using `flwr run`."
 msgstr ""
 
-#: ../../source/ref-changelog.md:320
+#: ../../source/ref-changelog.md:342
 #, fuzzy
 msgid "v1.10.0 (2024-07-24)"
 msgstr "v1.0.0 (2022-07-28)"
 
-#: ../../source/ref-changelog.md:326
+#: ../../source/ref-changelog.md:348
 msgid ""
 "`Adam Narozniak`, `Charles Beauville`, `Chong Shen Ng`, `Daniel J. "
 "Beutel`, `Daniel Nata Nugraha`, `Danny`, `Gustavo Bertoli`, `Heng Pan`, "
@@ -18294,7 +18408,7 @@ msgid ""
 "---TOKEN_v1.10.0-->"
 msgstr ""
 
-#: ../../source/ref-changelog.md:330
+#: ../../source/ref-changelog.md:352
 #, fuzzy
 msgid ""
 "**Introduce** `flwr run` **(beta)** "
@@ -18315,7 +18429,7 @@ msgstr ""
 "[#1474](https://github.com/adap/flower/pull/1474), "
 "[#1475](https://github.com/adap/flower/pull/1475))"
 
-#: ../../source/ref-changelog.md:332
+#: ../../source/ref-changelog.md:354
 msgid ""
 "Flower 1.10 ships the first beta release of the new `flwr run` command. "
 "`flwr run` can run different projects using `flwr run path/to/project`, "
@@ -18328,7 +18442,7 @@ msgid ""
 "`flwr new` to generate a project and then run it using `flwr run`."
 msgstr ""
 
-#: ../../source/ref-changelog.md:334
+#: ../../source/ref-changelog.md:356
 #, fuzzy
 msgid ""
 "**Introduce run config** "
@@ -18357,7 +18471,7 @@ msgstr ""
 "[#1770](https://github.com/adap/flower/pull/1770), "
 "[#1733](https://github.com/adap/flower/pull/1733))"
 
-#: ../../source/ref-changelog.md:336
+#: ../../source/ref-changelog.md:358
 msgid ""
 "The new run config feature allows you to run your Flower project in "
 "different configurations without having to change a single line of code. "
@@ -18370,7 +18484,7 @@ msgid ""
 "new project using `flwr new` to see run config in action."
 msgstr ""
 
-#: ../../source/ref-changelog.md:338
+#: ../../source/ref-changelog.md:360
 #, fuzzy
 msgid ""
 "**Generalize** `client_fn` **signature to** `client_fn(context: Context) "
@@ -18385,7 +18499,7 @@ msgstr ""
 "[#1301](https://github.com/adap/flower/pull/1301), "
 "[#1310](https://github.com/adap/flower/pull/1310))"
 
-#: ../../source/ref-changelog.md:340
+#: ../../source/ref-changelog.md:362
 msgid ""
 "The `client_fn` signature has been generalized to `client_fn(context: "
 "Context) -> Client`. It now receives a `Context` object instead of the "
@@ -18395,14 +18509,14 @@ msgid ""
 "system."
 msgstr ""
 
-#: ../../source/ref-changelog.md:342
+#: ../../source/ref-changelog.md:364
 msgid ""
 "The previous signature `client_fn(cid: str)` is now deprecated and "
 "support for it will be removed in a future release. Use "
 "`client_fn(context: Context) -> Client` everywhere."
 msgstr ""
 
-#: ../../source/ref-changelog.md:344
+#: ../../source/ref-changelog.md:366
 #, fuzzy
 msgid ""
 "**Introduce new** `server_fn(context)` "
@@ -18415,7 +18529,7 @@ msgstr ""
 "[#1544](https://github.com/adap/flower/pull/1544), "
 "[#1584](https://github.com/adap/flower/pull/1584))"
 
-#: ../../source/ref-changelog.md:346
+#: ../../source/ref-changelog.md:368
 msgid ""
 "In addition to the new `client_fn(context:Context)`, a new "
 "`server_fn(context: Context) -> ServerAppComponents` can now be passed to"
@@ -18424,7 +18538,7 @@ msgid ""
 "build a configurable `ServerApp`."
 msgstr ""
 
-#: ../../source/ref-changelog.md:348
+#: ../../source/ref-changelog.md:370
 #, fuzzy
 msgid ""
 "**Relaunch all** `flwr new` **templates** "
@@ -18445,7 +18559,7 @@ msgstr ""
 "[#1613](https://github.com/adap/flower/pull/1613), "
 "[#1614](https://github.com/adap/flower/pull/1614))"
 
-#: ../../source/ref-changelog.md:350
+#: ../../source/ref-changelog.md:372
 msgid ""
 "All `flwr new` templates have been significantly updated to showcase new "
 "Flower features and best practices. This includes using `flwr run` and "
@@ -18454,7 +18568,7 @@ msgid ""
 "run` it."
 msgstr ""
 
-#: ../../source/ref-changelog.md:352
+#: ../../source/ref-changelog.md:374
 #, fuzzy
 msgid ""
 "**Introduce** `flower-supernode` **(preview)** "
@@ -18463,7 +18577,7 @@ msgstr ""
 "**Introduire une nouvelle ligne de base pour les fleurs : FedAvg "
 "FEMNIST** ([#1655](https://github.com/adap/flower/pull/1655))"
 
-#: ../../source/ref-changelog.md:354
+#: ../../source/ref-changelog.md:376
 msgid ""
 "The new `flower-supernode` CLI is here to replace `flower-client-app`. "
 "`flower-supernode` brings full multi-app support to the Flower client-"
@@ -18472,7 +18586,7 @@ msgid ""
 "`client_fn(context: Context)` signature)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:356
+#: ../../source/ref-changelog.md:378
 #, fuzzy
 msgid ""
 "**Introduce node config** "
@@ -18487,7 +18601,7 @@ msgstr ""
 "[#1681](https://github.com/adap/flower/pull/1681), "
 "[#1679](https://github.com/adap/flower/pull/1679))"
 
-#: ../../source/ref-changelog.md:358
+#: ../../source/ref-changelog.md:380
 msgid ""
 "A new node config feature allows you to pass a static configuration to "
 "the SuperNode. This configuration is read-only and available to every "
@@ -18495,7 +18609,7 @@ msgid ""
 "config via `Context` (`context.node_config`)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:360
+#: ../../source/ref-changelog.md:382
 msgid ""
 "**Introduce SuperExec (experimental)** "
 "([#3605](https://github.com/adap/flower/pull/3605), "
@@ -18516,14 +18630,14 @@ msgid ""
 "[#3629](https://github.com/adap/flower/pull/3629))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:362
+#: ../../source/ref-changelog.md:384
 msgid ""
 "This is the first experimental release of Flower SuperExec, a new service"
 " that executes your runs. It's not ready for production deployment just "
 "yet, but don't hesitate to give it a try if you're interested."
 msgstr ""
 
-#: ../../source/ref-changelog.md:364
+#: ../../source/ref-changelog.md:386
 #, fuzzy
 msgid ""
 "**Add new federated learning with tabular data example** "
@@ -18532,13 +18646,13 @@ msgstr ""
 "**Ajouter un nouvel exemple d'apprentissage fédéré utilisant fastai et "
 "Flower** ([#1598](https://github.com/adap/flower/pull/1598))"
 
-#: ../../source/ref-changelog.md:366
+#: ../../source/ref-changelog.md:388
 msgid ""
 "A new code example exemplifies a federated learning setup using the "
 "Flower framework on the Adult Census Income tabular dataset."
 msgstr ""
 
-#: ../../source/ref-changelog.md:368
+#: ../../source/ref-changelog.md:390
 #, fuzzy
 msgid ""
 "**Create generic adapter layer (preview)** "
@@ -18551,7 +18665,7 @@ msgstr ""
 "[#1286](https://github.com/adap/flower/pull/1286), "
 "[#1282](https://github.com/adap/flower/pull/1282))"
 
-#: ../../source/ref-changelog.md:370
+#: ../../source/ref-changelog.md:392
 msgid ""
 "A new generic gRPC adapter layer allows 3rd-party frameworks to integrate"
 " with Flower in a transparent way. This makes Flower more modular and "
@@ -18559,7 +18673,7 @@ msgid ""
 "platforms."
 msgstr ""
 
-#: ../../source/ref-changelog.md:372
+#: ../../source/ref-changelog.md:394
 #, fuzzy
 msgid ""
 "**Refactor Flower Simulation Engine** "
@@ -18582,7 +18696,7 @@ msgstr ""
 "[#1474](https://github.com/adap/flower/pull/1474), "
 "[#1475](https://github.com/adap/flower/pull/1475))"
 
-#: ../../source/ref-changelog.md:374
+#: ../../source/ref-changelog.md:396
 msgid ""
 "The Simulation Engine was significantly refactored. This results in "
 "faster and more stable simulations. It is also the foundation for "
@@ -18590,7 +18704,7 @@ msgid ""
 "configurability in federated learning simulations."
 msgstr ""
 
-#: ../../source/ref-changelog.md:376
+#: ../../source/ref-changelog.md:398
 #, fuzzy
 msgid ""
 "**Optimize Docker containers** "
@@ -18599,13 +18713,13 @@ msgstr ""
 "Nouveau thème de documentation "
 "([#551](https://github.com/adap/flower/pull/551))"
 
-#: ../../source/ref-changelog.md:378
+#: ../../source/ref-changelog.md:400
 msgid ""
 "Flower Docker containers were optimized and updated to use that latest "
 "Flower framework features."
 msgstr ""
 
-#: ../../source/ref-changelog.md:380
+#: ../../source/ref-changelog.md:402
 #, fuzzy
 msgid ""
 "**Improve logging** ([#3776](https://github.com/adap/flower/pull/3776), "
@@ -18615,13 +18729,13 @@ msgstr ""
 "([#1344](https://github.com/adap/flower/pull/1344), "
 "[#1347](https://github.com/adap/flower/pull/1347))"
 
-#: ../../source/ref-changelog.md:382
+#: ../../source/ref-changelog.md:404
 msgid ""
 "Improved logging aims to be more concise and helpful to show you the "
 "details you actually care about."
 msgstr ""
 
-#: ../../source/ref-changelog.md:384
+#: ../../source/ref-changelog.md:406
 #, fuzzy
 msgid ""
 "**Refactor framework internals** "
@@ -18642,7 +18756,12 @@ msgstr ""
 "[#1474](https://github.com/adap/flower/pull/1474), "
 "[#1475](https://github.com/adap/flower/pull/1475))"
 
-#: ../../source/ref-changelog.md:390
+#: ../../source/ref-changelog.md:410
+#, fuzzy
+msgid "Documentation improvements"
+msgstr "Améliorations facultatives"
+
+#: ../../source/ref-changelog.md:412
 #, fuzzy
 msgid ""
 "**Add 🇰🇷 Korean translations** "
@@ -18651,7 +18770,7 @@ msgstr ""
 "**Ouvrir dans le bouton Colab** "
 "([#1389](https://github.com/adap/flower/pull/1389))"
 
-#: ../../source/ref-changelog.md:392
+#: ../../source/ref-changelog.md:414
 #, fuzzy
 msgid ""
 "**Update translations** "
@@ -18672,7 +18791,7 @@ msgstr ""
 "[#1474](https://github.com/adap/flower/pull/1474), "
 "[#1475](https://github.com/adap/flower/pull/1475))"
 
-#: ../../source/ref-changelog.md:394
+#: ../../source/ref-changelog.md:416
 #, fuzzy
 msgid ""
 "**Update documentation** "
@@ -18695,18 +18814,18 @@ msgstr ""
 "[#1613](https://github.com/adap/flower/pull/1613), "
 "[#1614](https://github.com/adap/flower/pull/1614))"
 
-#: ../../source/ref-changelog.md:396
+#: ../../source/ref-changelog.md:418
 msgid ""
 "Updated documentation includes new install instructions for different "
 "shells, a new Flower Code Examples documentation landing page, new `flwr`"
 " CLI docs and an updated federated XGBoost code example."
 msgstr ""
 
-#: ../../source/ref-changelog.md:400
+#: ../../source/ref-changelog.md:422
 msgid "**Deprecate** `client_fn(cid: str)`"
 msgstr ""
 
-#: ../../source/ref-changelog.md:402
+#: ../../source/ref-changelog.md:424
 msgid ""
 "`client_fn` used to have a signature `client_fn(cid: str) -> Client`. "
 "This signature is now deprecated. Use the new signature "
@@ -18719,13 +18838,13 @@ msgid ""
 " the dataset on each simulated or deployed SuperNode."
 msgstr ""
 
-#: ../../source/ref-changelog.md:404
+#: ../../source/ref-changelog.md:426
 msgid ""
 "**Deprecate passing** `Server/ServerConfig/Strategy/ClientManager` **to**"
 " `ServerApp` **directly**"
 msgstr ""
 
-#: ../../source/ref-changelog.md:406
+#: ../../source/ref-changelog.md:428
 msgid ""
 "Creating `ServerApp` using `ServerApp(config=config, strategy=strategy)` "
 "is now deprecated. Instead of passing "
@@ -18738,7 +18857,7 @@ msgid ""
 " the `run_config`)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:410
+#: ../../source/ref-changelog.md:432
 #, fuzzy
 msgid ""
 "**Remove support for `client_ids` in `start_simulation`** "
@@ -18747,7 +18866,7 @@ msgstr ""
 "**Améliorer la prise en charge des GPU dans les simulations** "
 "([#1555](https://github.com/adap/flower/pull/1555))"
 
-#: ../../source/ref-changelog.md:412
+#: ../../source/ref-changelog.md:434
 msgid ""
 "The (rarely used) feature that allowed passing custom `client_ids` to the"
 " `start_simulation` function was removed. This removal is part of a "
@@ -18755,7 +18874,7 @@ msgid ""
 "internals work in simulation and deployment."
 msgstr ""
 
-#: ../../source/ref-changelog.md:414
+#: ../../source/ref-changelog.md:436
 #, fuzzy
 msgid ""
 "**Remove `flower-driver-api` and `flower-fleet-api`** "
@@ -18764,19 +18883,19 @@ msgstr ""
 "**Supprimez KerasClient** "
 "([#857](https://github.com/adap/flower/pull/857))"
 
-#: ../../source/ref-changelog.md:416
+#: ../../source/ref-changelog.md:438
 msgid ""
 "The two deprecated CLI commands `flower-driver-api` and `flower-fleet-"
 "api` were removed in an effort to streamline the SuperLink developer "
 "experience. Use `flower-superlink` instead."
 msgstr ""
 
-#: ../../source/ref-changelog.md:418
+#: ../../source/ref-changelog.md:440
 #, fuzzy
 msgid "v1.9.0 (2024-06-10)"
 msgstr "v1.3.0 (2023-02-06)"
 
-#: ../../source/ref-changelog.md:424
+#: ../../source/ref-changelog.md:446
 msgid ""
 "`Adam Narozniak`, `Charles Beauville`, `Chong Shen Ng`, `Daniel J. "
 "Beutel`, `Daniel Nata Nugraha`, `Heng Pan`, `Javier`, `Mahdi Beitollahi`,"
@@ -18784,7 +18903,7 @@ msgid ""
 "---TOKEN_v1.9.0-->"
 msgstr ""
 
-#: ../../source/ref-changelog.md:428
+#: ../../source/ref-changelog.md:450
 #, fuzzy
 msgid ""
 "**Introduce built-in authentication (preview)** "
@@ -18814,7 +18933,7 @@ msgstr ""
 "[#1519](https://github.com/adap/flower/pull/1519), "
 "[#1515](https://github.com/adap/flower/pull/1515))"
 
-#: ../../source/ref-changelog.md:430
+#: ../../source/ref-changelog.md:452
 msgid ""
 "Flower 1.9 introduces the first build-in version of client node "
 "authentication. In previous releases, users often wrote glue code to "
@@ -18826,14 +18945,14 @@ msgid ""
 "authentication) help you to get started."
 msgstr ""
 
-#: ../../source/ref-changelog.md:432
+#: ../../source/ref-changelog.md:454
 msgid ""
 "This is the first preview release of the Flower-native authentication "
 "system. Many additional features are on the roadmap for upcoming Flower "
 "releases - stay tuned."
 msgstr ""
 
-#: ../../source/ref-changelog.md:434
+#: ../../source/ref-changelog.md:456
 #, fuzzy
 msgid ""
 "**Introduce end-to-end Docker support** "
@@ -18859,7 +18978,7 @@ msgstr ""
 "[#1770](https://github.com/adap/flower/pull/1770), "
 "[#1733](https://github.com/adap/flower/pull/1733))"
 
-#: ../../source/ref-changelog.md:436
+#: ../../source/ref-changelog.md:458
 msgid ""
 "Full Flower Next Docker support is here! With the release of Flower 1.9, "
 "Flower provides stable Docker images for the Flower SuperLink, the Flower"
@@ -18869,7 +18988,7 @@ msgid ""
 "docker.html) to get stated."
 msgstr ""
 
-#: ../../source/ref-changelog.md:438
+#: ../../source/ref-changelog.md:460
 #, fuzzy
 msgid ""
 "**Re-architect Flower Next simulation engine** "
@@ -18891,7 +19010,7 @@ msgstr ""
 "[#1613](https://github.com/adap/flower/pull/1613), "
 "[#1614](https://github.com/adap/flower/pull/1614))"
 
-#: ../../source/ref-changelog.md:440
+#: ../../source/ref-changelog.md:462
 msgid ""
 "Flower Next simulations now use a new in-memory `Driver` that improves "
 "the reliability of simulations, especially in notebook environments. This"
@@ -18899,7 +19018,7 @@ msgid ""
 "simulation architecture."
 msgstr ""
 
-#: ../../source/ref-changelog.md:442
+#: ../../source/ref-changelog.md:464
 #, fuzzy
 msgid ""
 "**Upgrade simulation engine** "
@@ -18920,14 +19039,14 @@ msgstr ""
 "[#1613](https://github.com/adap/flower/pull/1613), "
 "[#1614](https://github.com/adap/flower/pull/1614))"
 
-#: ../../source/ref-changelog.md:444
+#: ../../source/ref-changelog.md:466
 msgid ""
 "The Flower Next simulation engine comes with improved and configurable "
 "logging. The Ray-based simulation backend in Flower 1.9 was updated to "
 "use Ray 2.10."
 msgstr ""
 
-#: ../../source/ref-changelog.md:446
+#: ../../source/ref-changelog.md:468
 #, fuzzy
 msgid ""
 "**Introduce FedPFT baseline** "
@@ -18936,7 +19055,7 @@ msgstr ""
 "**Ajouter une nouvelle stratégie `FedProx`** "
 "([#1619](https://github.com/adap/flower/pull/1619))"
 
-#: ../../source/ref-changelog.md:448
+#: ../../source/ref-changelog.md:470
 msgid ""
 "FedPFT allows you to perform one-shot Federated Learning by leveraging "
 "widely available foundational models, dramatically reducing communication"
@@ -18947,7 +19066,7 @@ msgid ""
 "([arxiv](https://arxiv.org/abs/2402.01862))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:450
+#: ../../source/ref-changelog.md:472
 #, fuzzy
 msgid ""
 "**Launch additional** `flwr new` **templates for Apple MLX, Hugging Face "
@@ -18965,7 +19084,7 @@ msgstr ""
 "[#1065](https://github.com/adap/flower/pull/1065), "
 "[#1090](https://github.com/adap/flower/pull/1090))"
 
-#: ../../source/ref-changelog.md:452
+#: ../../source/ref-changelog.md:474
 msgid ""
 "The `flwr` CLI's `flwr new` command is starting to become everone's "
 "favorite way of creating new Flower projects. This release introduces "
@@ -18974,7 +19093,7 @@ msgid ""
 "also received updates."
 msgstr ""
 
-#: ../../source/ref-changelog.md:454
+#: ../../source/ref-changelog.md:476
 #, fuzzy
 msgid ""
 "**Refine** `RecordSet` **API** "
@@ -18994,14 +19113,14 @@ msgstr ""
 "[#1613](https://github.com/adap/flower/pull/1613), "
 "[#1614](https://github.com/adap/flower/pull/1614))"
 
-#: ../../source/ref-changelog.md:456
+#: ../../source/ref-changelog.md:478
 msgid ""
 "`RecordSet` is part of the Flower Next low-level API preview release. In "
 "Flower 1.9, `RecordSet` received a number of usability improvements that "
 "make it easier to build `RecordSet`-based `ServerApp`s and `ClientApp`s."
 msgstr ""
 
-#: ../../source/ref-changelog.md:458
+#: ../../source/ref-changelog.md:480
 #, fuzzy
 msgid ""
 "**Beautify logging** ([#3379](https://github.com/adap/flower/pull/3379), "
@@ -19016,13 +19135,13 @@ msgstr ""
 "[#1301](https://github.com/adap/flower/pull/1301), "
 "[#1310](https://github.com/adap/flower/pull/1310))"
 
-#: ../../source/ref-changelog.md:460
+#: ../../source/ref-changelog.md:482
 msgid ""
 "Logs received a substantial update. Not only are logs now much nicer to "
 "look at, but they are also more configurable."
 msgstr ""
 
-#: ../../source/ref-changelog.md:462
+#: ../../source/ref-changelog.md:484
 #, fuzzy
 msgid ""
 "**Improve reliability** "
@@ -19042,13 +19161,13 @@ msgstr ""
 "[#1474](https://github.com/adap/flower/pull/1474), "
 "[#1475](https://github.com/adap/flower/pull/1475))"
 
-#: ../../source/ref-changelog.md:464
+#: ../../source/ref-changelog.md:486
 msgid ""
 "Flower 1.9 includes reliability improvements across many parts of the "
 "system. One example is a much improved SuperNode shutdown procedure."
 msgstr ""
 
-#: ../../source/ref-changelog.md:466
+#: ../../source/ref-changelog.md:488
 #, fuzzy
 msgid ""
 "**Update Swift and C++ SDKs** "
@@ -19059,14 +19178,14 @@ msgstr ""
 "([#1344](https://github.com/adap/flower/pull/1344), "
 "[#1347](https://github.com/adap/flower/pull/1347))"
 
-#: ../../source/ref-changelog.md:468
+#: ../../source/ref-changelog.md:490
 msgid ""
 "In the C++ SDK, communication-related code is now separate from main "
 "client logic. A new abstract class `Communicator` has been introduced "
 "alongside a gRPC implementation of it."
 msgstr ""
 
-#: ../../source/ref-changelog.md:470
+#: ../../source/ref-changelog.md:492
 msgid ""
 "**Improve testing, tooling and CI/CD infrastructure** "
 "([#3294](https://github.com/adap/flower/pull/3294), "
@@ -19100,13 +19219,13 @@ msgid ""
 "[#3271](https://github.com/adap/flower/pull/3271))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:472
+#: ../../source/ref-changelog.md:494
 msgid ""
 "As always, the Flower tooling, testing, and CI/CD infrastructure has "
 "received many updates."
 msgstr ""
 
-#: ../../source/ref-changelog.md:474
+#: ../../source/ref-changelog.md:496
 msgid ""
 "**Improve documentation** "
 "([#3530](https://github.com/adap/flower/pull/3530), "
@@ -19131,32 +19250,32 @@ msgid ""
 "[#3274](https://github.com/adap/flower/pull/3274))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:476
+#: ../../source/ref-changelog.md:498
 msgid ""
 "As always, the Flower documentation has received many updates. Notable "
 "new pages include:"
 msgstr ""
 
-#: ../../source/ref-changelog.md:478
+#: ../../source/ref-changelog.md:500
 msgid ""
 "[How-to upgrate to Flower Next (Flower Next migration "
 "guide)](https://flower.ai/docs/framework/how-to-upgrade-to-flower-"
 "next.html)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:480
+#: ../../source/ref-changelog.md:502
 msgid ""
 "[How-to run Flower using Docker](https://flower.ai/docs/framework/how-to-"
 "run-flower-using-docker.html)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:482
+#: ../../source/ref-changelog.md:504
 msgid ""
 "[Flower Mods reference](https://flower.ai/docs/framework/ref-"
 "api/flwr.client.mod.html#module-flwr.client.mod)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:484
+#: ../../source/ref-changelog.md:506
 #, fuzzy
 msgid ""
 "**General updates to Flower Examples** "
@@ -19191,11 +19310,11 @@ msgstr ""
 "[#1305](https://github.com/adap/flower/pull/1305), "
 "[#1307](https://github.com/adap/flower/pull/1307))"
 
-#: ../../source/ref-changelog.md:486
+#: ../../source/ref-changelog.md:508
 msgid "As always, Flower code examples have received many updates."
 msgstr ""
 
-#: ../../source/ref-changelog.md:488
+#: ../../source/ref-changelog.md:510
 msgid ""
 "**General improvements** "
 "([#3532](https://github.com/adap/flower/pull/3532), "
@@ -19234,19 +19353,19 @@ msgid ""
 "[#3261](https://github.com/adap/flower/pull/3261))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:492
+#: ../../source/ref-changelog.md:514
 #, fuzzy
 msgid "**Deprecate Python 3.8 support**"
 msgstr "**Créer le PR**"
 
-#: ../../source/ref-changelog.md:494
+#: ../../source/ref-changelog.md:516
 msgid ""
 "Python 3.8 will stop receiving security fixes in [October "
 "2024](https://devguide.python.org/versions/). Support for Python 3.8 is "
 "now deprecated and will be removed in an upcoming release."
 msgstr ""
 
-#: ../../source/ref-changelog.md:496
+#: ../../source/ref-changelog.md:518
 #, fuzzy
 msgid ""
 "**Deprecate (experimental)** `flower-driver-api` **and** `flower-fleet-"
@@ -19257,14 +19376,14 @@ msgstr ""
 "([#1258](https://github.com/adap/flower/pull/1258), "
 "[#1259](https://github.com/adap/flower/pull/1259))"
 
-#: ../../source/ref-changelog.md:498
+#: ../../source/ref-changelog.md:520
 msgid ""
 "Flower 1.9 deprecates the two (experimental) commands `flower-driver-api`"
 " and `flower-fleet-api`. Both commands will be removed in an upcoming "
 "release. Use `flower-superlink` instead."
 msgstr ""
 
-#: ../../source/ref-changelog.md:500
+#: ../../source/ref-changelog.md:522
 #, fuzzy
 msgid ""
 "**Deprecate** `--server` **in favor of** `--superlink` "
@@ -19273,14 +19392,14 @@ msgstr ""
 "**Autoriser le passage d'une **instance `Server` à** `start_simulation` "
 "([#1281](https://github.com/adap/flower/pull/1281))"
 
-#: ../../source/ref-changelog.md:502
+#: ../../source/ref-changelog.md:524
 msgid ""
 "The commands `flower-server-app` and `flower-client-app` should use "
 "`--superlink` instead of the now deprecated `--server`. Support for "
 "`--server` will be removed in a future release."
 msgstr ""
 
-#: ../../source/ref-changelog.md:506
+#: ../../source/ref-changelog.md:528
 msgid ""
 "**Replace** `flower-superlink` **CLI option** `--certificates` **with** "
 "`--ssl-ca-certfile` **,** `--ssl-certfile` **and** `--ssl-keyfile` "
@@ -19288,7 +19407,7 @@ msgid ""
 "[#3408](https://github.com/adap/flower/pull/3408))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:508
+#: ../../source/ref-changelog.md:530
 msgid ""
 "SSL-related `flower-superlink` CLI arguments were restructured in an "
 "incompatible way. Instead of passing a single `--certificates` flag with "
@@ -19298,7 +19417,7 @@ msgid ""
 "connections.html) documentation page for details."
 msgstr ""
 
-#: ../../source/ref-changelog.md:510
+#: ../../source/ref-changelog.md:532
 #, fuzzy
 msgid ""
 "**Remove SuperLink** `--vce` **option** "
@@ -19307,14 +19426,14 @@ msgstr ""
 "**Documentation restructurée** "
 "([#1387](https://github.com/adap/flower/pull/1387))"
 
-#: ../../source/ref-changelog.md:512
+#: ../../source/ref-changelog.md:534
 msgid ""
 "Instead of separately starting a SuperLink and a `ServerApp` for "
 "simulation, simulations must now be started using the single `flower-"
 "simulation` command."
 msgstr ""
 
-#: ../../source/ref-changelog.md:514
+#: ../../source/ref-changelog.md:536
 #, fuzzy
 msgid ""
 "**Merge** `--grpc-rere` **and** `--rest` **SuperLink options** "
@@ -19323,7 +19442,7 @@ msgstr ""
 "**Rename** `rnd` **to** `server_round` "
 "([#1321](https://github.com/adap/flower/pull/1321))"
 
-#: ../../source/ref-changelog.md:516
+#: ../../source/ref-changelog.md:538
 msgid ""
 "To simplify the usage of `flower-superlink`, previously separate sets of "
 "CLI options for gRPC and REST were merged into one unified set of "
@@ -19332,12 +19451,12 @@ msgid ""
 "details."
 msgstr ""
 
-#: ../../source/ref-changelog.md:518
+#: ../../source/ref-changelog.md:540
 #, fuzzy
 msgid "v1.8.0 (2024-04-03)"
 msgstr "v1.3.0 (2023-02-06)"
 
-#: ../../source/ref-changelog.md:524
+#: ../../source/ref-changelog.md:546
 msgid ""
 "`Adam Narozniak`, `Charles Beauville`, `Daniel J. Beutel`, `Daniel Nata "
 "Nugraha`, `Danny`, `Gustavo Bertoli`, `Heng Pan`, `Ikko Eltociear "
@@ -19346,7 +19465,7 @@ msgid ""
 "`tabdar-khan` <!---TOKEN_v1.8.0-->"
 msgstr ""
 
-#: ../../source/ref-changelog.md:528
+#: ../../source/ref-changelog.md:550
 msgid ""
 "**Introduce Flower Next high-level API (stable)** "
 "([#3002](https://github.com/adap/flower/pull/3002), "
@@ -19376,7 +19495,7 @@ msgid ""
 "[#3197](https://github.com/adap/flower/pull/3197))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:530
+#: ../../source/ref-changelog.md:552
 msgid ""
 "The Flower Next high-level API is stable! Flower Next is the future of "
 "Flower - all new features (like Flower Mods) will be built on top of it. "
@@ -19390,7 +19509,7 @@ msgid ""
 "projects that use `Strategy`, `NumPyClient` & co."
 msgstr ""
 
-#: ../../source/ref-changelog.md:532
+#: ../../source/ref-changelog.md:554
 #, fuzzy
 msgid ""
 "**Introduce Flower Next low-level API (preview)** "
@@ -19403,7 +19522,7 @@ msgstr ""
 "[#1286](https://github.com/adap/flower/pull/1286), "
 "[#1282](https://github.com/adap/flower/pull/1282))"
 
-#: ../../source/ref-changelog.md:534
+#: ../../source/ref-changelog.md:556
 msgid ""
 "In addition to the Flower Next *high-level* API that uses `Strategy`, "
 "`NumPyClient` & co, Flower 1.8 also comes with a preview version of the "
@@ -19420,7 +19539,7 @@ msgid ""
 "custom SMPC protocols, to name just a few."
 msgstr ""
 
-#: ../../source/ref-changelog.md:536
+#: ../../source/ref-changelog.md:558
 #, fuzzy
 msgid ""
 "**Introduce Flower Mods (preview)** "
@@ -19433,7 +19552,7 @@ msgstr ""
 "[#1544](https://github.com/adap/flower/pull/1544), "
 "[#1584](https://github.com/adap/flower/pull/1584))"
 
-#: ../../source/ref-changelog.md:538
+#: ../../source/ref-changelog.md:560
 msgid ""
 "Flower Modifiers (we call them Mods) can intercept messages and analyze, "
 "edit or handle them directly. Mods can be used to develop pluggable "
@@ -19445,7 +19564,7 @@ msgid ""
 "can already use it to experiment with arbirtrary SMPC protocols."
 msgstr ""
 
-#: ../../source/ref-changelog.md:540
+#: ../../source/ref-changelog.md:562
 #, fuzzy
 msgid ""
 "**Fine-tune LLMs with LLM FlowerTune** "
@@ -19464,7 +19583,7 @@ msgstr ""
 "[#1474](https://github.com/adap/flower/pull/1474), "
 "[#1475](https://github.com/adap/flower/pull/1475))"
 
-#: ../../source/ref-changelog.md:542
+#: ../../source/ref-changelog.md:564
 msgid ""
 "We are introducing LLM FlowerTune, an introductory example that "
 "demonstrates federated LLM fine-tuning of pre-trained Llama2 models on "
@@ -19474,7 +19593,7 @@ msgid ""
 "-llm-flowertune-federated-llm-finetuning-with-flower/) for more details."
 msgstr ""
 
-#: ../../source/ref-changelog.md:544
+#: ../../source/ref-changelog.md:566
 #, fuzzy
 msgid ""
 "**Introduce built-in Differential Privacy (preview)** "
@@ -19495,7 +19614,7 @@ msgstr ""
 "[#993](https://github.com/adap/flower/pull/993), "
 "[#994](https://github.com/adap/flower/pull/994))"
 
-#: ../../source/ref-changelog.md:546
+#: ../../source/ref-changelog.md:568
 msgid ""
 "Built-in Differential Privacy is here! Flower supports both central and "
 "local differential privacy (DP). Central DP can be configured with either"
@@ -19508,7 +19627,7 @@ msgid ""
 "/how-to-use-differential-privacy.html) in Flower."
 msgstr ""
 
-#: ../../source/ref-changelog.md:548
+#: ../../source/ref-changelog.md:570
 #, fuzzy
 msgid ""
 "**Introduce built-in Secure Aggregation (preview)** "
@@ -19521,7 +19640,7 @@ msgstr ""
 "[#1544](https://github.com/adap/flower/pull/1544), "
 "[#1584](https://github.com/adap/flower/pull/1584))"
 
-#: ../../source/ref-changelog.md:550
+#: ../../source/ref-changelog.md:572
 msgid ""
 "Built-in Secure Aggregation is here! Flower now supports different secure"
 " aggregation protocols out-of-the-box. The best part? You can add secure "
@@ -19534,7 +19653,7 @@ msgid ""
 "in the same project."
 msgstr ""
 
-#: ../../source/ref-changelog.md:552
+#: ../../source/ref-changelog.md:574
 #, fuzzy
 msgid ""
 "**Introduce** `flwr` **CLI (preview)** "
@@ -19557,13 +19676,13 @@ msgstr ""
 "[#1613](https://github.com/adap/flower/pull/1613), "
 "[#1614](https://github.com/adap/flower/pull/1614))"
 
-#: ../../source/ref-changelog.md:554
+#: ../../source/ref-changelog.md:576
 msgid ""
 "A new `flwr` CLI command allows creating new Flower projects (`flwr new`)"
 " and then running them using the Simulation Engine (`flwr run`)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:556
+#: ../../source/ref-changelog.md:578
 #, fuzzy
 msgid ""
 "**Introduce Flower Next Simulation Engine** "
@@ -19587,14 +19706,14 @@ msgstr ""
 "[#1770](https://github.com/adap/flower/pull/1770), "
 "[#1733](https://github.com/adap/flower/pull/1733))"
 
-#: ../../source/ref-changelog.md:558
+#: ../../source/ref-changelog.md:580
 msgid ""
 "The Flower Simulation Engine can now run Flower Next projects. For "
 "notebook environments, there's also a new `run_simulation` function that "
 "can run `ServerApp` and `ClientApp`."
 msgstr ""
 
-#: ../../source/ref-changelog.md:560
+#: ../../source/ref-changelog.md:582
 #, fuzzy
 msgid ""
 "**Handle SuperNode connection errors** "
@@ -19603,7 +19722,7 @@ msgstr ""
 "**Ajouter une nouvelle stratégie `FedProx`** "
 "([#1619](https://github.com/adap/flower/pull/1619))"
 
-#: ../../source/ref-changelog.md:562
+#: ../../source/ref-changelog.md:584
 msgid ""
 "A SuperNode will now try to reconnect indefinitely to the SuperLink in "
 "case of connection errors. The arguments `--max-retries` and `--max-wait-"
@@ -19614,7 +19733,7 @@ msgid ""
 "reconnect to the SuperLink."
 msgstr ""
 
-#: ../../source/ref-changelog.md:564
+#: ../../source/ref-changelog.md:586
 #, fuzzy
 msgid ""
 "**General updates to Flower Baselines** "
@@ -19629,13 +19748,13 @@ msgstr ""
 "[#1681](https://github.com/adap/flower/pull/1681), "
 "[#1679](https://github.com/adap/flower/pull/1679))"
 
-#: ../../source/ref-changelog.md:566
+#: ../../source/ref-changelog.md:588
 msgid ""
 "There's a new [FedStar](https://flower.ai/docs/baselines/fedstar.html) "
 "baseline. Several other baselined have been updated as well."
 msgstr ""
 
-#: ../../source/ref-changelog.md:568
+#: ../../source/ref-changelog.md:590
 msgid ""
 "**Improve documentation and translations** "
 "([#3050](https://github.com/adap/flower/pull/3050), "
@@ -19656,14 +19775,14 @@ msgid ""
 "[#2989](https://github.com/adap/flower/pull/2989))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:570
+#: ../../source/ref-changelog.md:592
 msgid ""
 "As usual, we merged many smaller and larger improvements to the "
 "documentation. A special thank you goes to [Sebastian van der "
 "Voort](https://github.com/svdvoort) for landing a big documentation PR!"
 msgstr ""
 
-#: ../../source/ref-changelog.md:572
+#: ../../source/ref-changelog.md:594
 #, fuzzy
 msgid ""
 "**General updates to Flower Examples** "
@@ -19690,7 +19809,7 @@ msgstr ""
 "[#1519](https://github.com/adap/flower/pull/1519), "
 "[#1515](https://github.com/adap/flower/pull/1515))"
 
-#: ../../source/ref-changelog.md:574
+#: ../../source/ref-changelog.md:596
 msgid ""
 "Two new examples show federated training of a Vision Transformer (ViT) "
 "and federated learning in a medical context using the popular MONAI "
@@ -19699,7 +19818,7 @@ msgid ""
 "received considerable updates as well."
 msgstr ""
 
-#: ../../source/ref-changelog.md:576
+#: ../../source/ref-changelog.md:598
 msgid ""
 "**General improvements** "
 "([#3171](https://github.com/adap/flower/pull/3171), "
@@ -19777,12 +19896,12 @@ msgid ""
 "[#2954](https://github.com/adap/flower/pull/2954))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:582
+#: ../../source/ref-changelog.md:604
 #, fuzzy
 msgid "v1.7.0 (2024-02-05)"
 msgstr "v1.3.0 (2023-02-06)"
 
-#: ../../source/ref-changelog.md:588
+#: ../../source/ref-changelog.md:610
 msgid ""
 "`Aasheesh Singh`, `Adam Narozniak`, `Aml Hassan Esmil`, `Charles "
 "Beauville`, `Daniel J. Beutel`, `Daniel Nata Nugraha`, `Edoardo "
@@ -19792,7 +19911,7 @@ msgid ""
 "Shaaban`, `Yan Gao`, `Yasar Abbas` <!---TOKEN_v1.7.0-->"
 msgstr ""
 
-#: ../../source/ref-changelog.md:592
+#: ../../source/ref-changelog.md:614
 #, fuzzy
 msgid ""
 "**Introduce stateful clients (experimental)** "
@@ -19809,7 +19928,7 @@ msgstr ""
 "[#993](https://github.com/adap/flower/pull/993), "
 "[#994](https://github.com/adap/flower/pull/994))"
 
-#: ../../source/ref-changelog.md:594
+#: ../../source/ref-changelog.md:616
 msgid ""
 "Subclasses of `Client` and `NumPyClient` can now store local state that "
 "remains on the client. Let's start with the highlight first: this new "
@@ -19822,7 +19941,7 @@ msgid ""
 "unified way across simulation and deployment."
 msgstr ""
 
-#: ../../source/ref-changelog.md:596
+#: ../../source/ref-changelog.md:618
 #, fuzzy
 msgid ""
 "**Improve performance** "
@@ -19831,7 +19950,7 @@ msgstr ""
 "**Supprimer les stratégies expérimentales** "
 "([#1280](https://github.com/adap/flower/pull/1280))"
 
-#: ../../source/ref-changelog.md:598
+#: ../../source/ref-changelog.md:620
 msgid ""
 "Flower is faster than ever. All `FedAvg`-derived strategies now use in-"
 "place aggregation to reduce memory consumption. The Flower client "
@@ -19840,7 +19959,7 @@ msgid ""
 "training time is short."
 msgstr ""
 
-#: ../../source/ref-changelog.md:600
+#: ../../source/ref-changelog.md:622
 #, fuzzy
 msgid ""
 "**Support Federated Learning with Apple MLX and Flower** "
@@ -19849,14 +19968,14 @@ msgstr ""
 "**Ajouter un nouvel exemple d'apprentissage fédéré utilisant fastai et "
 "Flower** ([#1598](https://github.com/adap/flower/pull/1598))"
 
-#: ../../source/ref-changelog.md:602
+#: ../../source/ref-changelog.md:624
 msgid ""
 "Flower has official support for federated learning using [Apple "
 "MLX](https://ml-explore.github.io/mlx) via the new `quickstart-mlx` code "
 "example."
 msgstr ""
 
-#: ../../source/ref-changelog.md:604
+#: ../../source/ref-changelog.md:626
 #, fuzzy
 msgid ""
 "**Introduce new XGBoost cyclic strategy** "
@@ -19867,7 +19986,7 @@ msgstr ""
 "([#1621](https://github.com/adap/flower/pull/1621), "
 "[#1764](https://github.com/adap/flower/pull/1764))"
 
-#: ../../source/ref-changelog.md:606
+#: ../../source/ref-changelog.md:628
 msgid ""
 "A new strategy called `FedXgbCyclic` supports a client-by-client style of"
 " training (often called cyclic). The `xgboost-comprehensive` code example"
@@ -19876,7 +19995,7 @@ msgid ""
 "offers best-in-class XGBoost support."
 msgstr ""
 
-#: ../../source/ref-changelog.md:608
+#: ../../source/ref-changelog.md:630
 #, fuzzy
 msgid ""
 "**Support Python 3.11** "
@@ -19885,13 +20004,13 @@ msgstr ""
 "**Support Python 3.10** "
 "([#1320](https://github.com/adap/flower/pull/1320))"
 
-#: ../../source/ref-changelog.md:610
+#: ../../source/ref-changelog.md:632
 msgid ""
 "Framework tests now run on Python 3.8, 3.9, 3.10, and 3.11. This will "
 "ensure better support for users using more recent Python versions."
 msgstr ""
 
-#: ../../source/ref-changelog.md:612
+#: ../../source/ref-changelog.md:634
 #, fuzzy
 msgid ""
 "**Update gRPC and ProtoBuf dependencies** "
@@ -19900,13 +20019,13 @@ msgstr ""
 "**Ajouter une nouvelle stratégie `FedProx`** "
 "([#1619](https://github.com/adap/flower/pull/1619))"
 
-#: ../../source/ref-changelog.md:614
+#: ../../source/ref-changelog.md:636
 msgid ""
 "The `grpcio` and `protobuf` dependencies were updated to their latest "
 "versions for improved security and performance."
 msgstr ""
 
-#: ../../source/ref-changelog.md:616
+#: ../../source/ref-changelog.md:638
 #, fuzzy
 msgid ""
 "**Introduce Docker image for Flower server** "
@@ -19927,7 +20046,7 @@ msgstr ""
 "[#993](https://github.com/adap/flower/pull/993), "
 "[#994](https://github.com/adap/flower/pull/994))"
 
-#: ../../source/ref-changelog.md:618
+#: ../../source/ref-changelog.md:640
 msgid ""
 "The Flower server can now be run using an official Docker image. A new "
 "how-to guide explains [how to run Flower using "
@@ -19935,7 +20054,7 @@ msgid ""
 "docker.html). An official Flower client Docker image will follow."
 msgstr ""
 
-#: ../../source/ref-changelog.md:620
+#: ../../source/ref-changelog.md:642
 #, fuzzy
 msgid ""
 "**Introduce** `flower-via-docker-compose` **example** "
@@ -19944,7 +20063,7 @@ msgstr ""
 "**Introduire une nouvelle ligne de base pour les fleurs : FedAvg "
 "FEMNIST** ([#1655](https://github.com/adap/flower/pull/1655))"
 
-#: ../../source/ref-changelog.md:622
+#: ../../source/ref-changelog.md:644
 #, fuzzy
 msgid ""
 "**Introduce** `quickstart-sklearn-tabular` **example** "
@@ -19953,7 +20072,7 @@ msgstr ""
 "**Ajouter une nouvelle stratégie `FedProx`** "
 "([#1619](https://github.com/adap/flower/pull/1619))"
 
-#: ../../source/ref-changelog.md:624
+#: ../../source/ref-changelog.md:646
 #, fuzzy
 msgid ""
 "**Introduce** `custom-metrics` **example** "
@@ -19962,7 +20081,7 @@ msgstr ""
 "**Ajouter une nouvelle stratégie `FedProx`** "
 "([#1619](https://github.com/adap/flower/pull/1619))"
 
-#: ../../source/ref-changelog.md:626
+#: ../../source/ref-changelog.md:648
 #, fuzzy
 msgid ""
 "**Update code examples to use Flower Datasets** "
@@ -19977,13 +20096,13 @@ msgstr ""
 "[#1301](https://github.com/adap/flower/pull/1301), "
 "[#1310](https://github.com/adap/flower/pull/1310))"
 
-#: ../../source/ref-changelog.md:628
+#: ../../source/ref-changelog.md:650
 msgid ""
 "Several code examples were updated to use [Flower "
 "Datasets](https://flower.ai/docs/datasets/)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:630
+#: ../../source/ref-changelog.md:652
 #, fuzzy
 msgid ""
 "**General updates to Flower Examples** "
@@ -20009,16 +20128,16 @@ msgstr ""
 "[#1662](https://github.com/adap/flower/pull/1662), "
 "[#1794](https://github.com/adap/flower/pull/1794))"
 
-#: ../../source/ref-changelog.md:632
+#: ../../source/ref-changelog.md:654
 msgid "Many Flower code examples received substantial updates."
 msgstr ""
 
-#: ../../source/ref-changelog.md:634 ../../source/ref-changelog.md:727
+#: ../../source/ref-changelog.md:656 ../../source/ref-changelog.md:749
 #, fuzzy
 msgid "**Update Flower Baselines**"
 msgstr "Demande pour une nouvelle Flower Baseline"
 
-#: ../../source/ref-changelog.md:636
+#: ../../source/ref-changelog.md:658
 #, fuzzy
 msgid ""
 "HFedXGBoost ([#2226](https://github.com/adap/flower/pull/2226), "
@@ -20028,38 +20147,38 @@ msgstr ""
 "([#906](https://github.com/adap/flower/pull/906), "
 "[#1143](https://github.com/adap/flower/pull/1143))"
 
-#: ../../source/ref-changelog.md:637
+#: ../../source/ref-changelog.md:659
 #, fuzzy
 msgid "FedVSSL ([#2412](https://github.com/adap/flower/pull/2412))"
 msgstr ""
 "Amélioration de la documentation sur le serveur gRPC "
 "([#841](https://github.com/adap/flower/pull/841))"
 
-#: ../../source/ref-changelog.md:638
+#: ../../source/ref-changelog.md:660
 #, fuzzy
 msgid "FedNova ([#2179](https://github.com/adap/flower/pull/2179))"
 msgstr ""
 "**Ajouter une nouvelle stratégie `FedProx`** "
 "([#1619](https://github.com/adap/flower/pull/1619))"
 
-#: ../../source/ref-changelog.md:639
+#: ../../source/ref-changelog.md:661
 #, fuzzy
 msgid "HeteroFL ([#2439](https://github.com/adap/flower/pull/2439))"
 msgstr "Nouvelle référence API ([#554](https://github.com/adap/flower/pull/554))"
 
-#: ../../source/ref-changelog.md:640
+#: ../../source/ref-changelog.md:662
 #, fuzzy
 msgid "FedAvgM ([#2246](https://github.com/adap/flower/pull/2246))"
 msgstr "Nouvelle référence API ([#554](https://github.com/adap/flower/pull/554))"
 
-#: ../../source/ref-changelog.md:641
+#: ../../source/ref-changelog.md:663
 #, fuzzy
 msgid "FedPara ([#2722](https://github.com/adap/flower/pull/2722))"
 msgstr ""
 "**Renommé stratégie q-FedAvg** "
 "([#802](https://github.com/adap/flower/pull/802))"
 
-#: ../../source/ref-changelog.md:643
+#: ../../source/ref-changelog.md:665
 #, fuzzy
 msgid ""
 "**Improve documentation** "
@@ -20079,7 +20198,7 @@ msgstr ""
 "[#1613](https://github.com/adap/flower/pull/1613), "
 "[#1614](https://github.com/adap/flower/pull/1614))"
 
-#: ../../source/ref-changelog.md:645
+#: ../../source/ref-changelog.md:667
 msgid ""
 "**Improved testing and development infrastructure** "
 "([#2797](https://github.com/adap/flower/pull/2797), "
@@ -20113,13 +20232,13 @@ msgid ""
 "[#2398](https://github.com/adap/flower/pull/2398))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:647
+#: ../../source/ref-changelog.md:669
 msgid ""
 "The Flower testing and development infrastructure has received "
 "substantial updates. This makes Flower 1.7 the most tested release ever."
 msgstr ""
 
-#: ../../source/ref-changelog.md:649
+#: ../../source/ref-changelog.md:671
 msgid ""
 "**Update dependencies** "
 "([#2753](https://github.com/adap/flower/pull/2753), "
@@ -20143,7 +20262,7 @@ msgid ""
 "[#2789](https://github.com/adap/flower/pull/2789))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:651
+#: ../../source/ref-changelog.md:673
 msgid ""
 "**General improvements** "
 "([#2803](https://github.com/adap/flower/pull/2803), "
@@ -20184,7 +20303,7 @@ msgid ""
 "[#2759](https://github.com/adap/flower/pull/2759))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:655
+#: ../../source/ref-changelog.md:677
 #, fuzzy
 msgid ""
 "**Deprecate** `start_numpy_client` "
@@ -20195,7 +20314,7 @@ msgstr ""
 "([#828](https://github.com/adap/flower/pull/828) "
 "[#822](https://github.com/adap/flower/pull/822))"
 
-#: ../../source/ref-changelog.md:657
+#: ../../source/ref-changelog.md:679
 msgid ""
 "Until now, clients of type `NumPyClient` needed to be started via "
 "`start_numpy_client`. In our efforts to consolidate framework APIs, we "
@@ -20206,7 +20325,7 @@ msgid ""
 "updated accordingly."
 msgstr ""
 
-#: ../../source/ref-changelog.md:659
+#: ../../source/ref-changelog.md:681
 #, fuzzy
 msgid ""
 "**Deprecate legacy DP wrappers** "
@@ -20215,14 +20334,14 @@ msgstr ""
 "**Supprimez KerasClient** "
 "([#857](https://github.com/adap/flower/pull/857))"
 
-#: ../../source/ref-changelog.md:661
+#: ../../source/ref-changelog.md:683
 msgid ""
 "Legacy DP wrapper classes are deprecated, but still functional. This is "
 "in preparation for an all-new pluggable version of differential privacy "
 "support in Flower."
 msgstr ""
 
-#: ../../source/ref-changelog.md:663
+#: ../../source/ref-changelog.md:685
 #, fuzzy
 msgid ""
 "**Make optional arg** `--callable` **in** `flower-client` **a required "
@@ -20231,7 +20350,7 @@ msgstr ""
 "**Log** `Client` **exceptions dans le moteur de client virtuel** "
 "([#1493](https://github.com/adap/flower/pull/1493))"
 
-#: ../../source/ref-changelog.md:665
+#: ../../source/ref-changelog.md:687
 #, fuzzy
 msgid ""
 "**Rename** `certificates` **to** `root_certificates` **in** `Driver` "
@@ -20240,7 +20359,7 @@ msgstr ""
 "**Rename** `rnd` **to** `server_round` "
 "([#1321](https://github.com/adap/flower/pull/1321))"
 
-#: ../../source/ref-changelog.md:667
+#: ../../source/ref-changelog.md:689
 #, fuzzy
 msgid ""
 "**Drop experimental** `Task` **fields** "
@@ -20251,14 +20370,14 @@ msgstr ""
 "([#1258](https://github.com/adap/flower/pull/1258), "
 "[#1259](https://github.com/adap/flower/pull/1259))"
 
-#: ../../source/ref-changelog.md:669
+#: ../../source/ref-changelog.md:691
 msgid ""
 "Experimental fields `sa`, `legacy_server_message` and "
 "`legacy_client_message` were removed from `Task` message. The removed "
 "fields are superseded by the new `RecordSet` abstraction."
 msgstr ""
 
-#: ../../source/ref-changelog.md:671
+#: ../../source/ref-changelog.md:693
 #, fuzzy
 msgid ""
 "**Retire MXNet examples** "
@@ -20267,19 +20386,19 @@ msgstr ""
 "**Nouvel exemple de code scikit-learn** "
 "([#748](https://github.com/adap/flower/pull/748))"
 
-#: ../../source/ref-changelog.md:673
+#: ../../source/ref-changelog.md:695
 msgid ""
 "The development of the MXNet fremework has ended and the project is now "
 "[archived on GitHub](https://github.com/apache/mxnet). Existing MXNet "
 "examples won't receive updates."
 msgstr ""
 
-#: ../../source/ref-changelog.md:675
+#: ../../source/ref-changelog.md:697
 #, fuzzy
 msgid "v1.6.0 (2023-11-28)"
 msgstr "v1.4.0 (2023-04-21)"
 
-#: ../../source/ref-changelog.md:681
+#: ../../source/ref-changelog.md:703
 msgid ""
 "`Aashish Kolluri`, `Adam Narozniak`, `Alessio Mora`, `Barathwaja S`, "
 "`Charles Beauville`, `Daniel J. Beutel`, `Daniel Nata Nugraha`, `Gabriel "
@@ -20289,7 +20408,7 @@ msgid ""
 "`cnxdeveloper`, `k3nfalt` <!---TOKEN_v1.6.0-->"
 msgstr ""
 
-#: ../../source/ref-changelog.md:685
+#: ../../source/ref-changelog.md:707
 #, fuzzy
 msgid ""
 "**Add experimental support for Python 3.12** "
@@ -20298,7 +20417,7 @@ msgstr ""
 "**Ajouter la prise en charge expérimentale de Python 3.10 et Python "
 "3.11** ([#1135](https://github.com/adap/flower/pull/1135))"
 
-#: ../../source/ref-changelog.md:687
+#: ../../source/ref-changelog.md:709
 #, fuzzy
 msgid ""
 "**Add new XGBoost examples** "
@@ -20317,13 +20436,13 @@ msgstr ""
 "[#1551](https://github.com/adap/flower/pull/1551), "
 "[#1567](https://github.com/adap/flower/pull/1567))"
 
-#: ../../source/ref-changelog.md:689
+#: ../../source/ref-changelog.md:711
 msgid ""
 "We have added a new `xgboost-quickstart` example alongside a new "
 "`xgboost-comprehensive` example that goes more in-depth."
 msgstr ""
 
-#: ../../source/ref-changelog.md:691
+#: ../../source/ref-changelog.md:713
 #, fuzzy
 msgid ""
 "**Add Vertical FL example** "
@@ -20332,7 +20451,7 @@ msgstr ""
 "**Nouvel exemple de code CoreML pour iOS** "
 "([#1289](https://github.com/adap/flower/pull/1289))"
 
-#: ../../source/ref-changelog.md:693
+#: ../../source/ref-changelog.md:715
 msgid ""
 "We had many questions about Vertical Federated Learning using Flower, so "
 "we decided to add an simple example for it on the [Titanic "
@@ -20340,7 +20459,7 @@ msgid ""
 "tutorial (in the README)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:695
+#: ../../source/ref-changelog.md:717
 #, fuzzy
 msgid ""
 "**Support custom** `ClientManager` **in** `start_driver()` "
@@ -20350,7 +20469,7 @@ msgstr ""
 "paramètre de `start_simulation` "
 "([#1171](https://github.com/adap/flower/pull/1171))"
 
-#: ../../source/ref-changelog.md:697
+#: ../../source/ref-changelog.md:719
 #, fuzzy
 msgid ""
 "**Update REST API to support create and delete nodes** "
@@ -20359,7 +20478,7 @@ msgstr ""
 "**Nouvelle stratégie expérimentale TensorBoard** "
 "([#789](https://github.com/adap/flower/pull/789))"
 
-#: ../../source/ref-changelog.md:699
+#: ../../source/ref-changelog.md:721
 #, fuzzy
 msgid ""
 "**Update the Android SDK** "
@@ -20368,11 +20487,11 @@ msgstr ""
 "**Introduire une nouvelle ligne de base pour les fleurs : FedAvg "
 "FEMNIST** ([#1655](https://github.com/adap/flower/pull/1655))"
 
-#: ../../source/ref-changelog.md:701
+#: ../../source/ref-changelog.md:723
 msgid "Add gRPC request-response capability to the Android SDK."
 msgstr ""
 
-#: ../../source/ref-changelog.md:703
+#: ../../source/ref-changelog.md:725
 #, fuzzy
 msgid ""
 "**Update the C++ SDK** "
@@ -20387,11 +20506,11 @@ msgstr ""
 "[#1301](https://github.com/adap/flower/pull/1301), "
 "[#1310](https://github.com/adap/flower/pull/1310))"
 
-#: ../../source/ref-changelog.md:705
+#: ../../source/ref-changelog.md:727
 msgid "Add gRPC request-response capability to the C++ SDK."
 msgstr ""
 
-#: ../../source/ref-changelog.md:707
+#: ../../source/ref-changelog.md:729
 #, fuzzy
 msgid ""
 "**Make HTTPS the new default** "
@@ -20402,7 +20521,7 @@ msgstr ""
 "([#1344](https://github.com/adap/flower/pull/1344), "
 "[#1347](https://github.com/adap/flower/pull/1347))"
 
-#: ../../source/ref-changelog.md:709
+#: ../../source/ref-changelog.md:731
 msgid ""
 "Flower is moving to HTTPS by default. The new `flower-server` requires "
 "passing `--certificates`, but users can enable `--insecure` to use HTTP "
@@ -20412,14 +20531,14 @@ msgid ""
 "enable insecure HTTP connections."
 msgstr ""
 
-#: ../../source/ref-changelog.md:711
+#: ../../source/ref-changelog.md:733
 msgid ""
 "For backward compatibility, `start_client()` and `start_numpy_client()` "
 "will still start in insecure mode by default. In a future release, "
 "insecure connections will require user opt-in by passing `insecure=True`."
 msgstr ""
 
-#: ../../source/ref-changelog.md:713
+#: ../../source/ref-changelog.md:735
 #, fuzzy
 msgid ""
 "**Unify client API** ([#2303](https://github.com/adap/flower/pull/2303), "
@@ -20431,7 +20550,7 @@ msgstr ""
 "[#1286](https://github.com/adap/flower/pull/1286), "
 "[#1282](https://github.com/adap/flower/pull/1282))"
 
-#: ../../source/ref-changelog.md:715
+#: ../../source/ref-changelog.md:737
 msgid ""
 "Using the `client_fn`, Flower clients can interchangeably run as "
 "standalone processes (i.e. via `start_client`) or in simulation (i.e. via"
@@ -20440,7 +20559,7 @@ msgid ""
 "convert a `NumPyClient` to a `Client`."
 msgstr ""
 
-#: ../../source/ref-changelog.md:717
+#: ../../source/ref-changelog.md:739
 #, fuzzy
 msgid ""
 "**Add new** `Bulyan` **strategy** "
@@ -20451,7 +20570,7 @@ msgstr ""
 "([#828](https://github.com/adap/flower/pull/828) "
 "[#822](https://github.com/adap/flower/pull/822))"
 
-#: ../../source/ref-changelog.md:719
+#: ../../source/ref-changelog.md:741
 #, fuzzy
 msgid ""
 "The new `Bulyan` strategy implements Bulyan by [El Mhamdi et al., "
@@ -20461,7 +20580,7 @@ msgstr ""
 "(FedMedian) par [Yin et al., 2018] "
 "(https://arxiv.org/pdf/1803.01498v1.pdf)."
 
-#: ../../source/ref-changelog.md:721
+#: ../../source/ref-changelog.md:743
 #, fuzzy
 msgid ""
 "**Add new** `XGB Bagging` **strategy** "
@@ -20470,7 +20589,7 @@ msgstr ""
 "**Ajouter une nouvelle stratégie `FedProx`** "
 "([#1619](https://github.com/adap/flower/pull/1619))"
 
-#: ../../source/ref-changelog.md:723 ../../source/ref-changelog.md:725
+#: ../../source/ref-changelog.md:745 ../../source/ref-changelog.md:747
 #, fuzzy
 msgid ""
 "**Introduce `WorkloadState`** "
@@ -20481,7 +20600,7 @@ msgstr ""
 "([#828](https://github.com/adap/flower/pull/828) "
 "[#822](https://github.com/adap/flower/pull/822))"
 
-#: ../../source/ref-changelog.md:729
+#: ../../source/ref-changelog.md:751
 #, fuzzy
 msgid ""
 "FedProx ([#2210](https://github.com/adap/flower/pull/2210), "
@@ -20493,7 +20612,7 @@ msgstr ""
 "[#1286](https://github.com/adap/flower/pull/1286), "
 "[#1282](https://github.com/adap/flower/pull/1282))"
 
-#: ../../source/ref-changelog.md:731
+#: ../../source/ref-changelog.md:753
 #, fuzzy
 msgid ""
 "Baselines Docs ([#2290](https://github.com/adap/flower/pull/2290), "
@@ -20503,7 +20622,7 @@ msgstr ""
 "([#906](https://github.com/adap/flower/pull/906), "
 "[#1143](https://github.com/adap/flower/pull/1143))"
 
-#: ../../source/ref-changelog.md:733
+#: ../../source/ref-changelog.md:755
 #, fuzzy
 msgid ""
 "FedMLB ([#2340](https://github.com/adap/flower/pull/2340), "
@@ -20513,7 +20632,7 @@ msgstr ""
 "([#1344](https://github.com/adap/flower/pull/1344), "
 "[#1347](https://github.com/adap/flower/pull/1347))"
 
-#: ../../source/ref-changelog.md:735
+#: ../../source/ref-changelog.md:757
 #, fuzzy
 msgid ""
 "TAMUNA ([#2254](https://github.com/adap/flower/pull/2254), "
@@ -20523,48 +20642,48 @@ msgstr ""
 "([#828](https://github.com/adap/flower/pull/828) "
 "[#822](https://github.com/adap/flower/pull/822))"
 
-#: ../../source/ref-changelog.md:737
+#: ../../source/ref-changelog.md:759
 #, fuzzy
 msgid "FedMeta [#2438](https://github.com/adap/flower/pull/2438)"
 msgstr "Nouvelle référence API ([#554](https://github.com/adap/flower/pull/554))"
 
-#: ../../source/ref-changelog.md:739
+#: ../../source/ref-changelog.md:761
 #, fuzzy
 msgid "FjORD [#2431](https://github.com/adap/flower/pull/2431)"
 msgstr ""
 "Amélioration de la documentation sur le serveur gRPC "
 "([#841](https://github.com/adap/flower/pull/841))"
 
-#: ../../source/ref-changelog.md:741
+#: ../../source/ref-changelog.md:763
 #, fuzzy
 msgid "MOON [#2421](https://github.com/adap/flower/pull/2421)"
 msgstr ""
 "**Ajouter une nouvelle stratégie `FedProx`** "
 "([#1619](https://github.com/adap/flower/pull/1619))"
 
-#: ../../source/ref-changelog.md:743
+#: ../../source/ref-changelog.md:765
 #, fuzzy
 msgid "DepthFL [#2295](https://github.com/adap/flower/pull/2295)"
 msgstr ""
 "**Ajouter une nouvelle stratégie `FedProx`** "
 "([#1619](https://github.com/adap/flower/pull/1619))"
 
-#: ../../source/ref-changelog.md:745
+#: ../../source/ref-changelog.md:767
 #, fuzzy
 msgid "FedPer [#2266](https://github.com/adap/flower/pull/2266)"
 msgstr "Nouvelle référence API ([#554](https://github.com/adap/flower/pull/554))"
 
-#: ../../source/ref-changelog.md:747
+#: ../../source/ref-changelog.md:769
 #, fuzzy
 msgid "FedWav2vec [#2551](https://github.com/adap/flower/pull/2551)"
 msgstr "Nouvelle référence API ([#554](https://github.com/adap/flower/pull/554))"
 
-#: ../../source/ref-changelog.md:749
+#: ../../source/ref-changelog.md:771
 #, fuzzy
 msgid "niid-Bench [#2428](https://github.com/adap/flower/pull/2428)"
 msgstr "Nouvelle référence API ([#554](https://github.com/adap/flower/pull/554))"
 
-#: ../../source/ref-changelog.md:751
+#: ../../source/ref-changelog.md:773
 #, fuzzy
 msgid ""
 "FedBN ([#2608](https://github.com/adap/flower/pull/2608), "
@@ -20574,7 +20693,7 @@ msgstr ""
 "([#828](https://github.com/adap/flower/pull/828) "
 "[#822](https://github.com/adap/flower/pull/822))"
 
-#: ../../source/ref-changelog.md:753
+#: ../../source/ref-changelog.md:775
 #, fuzzy
 msgid ""
 "**General updates to Flower Examples** "
@@ -20590,7 +20709,7 @@ msgstr ""
 "[#1301](https://github.com/adap/flower/pull/1301), "
 "[#1310](https://github.com/adap/flower/pull/1310))"
 
-#: ../../source/ref-changelog.md:755
+#: ../../source/ref-changelog.md:777
 #, fuzzy
 msgid ""
 "**General updates to Flower Baselines** "
@@ -20623,7 +20742,7 @@ msgstr ""
 "[#1564](https://github.com/adap/flower/pull/1564), "
 "[#1566](https://github.com/adap/flower/pull/1566))"
 
-#: ../../source/ref-changelog.md:757
+#: ../../source/ref-changelog.md:779
 #, fuzzy
 msgid ""
 "**General updates to the simulation engine** "
@@ -20638,7 +20757,7 @@ msgstr ""
 "[#1301](https://github.com/adap/flower/pull/1301), "
 "[#1310](https://github.com/adap/flower/pull/1310))"
 
-#: ../../source/ref-changelog.md:759
+#: ../../source/ref-changelog.md:781
 #, fuzzy
 msgid ""
 "**General updates to Flower SDKs** "
@@ -20657,7 +20776,7 @@ msgstr ""
 "[#1474](https://github.com/adap/flower/pull/1474), "
 "[#1475](https://github.com/adap/flower/pull/1475))"
 
-#: ../../source/ref-changelog.md:761
+#: ../../source/ref-changelog.md:783
 msgid ""
 "**General improvements** "
 "([#2309](https://github.com/adap/flower/pull/2309), "
@@ -20689,15 +20808,15 @@ msgid ""
 "[#2596](https://github.com/adap/flower/pull/2596))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:763 ../../source/ref-changelog.md:853
-#: ../../source/ref-changelog.md:917 ../../source/ref-changelog.md:971
-#: ../../source/ref-changelog.md:1038
+#: ../../source/ref-changelog.md:785 ../../source/ref-changelog.md:875
+#: ../../source/ref-changelog.md:939 ../../source/ref-changelog.md:993
+#: ../../source/ref-changelog.md:1060
 msgid "Flower received many improvements under the hood, too many to list here."
 msgstr ""
 "Flower a reçu de nombreuses améliorations sous le capot, trop nombreuses "
 "pour être énumérées ici."
 
-#: ../../source/ref-changelog.md:767
+#: ../../source/ref-changelog.md:789
 #, fuzzy
 msgid ""
 "**Remove support for Python 3.7** "
@@ -20714,13 +20833,13 @@ msgstr ""
 "[#1065](https://github.com/adap/flower/pull/1065), "
 "[#1090](https://github.com/adap/flower/pull/1090))"
 
-#: ../../source/ref-changelog.md:769
+#: ../../source/ref-changelog.md:791
 msgid ""
 "Python 3.7 support was deprecated in Flower 1.5, and this release removes"
 " support. Flower now requires Python 3.8."
 msgstr ""
 
-#: ../../source/ref-changelog.md:771
+#: ../../source/ref-changelog.md:793
 #, fuzzy
 msgid ""
 "**Remove experimental argument** `rest` **from** `start_client` "
@@ -20729,19 +20848,19 @@ msgstr ""
 "**Supprimer les stratégies expérimentales** "
 "([#1280](https://github.com/adap/flower/pull/1280))"
 
-#: ../../source/ref-changelog.md:773
+#: ../../source/ref-changelog.md:795
 msgid ""
 "The (still experimental) argument `rest` was removed from `start_client` "
 "and `start_numpy_client`. Use `transport=\"rest\"` to opt into the "
 "experimental REST API instead."
 msgstr ""
 
-#: ../../source/ref-changelog.md:775
+#: ../../source/ref-changelog.md:797
 #, fuzzy
 msgid "v1.5.0 (2023-08-31)"
 msgstr "v1.4.0 (2023-04-21)"
 
-#: ../../source/ref-changelog.md:781
+#: ../../source/ref-changelog.md:803
 msgid ""
 "`Adam Narozniak`, `Anass Anhari`, `Charles Beauville`, `Dana-Farber`, "
 "`Daniel J. Beutel`, `Daniel Nata Nugraha`, `Edoardo Gabrielli`, `Gustavo "
@@ -20750,7 +20869,7 @@ msgid ""
 "TOKEN_v1.5.0-->"
 msgstr ""
 
-#: ../../source/ref-changelog.md:785
+#: ../../source/ref-changelog.md:807
 #, fuzzy
 msgid ""
 "**Introduce new simulation engine** "
@@ -20763,7 +20882,7 @@ msgstr ""
 "[#1544](https://github.com/adap/flower/pull/1544), "
 "[#1584](https://github.com/adap/flower/pull/1584))"
 
-#: ../../source/ref-changelog.md:787
+#: ../../source/ref-changelog.md:809
 msgid ""
 "The new simulation engine has been rewritten from the ground up, yet it "
 "remains fully backwards compatible. It offers much improved stability and"
@@ -20772,7 +20891,7 @@ msgid ""
 "only, CPU+GPU, multi-GPU, or multi-node multi-GPU environments."
 msgstr ""
 
-#: ../../source/ref-changelog.md:789
+#: ../../source/ref-changelog.md:811
 msgid ""
 "Comprehensive documentation includes a new [how-to run "
 "simulations](https://flower.ai/docs/framework/how-to-run-"
@@ -20783,7 +20902,7 @@ msgid ""
 "series](https://www.youtube.com/watch?v=cRebUIGB5RU&list=PLNG4feLHqCWlnj8a_E1A_n5zr2-8pafTB)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:791
+#: ../../source/ref-changelog.md:813
 msgid ""
 "**Restructure Flower Docs** "
 "([#1824](https://github.com/adap/flower/pull/1824), "
@@ -20815,7 +20934,7 @@ msgid ""
 "[#2227](https://github.com/adap/flower/pull/2227))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:793
+#: ../../source/ref-changelog.md:815
 msgid ""
 "Much effort went into a completely restructured Flower docs experience. "
 "The documentation on [flower.ai/docs](https://flower.ai/docs) is now "
@@ -20823,7 +20942,7 @@ msgid ""
 "Flower iOS SDK, and code example projects."
 msgstr ""
 
-#: ../../source/ref-changelog.md:795
+#: ../../source/ref-changelog.md:817
 #, fuzzy
 msgid ""
 "**Introduce Flower Swift SDK** "
@@ -20834,14 +20953,14 @@ msgstr ""
 "([#1621](https://github.com/adap/flower/pull/1621), "
 "[#1764](https://github.com/adap/flower/pull/1764))"
 
-#: ../../source/ref-changelog.md:797
+#: ../../source/ref-changelog.md:819
 msgid ""
 "This is the first preview release of the Flower Swift SDK. Flower support"
 " on iOS is improving, and alongside the Swift SDK and code example, there"
 " is now also an iOS quickstart tutorial."
 msgstr ""
 
-#: ../../source/ref-changelog.md:799
+#: ../../source/ref-changelog.md:821
 #, fuzzy
 msgid ""
 "**Introduce Flower Android SDK** "
@@ -20850,14 +20969,14 @@ msgstr ""
 "**Introduire une nouvelle ligne de base pour les fleurs : FedAvg "
 "FEMNIST** ([#1655](https://github.com/adap/flower/pull/1655))"
 
-#: ../../source/ref-changelog.md:801
+#: ../../source/ref-changelog.md:823
 msgid ""
 "This is the first preview release of the Flower Kotlin SDK. Flower "
 "support on Android is improving, and alongside the Kotlin SDK and code "
 "example, there is now also an Android quickstart tutorial."
 msgstr ""
 
-#: ../../source/ref-changelog.md:803
+#: ../../source/ref-changelog.md:825
 #, fuzzy
 msgid ""
 "**Introduce new end-to-end testing infrastructure** "
@@ -20890,24 +21009,24 @@ msgstr ""
 "[#1662](https://github.com/adap/flower/pull/1662), "
 "[#1794](https://github.com/adap/flower/pull/1794))"
 
-#: ../../source/ref-changelog.md:805
+#: ../../source/ref-changelog.md:827
 msgid ""
 "A new testing infrastructure ensures that new changes stay compatible "
 "with existing framework integrations or strategies."
 msgstr ""
 
-#: ../../source/ref-changelog.md:807
+#: ../../source/ref-changelog.md:829
 #, fuzzy
 msgid "**Deprecate Python 3.7**"
 msgstr "**Créer le PR**"
 
-#: ../../source/ref-changelog.md:809
+#: ../../source/ref-changelog.md:831
 msgid ""
 "Since Python 3.7 reached its end of life (EOL) on 2023-06-27, support for"
 " Python 3.7 is now deprecated and will be removed in an upcoming release."
 msgstr ""
 
-#: ../../source/ref-changelog.md:811
+#: ../../source/ref-changelog.md:833
 #, fuzzy
 msgid ""
 "**Add new** `FedTrimmedAvg` **strategy** "
@@ -20918,7 +21037,7 @@ msgstr ""
 "([#1469](https://github.com/adap/flower/pull/1469), "
 "[#1535](https://github.com/adap/flower/pull/1535))"
 
-#: ../../source/ref-changelog.md:813
+#: ../../source/ref-changelog.md:835
 #, fuzzy
 msgid ""
 "The new `FedTrimmedAvg` strategy implements Trimmed Mean by [Dong Yin, "
@@ -20928,7 +21047,7 @@ msgstr ""
 "(FedMedian) par [Yin et al., 2018] "
 "(https://arxiv.org/pdf/1803.01498v1.pdf)."
 
-#: ../../source/ref-changelog.md:815
+#: ../../source/ref-changelog.md:837
 #, fuzzy
 msgid ""
 "**Introduce start_driver** "
@@ -20937,7 +21056,7 @@ msgstr ""
 "**Ajouter une nouvelle stratégie `FedProx`** "
 "([#1619](https://github.com/adap/flower/pull/1619))"
 
-#: ../../source/ref-changelog.md:817
+#: ../../source/ref-changelog.md:839
 msgid ""
 "In addition to `start_server` and using the raw Driver API, there is a "
 "new `start_driver` function that allows for running `start_server` "
@@ -20946,7 +21065,7 @@ msgid ""
 "`start_driver`."
 msgstr ""
 
-#: ../../source/ref-changelog.md:819
+#: ../../source/ref-changelog.md:841
 #, fuzzy
 msgid ""
 "**Add parameter aggregation to** `mt-pytorch` **code example** "
@@ -20955,7 +21074,7 @@ msgstr ""
 "**Nouvel exemple de code PyTorch avancé** "
 "([#1007](https://github.com/adap/flower/pull/1007))"
 
-#: ../../source/ref-changelog.md:821
+#: ../../source/ref-changelog.md:843
 msgid ""
 "The `mt-pytorch` example shows how to aggregate parameters when writing a"
 " driver script. The included `driver.py` and `server.py` have been "
@@ -20963,7 +21082,7 @@ msgid ""
 "building server-side logic."
 msgstr ""
 
-#: ../../source/ref-changelog.md:823
+#: ../../source/ref-changelog.md:845
 #, fuzzy
 msgid ""
 "**Migrate experimental REST API to Starlette** "
@@ -20972,14 +21091,14 @@ msgstr ""
 "**Nouvelle stratégie expérimentale TensorBoard** "
 "([#789](https://github.com/adap/flower/pull/789))"
 
-#: ../../source/ref-changelog.md:825
+#: ../../source/ref-changelog.md:847
 msgid ""
 "The (experimental) REST API used to be implemented in "
 "[FastAPI](https://fastapi.tiangolo.com/), but it has now been migrated to"
 " use [Starlette](https://www.starlette.io/) directly."
 msgstr ""
 
-#: ../../source/ref-changelog.md:827
+#: ../../source/ref-changelog.md:849
 #, fuzzy
 msgid ""
 "Please note: The REST request-response API is still experimental and will"
@@ -20988,7 +21107,7 @@ msgstr ""
 "Remarque : l'API REST est encore expérimentale et est susceptible de "
 "changer de manière significative au fil du temps."
 
-#: ../../source/ref-changelog.md:829
+#: ../../source/ref-changelog.md:851
 #, fuzzy
 msgid ""
 "**Introduce experimental gRPC request-response API** "
@@ -20999,14 +21118,14 @@ msgstr ""
 "([#1357](https://github.com/adap/flower/pull/1357), "
 "[#1460](https://github.com/adap/flower/pull/1460))"
 
-#: ../../source/ref-changelog.md:831
+#: ../../source/ref-changelog.md:853
 msgid ""
 "In addition to the existing gRPC API (based on bidirectional streaming) "
 "and the experimental REST API, there is now a new gRPC API that uses a "
 "request-response model to communicate with client nodes."
 msgstr ""
 
-#: ../../source/ref-changelog.md:833
+#: ../../source/ref-changelog.md:855
 #, fuzzy
 msgid ""
 "Please note: The gRPC request-response API is still experimental and will"
@@ -21015,7 +21134,7 @@ msgstr ""
 "Remarque : l'API REST est encore expérimentale et est susceptible de "
 "changer de manière significative au fil du temps."
 
-#: ../../source/ref-changelog.md:835
+#: ../../source/ref-changelog.md:857
 #, fuzzy
 msgid ""
 "**Replace the experimental** `start_client(rest=True)` **with the new** "
@@ -21025,7 +21144,7 @@ msgstr ""
 "**Initialise** `start_simulation` **avec une liste d'ID de clients** "
 "([#860](https://github.com/adap/flower/pull/860))"
 
-#: ../../source/ref-changelog.md:837
+#: ../../source/ref-changelog.md:859
 msgid ""
 "The (experimental) `start_client` argument `rest` was deprecated in "
 "favour of a new argument `transport`. `start_client(transport=\"rest\")` "
@@ -21034,7 +21153,7 @@ msgid ""
 "argument `rest` will be removed in a future release."
 msgstr ""
 
-#: ../../source/ref-changelog.md:839
+#: ../../source/ref-changelog.md:861
 #, fuzzy
 msgid ""
 "**Add a new gRPC option** "
@@ -21043,14 +21162,14 @@ msgstr ""
 "**Ajouter une nouvelle stratégie `FedProx`** "
 "([#1619](https://github.com/adap/flower/pull/1619))"
 
-#: ../../source/ref-changelog.md:841
+#: ../../source/ref-changelog.md:863
 msgid ""
 "We now start a gRPC server with the `grpc.keepalive_permit_without_calls`"
 " option set to 0 by default. This prevents the clients from sending "
 "keepalive pings when there is no outstanding stream."
 msgstr ""
 
-#: ../../source/ref-changelog.md:843
+#: ../../source/ref-changelog.md:865
 #, fuzzy
 msgid ""
 "**Improve example notebooks** "
@@ -21059,12 +21178,12 @@ msgstr ""
 "**Supprimer les stratégies expérimentales** "
 "([#1280](https://github.com/adap/flower/pull/1280))"
 
-#: ../../source/ref-changelog.md:845
+#: ../../source/ref-changelog.md:867
 #, fuzzy
 msgid "There's a new 30min Federated Learning PyTorch tutorial!"
 msgstr "Bienvenue au tutoriel sur l'apprentissage fédéré de la fleur !"
 
-#: ../../source/ref-changelog.md:847
+#: ../../source/ref-changelog.md:869
 msgid ""
 "**Example updates** ([#1772](https://github.com/adap/flower/pull/1772), "
 "[#1873](https://github.com/adap/flower/pull/1873), "
@@ -21079,7 +21198,7 @@ msgid ""
 "[#2183](https://github.com/adap/flower/pull/2183))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:849
+#: ../../source/ref-changelog.md:871
 msgid ""
 "Many examples have received significant updates, including simplified "
 "advanced-tensorflow and advanced-pytorch examples, improved macOS "
@@ -21088,7 +21207,7 @@ msgid ""
 "(in addition to `pyproject.toml`)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:851
+#: ../../source/ref-changelog.md:873
 #, fuzzy
 msgid ""
 "**General improvements** "
@@ -21108,11 +21227,11 @@ msgstr ""
 "[#1613](https://github.com/adap/flower/pull/1613), "
 "[#1614](https://github.com/adap/flower/pull/1614))"
 
-#: ../../source/ref-changelog.md:859
+#: ../../source/ref-changelog.md:881
 msgid "v1.4.0 (2023-04-21)"
 msgstr "v1.4.0 (2023-04-21)"
 
-#: ../../source/ref-changelog.md:865
+#: ../../source/ref-changelog.md:887
 msgid ""
 "`Adam Narozniak`, `Alexander Viala Bellander`, `Charles Beauville`, "
 "`Chenyang Ma (Danny)`, `Daniel J. Beutel`, `Edoardo`, `Gautam Jajoo`, "
@@ -21128,7 +21247,7 @@ msgstr ""
 "Lane`, `Nikolaos Episkopos`, `Ragy`, `Saurav Maheshkar`, `Semo Yang`, "
 "`Steve Laskaridis`, `Steven Hé (Sīchàng)`, `Taner Topal`"
 
-#: ../../source/ref-changelog.md:869
+#: ../../source/ref-changelog.md:891
 msgid ""
 "**Introduce support for XGBoost (**`FedXgbNnAvg` **strategy and "
 "example)** ([#1694](https://github.com/adap/flower/pull/1694), "
@@ -21146,7 +21265,7 @@ msgstr ""
 "[#1763](https://github.com/adap/flower/pull/1763), "
 "[#1795](https://github.com/adap/flower/pull/1795))"
 
-#: ../../source/ref-changelog.md:871
+#: ../../source/ref-changelog.md:893
 msgid ""
 "XGBoost is a tree-based ensemble machine learning algorithm that uses "
 "gradient boosting to improve model accuracy. We added a new `FedXgbNnAvg`"
@@ -21163,7 +21282,7 @@ msgstr ""
 "qui démontre l'utilisation de cette nouvelle stratégie dans un projet "
 "XGBoost."
 
-#: ../../source/ref-changelog.md:873
+#: ../../source/ref-changelog.md:895
 msgid ""
 "**Introduce iOS SDK (preview)** "
 "([#1621](https://github.com/adap/flower/pull/1621), "
@@ -21173,7 +21292,7 @@ msgstr ""
 "([#1621](https://github.com/adap/flower/pull/1621), "
 "[#1764](https://github.com/adap/flower/pull/1764))"
 
-#: ../../source/ref-changelog.md:875
+#: ../../source/ref-changelog.md:897
 msgid ""
 "This is a major update for anyone wanting to implement Federated Learning"
 " on iOS mobile devices. We now have a swift iOS SDK present under "
@@ -21192,7 +21311,7 @@ msgstr ""
 "iOS](https://github.com/adap/flower/tree/main/examples/ios) a également "
 "été mis à jour !"
 
-#: ../../source/ref-changelog.md:877
+#: ../../source/ref-changelog.md:899
 msgid ""
 "**Introduce new \"What is Federated Learning?\" tutorial** "
 "([#1657](https://github.com/adap/flower/pull/1657), "
@@ -21202,7 +21321,7 @@ msgstr ""
 " \"** ([#1657](https://github.com/adap/flower/pull/1657), "
 "[#1721](https://github.com/adap/flower/pull/1721))"
 
-#: ../../source/ref-changelog.md:879
+#: ../../source/ref-changelog.md:901
 #, fuzzy
 msgid ""
 "A new [entry-level tutorial](https://flower.ai/docs/framework/tutorial-"
@@ -21218,7 +21337,7 @@ msgstr ""
 " voyage avec Flower. Fais-le suivre à tous ceux qui s'intéressent à "
 "l'apprentissage fédéré !"
 
-#: ../../source/ref-changelog.md:881
+#: ../../source/ref-changelog.md:903
 msgid ""
 "**Introduce new Flower Baseline: FedProx MNIST** "
 "([#1513](https://github.com/adap/flower/pull/1513), "
@@ -21232,7 +21351,7 @@ msgstr ""
 "[#1681](https://github.com/adap/flower/pull/1681), "
 "[#1679](https://github.com/adap/flower/pull/1679))"
 
-#: ../../source/ref-changelog.md:883
+#: ../../source/ref-changelog.md:905
 msgid ""
 "This new baseline replicates the MNIST+CNN task from the paper [Federated"
 " Optimization in Heterogeneous Networks (Li et al., "
@@ -21245,7 +21364,7 @@ msgstr ""
 "qui vise à rendre la convergence plus robuste dans des contextes "
 "hétérogènes."
 
-#: ../../source/ref-changelog.md:885
+#: ../../source/ref-changelog.md:907
 msgid ""
 "**Introduce new Flower Baseline: FedAvg FEMNIST** "
 "([#1655](https://github.com/adap/flower/pull/1655))"
@@ -21253,7 +21372,7 @@ msgstr ""
 "**Introduire une nouvelle ligne de base pour les fleurs : FedAvg "
 "FEMNIST** ([#1655](https://github.com/adap/flower/pull/1655))"
 
-#: ../../source/ref-changelog.md:887
+#: ../../source/ref-changelog.md:909
 msgid ""
 "This new baseline replicates an experiment evaluating the performance of "
 "the FedAvg algorithm on the FEMNIST dataset from the paper [LEAF: A "
@@ -21265,7 +21384,7 @@ msgstr ""
 " l'article [LEAF : A Benchmark for Federated Settings (Caldas et al., "
 "2018)] (https://arxiv.org/abs/1812.01097)."
 
-#: ../../source/ref-changelog.md:889
+#: ../../source/ref-changelog.md:911
 msgid ""
 "**Introduce (experimental) REST API** "
 "([#1594](https://github.com/adap/flower/pull/1594), "
@@ -21285,7 +21404,7 @@ msgstr ""
 "[#1770](https://github.com/adap/flower/pull/1770), "
 "[#1733](https://github.com/adap/flower/pull/1733))"
 
-#: ../../source/ref-changelog.md:891
+#: ../../source/ref-changelog.md:913
 msgid ""
 "A new REST API has been introduced as an alternative to the gRPC-based "
 "communication stack. In this initial version, the REST API only supports "
@@ -21295,7 +21414,7 @@ msgstr ""
 "communication basée sur gRPC. Dans cette version initiale, l'API REST ne "
 "prend en charge que les clients anonymes."
 
-#: ../../source/ref-changelog.md:893
+#: ../../source/ref-changelog.md:915
 msgid ""
 "Please note: The REST API is still experimental and will likely change "
 "significantly over time."
@@ -21303,7 +21422,7 @@ msgstr ""
 "Remarque : l'API REST est encore expérimentale et est susceptible de "
 "changer de manière significative au fil du temps."
 
-#: ../../source/ref-changelog.md:895
+#: ../../source/ref-changelog.md:917
 msgid ""
 "**Improve the (experimental) Driver API** "
 "([#1663](https://github.com/adap/flower/pull/1663), "
@@ -21327,7 +21446,7 @@ msgstr ""
 "[#1662](https://github.com/adap/flower/pull/1662), "
 "[#1794](https://github.com/adap/flower/pull/1794))"
 
-#: ../../source/ref-changelog.md:897
+#: ../../source/ref-changelog.md:919
 msgid ""
 "The Driver API is still an experimental feature, but this release "
 "introduces some major upgrades. One of the main improvements is the "
@@ -21345,7 +21464,7 @@ msgstr ""
 "considérablement l'efficacité de la mémoire d'un serveur Flower "
 "fonctionnant depuis longtemps."
 
-#: ../../source/ref-changelog.md:899
+#: ../../source/ref-changelog.md:921
 msgid ""
 "**Fix spilling issues related to Ray during simulations** "
 "([#1698](https://github.com/adap/flower/pull/1698))"
@@ -21353,7 +21472,7 @@ msgstr ""
 "**Répare les problèmes de déversement liés à Ray pendant les "
 "simulations** ([#1698](https://github.com/adap/flower/pull/1698))"
 
-#: ../../source/ref-changelog.md:901
+#: ../../source/ref-changelog.md:923
 #, fuzzy
 msgid ""
 "While running long simulations, `ray` was sometimes spilling huge amounts"
@@ -21364,7 +21483,7 @@ msgstr ""
 "d'énormes quantités de données qui rendaient l'entraînement incapable de "
 "continuer. ce problème est maintenant corrigé ! 🎉"
 
-#: ../../source/ref-changelog.md:903
+#: ../../source/ref-changelog.md:925
 msgid ""
 "**Add new example using** `TabNet` **and Flower** "
 "([#1725](https://github.com/adap/flower/pull/1725))"
@@ -21372,7 +21491,7 @@ msgstr ""
 "**Ajouter un nouvel exemple utilisant** `TabNet` **et Flower** "
 "([#1725](https://github.com/adap/flower/pull/1725))"
 
-#: ../../source/ref-changelog.md:905
+#: ../../source/ref-changelog.md:927
 msgid ""
 "TabNet is a powerful and flexible framework for training machine learning"
 " models on tabular data. We now have a federated example using Flower: "
@@ -21385,7 +21504,7 @@ msgstr ""
 "tabnet](https://github.com/adap/flower/tree/main/examples/quickstart-"
 "tabnet)."
 
-#: ../../source/ref-changelog.md:907
+#: ../../source/ref-changelog.md:929
 msgid ""
 "**Add new how-to guide for monitoring simulations** "
 "([#1649](https://github.com/adap/flower/pull/1649))"
@@ -21393,7 +21512,7 @@ msgstr ""
 "**Ajouter un nouveau guide pratique pour le suivi des simulations** "
 "([#1649](https://github.com/adap/flower/pull/1649))"
 
-#: ../../source/ref-changelog.md:909
+#: ../../source/ref-changelog.md:931
 msgid ""
 "We now have a documentation guide to help users monitor their performance"
 " during simulations."
@@ -21401,7 +21520,7 @@ msgstr ""
 "Nous avons maintenant un guide de documentation pour aider les "
 "utilisateurs à surveiller leurs performances pendant les simulations."
 
-#: ../../source/ref-changelog.md:911
+#: ../../source/ref-changelog.md:933
 msgid ""
 "**Add training metrics to** `History` **object during simulations** "
 "([#1696](https://github.com/adap/flower/pull/1696))"
@@ -21409,7 +21528,7 @@ msgstr ""
 "**Ajouter des mesures de formation à** `History` **objet pendant les "
 "simulations** ([#1696](https://github.com/adap/flower/pull/1696))"
 
-#: ../../source/ref-changelog.md:913
+#: ../../source/ref-changelog.md:935
 msgid ""
 "The `fit_metrics_aggregation_fn` can be used to aggregate training "
 "metrics, but previous releases did not save the results in the `History` "
@@ -21420,7 +21539,7 @@ msgstr ""
 "n'enregistraient pas les résultats dans l'objet `History`. c'est "
 "désormais le cas !"
 
-#: ../../source/ref-changelog.md:915
+#: ../../source/ref-changelog.md:937
 msgid ""
 "**General improvements** "
 "([#1659](https://github.com/adap/flower/pull/1659), "
@@ -21495,11 +21614,11 @@ msgstr ""
 "[#1692](https://github.com/adap/flower/pull/1692), "
 "[#1705](https://github.com/ada"
 
-#: ../../source/ref-changelog.md:923
+#: ../../source/ref-changelog.md:945
 msgid "v1.3.0 (2023-02-06)"
 msgstr "v1.3.0 (2023-02-06)"
 
-#: ../../source/ref-changelog.md:929
+#: ../../source/ref-changelog.md:951
 msgid ""
 "`Adam Narozniak`, `Alexander Viala Bellander`, `Charles Beauville`, "
 "`Daniel J. Beutel`, `JDRanpariya`, `Lennart Behme`, `Taner Topal`"
@@ -21507,7 +21626,7 @@ msgstr ""
 "`Adam Narozniak`, `Alexander Viala Bellander`, `Charles Beauville`, "
 "`Daniel J. Beutel`, `JDRanpariya`, `Lennart Behme`, `Taner Topal`"
 
-#: ../../source/ref-changelog.md:933
+#: ../../source/ref-changelog.md:955
 msgid ""
 "**Add support for** `workload_id` **and** `group_id` **in Driver API** "
 "([#1595](https://github.com/adap/flower/pull/1595))"
@@ -21515,7 +21634,7 @@ msgstr ""
 "**Ajouter la prise en charge de** `workload_id` **et** `group_id` **dans "
 "l'API du pilote** ([#1595](https://github.com/adap/flower/pull/1595))"
 
-#: ../../source/ref-changelog.md:935
+#: ../../source/ref-changelog.md:957
 msgid ""
 "The (experimental) Driver API now supports a `workload_id` that can be "
 "used to identify which workload a task belongs to. It also supports a new"
@@ -21530,7 +21649,7 @@ msgstr ""
 "en cours. Le `workload_id` et le `group_id` permettent tous deux aux "
 "nœuds clients de décider s'ils veulent traiter une tâche ou non."
 
-#: ../../source/ref-changelog.md:937
+#: ../../source/ref-changelog.md:959
 msgid ""
 "**Make Driver API and Fleet API address configurable** "
 "([#1637](https://github.com/adap/flower/pull/1637))"
@@ -21539,7 +21658,7 @@ msgstr ""
 "flotte soit configurable** "
 "([#1637](https://github.com/adap/flower/pull/1637))"
 
-#: ../../source/ref-changelog.md:939
+#: ../../source/ref-changelog.md:961
 msgid ""
 "The (experimental) long-running Flower server (Driver API and Fleet API) "
 "can now configure the server address of both Driver API (via `--driver-"
@@ -21550,7 +21669,7 @@ msgstr ""
 "`--driver-api-address`) et de Fleet API (via `--fleet-api-address`) lors "
 "de son démarrage :"
 
-#: ../../source/ref-changelog.md:941
+#: ../../source/ref-changelog.md:963
 #, fuzzy
 msgid ""
 "`flower-server --driver-api-address \"0.0.0.0:8081\" --fleet-api-address "
@@ -21559,11 +21678,11 @@ msgstr ""
 "``flower-superlink --driver-api-address \"0.0.0.0:8081\" --fleet-api-"
 "address \"0.0.0.0:8086\" ``"
 
-#: ../../source/ref-changelog.md:943
+#: ../../source/ref-changelog.md:965
 msgid "Both IPv4 and IPv6 addresses are supported."
 msgstr "Les adresses IPv4 et IPv6 sont toutes deux prises en charge."
 
-#: ../../source/ref-changelog.md:945
+#: ../../source/ref-changelog.md:967
 msgid ""
 "**Add new example of Federated Learning using fastai and Flower** "
 "([#1598](https://github.com/adap/flower/pull/1598))"
@@ -21571,7 +21690,7 @@ msgstr ""
 "**Ajouter un nouvel exemple d'apprentissage fédéré utilisant fastai et "
 "Flower** ([#1598](https://github.com/adap/flower/pull/1598))"
 
-#: ../../source/ref-changelog.md:947
+#: ../../source/ref-changelog.md:969
 msgid ""
 "A new code example (`quickstart-fastai`) demonstrates federated learning "
 "with [fastai](https://www.fast.ai/) and Flower. You can find it here: "
@@ -21584,7 +21703,7 @@ msgstr ""
 "fastai](https://github.com/adap/flower/tree/main/examples/quickstart-"
 "fastai)."
 
-#: ../../source/ref-changelog.md:949
+#: ../../source/ref-changelog.md:971
 msgid ""
 "**Make Android example compatible with** `flwr >= 1.0.0` **and the latest"
 " versions of Android** "
@@ -21594,7 +21713,7 @@ msgstr ""
 "dernières versions d'Android** "
 "([#1603](https://github.com/adap/flower/pull/1603))"
 
-#: ../../source/ref-changelog.md:951
+#: ../../source/ref-changelog.md:973
 #, fuzzy
 msgid ""
 "The Android code example has received a substantial update: the project "
@@ -21608,7 +21727,7 @@ msgstr ""
 "est mis à jour pour être compatible avec les outils Android les plus "
 "récents."
 
-#: ../../source/ref-changelog.md:953
+#: ../../source/ref-changelog.md:975
 msgid ""
 "**Add new `FedProx` strategy** "
 "([#1619](https://github.com/adap/flower/pull/1619))"
@@ -21616,7 +21735,7 @@ msgstr ""
 "**Ajouter une nouvelle stratégie `FedProx`** "
 "([#1619](https://github.com/adap/flower/pull/1619))"
 
-#: ../../source/ref-changelog.md:955
+#: ../../source/ref-changelog.md:977
 msgid ""
 "This "
 "[strategy](https://github.com/adap/flower/blob/main/src/py/flwr/server/strategy/fedprox.py)"
@@ -21636,7 +21755,7 @@ msgstr ""
 "un paramètre appelé `proximal_mu` pour régulariser les modèles locaux par"
 " rapport aux modèles globaux."
 
-#: ../../source/ref-changelog.md:957
+#: ../../source/ref-changelog.md:979
 msgid ""
 "**Add new metrics to telemetry events** "
 "([#1640](https://github.com/adap/flower/pull/1640))"
@@ -21644,7 +21763,7 @@ msgstr ""
 "**Ajouter de nouvelles métriques aux événements de télémétrie** "
 "([#1640](https://github.com/adap/flower/pull/1640))"
 
-#: ../../source/ref-changelog.md:959
+#: ../../source/ref-changelog.md:981
 msgid ""
 "An updated event structure allows, for example, the clustering of events "
 "within the same workload."
@@ -21652,7 +21771,7 @@ msgstr ""
 "Une structure d'événements mise à jour permet, par exemple, de regrouper "
 "des événements au sein d'une même charge de travail."
 
-#: ../../source/ref-changelog.md:961
+#: ../../source/ref-changelog.md:983
 msgid ""
 "**Add new custom strategy tutorial section** "
 "[#1623](https://github.com/adap/flower/pull/1623)"
@@ -21660,7 +21779,7 @@ msgstr ""
 "**Ajouter une nouvelle section de tutoriel sur les stratégies "
 "personnalisées** [#1623](https://github.com/adap/flower/pull/1623)"
 
-#: ../../source/ref-changelog.md:963
+#: ../../source/ref-changelog.md:985
 #, fuzzy
 msgid ""
 "The Flower tutorial now has a new section that covers implementing a "
@@ -21674,7 +21793,7 @@ msgstr ""
 "Colab](https://colab.research.google.com/github/adap/flower/blob/main/doc/source/tutorial/Flower-3-Building-a"
 "-Strategy-PyTorch.ipynb)"
 
-#: ../../source/ref-changelog.md:965
+#: ../../source/ref-changelog.md:987
 msgid ""
 "**Add new custom serialization tutorial section** "
 "([#1622](https://github.com/adap/flower/pull/1622))"
@@ -21682,7 +21801,7 @@ msgstr ""
 "**Ajouter une nouvelle section de tutoriel sur la sérialisation "
 "personnalisée** ([#1622](https://github.com/adap/flower/pull/1622))"
 
-#: ../../source/ref-changelog.md:967
+#: ../../source/ref-changelog.md:989
 #, fuzzy
 msgid ""
 "The Flower tutorial now has a new section that covers custom "
@@ -21695,7 +21814,7 @@ msgstr ""
 "Colab](https://colab.research.google.com/github/adap/flower/blob/main/doc/source/tutorial/Flower-4"
 "-Client-and-NumPyClient-PyTorch.ipynb)"
 
-#: ../../source/ref-changelog.md:969
+#: ../../source/ref-changelog.md:991
 msgid ""
 "**General improvements** "
 "([#1638](https://github.com/adap/flower/pull/1638), "
@@ -21754,7 +21873,7 @@ msgstr ""
 "[#1599](https://github.com/adap/flower/pull/1599), "
 "[#1600](https://github.com/ada"
 
-#: ../../source/ref-changelog.md:973
+#: ../../source/ref-changelog.md:995
 msgid ""
 "**Updated documentation** "
 "([#1629](https://github.com/adap/flower/pull/1629), "
@@ -21774,7 +21893,7 @@ msgstr ""
 "[#1613](https://github.com/adap/flower/pull/1613), "
 "[#1614](https://github.com/adap/flower/pull/1614))"
 
-#: ../../source/ref-changelog.md:975 ../../source/ref-changelog.md:1042
+#: ../../source/ref-changelog.md:997 ../../source/ref-changelog.md:1064
 msgid ""
 "As usual, the documentation has improved quite a bit. It is another step "
 "in our effort to make the Flower documentation the best documentation of "
@@ -21785,11 +21904,11 @@ msgstr ""
 " meilleure documentation de tout projet. Reste à l'écoute et comme "
 "toujours, n'hésite pas à nous faire part de tes commentaires !"
 
-#: ../../source/ref-changelog.md:981
+#: ../../source/ref-changelog.md:1003
 msgid "v1.2.0 (2023-01-13)"
 msgstr "v1.2.0 (2023-01-13)"
 
-#: ../../source/ref-changelog.md:987
+#: ../../source/ref-changelog.md:1009
 msgid ""
 "`Adam Narozniak`, `Charles Beauville`, `Daniel J. Beutel`, `Edoardo`, `L."
 " Jiang`, `Ragy`, `Taner Topal`, `dannymcy`"
@@ -21797,7 +21916,7 @@ msgstr ""
 "adam Narozniak`, `Charles Beauville`, `Daniel J. Beutel`, `Edoardo`, `L. "
 "Jiang`, `Ragy`, `Taner Topal`, `dannymcy`"
 
-#: ../../source/ref-changelog.md:991
+#: ../../source/ref-changelog.md:1013
 msgid ""
 "**Introduce new Flower Baseline: FedAvg MNIST** "
 "([#1497](https://github.com/adap/flower/pull/1497), "
@@ -21807,7 +21926,7 @@ msgstr ""
 "([#1497](https://github.com/adap/flower/pull/1497), "
 "[#1552](https://github.com/adap/flower/pull/1552))"
 
-#: ../../source/ref-changelog.md:993
+#: ../../source/ref-changelog.md:1015
 msgid ""
 "Over the coming weeks, we will be releasing a number of new reference "
 "implementations useful especially to FL newcomers. They will typically "
@@ -21827,7 +21946,7 @@ msgstr ""
 "suite.](https://flower.ai/blog/2023-01-12-fl-starter-pack-fedavg-mnist-"
 "cnn/)"
 
-#: ../../source/ref-changelog.md:995
+#: ../../source/ref-changelog.md:1017
 msgid ""
 "**Improve GPU support in simulations** "
 "([#1555](https://github.com/adap/flower/pull/1555))"
@@ -21835,7 +21954,7 @@ msgstr ""
 "**Améliorer la prise en charge des GPU dans les simulations** "
 "([#1555](https://github.com/adap/flower/pull/1555))"
 
-#: ../../source/ref-changelog.md:997
+#: ../../source/ref-changelog.md:1019
 msgid ""
 "The Ray-based Virtual Client Engine (`start_simulation`) has been updated"
 " to improve GPU support. The update includes some of the hard-earned "
@@ -21849,7 +21968,7 @@ msgstr ""
 "paramètres par défaut rendent l'exécution des simulations basées sur les "
 "GPU beaucoup plus robuste."
 
-#: ../../source/ref-changelog.md:999
+#: ../../source/ref-changelog.md:1021
 msgid ""
 "**Improve GPU support in Jupyter Notebook tutorials** "
 "([#1527](https://github.com/adap/flower/pull/1527), "
@@ -21859,7 +21978,7 @@ msgstr ""
 "Notebook** ([#1527](https://github.com/adap/flower/pull/1527), "
 "[#1558](https://github.com/adap/flower/pull/1558))"
 
-#: ../../source/ref-changelog.md:1001
+#: ../../source/ref-changelog.md:1023
 msgid ""
 "Some users reported that Jupyter Notebooks have not always been easy to "
 "use on GPU instances. We listened and made improvements to all of our "
@@ -21870,7 +21989,7 @@ msgstr ""
 "écoutés et avons apporté des améliorations à tous nos carnets Jupyter ! "
 "Découvre les carnets mis à jour ici :"
 
-#: ../../source/ref-changelog.md:1003
+#: ../../source/ref-changelog.md:1025
 #, fuzzy
 msgid ""
 "[An Introduction to Federated Learning](https://flower.ai/docs/framework"
@@ -21879,7 +21998,7 @@ msgstr ""
 "[Une introduction à l'apprentissage fédéré] "
 "(https://flower.ai/docs/tutorial/Flower-1-Intro-to-FL-PyTorch.html)"
 
-#: ../../source/ref-changelog.md:1004
+#: ../../source/ref-changelog.md:1026
 #, fuzzy
 msgid ""
 "[Strategies in Federated Learning](https://flower.ai/docs/framework"
@@ -21888,7 +22007,7 @@ msgstr ""
 "[Stratégies d'apprentissage fédéré] "
 "(https://flower.ai/docs/tutorial/Flower-2-Strategies-in-FL-PyTorch.html)"
 
-#: ../../source/ref-changelog.md:1005
+#: ../../source/ref-changelog.md:1027
 #, fuzzy
 msgid ""
 "[Building a Strategy](https://flower.ai/docs/framework/tutorial-build-a"
@@ -21898,7 +22017,7 @@ msgstr ""
 "(https://flower.ai/docs/tutorial/Flower-3-Building-a-Strategy-"
 "PyTorch.html)"
 
-#: ../../source/ref-changelog.md:1006
+#: ../../source/ref-changelog.md:1028
 #, fuzzy
 msgid ""
 "[Client and NumPyClient](https://flower.ai/docs/framework/tutorial-"
@@ -21907,7 +22026,7 @@ msgstr ""
 "[Client et NumPyClient] (https://flower.ai/docs/tutorial/Flower-4-Client-"
 "and-NumPyClient-PyTorch.html)"
 
-#: ../../source/ref-changelog.md:1008
+#: ../../source/ref-changelog.md:1030
 msgid ""
 "**Introduce optional telemetry** "
 "([#1533](https://github.com/adap/flower/pull/1533), "
@@ -21919,7 +22038,7 @@ msgstr ""
 "[#1544](https://github.com/adap/flower/pull/1544), "
 "[#1584](https://github.com/adap/flower/pull/1584))"
 
-#: ../../source/ref-changelog.md:1010
+#: ../../source/ref-changelog.md:1032
 msgid ""
 "After a [request for "
 "feedback](https://github.com/adap/flower/issues/1534) from the community,"
@@ -21936,7 +22055,7 @@ msgstr ""
 "comment Flower est utilisé et quels sont les défis auxquels les "
 "utilisateurs peuvent être confrontés."
 
-#: ../../source/ref-changelog.md:1012
+#: ../../source/ref-changelog.md:1034
 #, fuzzy
 msgid ""
 "**Flower is a friendly framework for collaborative AI and data science.**"
@@ -21950,7 +22069,7 @@ msgstr ""
 "souhaitent pas partager des métriques d'utilisation anonymes.[Lire la "
 "suite.](https://flower.ai/docs/telemetry.html)."
 
-#: ../../source/ref-changelog.md:1014
+#: ../../source/ref-changelog.md:1036
 msgid ""
 "**Introduce (experimental) Driver API** "
 "([#1520](https://github.com/adap/flower/pull/1520), "
@@ -21969,7 +22088,7 @@ msgstr ""
 "[#1551](https://github.com/adap/flower/pull/1551), "
 "[#1567](https://github.com/adap/flower/pull/1567))"
 
-#: ../../source/ref-changelog.md:1016
+#: ../../source/ref-changelog.md:1038
 msgid ""
 "Flower now has a new (experimental) Driver API which will enable fully "
 "programmable, async, and multi-tenant Federated Learning and Federated "
@@ -21984,7 +22103,7 @@ msgstr ""
 "laquelle de nombreuses fonctionnalités à venir seront construites - et tu"
 " peux commencer à construire ces choses dès maintenant, aussi."
 
-#: ../../source/ref-changelog.md:1018
+#: ../../source/ref-changelog.md:1040
 msgid ""
 "The Driver API also enables a new execution mode in which the server runs"
 " indefinitely. Multiple individual workloads can run concurrently and "
@@ -21997,7 +22116,7 @@ msgstr ""
 "leur exécution indépendamment du serveur. Ceci est particulièrement utile"
 " pour les utilisateurs qui souhaitent déployer Flower en production."
 
-#: ../../source/ref-changelog.md:1020
+#: ../../source/ref-changelog.md:1042
 msgid ""
 "To learn more, check out the `mt-pytorch` code example. We look forward "
 "to you feedback!"
@@ -22005,7 +22124,7 @@ msgstr ""
 "Pour en savoir plus, consulte l'exemple de code `mt-pytorch`. Nous "
 "attendons tes commentaires avec impatience !"
 
-#: ../../source/ref-changelog.md:1022
+#: ../../source/ref-changelog.md:1044
 msgid ""
 "Please note: *The Driver API is still experimental and will likely change"
 " significantly over time.*"
@@ -22013,7 +22132,7 @@ msgstr ""
 "Remarque : *L'API du pilote est encore expérimentale et est susceptible "
 "de changer de manière significative au fil du temps.*"
 
-#: ../../source/ref-changelog.md:1024
+#: ../../source/ref-changelog.md:1046
 msgid ""
 "**Add new Federated Analytics with Pandas example** "
 "([#1469](https://github.com/adap/flower/pull/1469), "
@@ -22023,7 +22142,7 @@ msgstr ""
 "([#1469](https://github.com/adap/flower/pull/1469), "
 "[#1535](https://github.com/adap/flower/pull/1535))"
 
-#: ../../source/ref-changelog.md:1026
+#: ../../source/ref-changelog.md:1048
 msgid ""
 "A new code example (`quickstart-pandas`) demonstrates federated analytics"
 " with Pandas and Flower. You can find it here: [quickstart-"
@@ -22035,7 +22154,7 @@ msgstr ""
 "pandas](https://github.com/adap/flower/tree/main/examples/quickstart-"
 "pandas)."
 
-#: ../../source/ref-changelog.md:1028
+#: ../../source/ref-changelog.md:1050
 msgid ""
 "**Add new strategies: Krum and MultiKrum** "
 "([#1481](https://github.com/adap/flower/pull/1481))"
@@ -22043,7 +22162,7 @@ msgstr ""
 "**Ajouter de nouvelles stratégies : Krum et MultiKrum** "
 "([#1481](https://github.com/adap/flower/pull/1481))"
 
-#: ../../source/ref-changelog.md:1030
+#: ../../source/ref-changelog.md:1052
 msgid ""
 "Edoardo, a computer science student at the Sapienza University of Rome, "
 "contributed a new `Krum` strategy that enables users to easily use Krum "
@@ -22053,7 +22172,7 @@ msgstr ""
 "contribué à une nouvelle stratégie `Krum` qui permet aux utilisateurs "
 "d'utiliser facilement Krum et MultiKrum dans leurs charges de travail."
 
-#: ../../source/ref-changelog.md:1032
+#: ../../source/ref-changelog.md:1054
 msgid ""
 "**Update C++ example to be compatible with Flower v1.2.0** "
 "([#1495](https://github.com/adap/flower/pull/1495))"
@@ -22061,7 +22180,7 @@ msgstr ""
 "**Mettre à jour l'exemple C++ pour qu'il soit compatible avec Flower "
 "v1.2.0** ([#1495](https://github.com/adap/flower/pull/1495))"
 
-#: ../../source/ref-changelog.md:1034
+#: ../../source/ref-changelog.md:1056
 msgid ""
 "The C++ code example has received a substantial update to make it "
 "compatible with the latest version of Flower."
@@ -22069,7 +22188,7 @@ msgstr ""
 "L'exemple de code C++ a reçu une mise à jour substantielle pour le rendre"
 " compatible avec la dernière version de Flower."
 
-#: ../../source/ref-changelog.md:1036
+#: ../../source/ref-changelog.md:1058
 msgid ""
 "**General improvements** "
 "([#1491](https://github.com/adap/flower/pull/1491), "
@@ -22101,7 +22220,7 @@ msgstr ""
 "[#1564](https://github.com/adap/flower/pull/1564), "
 "[#1566](https://github.com/adap/flower/pull/1566))"
 
-#: ../../source/ref-changelog.md:1040
+#: ../../source/ref-changelog.md:1062
 msgid ""
 "**Updated documentation** "
 "([#1494](https://github.com/adap/flower/pull/1494), "
@@ -22125,7 +22244,7 @@ msgstr ""
 "[#1519](https://github.com/adap/flower/pull/1519), "
 "[#1515](https://github.com/adap/flower/pull/1515))"
 
-#: ../../source/ref-changelog.md:1044
+#: ../../source/ref-changelog.md:1066
 msgid ""
 "One highlight is the new [first time contributor "
 "guide](https://flower.ai/docs/first-time-contributors.html): if you've "
@@ -22135,11 +22254,11 @@ msgstr ""
 "(https://flower.ai/docs/first-time-contributors.html) : si tu n'as jamais"
 " contribué sur GitHub auparavant, c'est l'endroit idéal pour commencer !"
 
-#: ../../source/ref-changelog.md:1050
+#: ../../source/ref-changelog.md:1072
 msgid "v1.1.0 (2022-10-31)"
 msgstr "v1.1.0 (2022-10-31)"
 
-#: ../../source/ref-changelog.md:1054
+#: ../../source/ref-changelog.md:1076
 msgid ""
 "We would like to give our **special thanks** to all the contributors who "
 "made the new version of Flower possible (in `git shortlog` order):"
@@ -22148,7 +22267,7 @@ msgstr ""
 " qui ont rendu possible la nouvelle version de Flower (dans l'ordre `git "
 "shortlog`) :"
 
-#: ../../source/ref-changelog.md:1056
+#: ../../source/ref-changelog.md:1078
 msgid ""
 "`Akis Linardos`, `Christopher S`, `Daniel J. Beutel`, `George`, `Jan "
 "Schlicht`, `Mohammad Fares`, `Pedro Porto Buarque de Gusmão`, `Philipp "
@@ -22160,7 +22279,7 @@ msgstr ""
 "Wiesner`, `Rob Luke`, `Taner Topal`, `VasundharaAgarwal`, "
 "`danielnugraha`, `edogab33`"
 
-#: ../../source/ref-changelog.md:1060
+#: ../../source/ref-changelog.md:1082
 msgid ""
 "**Introduce Differential Privacy wrappers (preview)** "
 "([#1357](https://github.com/adap/flower/pull/1357), "
@@ -22170,7 +22289,7 @@ msgstr ""
 "([#1357](https://github.com/adap/flower/pull/1357), "
 "[#1460](https://github.com/adap/flower/pull/1460))"
 
-#: ../../source/ref-changelog.md:1062
+#: ../../source/ref-changelog.md:1084
 msgid ""
 "The first (experimental) preview of pluggable Differential Privacy "
 "wrappers enables easy configuration and usage of differential privacy "
@@ -22186,7 +22305,7 @@ msgstr ""
 "voir les documents de Flower, un nouvel explicatif va plus loin dans les "
 "détails."
 
-#: ../../source/ref-changelog.md:1064
+#: ../../source/ref-changelog.md:1086
 msgid ""
 "**New iOS CoreML code example** "
 "([#1289](https://github.com/adap/flower/pull/1289))"
@@ -22194,7 +22313,7 @@ msgstr ""
 "**Nouvel exemple de code CoreML pour iOS** "
 "([#1289](https://github.com/adap/flower/pull/1289))"
 
-#: ../../source/ref-changelog.md:1066
+#: ../../source/ref-changelog.md:1088
 msgid ""
 "Flower goes iOS! A massive new code example shows how Flower clients can "
 "be built for iOS. The code example contains both Flower iOS SDK "
@@ -22207,7 +22326,7 @@ msgstr ""
 "utilisés pour de nombreuses tâches, et un exemple de tâche fonctionnant "
 "sur CoreML."
 
-#: ../../source/ref-changelog.md:1068
+#: ../../source/ref-changelog.md:1090
 msgid ""
 "**New FedMedian strategy** "
 "([#1461](https://github.com/adap/flower/pull/1461))"
@@ -22215,7 +22334,7 @@ msgstr ""
 "**Nouvelle stratégie de FedMedian** "
 "([#1461](https://github.com/adap/flower/pull/1461))"
 
-#: ../../source/ref-changelog.md:1070
+#: ../../source/ref-changelog.md:1092
 msgid ""
 "The new `FedMedian` strategy implements Federated Median (FedMedian) by "
 "[Yin et al., 2018](https://arxiv.org/pdf/1803.01498v1.pdf)."
@@ -22224,7 +22343,7 @@ msgstr ""
 "(FedMedian) par [Yin et al., 2018] "
 "(https://arxiv.org/pdf/1803.01498v1.pdf)."
 
-#: ../../source/ref-changelog.md:1072
+#: ../../source/ref-changelog.md:1094
 msgid ""
 "**Log** `Client` **exceptions in Virtual Client Engine** "
 "([#1493](https://github.com/adap/flower/pull/1493))"
@@ -22232,7 +22351,7 @@ msgstr ""
 "**Log** `Client` **exceptions dans le moteur de client virtuel** "
 "([#1493](https://github.com/adap/flower/pull/1493))"
 
-#: ../../source/ref-changelog.md:1074
+#: ../../source/ref-changelog.md:1096
 msgid ""
 "All `Client` exceptions happening in the VCE are now logged by default "
 "and not just exposed to the configured `Strategy` (via the `failures` "
@@ -22242,7 +22361,7 @@ msgstr ""
 "maintenant enregistrées par défaut et ne sont pas seulement exposées à la"
 " `Stratégie` configurée (via l'argument `failures`)."
 
-#: ../../source/ref-changelog.md:1076
+#: ../../source/ref-changelog.md:1098
 msgid ""
 "**Improve Virtual Client Engine internals** "
 "([#1401](https://github.com/adap/flower/pull/1401), "
@@ -22252,7 +22371,7 @@ msgstr ""
 "([#1401](https://github.com/adap/flower/pull/1401), "
 "[#1453](https://github.com/adap/flower/pull/1453))"
 
-#: ../../source/ref-changelog.md:1078
+#: ../../source/ref-changelog.md:1100
 msgid ""
 "Some internals of the Virtual Client Engine have been revamped. The VCE "
 "now uses Ray 2.0 under the hood, the value type of the `client_resources`"
@@ -22263,7 +22382,7 @@ msgstr ""
 "dictionnaire `client_resources` a été remplacé par `float` pour permettre"
 " l'allocation de fractions de ressources."
 
-#: ../../source/ref-changelog.md:1080
+#: ../../source/ref-changelog.md:1102
 msgid ""
 "**Support optional** `Client`**/**`NumPyClient` **methods in Virtual "
 "Client Engine**"
@@ -22271,7 +22390,7 @@ msgstr ""
 "**Support optional** `Client`**/**`NumPyClient` **methods in Virtual "
 "Client Engine**"
 
-#: ../../source/ref-changelog.md:1082
+#: ../../source/ref-changelog.md:1104
 msgid ""
 "The Virtual Client Engine now has full support for optional `Client` (and"
 " `NumPyClient`) methods."
@@ -22279,7 +22398,7 @@ msgstr ""
 "Le moteur de client virtuel prend désormais en charge les méthodes "
 "optionnelles `Client` (et `NumPyClient`)."
 
-#: ../../source/ref-changelog.md:1084
+#: ../../source/ref-changelog.md:1106
 msgid ""
 "**Provide type information to packages using** `flwr` "
 "([#1377](https://github.com/adap/flower/pull/1377))"
@@ -22287,7 +22406,7 @@ msgstr ""
 "**Fournir des informations de type aux paquets en utilisant** `flwr` "
 "([#1377](https://github.com/adap/flower/pull/1377))"
 
-#: ../../source/ref-changelog.md:1086
+#: ../../source/ref-changelog.md:1108
 msgid ""
 "The package `flwr` is now bundled with a `py.typed` file indicating that "
 "the package is typed. This enables typing support for projects or "
@@ -22300,7 +22419,7 @@ msgstr ""
 "permettant d'améliorer leur code à l'aide de vérificateurs de types "
 "statiques comme `mypy`."
 
-#: ../../source/ref-changelog.md:1088
+#: ../../source/ref-changelog.md:1110
 msgid ""
 "**Updated code example** "
 "([#1344](https://github.com/adap/flower/pull/1344), "
@@ -22310,7 +22429,7 @@ msgstr ""
 "([#1344](https://github.com/adap/flower/pull/1344), "
 "[#1347](https://github.com/adap/flower/pull/1347))"
 
-#: ../../source/ref-changelog.md:1090
+#: ../../source/ref-changelog.md:1112
 msgid ""
 "The code examples covering scikit-learn and PyTorch Lightning have been "
 "updated to work with the latest version of Flower."
@@ -22318,7 +22437,7 @@ msgstr ""
 "Les exemples de code couvrant scikit-learn et PyTorch Lightning ont été "
 "mis à jour pour fonctionner avec la dernière version de Flower."
 
-#: ../../source/ref-changelog.md:1092
+#: ../../source/ref-changelog.md:1114
 msgid ""
 "**Updated documentation** "
 "([#1355](https://github.com/adap/flower/pull/1355), "
@@ -22358,7 +22477,7 @@ msgstr ""
 "[#1465](https://github.com/adap/flower/pull/1465), "
 "[#1467](https://github.com/adap/flower/pull/1467))"
 
-#: ../../source/ref-changelog.md:1094
+#: ../../source/ref-changelog.md:1116
 msgid ""
 "There have been so many documentation updates that it doesn't even make "
 "sense to list them individually."
@@ -22366,7 +22485,7 @@ msgstr ""
 "Il y a eu tellement de mises à jour de la documentation que cela n'a même"
 " pas de sens de les énumérer individuellement."
 
-#: ../../source/ref-changelog.md:1096
+#: ../../source/ref-changelog.md:1118
 msgid ""
 "**Restructured documentation** "
 "([#1387](https://github.com/adap/flower/pull/1387))"
@@ -22374,7 +22493,7 @@ msgstr ""
 "**Documentation restructurée** "
 "([#1387](https://github.com/adap/flower/pull/1387))"
 
-#: ../../source/ref-changelog.md:1098
+#: ../../source/ref-changelog.md:1120
 msgid ""
 "The documentation has been restructured to make it easier to navigate. "
 "This is just the first step in a larger effort to make the Flower "
@@ -22384,7 +22503,7 @@ msgstr ""
 "n'est que la première étape d'un effort plus important visant à faire de "
 "la documentation de Flower la meilleure documentation de tous les projets"
 
-#: ../../source/ref-changelog.md:1100
+#: ../../source/ref-changelog.md:1122
 msgid ""
 "**Open in Colab button** "
 "([#1389](https://github.com/adap/flower/pull/1389))"
@@ -22392,7 +22511,7 @@ msgstr ""
 "**Ouvrir dans le bouton Colab** "
 "([#1389](https://github.com/adap/flower/pull/1389))"
 
-#: ../../source/ref-changelog.md:1102
+#: ../../source/ref-changelog.md:1124
 msgid ""
 "The four parts of the Flower Federated Learning Tutorial now come with a "
 "new `Open in Colab` button. No need to install anything on your local "
@@ -22405,7 +22524,7 @@ msgstr ""
 "maintenant utiliser et apprendre à connaître Flower dans ton navigateur, "
 "il te suffit d'un simple clic."
 
-#: ../../source/ref-changelog.md:1104
+#: ../../source/ref-changelog.md:1126
 msgid ""
 "**Improved tutorial** ([#1468](https://github.com/adap/flower/pull/1468),"
 " [#1470](https://github.com/adap/flower/pull/1470), "
@@ -22421,7 +22540,7 @@ msgstr ""
 "[#1474](https://github.com/adap/flower/pull/1474), "
 "[#1475](https://github.com/adap/flower/pull/1475))"
 
-#: ../../source/ref-changelog.md:1106
+#: ../../source/ref-changelog.md:1128
 msgid ""
 "The Flower Federated Learning Tutorial has two brand-new parts covering "
 "custom strategies (still WIP) and the distinction between `Client` and "
@@ -22434,27 +22553,27 @@ msgstr ""
 "existantes ont également été améliorées (beaucoup de petits changements "
 "et de corrections)."
 
-#: ../../source/ref-changelog.md:1112
+#: ../../source/ref-changelog.md:1134
 msgid "v1.0.0 (2022-07-28)"
 msgstr "v1.0.0 (2022-07-28)"
 
-#: ../../source/ref-changelog.md:1114
+#: ../../source/ref-changelog.md:1136
 msgid "Highlights"
 msgstr "Points forts"
 
-#: ../../source/ref-changelog.md:1116
+#: ../../source/ref-changelog.md:1138
 msgid "Stable **Virtual Client Engine** (accessible via `start_simulation`)"
 msgstr "Moteur de client virtuel stable** (accessible via `start_simulation`)"
 
-#: ../../source/ref-changelog.md:1117
+#: ../../source/ref-changelog.md:1139
 msgid "All `Client`/`NumPyClient` methods are now optional"
 msgstr "Toutes les méthodes `Client`/`NumPyClient` sont maintenant optionnelles"
 
-#: ../../source/ref-changelog.md:1118
+#: ../../source/ref-changelog.md:1140
 msgid "Configurable `get_parameters`"
 msgstr "`get_parameters` configurable"
 
-#: ../../source/ref-changelog.md:1119
+#: ../../source/ref-changelog.md:1141
 msgid ""
 "Tons of small API cleanups resulting in a more coherent developer "
 "experience"
@@ -22462,7 +22581,7 @@ msgstr ""
 "Des tonnes de petits nettoyages d'API résultant en une expérience plus "
 "cohérente pour les développeurs"
 
-#: ../../source/ref-changelog.md:1123
+#: ../../source/ref-changelog.md:1145
 msgid ""
 "We would like to give our **special thanks** to all the contributors who "
 "made Flower 1.0 possible (in reverse [GitHub "
@@ -22472,7 +22591,7 @@ msgstr ""
 "ont rendu Flower 1.0 possible (dans l'ordre inverse de [GitHub "
 "Contributors](https://github.com/adap/flower/graphs/contributors)) :"
 
-#: ../../source/ref-changelog.md:1125
+#: ../../source/ref-changelog.md:1147
 msgid ""
 "[@rtaiello](https://github.com/rtaiello), "
 "[@g-pichler](https://github.com/g-pichler), [@rob-"
@@ -22532,7 +22651,7 @@ msgstr ""
 "/Jueun-Park), [@architjen](https://github.com/architjen), "
 "[@PratikGarai](https://github.com/PratikGarai), [@mrinaald]("
 
-#: ../../source/ref-changelog.md:1129
+#: ../../source/ref-changelog.md:1151
 msgid ""
 "**All arguments must be passed as keyword arguments** "
 "([#1338](https://github.com/adap/flower/pull/1338))"
@@ -22540,7 +22659,7 @@ msgstr ""
 "**Tous les arguments doivent être passés comme des arguments de mot-clé**"
 " ([#1338](https://github.com/adap/flower/pull/1338))"
 
-#: ../../source/ref-changelog.md:1131
+#: ../../source/ref-changelog.md:1153
 #, fuzzy
 msgid ""
 "Pass all arguments as keyword arguments, positional arguments are not "
@@ -22556,7 +22675,7 @@ msgstr ""
 "``start_client(server_address=\"127.0.0.1:8080\", "
 "client=FlowerClient())`)."
 
-#: ../../source/ref-changelog.md:1133
+#: ../../source/ref-changelog.md:1155
 msgid ""
 "**Introduce configuration object** `ServerConfig` **in** `start_server` "
 "**and** `start_simulation` "
@@ -22566,7 +22685,7 @@ msgstr ""
 "`start_server` **et** `start_simulation` "
 "([#1317](https://github.com/adap/flower/pull/1317))"
 
-#: ../../source/ref-changelog.md:1135
+#: ../../source/ref-changelog.md:1157
 msgid ""
 "Instead of a config dictionary `{\"num_rounds\": 3, \"round_timeout\": "
 "600.0}`, `start_server` and `start_simulation` now expect a configuration"
@@ -22582,7 +22701,7 @@ msgstr ""
 "sécurisé plus facile et les valeurs des paramètres par défaut plus "
 "transparentes."
 
-#: ../../source/ref-changelog.md:1137
+#: ../../source/ref-changelog.md:1159
 msgid ""
 "**Rename built-in strategy parameters for clarity** "
 "([#1334](https://github.com/adap/flower/pull/1334))"
@@ -22590,7 +22709,7 @@ msgstr ""
 "**Renommer les paramètres de la stratégie intégrée pour plus de clarté** "
 "([#1334](https://github.com/adap/flower/pull/1334))"
 
-#: ../../source/ref-changelog.md:1139
+#: ../../source/ref-changelog.md:1161
 msgid ""
 "The following built-in strategy parameters were renamed to improve "
 "readability and consistency with other API's:"
@@ -22598,19 +22717,19 @@ msgstr ""
 "Les paramètres de stratégie intégrés suivants ont été renommés pour "
 "améliorer la lisibilité et la cohérence avec d'autres API :"
 
-#: ../../source/ref-changelog.md:1141
+#: ../../source/ref-changelog.md:1163
 msgid "`fraction_eval` --> `fraction_evaluate`"
 msgstr "`fraction_eval` --> `fraction_evaluate`"
 
-#: ../../source/ref-changelog.md:1142
+#: ../../source/ref-changelog.md:1164
 msgid "`min_eval_clients` --> `min_evaluate_clients`"
 msgstr "`min_eval_clients` --> `min_evaluate_clients`"
 
-#: ../../source/ref-changelog.md:1143
+#: ../../source/ref-changelog.md:1165
 msgid "`eval_fn` --> `evaluate_fn`"
 msgstr "`eval_fn` --> `evaluate_fn`"
 
-#: ../../source/ref-changelog.md:1145
+#: ../../source/ref-changelog.md:1167
 msgid ""
 "**Update default arguments of built-in strategies** "
 "([#1278](https://github.com/adap/flower/pull/1278))"
@@ -22618,7 +22737,7 @@ msgstr ""
 "**Mettre à jour les arguments par défaut des stratégies intégrées** "
 "([#1278](https://github.com/adap/flower/pull/1278))"
 
-#: ../../source/ref-changelog.md:1147
+#: ../../source/ref-changelog.md:1169
 msgid ""
 "All built-in strategies now use `fraction_fit=1.0` and "
 "`fraction_evaluate=1.0`, which means they select *all* currently "
@@ -22633,11 +22752,11 @@ msgstr ""
 "peuvent retrouver le comportement antérieur en initialisant la stratégie "
 "de la manière suivante :"
 
-#: ../../source/ref-changelog.md:1149
+#: ../../source/ref-changelog.md:1171
 msgid "`strategy = FedAvg(fraction_fit=0.1, fraction_evaluate=0.1)`"
 msgstr "`stratégie = FedAvg(fraction_fit=0.1, fraction_evaluate=0.1)`"
 
-#: ../../source/ref-changelog.md:1151
+#: ../../source/ref-changelog.md:1173
 msgid ""
 "**Add** `server_round` **to** `Strategy.evaluate` "
 "([#1334](https://github.com/adap/flower/pull/1334))"
@@ -22645,7 +22764,7 @@ msgstr ""
 "**Ajouter** `server_round` **à** `Strategy.evaluate` "
 "([#1334](https://github.com/adap/flower/pull/1334))"
 
-#: ../../source/ref-changelog.md:1153
+#: ../../source/ref-changelog.md:1175
 msgid ""
 "The `Strategy` method `evaluate` now receives the current round of "
 "federated learning/evaluation as the first parameter."
@@ -22653,7 +22772,7 @@ msgstr ""
 "La méthode `Stratégie` `évaluer` reçoit maintenant le cycle actuel "
 "d'apprentissage/évaluation fédéré comme premier paramètre."
 
-#: ../../source/ref-changelog.md:1155
+#: ../../source/ref-changelog.md:1177
 msgid ""
 "**Add** `server_round` **and** `config` **parameters to** `evaluate_fn` "
 "([#1334](https://github.com/adap/flower/pull/1334))"
@@ -22661,7 +22780,7 @@ msgstr ""
 "**Ajouter** `server_round` **et** `config` **paramètres à** `evaluate_fn`"
 " ([#1334](https://github.com/adap/flower/pull/1334))"
 
-#: ../../source/ref-changelog.md:1157
+#: ../../source/ref-changelog.md:1179
 msgid ""
 "The `evaluate_fn` passed to built-in strategies like `FedAvg` now takes "
 "three parameters: (1) The current round of federated learning/evaluation "
@@ -22674,7 +22793,7 @@ msgstr ""
 " modèle à évaluer (`parameters`), et (3) un dictionnaire de configuration"
 " (`config`)."
 
-#: ../../source/ref-changelog.md:1159
+#: ../../source/ref-changelog.md:1181
 msgid ""
 "**Rename** `rnd` **to** `server_round` "
 "([#1321](https://github.com/adap/flower/pull/1321))"
@@ -22682,7 +22801,7 @@ msgstr ""
 "**Rename** `rnd` **to** `server_round` "
 "([#1321](https://github.com/adap/flower/pull/1321))"
 
-#: ../../source/ref-changelog.md:1161
+#: ../../source/ref-changelog.md:1183
 msgid ""
 "Several Flower methods and functions (`evaluate_fn`, `configure_fit`, "
 "`aggregate_fit`, `configure_evaluate`, `aggregate_evaluate`) receive the "
@@ -22697,7 +22816,7 @@ msgstr ""
 " la fiabilité et éviter la confusion avec *random*, ce paramètre a été "
 "renommé de `rnd` à `server_round`."
 
-#: ../../source/ref-changelog.md:1163
+#: ../../source/ref-changelog.md:1185
 msgid ""
 "**Move** `flwr.dataset` **to** `flwr_baselines` "
 "([#1273](https://github.com/adap/flower/pull/1273))"
@@ -22705,11 +22824,11 @@ msgstr ""
 "**Déplacer** `flwr.dataset` **vers** `flwr_baselines` "
 "([#1273](https://github.com/adap/flower/pull/1273))"
 
-#: ../../source/ref-changelog.md:1165
+#: ../../source/ref-changelog.md:1187
 msgid "The experimental package `flwr.dataset` was migrated to Flower Baselines."
 msgstr "Le paquet expérimental `flwr.dataset` a été migré vers Flower Baselines."
 
-#: ../../source/ref-changelog.md:1167
+#: ../../source/ref-changelog.md:1189
 msgid ""
 "**Remove experimental strategies** "
 "([#1280](https://github.com/adap/flower/pull/1280))"
@@ -22717,7 +22836,7 @@ msgstr ""
 "**Supprimer les stratégies expérimentales** "
 "([#1280](https://github.com/adap/flower/pull/1280))"
 
-#: ../../source/ref-changelog.md:1169
+#: ../../source/ref-changelog.md:1191
 msgid ""
 "Remove unmaintained experimental strategies (`FastAndSlow`, `FedFSv0`, "
 "`FedFSv1`)."
@@ -22725,7 +22844,7 @@ msgstr ""
 "Supprimer les stratégies expérimentales non maintenues (`FastAndSlow`, "
 "`FedFSv0`, `FedFSv1`)."
 
-#: ../../source/ref-changelog.md:1171
+#: ../../source/ref-changelog.md:1193
 msgid ""
 "**Rename** `Weights` **to** `NDArrays` "
 "([#1258](https://github.com/adap/flower/pull/1258), "
@@ -22735,7 +22854,7 @@ msgstr ""
 "([#1258](https://github.com/adap/flower/pull/1258), "
 "[#1259](https://github.com/adap/flower/pull/1259))"
 
-#: ../../source/ref-changelog.md:1173
+#: ../../source/ref-changelog.md:1195
 msgid ""
 "`flwr.common.Weights` was renamed to `flwr.common.NDArrays` to better "
 "capture what this type is all about."
@@ -22743,7 +22862,7 @@ msgstr ""
 "`flwr.common.Weights` a été renommé en `flwr.common.NDArys` pour mieux "
 "rendre compte de la nature de ce type."
 
-#: ../../source/ref-changelog.md:1175
+#: ../../source/ref-changelog.md:1197
 msgid ""
 "**Remove antiquated** `force_final_distributed_eval` **from** "
 "`start_server` ([#1258](https://github.com/adap/flower/pull/1258), "
@@ -22753,7 +22872,7 @@ msgstr ""
 "`start_server` ([#1258](https://github.com/adap/flower/pull/1258), "
 "[#1259](https://github.com/adap/flower/pull/1259))"
 
-#: ../../source/ref-changelog.md:1177
+#: ../../source/ref-changelog.md:1199
 msgid ""
 "The `start_server` parameter `force_final_distributed_eval` has long been"
 " a historic artefact, in this release it is finally gone for good."
@@ -22762,7 +22881,7 @@ msgstr ""
 "été un artefact historique, dans cette version il a finalement disparu "
 "pour de bon."
 
-#: ../../source/ref-changelog.md:1179
+#: ../../source/ref-changelog.md:1201
 msgid ""
 "**Make** `get_parameters` **configurable** "
 "([#1242](https://github.com/adap/flower/pull/1242))"
@@ -22770,7 +22889,7 @@ msgstr ""
 "**Make** `get_parameters` **configurable** "
 "([#1242](https://github.com/adap/flower/pull/1242))"
 
-#: ../../source/ref-changelog.md:1181
+#: ../../source/ref-changelog.md:1203
 msgid ""
 "The `get_parameters` method now accepts a configuration dictionary, just "
 "like `get_properties`, `fit`, and `evaluate`."
@@ -22778,7 +22897,7 @@ msgstr ""
 "La méthode `get_parameters` accepte maintenant un dictionnaire de "
 "configuration, tout comme `get_properties`, `fit`, et `evaluate`."
 
-#: ../../source/ref-changelog.md:1183
+#: ../../source/ref-changelog.md:1205
 msgid ""
 "**Replace** `num_rounds` **in** `start_simulation` **with new** `config` "
 "**parameter** ([#1281](https://github.com/adap/flower/pull/1281))"
@@ -22787,7 +22906,7 @@ msgstr ""
 " `config` **paramètre** "
 "([#1281](https://github.com/adap/flower/pull/1281))"
 
-#: ../../source/ref-changelog.md:1185
+#: ../../source/ref-changelog.md:1207
 msgid ""
 "The `start_simulation` function now accepts a configuration dictionary "
 "`config` instead of the `num_rounds` integer. This improves the "
@@ -22799,7 +22918,7 @@ msgstr ""
 " cohérence entre `start_simulation` et `start_server` et facilite la "
 "transition entre les deux."
 
-#: ../../source/ref-changelog.md:1189
+#: ../../source/ref-changelog.md:1211
 msgid ""
 "**Support Python 3.10** "
 "([#1320](https://github.com/adap/flower/pull/1320))"
@@ -22807,7 +22926,7 @@ msgstr ""
 "**Support Python 3.10** "
 "([#1320](https://github.com/adap/flower/pull/1320))"
 
-#: ../../source/ref-changelog.md:1191
+#: ../../source/ref-changelog.md:1213
 msgid ""
 "The previous Flower release introduced experimental support for Python "
 "3.10, this release declares Python 3.10 support as stable."
@@ -22816,7 +22935,7 @@ msgstr ""
 "expérimentale de Python 3.10, cette version déclare la prise en charge de"
 " Python 3.10 comme stable."
 
-#: ../../source/ref-changelog.md:1193
+#: ../../source/ref-changelog.md:1215
 msgid ""
 "**Make all** `Client` **and** `NumPyClient` **methods optional** "
 "([#1260](https://github.com/adap/flower/pull/1260), "
@@ -22826,7 +22945,7 @@ msgstr ""
 "**facultatives** ([#1260](https://github.com/adap/flower/pull/1260), "
 "[#1277](https://github.com/adap/flower/pull/1277))"
 
-#: ../../source/ref-changelog.md:1195
+#: ../../source/ref-changelog.md:1217
 msgid ""
 "The `Client`/`NumPyClient` methods `get_properties`, `get_parameters`, "
 "`fit`, and `evaluate` are all optional. This enables writing clients that"
@@ -22839,7 +22958,7 @@ msgstr ""
 "méthode. Pas besoin d'implémenter `evaluate` quand on utilise "
 "l'évaluation centralisée !"
 
-#: ../../source/ref-changelog.md:1197
+#: ../../source/ref-changelog.md:1219
 msgid ""
 "**Enable passing a** `Server` **instance to** `start_simulation` "
 "([#1281](https://github.com/adap/flower/pull/1281))"
@@ -22847,7 +22966,7 @@ msgstr ""
 "**Autoriser le passage d'une **instance `Server` à** `start_simulation` "
 "([#1281](https://github.com/adap/flower/pull/1281))"
 
-#: ../../source/ref-changelog.md:1199
+#: ../../source/ref-changelog.md:1221
 msgid ""
 "Similar to `start_server`, `start_simulation` now accepts a full `Server`"
 " instance. This enables users to heavily customize the execution of "
@@ -22860,7 +22979,7 @@ msgstr ""
 "l'exécution, par exemple, de FL asynchrones à l'aide du moteur de client "
 "virtuel."
 
-#: ../../source/ref-changelog.md:1201
+#: ../../source/ref-changelog.md:1223
 msgid ""
 "**Update code examples** "
 "([#1291](https://github.com/adap/flower/pull/1291), "
@@ -22872,7 +22991,7 @@ msgstr ""
 "[#1286](https://github.com/adap/flower/pull/1286), "
 "[#1282](https://github.com/adap/flower/pull/1282))"
 
-#: ../../source/ref-changelog.md:1203
+#: ../../source/ref-changelog.md:1225
 msgid ""
 "Many code examples received small or even large maintenance updates, "
 "among them are"
@@ -22880,31 +22999,31 @@ msgstr ""
 "De nombreux exemples de code ont reçu de petites ou même de grandes mises"
 " à jour de maintenance"
 
-#: ../../source/ref-changelog.md:1205
+#: ../../source/ref-changelog.md:1227
 msgid "`scikit-learn`"
 msgstr "`scikit-learn`"
 
-#: ../../source/ref-changelog.md:1206
+#: ../../source/ref-changelog.md:1228
 msgid "`simulation_pytorch`"
 msgstr "`simulation_pytorch`"
 
-#: ../../source/ref-changelog.md:1207
+#: ../../source/ref-changelog.md:1229
 msgid "`quickstart_pytorch`"
 msgstr "`quickstart_pytorch` (démarrage rapide)"
 
-#: ../../source/ref-changelog.md:1208
+#: ../../source/ref-changelog.md:1230
 msgid "`quickstart_simulation`"
 msgstr "`quickstart_simulation`"
 
-#: ../../source/ref-changelog.md:1209
+#: ../../source/ref-changelog.md:1231
 msgid "`quickstart_tensorflow`"
 msgstr "`quickstart_tensorflow`"
 
-#: ../../source/ref-changelog.md:1210
+#: ../../source/ref-changelog.md:1232
 msgid "`advanced_tensorflow`"
 msgstr "`advanced_tensorflow` (en anglais)"
 
-#: ../../source/ref-changelog.md:1212
+#: ../../source/ref-changelog.md:1234
 msgid ""
 "**Remove the obsolete simulation example** "
 "([#1328](https://github.com/adap/flower/pull/1328))"
@@ -22912,7 +23031,7 @@ msgstr ""
 "**Supprime l'exemple de simulation obsolète** "
 "([#1328](https://github.com/adap/flower/pull/1328))"
 
-#: ../../source/ref-changelog.md:1214
+#: ../../source/ref-changelog.md:1236
 msgid ""
 "Removes the obsolete `simulation` example and renames "
 "`quickstart_simulation` to `simulation_tensorflow` so it fits withs the "
@@ -22922,7 +23041,7 @@ msgstr ""
 "`quickstart_simulation` en `simulation_tensorflow` pour qu'il corresponde"
 " au nom de `simulation_pytorch`"
 
-#: ../../source/ref-changelog.md:1216
+#: ../../source/ref-changelog.md:1238
 msgid ""
 "**Update documentation** "
 "([#1223](https://github.com/adap/flower/pull/1223), "
@@ -22948,7 +23067,7 @@ msgstr ""
 "[#1305](https://github.com/adap/flower/pull/1305), "
 "[#1307](https://github.com/adap/flower/pull/1307))"
 
-#: ../../source/ref-changelog.md:1218
+#: ../../source/ref-changelog.md:1240
 msgid ""
 "One substantial documentation update fixes multiple smaller rendering "
 "issues, makes titles more succinct to improve navigation, removes a "
@@ -22965,12 +23084,12 @@ msgstr ""
 "markdown, migre le changelog de `.rst` vers `.md`, et corrige un certain "
 "nombre de détails plus petits !"
 
-#: ../../source/ref-changelog.md:1220 ../../source/ref-changelog.md:1275
-#: ../../source/ref-changelog.md:1344 ../../source/ref-changelog.md:1383
+#: ../../source/ref-changelog.md:1242 ../../source/ref-changelog.md:1297
+#: ../../source/ref-changelog.md:1366 ../../source/ref-changelog.md:1405
 msgid "**Minor updates**"
 msgstr "**Mises à jour mineures**"
 
-#: ../../source/ref-changelog.md:1222
+#: ../../source/ref-changelog.md:1244
 msgid ""
 "Add round number to fit and evaluate log messages "
 "([#1266](https://github.com/adap/flower/pull/1266))"
@@ -22978,7 +23097,7 @@ msgstr ""
 "Ajoute un chiffre rond pour ajuster et évaluer les messages du journal "
 "([#1266](https://github.com/adap/flower/pull/1266))"
 
-#: ../../source/ref-changelog.md:1223
+#: ../../source/ref-changelog.md:1245
 msgid ""
 "Add secure gRPC connection to the `advanced_tensorflow` code example "
 "([#847](https://github.com/adap/flower/pull/847))"
@@ -22986,7 +23105,7 @@ msgstr ""
 "Ajouter une connexion gRPC sécurisée à l'exemple de code "
 "`advanced_tensorflow` ([#847](https://github.com/adap/flower/pull/847))"
 
-#: ../../source/ref-changelog.md:1224
+#: ../../source/ref-changelog.md:1246
 msgid ""
 "Update developer tooling "
 "([#1231](https://github.com/adap/flower/pull/1231), "
@@ -23000,7 +23119,7 @@ msgstr ""
 "[#1301](https://github.com/adap/flower/pull/1301), "
 "[#1310](https://github.com/adap/flower/pull/1310))"
 
-#: ../../source/ref-changelog.md:1225
+#: ../../source/ref-changelog.md:1247
 msgid ""
 "Rename ProtoBuf messages to improve consistency "
 "([#1214](https://github.com/adap/flower/pull/1214), "
@@ -23012,11 +23131,11 @@ msgstr ""
 "[#1258](https://github.com/adap/flower/pull/1258), "
 "[#1259](https://github.com/adap/flower/pull/1259))"
 
-#: ../../source/ref-changelog.md:1227
+#: ../../source/ref-changelog.md:1249
 msgid "v0.19.0 (2022-05-18)"
 msgstr "v0.19.0 (2022-05-18)"
 
-#: ../../source/ref-changelog.md:1231
+#: ../../source/ref-changelog.md:1253
 msgid ""
 "**Flower Baselines (preview): FedOpt, FedBN, FedAvgM** "
 "([#919](https://github.com/adap/flower/pull/919), "
@@ -23028,7 +23147,7 @@ msgstr ""
 "[#1127](https://github.com/adap/flower/pull/1127), "
 "[#914](https://github.com/adap/flower/pull/914))"
 
-#: ../../source/ref-changelog.md:1233
+#: ../../source/ref-changelog.md:1255
 #, fuzzy
 msgid ""
 "The first preview release of Flower Baselines has arrived! We're "
@@ -23047,7 +23166,7 @@ msgstr ""
 "également la communauté à [contribuer à leurs propres lignes de "
 "base](https://flower.ai/docs/baselines/how-to-contribute-baselines.html)."
 
-#: ../../source/ref-changelog.md:1235
+#: ../../source/ref-changelog.md:1257
 msgid ""
 "**C++ client SDK (preview) and code example** "
 "([#1111](https://github.com/adap/flower/pull/1111))"
@@ -23055,7 +23174,7 @@ msgstr ""
 "**SDK client C++ (aperçu) et exemple de code** "
 "([#1111](https://github.com/adap/flower/pull/1111))"
 
-#: ../../source/ref-changelog.md:1237
+#: ../../source/ref-changelog.md:1259
 msgid ""
 "Preview support for Flower clients written in C++. The C++ preview "
 "includes a Flower client SDK and a quickstart code example that "
@@ -23065,7 +23184,7 @@ msgstr ""
 "code de démarrage rapide qui démontre un client C++ simple utilisant le "
 "SDK."
 
-#: ../../source/ref-changelog.md:1239
+#: ../../source/ref-changelog.md:1261
 msgid ""
 "**Add experimental support for Python 3.10 and Python 3.11** "
 "([#1135](https://github.com/adap/flower/pull/1135))"
@@ -23073,7 +23192,7 @@ msgstr ""
 "**Ajouter la prise en charge expérimentale de Python 3.10 et Python "
 "3.11** ([#1135](https://github.com/adap/flower/pull/1135))"
 
-#: ../../source/ref-changelog.md:1241
+#: ../../source/ref-changelog.md:1263
 msgid ""
 "Python 3.10 is the latest stable release of Python and Python 3.11 is due"
 " to be released in October. This Flower release adds experimental support"
@@ -23083,7 +23202,7 @@ msgstr ""
 "devrait sortir en octobre. Cette version de Flower ajoute une prise en "
 "charge expérimentale pour les deux versions de Python."
 
-#: ../../source/ref-changelog.md:1243
+#: ../../source/ref-changelog.md:1265
 msgid ""
 "**Aggregate custom metrics through user-provided functions** "
 "([#1144](https://github.com/adap/flower/pull/1144))"
@@ -23091,7 +23210,7 @@ msgstr ""
 "**Agréger des mesures personnalisées grâce à des fonctions fournies par "
 "l'utilisateur** ([#1144](https://github.com/adap/flower/pull/1144))"
 
-#: ../../source/ref-changelog.md:1245
+#: ../../source/ref-changelog.md:1267
 msgid ""
 "Custom metrics (e.g., `accuracy`) can now be aggregated without having to"
 " customize the strategy. Built-in strategies support two new arguments, "
@@ -23103,7 +23222,7 @@ msgstr ""
 "permettent de passer des fonctions d'agrégation de métriques "
 "personnalisées."
 
-#: ../../source/ref-changelog.md:1247
+#: ../../source/ref-changelog.md:1269
 msgid ""
 "**User-configurable round timeout** "
 "([#1162](https://github.com/adap/flower/pull/1162))"
@@ -23111,7 +23230,7 @@ msgstr ""
 "**Temps d'attente configurable par l'utilisateur** "
 "([#1162](https://github.com/adap/flower/pull/1162))"
 
-#: ../../source/ref-changelog.md:1249
+#: ../../source/ref-changelog.md:1271
 msgid ""
 "A new configuration value allows the round timeout to be set for "
 "`start_server` and `start_simulation`. If the `config` dictionary "
@@ -23123,7 +23242,7 @@ msgstr ""
 "valeur `float` en secondes), le serveur attendra *au moins* "
 "`round_timeout` secondes avant de fermer la connexion."
 
-#: ../../source/ref-changelog.md:1251
+#: ../../source/ref-changelog.md:1273
 msgid ""
 "**Enable both federated evaluation and centralized evaluation to be used "
 "at the same time in all built-in strategies** "
@@ -23133,7 +23252,7 @@ msgstr ""
 "l'évaluation centralisée dans toutes les stratégies intégrées** "
 "([#1091](https://github.com/adap/flower/pull/1091))"
 
-#: ../../source/ref-changelog.md:1253
+#: ../../source/ref-changelog.md:1275
 msgid ""
 "Built-in strategies can now perform both federated evaluation (i.e., "
 "client-side) and centralized evaluation (i.e., server-side) in the same "
@@ -23145,7 +23264,7 @@ msgstr ""
 "(c'est-à-dire côté serveur) dans le même tour. L'évaluation fédérée peut "
 "être désactivée en réglant `fraction_eval` sur `0.0`."
 
-#: ../../source/ref-changelog.md:1255
+#: ../../source/ref-changelog.md:1277
 msgid ""
 "**Two new Jupyter Notebook tutorials** "
 "([#1141](https://github.com/adap/flower/pull/1141))"
@@ -23153,7 +23272,7 @@ msgstr ""
 "**Deux nouveaux tutoriels Jupyter Notebook** "
 "([#1141](https://github.com/adap/flower/pull/1141))"
 
-#: ../../source/ref-changelog.md:1257
+#: ../../source/ref-changelog.md:1279
 msgid ""
 "Two Jupyter Notebook tutorials (compatible with Google Colab) explain "
 "basic and intermediate Flower features:"
@@ -23161,7 +23280,7 @@ msgstr ""
 "Deux tutoriels Jupyter Notebook (compatibles avec Google Colab) "
 "expliquent les fonctionnalités de base et intermédiaires de Flower :"
 
-#: ../../source/ref-changelog.md:1259
+#: ../../source/ref-changelog.md:1281
 msgid ""
 "*An Introduction to Federated Learning*: [Open in "
 "Colab](https://colab.research.google.com/github/adap/flower/blob/main/tutorials/Flower-1"
@@ -23171,7 +23290,7 @@ msgstr ""
 "Colab](https://colab.research.google.com/github/adap/flower/blob/main/tutorials/Flower-1"
 "-Intro-to-FL-PyTorch.ipynb)"
 
-#: ../../source/ref-changelog.md:1261
+#: ../../source/ref-changelog.md:1283
 msgid ""
 "*Using Strategies in Federated Learning*: [Open in "
 "Colab](https://colab.research.google.com/github/adap/flower/blob/main/tutorials/Flower-2"
@@ -23181,7 +23300,7 @@ msgstr ""
 "Colab](https://colab.research.google.com/github/adap/flower/blob/main/tutorials/Flower-2"
 "-Strategies-in-FL-PyTorch.ipynb)"
 
-#: ../../source/ref-changelog.md:1263
+#: ../../source/ref-changelog.md:1285
 msgid ""
 "**New FedAvgM strategy (Federated Averaging with Server Momentum)** "
 "([#1076](https://github.com/adap/flower/pull/1076))"
@@ -23189,7 +23308,7 @@ msgstr ""
 "**Nouvelle stratégie FedAvgM (Federated Averaging with Server Momentum)**"
 " ([#1076](https://github.com/adap/flower/pull/1076))"
 
-#: ../../source/ref-changelog.md:1265
+#: ../../source/ref-changelog.md:1287
 #, fuzzy
 msgid ""
 "The new `FedAvgM` strategy implements Federated Averaging with Server "
@@ -23198,7 +23317,7 @@ msgstr ""
 "La nouvelle stratégie `FedAvgM` met en œuvre la moyenne fédérée avec le "
 "momentum du serveur [Hsu et al., 2019]."
 
-#: ../../source/ref-changelog.md:1267
+#: ../../source/ref-changelog.md:1289
 msgid ""
 "**New advanced PyTorch code example** "
 "([#1007](https://github.com/adap/flower/pull/1007))"
@@ -23206,7 +23325,7 @@ msgstr ""
 "**Nouvel exemple de code PyTorch avancé** "
 "([#1007](https://github.com/adap/flower/pull/1007))"
 
-#: ../../source/ref-changelog.md:1269
+#: ../../source/ref-changelog.md:1291
 msgid ""
 "A new code example (`advanced_pytorch`) demonstrates advanced Flower "
 "concepts with PyTorch."
@@ -23214,7 +23333,7 @@ msgstr ""
 "Un nouvel exemple de code (`advanced_pytorch`) démontre des concepts de "
 "fleur avancés avec PyTorch."
 
-#: ../../source/ref-changelog.md:1271
+#: ../../source/ref-changelog.md:1293
 msgid ""
 "**New JAX code example** "
 "([#906](https://github.com/adap/flower/pull/906), "
@@ -23224,7 +23343,7 @@ msgstr ""
 "([#906](https://github.com/adap/flower/pull/906), "
 "[#1143](https://github.com/adap/flower/pull/1143))"
 
-#: ../../source/ref-changelog.md:1273
+#: ../../source/ref-changelog.md:1295
 msgid ""
 "A new code example (`jax_from_centralized_to_federated`) shows federated "
 "learning with JAX and Flower."
@@ -23232,7 +23351,7 @@ msgstr ""
 "Un nouvel exemple de code (`jax_from_centralized_to_federated`) montre "
 "l'apprentissage fédéré avec JAX et Flower."
 
-#: ../../source/ref-changelog.md:1277
+#: ../../source/ref-changelog.md:1299
 msgid ""
 "New option to keep Ray running if Ray was already initialized in "
 "`start_simulation` ([#1177](https://github.com/adap/flower/pull/1177))"
@@ -23241,7 +23360,7 @@ msgstr ""
 "initialisé dans `start_simulation` "
 "([#1177](https://github.com/adap/flower/pull/1177))"
 
-#: ../../source/ref-changelog.md:1278
+#: ../../source/ref-changelog.md:1300
 msgid ""
 "Add support for custom `ClientManager` as a `start_simulation` parameter "
 "([#1171](https://github.com/adap/flower/pull/1171))"
@@ -23250,7 +23369,7 @@ msgstr ""
 "paramètre de `start_simulation` "
 "([#1171](https://github.com/adap/flower/pull/1171))"
 
-#: ../../source/ref-changelog.md:1279
+#: ../../source/ref-changelog.md:1301
 #, fuzzy
 msgid ""
 "New documentation for [implementing "
@@ -23263,7 +23382,7 @@ msgstr ""
 "strategies.html) ([#1097](https://github.com/adap/flower/pull/1097), "
 "[#1175](https://github.com/adap/flower/pull/1175))"
 
-#: ../../source/ref-changelog.md:1280
+#: ../../source/ref-changelog.md:1302
 msgid ""
 "New mobile-friendly documentation theme "
 "([#1174](https://github.com/adap/flower/pull/1174))"
@@ -23271,7 +23390,7 @@ msgstr ""
 "Nouveau thème de documentation adapté aux mobiles "
 "([#1174](https://github.com/adap/flower/pull/1174))"
 
-#: ../../source/ref-changelog.md:1281
+#: ../../source/ref-changelog.md:1303
 msgid ""
 "Limit version range for (optional) `ray` dependency to include only "
 "compatible releases (`>=1.9.2,<1.12.0`) "
@@ -23281,7 +23400,7 @@ msgstr ""
 "n'inclure que les versions compatibles (`>=1.9.2,<1.12.0`) "
 "([#1205](https://github.com/adap/flower/pull/1205))"
 
-#: ../../source/ref-changelog.md:1285
+#: ../../source/ref-changelog.md:1307
 msgid ""
 "**Remove deprecated support for Python 3.6** "
 "([#871](https://github.com/adap/flower/pull/871))"
@@ -23289,7 +23408,7 @@ msgstr ""
 "**Supprime la prise en charge obsolète de Python 3.6** "
 "([#871](https://github.com/adap/flower/pull/871))"
 
-#: ../../source/ref-changelog.md:1286
+#: ../../source/ref-changelog.md:1308
 msgid ""
 "**Remove deprecated KerasClient** "
 "([#857](https://github.com/adap/flower/pull/857))"
@@ -23297,7 +23416,7 @@ msgstr ""
 "**Supprimez KerasClient** "
 "([#857](https://github.com/adap/flower/pull/857))"
 
-#: ../../source/ref-changelog.md:1287
+#: ../../source/ref-changelog.md:1309
 msgid ""
 "**Remove deprecated no-op extra installs** "
 "([#973](https://github.com/adap/flower/pull/973))"
@@ -23305,7 +23424,7 @@ msgstr ""
 "**Supprimer les installations supplémentaires no-op dépréciées** "
 "([#973](https://github.com/adap/flower/pull/973))"
 
-#: ../../source/ref-changelog.md:1288
+#: ../../source/ref-changelog.md:1310
 msgid ""
 "**Remove deprecated proto fields from** `FitRes` **and** `EvaluateRes` "
 "([#869](https://github.com/adap/flower/pull/869))"
@@ -23313,7 +23432,7 @@ msgstr ""
 "**Supprimez les champs proto obsolètes de** `FitRes` **et** `EvaluateRes`"
 " ([#869](https://github.com/adap/flower/pull/869))"
 
-#: ../../source/ref-changelog.md:1289
+#: ../../source/ref-changelog.md:1311
 msgid ""
 "**Remove deprecated QffedAvg strategy (replaced by QFedAvg)** "
 "([#1107](https://github.com/adap/flower/pull/1107))"
@@ -23321,7 +23440,7 @@ msgstr ""
 "**Supprime la stratégie QffedAvg (remplacée par QFedAvg)** "
 "([#1107](https://github.com/adap/flower/pull/1107))"
 
-#: ../../source/ref-changelog.md:1290
+#: ../../source/ref-changelog.md:1312
 msgid ""
 "**Remove deprecated DefaultStrategy strategy** "
 "([#1142](https://github.com/adap/flower/pull/1142))"
@@ -23329,7 +23448,7 @@ msgstr ""
 "**Supprime la stratégie DefaultStrategy qui est obsolète** "
 "([#1142](https://github.com/adap/flower/pull/1142))"
 
-#: ../../source/ref-changelog.md:1291
+#: ../../source/ref-changelog.md:1313
 msgid ""
 "**Remove deprecated support for eval_fn accuracy return value** "
 "([#1142](https://github.com/adap/flower/pull/1142))"
@@ -23337,7 +23456,7 @@ msgstr ""
 "**Supprimer la prise en charge obsolète de la valeur de retour de la "
 "précision eval_fn** ([#1142](https://github.com/adap/flower/pull/1142))"
 
-#: ../../source/ref-changelog.md:1292
+#: ../../source/ref-changelog.md:1314
 msgid ""
 "**Remove deprecated support for passing initial parameters as NumPy "
 "ndarrays** ([#1142](https://github.com/adap/flower/pull/1142))"
@@ -23346,11 +23465,11 @@ msgstr ""
 " en tant que ndarrays NumPy** "
 "([#1142](https://github.com/adap/flower/pull/1142))"
 
-#: ../../source/ref-changelog.md:1294
+#: ../../source/ref-changelog.md:1316
 msgid "v0.18.0 (2022-02-28)"
 msgstr "v0.18.0 (2022-02-28)"
 
-#: ../../source/ref-changelog.md:1298
+#: ../../source/ref-changelog.md:1320
 msgid ""
 "**Improved Virtual Client Engine compatibility with Jupyter Notebook / "
 "Google Colab** ([#866](https://github.com/adap/flower/pull/866), "
@@ -23365,7 +23484,7 @@ msgstr ""
 "[#833](https://github.com/adap/flower/pull/833), "
 "[#1036](https://github.com/adap/flower/pull/1036))"
 
-#: ../../source/ref-changelog.md:1300
+#: ../../source/ref-changelog.md:1322
 msgid ""
 "Simulations (using the Virtual Client Engine through `start_simulation`) "
 "now work more smoothly on Jupyter Notebooks (incl. Google Colab) after "
@@ -23377,7 +23496,7 @@ msgstr ""
 "Notebooks Jupyter (y compris Google Colab) après avoir installé Flower "
 "avec l'option `simulation` (`pip install 'flwr[simulation]'`)."
 
-#: ../../source/ref-changelog.md:1302
+#: ../../source/ref-changelog.md:1324
 msgid ""
 "**New Jupyter Notebook code example** "
 "([#833](https://github.com/adap/flower/pull/833))"
@@ -23385,7 +23504,7 @@ msgstr ""
 "**Nouvel exemple de code Jupyter Notebook** "
 "([#833](https://github.com/adap/flower/pull/833))"
 
-#: ../../source/ref-changelog.md:1304
+#: ../../source/ref-changelog.md:1326
 msgid ""
 "A new code example (`quickstart_simulation`) demonstrates Flower "
 "simulations using the Virtual Client Engine through Jupyter Notebook "
@@ -23395,7 +23514,7 @@ msgstr ""
 "simulations de Flower en utilisant le moteur de client virtuel via "
 "Jupyter Notebook (y compris Google Colab)."
 
-#: ../../source/ref-changelog.md:1306
+#: ../../source/ref-changelog.md:1328
 msgid ""
 "**Client properties (feature preview)** "
 "([#795](https://github.com/adap/flower/pull/795))"
@@ -23403,7 +23522,7 @@ msgstr ""
 "**Propriétés du client (aperçu des fonctionnalités)** "
 "([#795](https://github.com/adap/flower/pull/795))"
 
-#: ../../source/ref-changelog.md:1308
+#: ../../source/ref-changelog.md:1330
 msgid ""
 "Clients can implement a new method `get_properties` to enable server-side"
 " strategies to query client properties."
@@ -23412,7 +23531,7 @@ msgstr ""
 "pour permettre aux stratégies côté serveur d'interroger les propriétés du"
 " client."
 
-#: ../../source/ref-changelog.md:1310
+#: ../../source/ref-changelog.md:1332
 msgid ""
 "**Experimental Android support with TFLite** "
 "([#865](https://github.com/adap/flower/pull/865))"
@@ -23420,7 +23539,7 @@ msgstr ""
 "**Support expérimental d'Android avec TFLite** "
 "([#865](https://github.com/adap/flower/pull/865))"
 
-#: ../../source/ref-changelog.md:1312
+#: ../../source/ref-changelog.md:1334
 msgid ""
 "Android support has finally arrived in `main`! Flower is both client-"
 "agnostic and framework-agnostic by design. One can integrate arbitrary "
@@ -23432,7 +23551,7 @@ msgstr ""
 "intégrer des plates-formes client arbitraires et avec cette version, "
 "l'utilisation de Flower sur Android est devenue beaucoup plus facile."
 
-#: ../../source/ref-changelog.md:1314
+#: ../../source/ref-changelog.md:1336
 msgid ""
 "The example uses TFLite on the client side, along with a new "
 "`FedAvgAndroid` strategy. The Android client and `FedAvgAndroid` are "
@@ -23446,7 +23565,7 @@ msgstr ""
 "part entière et une implémentation unifiée de `FedAvg` intégrant la "
 "nouvelle fonctionnalité de `FedAvgAndroid`."
 
-#: ../../source/ref-changelog.md:1316
+#: ../../source/ref-changelog.md:1338
 msgid ""
 "**Make gRPC keepalive time user-configurable and decrease default "
 "keepalive time** ([#1069](https://github.com/adap/flower/pull/1069))"
@@ -23455,7 +23574,7 @@ msgstr ""
 "diminuer le temps de garde par défaut** "
 "([#1069](https://github.com/adap/flower/pull/1069))"
 
-#: ../../source/ref-changelog.md:1318
+#: ../../source/ref-changelog.md:1340
 msgid ""
 "The default gRPC keepalive time has been reduced to increase the "
 "compatibility of Flower with more cloud environments (for example, "
@@ -23468,7 +23587,7 @@ msgstr ""
 "de keepalive pour personnaliser la pile gRPC en fonction d'exigences "
 "spécifiques."
 
-#: ../../source/ref-changelog.md:1320
+#: ../../source/ref-changelog.md:1342
 msgid ""
 "**New differential privacy example using Opacus and PyTorch** "
 "([#805](https://github.com/adap/flower/pull/805))"
@@ -23476,7 +23595,7 @@ msgstr ""
 "**Nouvel exemple de confidentialité différentielle utilisant Opacus et "
 "PyTorch** ([#805](https://github.com/adap/flower/pull/805))"
 
-#: ../../source/ref-changelog.md:1322
+#: ../../source/ref-changelog.md:1344
 msgid ""
 "A new code example (`opacus`) demonstrates differentially-private "
 "federated learning with Opacus, PyTorch, and Flower."
@@ -23484,7 +23603,7 @@ msgstr ""
 "Un nouvel exemple de code (`opacus`) démontre l'apprentissage fédéré "
 "différentiellement privé avec Opacus, PyTorch et Flower."
 
-#: ../../source/ref-changelog.md:1324
+#: ../../source/ref-changelog.md:1346
 msgid ""
 "**New Hugging Face Transformers code example** "
 "([#863](https://github.com/adap/flower/pull/863))"
@@ -23492,7 +23611,7 @@ msgstr ""
 "**Nouvel exemple de code pour les Transformers à visage embrassant** "
 "([#863](https://github.com/adap/flower/pull/863))"
 
-#: ../../source/ref-changelog.md:1326
+#: ../../source/ref-changelog.md:1348
 msgid ""
 "A new code example (`quickstart_huggingface`) demonstrates usage of "
 "Hugging Face Transformers with Flower."
@@ -23500,7 +23619,7 @@ msgstr ""
 "Un nouvel exemple de code (`quickstart_huggingface`) démontre "
 "l'utilisation des transformateurs Hugging Face avec Flower."
 
-#: ../../source/ref-changelog.md:1328
+#: ../../source/ref-changelog.md:1350
 msgid ""
 "**New MLCube code example** "
 "([#779](https://github.com/adap/flower/pull/779), "
@@ -23514,7 +23633,7 @@ msgstr ""
 "[#1065](https://github.com/adap/flower/pull/1065), "
 "[#1090](https://github.com/adap/flower/pull/1090))"
 
-#: ../../source/ref-changelog.md:1330
+#: ../../source/ref-changelog.md:1352
 msgid ""
 "A new code example (`quickstart_mlcube`) demonstrates usage of MLCube "
 "with Flower."
@@ -23522,7 +23641,7 @@ msgstr ""
 "Un nouvel exemple de code (`quickstart_mlcube`) démontre l'utilisation de"
 " MLCube avec Flower."
 
-#: ../../source/ref-changelog.md:1332
+#: ../../source/ref-changelog.md:1354
 msgid ""
 "**SSL-enabled server and client** "
 "([#842](https://github.com/adap/flower/pull/842),  "
@@ -23539,7 +23658,7 @@ msgstr ""
 "[#993](https://github.com/adap/flower/pull/993), "
 "[#994](https://github.com/adap/flower/pull/994))"
 
-#: ../../source/ref-changelog.md:1334
+#: ../../source/ref-changelog.md:1356
 msgid ""
 "SSL enables secure encrypted connections between clients and servers. "
 "This release open-sources the Flower secure gRPC implementation to make "
@@ -23550,7 +23669,7 @@ msgstr ""
 "l'implémentation gRPC sécurisée de Flower afin de rendre les canaux de "
 "communication cryptés accessibles à tous les utilisateurs de Flower."
 
-#: ../../source/ref-changelog.md:1336
+#: ../../source/ref-changelog.md:1358
 msgid ""
 "**Updated** `FedAdam` **and** `FedYogi` **strategies** "
 "([#885](https://github.com/adap/flower/pull/885), "
@@ -23560,7 +23679,7 @@ msgstr ""
 "([#885](https://github.com/adap/flower/pull/885), "
 "[#895](https://github.com/adap/flower/pull/895))"
 
-#: ../../source/ref-changelog.md:1338
+#: ../../source/ref-changelog.md:1360
 msgid ""
 "`FedAdam` and `FedAdam` match the latest version of the Adaptive "
 "Federated Optimization paper."
@@ -23568,7 +23687,7 @@ msgstr ""
 "`FedAdam` et `FedAdam` correspondent à la dernière version de l'article "
 "sur l'optimisation fédérée adaptative."
 
-#: ../../source/ref-changelog.md:1340
+#: ../../source/ref-changelog.md:1362
 msgid ""
 "**Initialize** `start_simulation` **with a list of client IDs** "
 "([#860](https://github.com/adap/flower/pull/860))"
@@ -23576,7 +23695,7 @@ msgstr ""
 "**Initialise** `start_simulation` **avec une liste d'ID de clients** "
 "([#860](https://github.com/adap/flower/pull/860))"
 
-#: ../../source/ref-changelog.md:1342
+#: ../../source/ref-changelog.md:1364
 msgid ""
 "`start_simulation` can now be called with a list of client IDs "
 "(`clients_ids`, type: `List[str]`). Those IDs will be passed to the "
@@ -23590,7 +23709,7 @@ msgstr ""
 "être initialisé, ce qui peut faciliter le chargement de partitions de "
 "données qui ne sont pas accessibles par des identifiants `int`."
 
-#: ../../source/ref-changelog.md:1346
+#: ../../source/ref-changelog.md:1368
 msgid ""
 "Update `num_examples` calculation in PyTorch code examples in "
 "([#909](https://github.com/adap/flower/pull/909))"
@@ -23598,7 +23717,7 @@ msgstr ""
 "Mettre à jour le calcul de `num_examples` dans les exemples de code "
 "PyTorch dans ([#909](https://github.com/adap/flower/pull/909))"
 
-#: ../../source/ref-changelog.md:1347
+#: ../../source/ref-changelog.md:1369
 msgid ""
 "Expose Flower version through `flwr.__version__` "
 "([#952](https://github.com/adap/flower/pull/952))"
@@ -23606,7 +23725,7 @@ msgstr ""
 "Exposer la version de Flower à travers `flwr.__version__` "
 "([#952](https://github.com/adap/flower/pull/952))"
 
-#: ../../source/ref-changelog.md:1348
+#: ../../source/ref-changelog.md:1370
 msgid ""
 "`start_server` in `app.py` now returns a `History` object containing "
 "metrics from training ([#974](https://github.com/adap/flower/pull/974))"
@@ -23615,7 +23734,7 @@ msgstr ""
 "contenant les métriques de l'entraînement "
 "([#974](https://github.com/adap/flower/pull/974))"
 
-#: ../../source/ref-changelog.md:1349
+#: ../../source/ref-changelog.md:1371
 msgid ""
 "Make `max_workers` (used by `ThreadPoolExecutor`) configurable "
 "([#978](https://github.com/adap/flower/pull/978))"
@@ -23623,7 +23742,7 @@ msgstr ""
 "Rendre `max_workers` (utilisé par `ThreadPoolExecutor`) configurable "
 "([#978](https://github.com/adap/flower/pull/978))"
 
-#: ../../source/ref-changelog.md:1350
+#: ../../source/ref-changelog.md:1372
 msgid ""
 "Increase sleep time after server start to three seconds in all code "
 "examples ([#1086](https://github.com/adap/flower/pull/1086))"
@@ -23632,7 +23751,7 @@ msgstr ""
 "secondes dans tous les exemples de code "
 "([#1086](https://github.com/adap/flower/pull/1086))"
 
-#: ../../source/ref-changelog.md:1351
+#: ../../source/ref-changelog.md:1373
 msgid ""
 "Added a new FAQ section to the documentation "
 "([#948](https://github.com/adap/flower/pull/948))"
@@ -23640,7 +23759,7 @@ msgstr ""
 "Ajout d'une nouvelle section FAQ à la documentation "
 "([#948](https://github.com/adap/flower/pull/948))"
 
-#: ../../source/ref-changelog.md:1352
+#: ../../source/ref-changelog.md:1374
 msgid ""
 "And many more under-the-hood changes, library updates, documentation "
 "changes, and tooling improvements!"
@@ -23649,7 +23768,7 @@ msgstr ""
 "bibliothèque, des modifications de la documentation et des améliorations "
 "de l'outillage !"
 
-#: ../../source/ref-changelog.md:1356
+#: ../../source/ref-changelog.md:1378
 msgid ""
 "**Removed** `flwr_example` **and** `flwr_experimental` **from release "
 "build** ([#869](https://github.com/adap/flower/pull/869))"
@@ -23657,7 +23776,7 @@ msgstr ""
 "**Supprimé** `flwr_example` **et** `flwr_experimental` **de la version "
 "release build** ([#869](https://github.com/adap/flower/pull/869))"
 
-#: ../../source/ref-changelog.md:1358
+#: ../../source/ref-changelog.md:1380
 msgid ""
 "The packages `flwr_example` and `flwr_experimental` have been deprecated "
 "since Flower 0.12.0 and they are not longer included in Flower release "
@@ -23671,11 +23790,11 @@ msgstr ""
 "tensorflow`, `http-logger`, `ops`) sont maintenant no-op et seront "
 "supprimés dans une prochaine version."
 
-#: ../../source/ref-changelog.md:1360
+#: ../../source/ref-changelog.md:1382
 msgid "v0.17.0 (2021-09-24)"
 msgstr "v0.17.0 (2021-09-24)"
 
-#: ../../source/ref-changelog.md:1364
+#: ../../source/ref-changelog.md:1386
 msgid ""
 "**Experimental virtual client engine** "
 "([#781](https://github.com/adap/flower/pull/781) "
@@ -23687,7 +23806,7 @@ msgstr ""
 "[#790](https://github.com/adap/flower/pull/790) "
 "[#791](https://github.com/adap/flower/pull/791))"
 
-#: ../../source/ref-changelog.md:1366
+#: ../../source/ref-changelog.md:1388
 msgid ""
 "One of Flower's goals is to enable research at scale. This release "
 "enables a first (experimental) peek at a major new feature, codenamed the"
@@ -23705,7 +23824,7 @@ msgstr ""
 "fonctionnalité est de regarder les deux nouveaux exemples de code appelés"
 " `quickstart_simulation` et `simulation_pytorch`."
 
-#: ../../source/ref-changelog.md:1368
+#: ../../source/ref-changelog.md:1390
 msgid ""
 "The feature is still experimental, so there's no stability guarantee for "
 "the API. It's also not quite ready for prime time and comes with a few "
@@ -23718,7 +23837,7 @@ msgstr ""
 " les personnes curieuses sont encouragées à l'essayer et à faire part de "
 "leurs réflexions."
 
-#: ../../source/ref-changelog.md:1370
+#: ../../source/ref-changelog.md:1392
 msgid ""
 "**New built-in strategies** "
 "([#828](https://github.com/adap/flower/pull/828) "
@@ -23728,7 +23847,7 @@ msgstr ""
 "([#828](https://github.com/adap/flower/pull/828) "
 "[#822](https://github.com/adap/flower/pull/822))"
 
-#: ../../source/ref-changelog.md:1372
+#: ../../source/ref-changelog.md:1394
 msgid ""
 "FedYogi - Federated learning strategy using Yogi on server-side. "
 "Implementation based on https://arxiv.org/abs/2003.00295"
@@ -23736,7 +23855,7 @@ msgstr ""
 "FedYogi - Stratégie d'apprentissage fédéré utilisant Yogi côté serveur. "
 "Mise en oeuvre basée sur https://arxiv.org/abs/2003.00295"
 
-#: ../../source/ref-changelog.md:1373
+#: ../../source/ref-changelog.md:1395
 msgid ""
 "FedAdam - Federated learning strategy using Adam on server-side. "
 "Implementation based on https://arxiv.org/abs/2003.00295"
@@ -23744,7 +23863,7 @@ msgstr ""
 "FedAdam - Stratégie d'apprentissage fédéré utilisant Adam côté serveur. "
 "Mise en œuvre basée sur https://arxiv.org/abs/2003.00295"
 
-#: ../../source/ref-changelog.md:1375
+#: ../../source/ref-changelog.md:1397
 msgid ""
 "**New PyTorch Lightning code example** "
 "([#617](https://github.com/adap/flower/pull/617))"
@@ -23752,7 +23871,7 @@ msgstr ""
 "**Nouvel exemple de code PyTorch Lightning** "
 "([#617](https://github.com/adap/flower/pull/617))"
 
-#: ../../source/ref-changelog.md:1377
+#: ../../source/ref-changelog.md:1399
 msgid ""
 "**New Variational Auto-Encoder code example** "
 "([#752](https://github.com/adap/flower/pull/752))"
@@ -23760,7 +23879,7 @@ msgstr ""
 "**Nouvel exemple de code d'autocodage variationnel** "
 "([#752](https://github.com/adap/flower/pull/752))"
 
-#: ../../source/ref-changelog.md:1379
+#: ../../source/ref-changelog.md:1401
 msgid ""
 "**New scikit-learn code example** "
 "([#748](https://github.com/adap/flower/pull/748))"
@@ -23768,7 +23887,7 @@ msgstr ""
 "**Nouvel exemple de code scikit-learn** "
 "([#748](https://github.com/adap/flower/pull/748))"
 
-#: ../../source/ref-changelog.md:1381
+#: ../../source/ref-changelog.md:1403
 msgid ""
 "**New experimental TensorBoard strategy** "
 "([#789](https://github.com/adap/flower/pull/789))"
@@ -23776,7 +23895,7 @@ msgstr ""
 "**Nouvelle stratégie expérimentale TensorBoard** "
 "([#789](https://github.com/adap/flower/pull/789))"
 
-#: ../../source/ref-changelog.md:1385
+#: ../../source/ref-changelog.md:1407
 msgid ""
 "Improved advanced TensorFlow code example "
 "([#769](https://github.com/adap/flower/pull/769))"
@@ -23784,7 +23903,7 @@ msgstr ""
 "Amélioration de l'exemple de code TensorFlow avancé "
 "([#769](https://github.com/adap/flower/pull/769))"
 
-#: ../../source/ref-changelog.md:1386
+#: ../../source/ref-changelog.md:1408
 msgid ""
 "Warning when `min_available_clients` is misconfigured "
 "([#830](https://github.com/adap/flower/pull/830))"
@@ -23792,7 +23911,7 @@ msgstr ""
 "Avertissement lorsque `min_available_clients` est mal configuré "
 "([#830](https://github.com/adap/flower/pull/830))"
 
-#: ../../source/ref-changelog.md:1387
+#: ../../source/ref-changelog.md:1409
 msgid ""
 "Improved gRPC server docs "
 "([#841](https://github.com/adap/flower/pull/841))"
@@ -23800,7 +23919,7 @@ msgstr ""
 "Amélioration de la documentation sur le serveur gRPC "
 "([#841](https://github.com/adap/flower/pull/841))"
 
-#: ../../source/ref-changelog.md:1388
+#: ../../source/ref-changelog.md:1410
 msgid ""
 "Improved error message in `NumPyClient` "
 "([#851](https://github.com/adap/flower/pull/851))"
@@ -23808,7 +23927,7 @@ msgstr ""
 "Amélioration du message d'erreur dans `NumPyClient` "
 "([#851](https://github.com/adap/flower/pull/851))"
 
-#: ../../source/ref-changelog.md:1389
+#: ../../source/ref-changelog.md:1411
 msgid ""
 "Improved PyTorch quickstart code example "
 "([#852](https://github.com/adap/flower/pull/852))"
@@ -23816,7 +23935,7 @@ msgstr ""
 "Exemple de code de démarrage rapide PyTorch amélioré "
 "([#852](https://github.com/adap/flower/pull/852))"
 
-#: ../../source/ref-changelog.md:1393
+#: ../../source/ref-changelog.md:1415
 msgid ""
 "**Disabled final distributed evaluation** "
 "([#800](https://github.com/adap/flower/pull/800))"
@@ -23824,7 +23943,7 @@ msgstr ""
 "**Désactivé l'évaluation finale distribuée** "
 "([#800](https://github.com/adap/flower/pull/800))"
 
-#: ../../source/ref-changelog.md:1395
+#: ../../source/ref-changelog.md:1417
 msgid ""
 "Prior behaviour was to perform a final round of distributed evaluation on"
 " all connected clients, which is often not required (e.g., when using "
@@ -23837,7 +23956,7 @@ msgstr ""
 "l'évaluation côté serveur). Le comportement précédent peut être activé en"
 " passant `force_final_distributed_eval=True` à `start_server`."
 
-#: ../../source/ref-changelog.md:1397
+#: ../../source/ref-changelog.md:1419
 msgid ""
 "**Renamed q-FedAvg strategy** "
 "([#802](https://github.com/adap/flower/pull/802))"
@@ -23845,7 +23964,7 @@ msgstr ""
 "**Renommé stratégie q-FedAvg** "
 "([#802](https://github.com/adap/flower/pull/802))"
 
-#: ../../source/ref-changelog.md:1399
+#: ../../source/ref-changelog.md:1421
 msgid ""
 "The strategy named `QffedAvg` was renamed to `QFedAvg` to better reflect "
 "the notation given in the original paper (q-FFL is the optimization "
@@ -23860,7 +23979,7 @@ msgstr ""
 "des raisons de compatibilité (elle sera supprimée dans une prochaine "
 "version)."
 
-#: ../../source/ref-changelog.md:1401
+#: ../../source/ref-changelog.md:1423
 msgid ""
 "**Deprecated and renamed code example** `simulation_pytorch` **to** "
 "`simulation_pytorch_legacy` "
@@ -23870,7 +23989,7 @@ msgstr ""
 "`simulation_pytorch_legacy` "
 "([#791](https://github.com/adap/flower/pull/791))"
 
-#: ../../source/ref-changelog.md:1403
+#: ../../source/ref-changelog.md:1425
 msgid ""
 "This example has been replaced by a new example. The new example is based"
 " on the experimental virtual client engine, which will become the new "
@@ -23885,11 +24004,11 @@ msgstr ""
 "conservé à des fins de référence, mais il pourrait être supprimé à "
 "l'avenir."
 
-#: ../../source/ref-changelog.md:1405
+#: ../../source/ref-changelog.md:1427
 msgid "v0.16.0 (2021-05-11)"
 msgstr "v0.16.0 (2021-05-11)"
 
-#: ../../source/ref-changelog.md:1409
+#: ../../source/ref-changelog.md:1431
 msgid ""
 "**New built-in strategies** "
 "([#549](https://github.com/adap/flower/pull/549))"
@@ -23897,11 +24016,11 @@ msgstr ""
 "**Nouvelles stratégies intégrées** "
 "([#549](https://github.com/adap/flower/pull/549))"
 
-#: ../../source/ref-changelog.md:1411
+#: ../../source/ref-changelog.md:1433
 msgid "(abstract) FedOpt"
 msgstr "(résumé) FedOpt"
 
-#: ../../source/ref-changelog.md:1414
+#: ../../source/ref-changelog.md:1436
 msgid ""
 "**Custom metrics for server and strategies** "
 "([#717](https://github.com/adap/flower/pull/717))"
@@ -23909,7 +24028,7 @@ msgstr ""
 "**Métriques personnalisées pour le serveur et les stratégies** "
 "([#717](https://github.com/adap/flower/pull/717))"
 
-#: ../../source/ref-changelog.md:1416
+#: ../../source/ref-changelog.md:1438
 msgid ""
 "The Flower server is now fully task-agnostic, all remaining instances of "
 "task-specific metrics (such as `accuracy`) have been replaced by custom "
@@ -23925,7 +24044,7 @@ msgstr ""
 " À partir de cette version, les métriques personnalisées remplacent les "
 "métriques spécifiques à une tâche sur le serveur."
 
-#: ../../source/ref-changelog.md:1418
+#: ../../source/ref-changelog.md:1440
 #, fuzzy
 msgid ""
 "Custom metric dictionaries are now used in two user-facing APIs: they are"
@@ -23943,7 +24062,7 @@ msgstr ""
 "stratégies peuvent même renvoyer des dictionnaires de métriques "
 "*agrégées* pour que le serveur puisse en garder la trace."
 
-#: ../../source/ref-changelog.md:1420
+#: ../../source/ref-changelog.md:1442
 #, fuzzy
 msgid ""
 "Strategy implementations should migrate their `aggregate_fit` and "
@@ -23957,7 +24076,7 @@ msgstr ""
 "d'évaluation côté serveur doivent migrer de `return loss, accuracy` à "
 "`return loss, {\"accuracy\" : accuracy}`."
 
-#: ../../source/ref-changelog.md:1422
+#: ../../source/ref-changelog.md:1444
 msgid ""
 "Flower 0.15-style return types are deprecated (but still supported), "
 "compatibility will be removed in a future release."
@@ -23966,7 +24085,7 @@ msgstr ""
 "pris en charge), la compatibilité sera supprimée dans une prochaine "
 "version."
 
-#: ../../source/ref-changelog.md:1424
+#: ../../source/ref-changelog.md:1446
 msgid ""
 "**Migration warnings for deprecated functionality** "
 "([#690](https://github.com/adap/flower/pull/690))"
@@ -23974,7 +24093,7 @@ msgstr ""
 "**Avertissements de migration pour les fonctionnalités obsolètes** "
 "([#690](https://github.com/adap/flower/pull/690))"
 
-#: ../../source/ref-changelog.md:1426
+#: ../../source/ref-changelog.md:1448
 msgid ""
 "Earlier versions of Flower were often migrated to new APIs, while "
 "maintaining compatibility with legacy APIs. This release introduces "
@@ -23990,7 +24109,7 @@ msgstr ""
 "vers des API plus récentes, facilitant ainsi la transition d'une version "
 "à l'autre."
 
-#: ../../source/ref-changelog.md:1428
+#: ../../source/ref-changelog.md:1450
 msgid ""
 "Improved docs and docstrings "
 "([#691](https://github.com/adap/flower/pull/691) "
@@ -24002,11 +24121,11 @@ msgstr ""
 "[#692](https://github.com/adap/flower/pull/692) "
 "[#713](https://github.com/adap/flower/pull/713))"
 
-#: ../../source/ref-changelog.md:1430
+#: ../../source/ref-changelog.md:1452
 msgid "MXNet example and documentation"
 msgstr "Exemple et documentation MXNet"
 
-#: ../../source/ref-changelog.md:1432
+#: ../../source/ref-changelog.md:1454
 msgid ""
 "FedBN implementation in example PyTorch: From Centralized To Federated "
 "([#696](https://github.com/adap/flower/pull/696) "
@@ -24018,7 +24137,7 @@ msgstr ""
 "[#702](https://github.com/adap/flower/pull/702) "
 "[#705](https://github.com/adap/flower/pull/705))"
 
-#: ../../source/ref-changelog.md:1436
+#: ../../source/ref-changelog.md:1458
 msgid ""
 "**Serialization-agnostic server** "
 "([#721](https://github.com/adap/flower/pull/721))"
@@ -24026,7 +24145,7 @@ msgstr ""
 "**Serveur agnostique de sérialisation** "
 "([#721](https://github.com/adap/flower/pull/721))"
 
-#: ../../source/ref-changelog.md:1438
+#: ../../source/ref-changelog.md:1460
 msgid ""
 "The Flower server is now fully serialization-agnostic. Prior usage of "
 "class `Weights` (which represents parameters as deserialized NumPy "
@@ -24046,7 +24165,7 @@ msgstr ""
 "d'octets doivent être interprétés (par exemple, pour la "
 "sérialisation/désérialisation)."
 
-#: ../../source/ref-changelog.md:1440
+#: ../../source/ref-changelog.md:1462
 msgid ""
 "Built-in strategies implement this approach by handling serialization and"
 " deserialization to/from `Weights` internally. Custom/3rd-party Strategy "
@@ -24063,7 +24182,7 @@ msgstr ""
 "[#721](https://github.com/adap/flower/pull/721) pour voir comment les "
 "stratégies peuvent facilement migrer vers le nouveau format."
 
-#: ../../source/ref-changelog.md:1442
+#: ../../source/ref-changelog.md:1464
 msgid ""
 "Deprecated `flwr.server.Server.evaluate`, use "
 "`flwr.server.Server.evaluate_round` instead "
@@ -24073,11 +24192,11 @@ msgstr ""
 "`flwr.server.Server.evaluate_round` à la place "
 "([#717](https://github.com/adap/flower/pull/717))"
 
-#: ../../source/ref-changelog.md:1444
+#: ../../source/ref-changelog.md:1466
 msgid "v0.15.0 (2021-03-12)"
 msgstr "v0.15.0 (2021-03-12)"
 
-#: ../../source/ref-changelog.md:1448
+#: ../../source/ref-changelog.md:1470
 msgid ""
 "**Server-side parameter initialization** "
 "([#658](https://github.com/adap/flower/pull/658))"
@@ -24085,7 +24204,7 @@ msgstr ""
 "**Initialisation des paramètres côté serveur** "
 "([#658](https://github.com/adap/flower/pull/658))"
 
-#: ../../source/ref-changelog.md:1450
+#: ../../source/ref-changelog.md:1472
 msgid ""
 "Model parameters can now be initialized on the server-side. Server-side "
 "parameter initialization works via a new `Strategy` method called "
@@ -24095,7 +24214,7 @@ msgstr ""
 "serveur. L'initialisation des paramètres côté serveur fonctionne via une "
 "nouvelle méthode `Strategy` appelée `initialize_parameters`."
 
-#: ../../source/ref-changelog.md:1452
+#: ../../source/ref-changelog.md:1474
 msgid ""
 "Built-in strategies support a new constructor argument called "
 "`initial_parameters` to set the initial parameters. Built-in strategies "
@@ -24107,7 +24226,7 @@ msgstr ""
 "initiaux. Les stratégies intégrées fourniront ces paramètres initiaux au "
 "serveur au démarrage et les supprimeront ensuite pour libérer la mémoire."
 
-#: ../../source/ref-changelog.md:1471
+#: ../../source/ref-changelog.md:1493
 msgid ""
 "If no initial parameters are provided to the strategy, the server will "
 "continue to use the current behaviour (namely, it will ask one of the "
@@ -24119,7 +24238,7 @@ msgstr ""
 "l'un des clients connectés ses paramètres et les utilisera comme "
 "paramètres globaux initiaux)."
 
-#: ../../source/ref-changelog.md:1475
+#: ../../source/ref-changelog.md:1497
 msgid ""
 "Deprecate `flwr.server.strategy.DefaultStrategy` (migrate to "
 "`flwr.server.strategy.FedAvg`, which is equivalent)"
@@ -24127,11 +24246,11 @@ msgstr ""
 "Déclasser `flwr.server.strategy.DefaultStrategy` (migrer vers "
 "`flwr.server.strategy.FedAvg`, qui est équivalent)"
 
-#: ../../source/ref-changelog.md:1477
+#: ../../source/ref-changelog.md:1499
 msgid "v0.14.0 (2021-02-18)"
 msgstr "v0.14.0 (2021-02-18)"
 
-#: ../../source/ref-changelog.md:1481
+#: ../../source/ref-changelog.md:1503
 msgid ""
 "**Generalized** `Client.fit` **and** `Client.evaluate` **return values** "
 "([#610](https://github.com/adap/flower/pull/610) "
@@ -24143,7 +24262,7 @@ msgstr ""
 "[#572](https://github.com/adap/flower/pull/572) "
 "[#633](https://github.com/adap/flower/pull/633))"
 
-#: ../../source/ref-changelog.md:1483
+#: ../../source/ref-changelog.md:1505
 msgid ""
 "Clients can now return an additional dictionary mapping `str` keys to "
 "values of the following types: `bool`, `bytes`, `float`, `int`, `str`. "
@@ -24156,7 +24275,7 @@ msgstr ""
 "valeurs presque arbitraires de `fit`/`evaluate` et les utiliser du côté "
 "du serveur !"
 
-#: ../../source/ref-changelog.md:1485
+#: ../../source/ref-changelog.md:1507
 msgid ""
 "This improvement also allowed for more consistent return types between "
 "`fit` and `evaluate`: `evaluate` should now return a tuple `(float, int, "
@@ -24169,7 +24288,7 @@ msgstr ""
 "d'exemples, et un dictionnaire contenant des valeurs arbitraires "
 "spécifiques au problème comme la précision."
 
-#: ../../source/ref-changelog.md:1487
+#: ../../source/ref-changelog.md:1509
 msgid ""
 "In case you wondered: this feature is compatible with existing projects, "
 "the additional dictionary return value is optional. New code should "
@@ -24186,7 +24305,7 @@ msgstr ""
 "Scalar]`, `evaluate` : `float, int, Dict[str, Scalar]`). Voir l'exemple "
 "ci-dessous pour plus de détails."
 
-#: ../../source/ref-changelog.md:1489
+#: ../../source/ref-changelog.md:1511
 msgid ""
 "*Code example:* note the additional dictionary return values in both "
 "`FlwrClient.fit` and `FlwrClient.evaluate`:"
@@ -24194,7 +24313,7 @@ msgstr ""
 "*Exemple de code:* note les valeurs de retour du dictionnaire "
 "supplémentaires dans `FlwrClient.fit` et `FlwrClient.evaluate` :"
 
-#: ../../source/ref-changelog.md:1504
+#: ../../source/ref-changelog.md:1526
 msgid ""
 "**Generalized** `config` **argument in** `Client.fit` **and** "
 "`Client.evaluate` ([#595](https://github.com/adap/flower/pull/595))"
@@ -24202,7 +24321,7 @@ msgstr ""
 "**Généralisé** `config` **argument dans** `Client.fit` **et** "
 "`Client.evaluate` ([#595](https://github.com/adap/flower/pull/595))"
 
-#: ../../source/ref-changelog.md:1506
+#: ../../source/ref-changelog.md:1528
 msgid ""
 "The `config` argument used to be of type `Dict[str, str]`, which means "
 "that dictionary values were expected to be strings. The new release "
@@ -24214,7 +24333,7 @@ msgstr ""
 "nouvelle version généralise cela pour permettre les valeurs des types "
 "suivants : `bool`, `bytes`, `float`, `int`, `str`."
 
-#: ../../source/ref-changelog.md:1508
+#: ../../source/ref-changelog.md:1530
 msgid ""
 "This means one can now pass almost arbitrary values to `fit`/`evaluate` "
 "using the `config` dictionary. Yay, no more `str(epochs)` on the server-"
@@ -24225,7 +24344,7 @@ msgstr ""
 "Yay, plus de `str(epochs)` du côté serveur et `int(config[\"epochs\"])` "
 "du côté client !"
 
-#: ../../source/ref-changelog.md:1510
+#: ../../source/ref-changelog.md:1532
 msgid ""
 "*Code example:* note that the `config` dictionary now contains non-`str` "
 "values in both `Client.fit` and `Client.evaluate`:"
@@ -24233,11 +24352,11 @@ msgstr ""
 "*Exemple de code:* Notez que le dictionnaire `config` contient maintenant"
 " des valeurs autres que `str` dans `Client.fit` et `Client.evaluate` :"
 
-#: ../../source/ref-changelog.md:1527
+#: ../../source/ref-changelog.md:1549
 msgid "v0.13.0 (2021-01-08)"
 msgstr "v0.13.0 (2021-01-08)"
 
-#: ../../source/ref-changelog.md:1531
+#: ../../source/ref-changelog.md:1553
 msgid ""
 "New example: PyTorch From Centralized To Federated "
 "([#549](https://github.com/adap/flower/pull/549))"
@@ -24245,21 +24364,21 @@ msgstr ""
 "Nouvel exemple : PyTorch de centralisé à fédéré "
 "([#549](https://github.com/adap/flower/pull/549))"
 
-#: ../../source/ref-changelog.md:1532
+#: ../../source/ref-changelog.md:1554
 msgid "Improved documentation"
 msgstr "Amélioration de la documentation"
 
-#: ../../source/ref-changelog.md:1533
+#: ../../source/ref-changelog.md:1555
 msgid "New documentation theme ([#551](https://github.com/adap/flower/pull/551))"
 msgstr ""
 "Nouveau thème de documentation "
 "([#551](https://github.com/adap/flower/pull/551))"
 
-#: ../../source/ref-changelog.md:1534
+#: ../../source/ref-changelog.md:1556
 msgid "New API reference ([#554](https://github.com/adap/flower/pull/554))"
 msgstr "Nouvelle référence API ([#554](https://github.com/adap/flower/pull/554))"
 
-#: ../../source/ref-changelog.md:1535
+#: ../../source/ref-changelog.md:1557
 msgid ""
 "Updated examples documentation "
 "([#549](https://github.com/adap/flower/pull/549))"
@@ -24267,7 +24386,7 @@ msgstr ""
 "Mise à jour de la documentation des exemples "
 "([#549](https://github.com/adap/flower/pull/549))"
 
-#: ../../source/ref-changelog.md:1536
+#: ../../source/ref-changelog.md:1558
 msgid ""
 "Removed obsolete documentation "
 "([#548](https://github.com/adap/flower/pull/548))"
@@ -24275,11 +24394,11 @@ msgstr ""
 "Suppression de la documentation obsolète "
 "([#548](https://github.com/adap/flower/pull/548))"
 
-#: ../../source/ref-changelog.md:1538
+#: ../../source/ref-changelog.md:1560
 msgid "Bugfix:"
 msgstr "Correction de bogues :"
 
-#: ../../source/ref-changelog.md:1540
+#: ../../source/ref-changelog.md:1562
 msgid ""
 "`Server.fit` does not disconnect clients when finished, disconnecting the"
 " clients is now handled in `flwr.server.start_server` "
@@ -24292,15 +24411,15 @@ msgstr ""
 "([#553](https://github.com/adap/flower/pull/553) "
 "[#540](https://github.com/adap/flower/issues/540))."
 
-#: ../../source/ref-changelog.md:1542
+#: ../../source/ref-changelog.md:1564
 msgid "v0.12.0 (2020-12-07)"
 msgstr "v0.12.0 (2020-12-07)"
 
-#: ../../source/ref-changelog.md:1544 ../../source/ref-changelog.md:1560
+#: ../../source/ref-changelog.md:1566 ../../source/ref-changelog.md:1582
 msgid "Important changes:"
 msgstr "Changements importants :"
 
-#: ../../source/ref-changelog.md:1546
+#: ../../source/ref-changelog.md:1568
 msgid ""
 "Added an example for embedded devices "
 "([#507](https://github.com/adap/flower/pull/507))"
@@ -24308,7 +24427,7 @@ msgstr ""
 "Ajout d'un exemple pour les périphériques embarqués "
 "([#507](https://github.com/adap/flower/pull/507))"
 
-#: ../../source/ref-changelog.md:1547
+#: ../../source/ref-changelog.md:1569
 msgid ""
 "Added a new NumPyClient (in addition to the existing KerasClient) "
 "([#504](https://github.com/adap/flower/pull/504) "
@@ -24318,7 +24437,7 @@ msgstr ""
 "([#504](https://github.com/adap/flower/pull/504) "
 "[#508](https://github.com/adap/flower/pull/508))"
 
-#: ../../source/ref-changelog.md:1548
+#: ../../source/ref-changelog.md:1570
 msgid ""
 "Deprecated `flwr_example` package and started to migrate examples into "
 "the top-level `examples` directory "
@@ -24330,15 +24449,15 @@ msgstr ""
 "([#494](https://github.com/adap/flower/pull/494) "
 "[#512](https://github.com/adap/flower/pull/512))"
 
-#: ../../source/ref-changelog.md:1550
+#: ../../source/ref-changelog.md:1572
 msgid "v0.11.0 (2020-11-30)"
 msgstr "v0.11.0 (2020-11-30)"
 
-#: ../../source/ref-changelog.md:1552
+#: ../../source/ref-changelog.md:1574
 msgid "Incompatible changes:"
 msgstr "Changements incompatibles :"
 
-#: ../../source/ref-changelog.md:1554
+#: ../../source/ref-changelog.md:1576
 msgid ""
 "Renamed strategy methods "
 "([#486](https://github.com/adap/flower/pull/486)) to unify the naming of "
@@ -24355,23 +24474,23 @@ msgstr ""
 "quatre méthodes de Stratégie. Pour migrer, renommez les méthodes de "
 "`Strategy` suivantes en conséquence :"
 
-#: ../../source/ref-changelog.md:1555
+#: ../../source/ref-changelog.md:1577
 msgid "`on_configure_evaluate` => `configure_evaluate`"
 msgstr "`on_configure_evaluate` => `configure_evaluate`"
 
-#: ../../source/ref-changelog.md:1556
+#: ../../source/ref-changelog.md:1578
 msgid "`on_aggregate_evaluate` => `aggregate_evaluate`"
 msgstr "`on_aggregate_evaluate` => `aggregate_evaluate`"
 
-#: ../../source/ref-changelog.md:1557
+#: ../../source/ref-changelog.md:1579
 msgid "`on_configure_fit` => `configure_fit`"
 msgstr "`on_configure_fit` => `configure_fit`"
 
-#: ../../source/ref-changelog.md:1558
+#: ../../source/ref-changelog.md:1580
 msgid "`on_aggregate_fit` => `aggregate_fit`"
 msgstr "`on_aggregate_fit` => `aggregate_fit`"
 
-#: ../../source/ref-changelog.md:1562
+#: ../../source/ref-changelog.md:1584
 msgid ""
 "Deprecated `DefaultStrategy` "
 "([#479](https://github.com/adap/flower/pull/479)). To migrate use "
@@ -24381,7 +24500,7 @@ msgstr ""
 "([#479](https://github.com/adap/flower/pull/479)). Pour migrer, utilisez "
 "`FedAvg` à la place."
 
-#: ../../source/ref-changelog.md:1563
+#: ../../source/ref-changelog.md:1585
 msgid ""
 "Simplified examples and baselines "
 "([#484](https://github.com/adap/flower/pull/484))."
@@ -24389,7 +24508,7 @@ msgstr ""
 "Exemples simplifiés et lignes de base "
 "([#484](https://github.com/adap/flower/pull/484))."
 
-#: ../../source/ref-changelog.md:1564
+#: ../../source/ref-changelog.md:1586
 msgid ""
 "Removed presently unused `on_conclude_round` from strategy interface "
 "([#483](https://github.com/adap/flower/pull/483))."
@@ -24397,7 +24516,7 @@ msgstr ""
 "Suppression de `on_conclude_round` actuellement inutilisé de l'interface "
 "de stratégie ([#483](https://github.com/adap/flower/pull/483))."
 
-#: ../../source/ref-changelog.md:1565
+#: ../../source/ref-changelog.md:1587
 msgid ""
 "Set minimal Python version to 3.6.1 instead of 3.6.9 "
 "([#471](https://github.com/adap/flower/pull/471))."
@@ -24405,7 +24524,7 @@ msgstr ""
 "Fixe la version minimale de Python à 3.6.1 au lieu de 3.6.9 "
 "([#471](https://github.com/adap/flower/pull/471))."
 
-#: ../../source/ref-changelog.md:1566
+#: ../../source/ref-changelog.md:1588
 msgid ""
 "Improved `Strategy` docstrings "
 "([#470](https://github.com/adap/flower/pull/470))."
@@ -28787,7 +28906,7 @@ msgstr ""
 "chose d'autre, comme la régression linéaire classique."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:41
-msgid "|cf5fe148406b44b9a8b842fb01b5a7ea|"
+msgid "|f150b8d6e0074250822c9f6f7a8de3e0|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:109
@@ -28806,7 +28925,7 @@ msgstr ""
 " Go."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:53
-msgid "|ba25c91426d64cc1ae2d3febc5715b35|"
+msgid "|72772d10debc4abd8373c0bc82985422|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:111
@@ -28838,7 +28957,7 @@ msgstr ""
 "chanson."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:67
-msgid "|fca67f83aaab4389aa9ebb4d9c5cd75e|"
+msgid "|5815398552ad41d290a3a2631fe8f6ca|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:113
@@ -28859,7 +28978,7 @@ msgstr ""
 " données pour la même tâche."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:79
-msgid "|6f2e8f95c95443379b0df00ca9824654|"
+msgid "|e6ac20744bf149378be20ac3dc309356|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:115
@@ -28881,7 +29000,7 @@ msgstr ""
 "cloud."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:91
-msgid "|c0ab3a1a733d4dbc9e1677aa608e8038|"
+msgid "|a4011ef443c14725b15a8cf33b0e3443|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:117
@@ -28902,7 +29021,7 @@ msgstr ""
 "appuyés."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:103
-msgid "|8f0491bde07341ab9f2e23d50593c0be|"
+msgid "|a22faa3617404c06803731525e1c609f|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:119
@@ -28928,7 +29047,7 @@ msgstr ""
 " sur un serveur centralisé."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:138
-msgid "|762fc099899943688361562252c5e600|"
+msgid "|84a5c9b5041c43c3beab9786197c3e4e|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:173
@@ -28947,7 +29066,7 @@ msgstr ""
 "suffisantes pour former un bon modèle."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:150
-msgid "|f62d365fd0ae405b975d3ca01e7183fd|"
+msgid "|b5c4be0b52d4493ba8c4af14d7c2db97|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:175
@@ -29178,7 +29297,7 @@ msgstr ""
 "partir d'un point de contrôle précédemment sauvegardé."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:210
-msgid "|2c78fc1816b143289f4d909388f92a80|"
+msgid "|c1c784183d18481186ff65dc261d1335|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:307
@@ -29213,7 +29332,7 @@ msgstr ""
 "rendements décroissants."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:225
-msgid "|4230725aeebe497d8ad84a3efc2a912b|"
+msgid "|669fcd1f44ab42f5bbd196c3cf1ecbc2|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:309
@@ -29246,7 +29365,7 @@ msgstr ""
 "données locales, ou même de quelques étapes (mini-batchs)."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:240
-msgid "|64b66a88417240eabe52f5cc55d89d0b|"
+msgid "|edfb08758c9441afb6736045a59e154c|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:311
@@ -29277,7 +29396,7 @@ msgstr ""
 " l'entraînement local."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:255
-msgid "|726c8eca58bc4f859b06aa24a587b253|"
+msgid "|82338b8bbad24d5ea9df3801aab37852|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:313
@@ -29337,7 +29456,7 @@ msgstr ""
 "times as much as each of the 100 examples."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:273
-msgid "|f9d869e4b33c4093b29cf24ed8dff80a|"
+msgid "|518d994dd2c844898b441da03b858326|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:315
@@ -29481,7 +29600,7 @@ msgstr ""
 "quel cadre de ML et n'importe quel langage de programmation."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:334
-msgid "|4ab50bc01a9f426a91a2c0cbc3ab7a84|"
+msgid "|7bfcfcb57ae5403f8e18486f45ca48b4|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:340
@@ -42795,3 +42914,48 @@ msgstr ""
 #~ msgid "|dd4434075f374e99ac07f509a883778f|"
 #~ msgstr ""
 
+#~ msgid "Other changes"
+#~ msgstr "Changements incompatibles"
+
+#~ msgid "|cf5fe148406b44b9a8b842fb01b5a7ea|"
+#~ msgstr ""
+
+#~ msgid "|ba25c91426d64cc1ae2d3febc5715b35|"
+#~ msgstr ""
+
+#~ msgid "|fca67f83aaab4389aa9ebb4d9c5cd75e|"
+#~ msgstr ""
+
+#~ msgid "|6f2e8f95c95443379b0df00ca9824654|"
+#~ msgstr ""
+
+#~ msgid "|c0ab3a1a733d4dbc9e1677aa608e8038|"
+#~ msgstr ""
+
+#~ msgid "|8f0491bde07341ab9f2e23d50593c0be|"
+#~ msgstr ""
+
+#~ msgid "|762fc099899943688361562252c5e600|"
+#~ msgstr ""
+
+#~ msgid "|f62d365fd0ae405b975d3ca01e7183fd|"
+#~ msgstr ""
+
+#~ msgid "|2c78fc1816b143289f4d909388f92a80|"
+#~ msgstr ""
+
+#~ msgid "|4230725aeebe497d8ad84a3efc2a912b|"
+#~ msgstr ""
+
+#~ msgid "|64b66a88417240eabe52f5cc55d89d0b|"
+#~ msgstr ""
+
+#~ msgid "|726c8eca58bc4f859b06aa24a587b253|"
+#~ msgstr ""
+
+#~ msgid "|f9d869e4b33c4093b29cf24ed8dff80a|"
+#~ msgstr ""
+
+#~ msgid "|4ab50bc01a9f426a91a2c0cbc3ab7a84|"
+#~ msgstr ""
+
diff --git a/doc/locales/ko/LC_MESSAGES/framework-docs.po b/doc/locales/ko/LC_MESSAGES/framework-docs.po
index 3d22083683a2..8775e9b1ca4d 100644
--- a/doc/locales/ko/LC_MESSAGES/framework-docs.po
+++ b/doc/locales/ko/LC_MESSAGES/framework-docs.po
@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Flower main\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-11-22 08:46+0000\n"
+"POT-Creation-Date: 2024-11-28 00:32+0000\n"
 "PO-Revision-Date: 2024-08-23 13:09+0000\n"
 "Last-Translator: Seulki Yun <icstuckyi@gmail.com>\n"
 "Language: ko\n"
@@ -3346,10 +3346,10 @@ msgstr "빠른 시작 튜토리얼"
 #: ../../source/docker/run-quickstart-examples-docker-compose.rst:119
 #: ../../source/docker/run-quickstart-examples-docker-compose.rst:121
 #: ../../source/docker/run-quickstart-examples-docker-compose.rst:125
-#: ../../source/ref-changelog.md:214 ../../source/ref-changelog.md:580
-#: ../../source/ref-changelog.md:857 ../../source/ref-changelog.md:921
-#: ../../source/ref-changelog.md:979 ../../source/ref-changelog.md:1048
-#: ../../source/ref-changelog.md:1110
+#: ../../source/ref-changelog.md:236 ../../source/ref-changelog.md:602
+#: ../../source/ref-changelog.md:879 ../../source/ref-changelog.md:943
+#: ../../source/ref-changelog.md:1001 ../../source/ref-changelog.md:1070
+#: ../../source/ref-changelog.md:1132
 msgid "None"
 msgstr ""
 
@@ -14861,7 +14861,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/ref-api/flwr.server.strategy.FedAdagrad.rst:2
-#: ../../source/ref-changelog.md:1412
+#: ../../source/ref-changelog.md:1434
 msgid "FedAdagrad"
 msgstr ""
 
@@ -16656,83 +16656,156 @@ msgid "Changelog"
 msgstr ""
 
 #: ../../source/ref-changelog.md:3
-#, fuzzy
-msgid "Unreleased"
-msgstr "릴리즈 빌드"
+msgid "v1.13.1 (2024-11-26)"
+msgstr ""
 
-#: ../../source/ref-changelog.md:5 ../../source/ref-changelog.md:21
-#: ../../source/ref-changelog.md:122 ../../source/ref-changelog.md:224
-#: ../../source/ref-changelog.md:328 ../../source/ref-changelog.md:426
-#: ../../source/ref-changelog.md:526 ../../source/ref-changelog.md:590
-#: ../../source/ref-changelog.md:683 ../../source/ref-changelog.md:783
-#: ../../source/ref-changelog.md:867 ../../source/ref-changelog.md:931
-#: ../../source/ref-changelog.md:989 ../../source/ref-changelog.md:1058
-#: ../../source/ref-changelog.md:1187 ../../source/ref-changelog.md:1229
-#: ../../source/ref-changelog.md:1296 ../../source/ref-changelog.md:1362
-#: ../../source/ref-changelog.md:1407 ../../source/ref-changelog.md:1446
-#: ../../source/ref-changelog.md:1479 ../../source/ref-changelog.md:1529
-msgid "What's new?"
+#: ../../source/ref-changelog.md:5 ../../source/ref-changelog.md:37
+#: ../../source/ref-changelog.md:138 ../../source/ref-changelog.md:208
+#: ../../source/ref-changelog.md:240 ../../source/ref-changelog.md:344
+#: ../../source/ref-changelog.md:442 ../../source/ref-changelog.md:542
+#: ../../source/ref-changelog.md:606 ../../source/ref-changelog.md:699
+#: ../../source/ref-changelog.md:799 ../../source/ref-changelog.md:883
+#: ../../source/ref-changelog.md:947 ../../source/ref-changelog.md:1005
+#: ../../source/ref-changelog.md:1074 ../../source/ref-changelog.md:1143
+msgid "Thanks to our contributors"
 msgstr ""
 
-#: ../../source/ref-changelog.md:7
-#, fuzzy
-msgid "Other changes"
-msgstr "**변경사항 스테이징**"
+#: ../../source/ref-changelog.md:7 ../../source/ref-changelog.md:39
+#: ../../source/ref-changelog.md:140 ../../source/ref-changelog.md:210
+#: ../../source/ref-changelog.md:242 ../../source/ref-changelog.md:346
+#: ../../source/ref-changelog.md:444 ../../source/ref-changelog.md:544
+#: ../../source/ref-changelog.md:608 ../../source/ref-changelog.md:701
+#: ../../source/ref-changelog.md:801 ../../source/ref-changelog.md:885
+#: ../../source/ref-changelog.md:949 ../../source/ref-changelog.md:1007
+msgid ""
+"We would like to give our special thanks to all the contributors who made"
+" the new version of Flower possible (in `git shortlog` order):"
+msgstr ""
 
-#: ../../source/ref-changelog.md:9 ../../source/ref-changelog.md:388
-#, fuzzy
-msgid "Documentation improvements"
-msgstr "선택적 개선 사항"
+#: ../../source/ref-changelog.md:9
+msgid ""
+"`Adam Narozniak`, `Charles Beauville`, `Heng Pan`, `Javier`, `Robert "
+"Steiner` <!---TOKEN_v1.13.1-->"
+msgstr ""
 
-#: ../../source/ref-changelog.md:11 ../../source/ref-changelog.md:88
-#: ../../source/ref-changelog.md:178 ../../source/ref-changelog.md:212
-#: ../../source/ref-changelog.md:292 ../../source/ref-changelog.md:408
-#: ../../source/ref-changelog.md:504 ../../source/ref-changelog.md:578
-#: ../../source/ref-changelog.md:653 ../../source/ref-changelog.md:765
-#: ../../source/ref-changelog.md:855 ../../source/ref-changelog.md:919
-#: ../../source/ref-changelog.md:977 ../../source/ref-changelog.md:1046
-#: ../../source/ref-changelog.md:1108 ../../source/ref-changelog.md:1127
-#: ../../source/ref-changelog.md:1283 ../../source/ref-changelog.md:1354
-#: ../../source/ref-changelog.md:1391 ../../source/ref-changelog.md:1434
-msgid "Incompatible changes"
+#: ../../source/ref-changelog.md:11 ../../source/ref-changelog.md:43
+#: ../../source/ref-changelog.md:144 ../../source/ref-changelog.md:246
+#: ../../source/ref-changelog.md:350 ../../source/ref-changelog.md:448
+#: ../../source/ref-changelog.md:548 ../../source/ref-changelog.md:612
+#: ../../source/ref-changelog.md:705 ../../source/ref-changelog.md:805
+#: ../../source/ref-changelog.md:889 ../../source/ref-changelog.md:953
+#: ../../source/ref-changelog.md:1011 ../../source/ref-changelog.md:1080
+#: ../../source/ref-changelog.md:1209 ../../source/ref-changelog.md:1251
+#: ../../source/ref-changelog.md:1318 ../../source/ref-changelog.md:1384
+#: ../../source/ref-changelog.md:1429 ../../source/ref-changelog.md:1468
+#: ../../source/ref-changelog.md:1501 ../../source/ref-changelog.md:1551
+msgid "What's new?"
 msgstr ""
 
 #: ../../source/ref-changelog.md:13
-msgid "v1.13.0 (2024-11-20)"
+msgid ""
+"**Fix `SimulationEngine` Executor for SuperLink** "
+"([#4563](https://github.com/adap/flower/pull/4563), "
+"[#4568](https://github.com/adap/flower/pull/4568), "
+"[#4570](https://github.com/adap/flower/pull/4570))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:15 ../../source/ref-changelog.md:116
-#: ../../source/ref-changelog.md:186 ../../source/ref-changelog.md:218
-#: ../../source/ref-changelog.md:322 ../../source/ref-changelog.md:420
-#: ../../source/ref-changelog.md:520 ../../source/ref-changelog.md:584
-#: ../../source/ref-changelog.md:677 ../../source/ref-changelog.md:777
-#: ../../source/ref-changelog.md:861 ../../source/ref-changelog.md:925
-#: ../../source/ref-changelog.md:983 ../../source/ref-changelog.md:1052
-#: ../../source/ref-changelog.md:1121
-msgid "Thanks to our contributors"
+#: ../../source/ref-changelog.md:15
+msgid ""
+"Resolved an issue that prevented SuperLink from functioning correctly "
+"when using the `SimulationEngine` executor."
 msgstr ""
 
-#: ../../source/ref-changelog.md:17 ../../source/ref-changelog.md:118
-#: ../../source/ref-changelog.md:188 ../../source/ref-changelog.md:220
-#: ../../source/ref-changelog.md:324 ../../source/ref-changelog.md:422
-#: ../../source/ref-changelog.md:522 ../../source/ref-changelog.md:586
-#: ../../source/ref-changelog.md:679 ../../source/ref-changelog.md:779
-#: ../../source/ref-changelog.md:863 ../../source/ref-changelog.md:927
-#: ../../source/ref-changelog.md:985
+#: ../../source/ref-changelog.md:17
 msgid ""
-"We would like to give our special thanks to all the contributors who made"
-" the new version of Flower possible (in `git shortlog` order):"
+"**Improve FAB build and install** "
+"([#4571](https://github.com/adap/flower/pull/4571))"
 msgstr ""
 
 #: ../../source/ref-changelog.md:19
 msgid ""
+"An updated FAB build and install process produces smaller FAB files and "
+"doesn't rely on `pip install` any more. It also resolves an issue where "
+"all files were unnecessarily included in the FAB file. The `flwr` CLI "
+"commands now correctly pack only the necessary files, such as `.md`, "
+"`.toml` and `.py`, ensuring more efficient and accurate packaging."
+msgstr ""
+
+#: ../../source/ref-changelog.md:21
+msgid ""
+"**Update** `embedded-devices` **example** "
+"([#4381](https://github.com/adap/flower/pull/4381))"
+msgstr ""
+
+#: ../../source/ref-changelog.md:23
+msgid "The example now uses the `flwr run` command and the Deployment Engine."
+msgstr ""
+
+#: ../../source/ref-changelog.md:25
+msgid ""
+"**Update Documentation** "
+"([#4566](https://github.com/adap/flower/pull/4566), "
+"[#4569](https://github.com/adap/flower/pull/4569), "
+"[#4560](https://github.com/adap/flower/pull/4560), "
+"[#4556](https://github.com/adap/flower/pull/4556), "
+"[#4581](https://github.com/adap/flower/pull/4581), "
+"[#4537](https://github.com/adap/flower/pull/4537), "
+"[#4562](https://github.com/adap/flower/pull/4562), "
+"[#4582](https://github.com/adap/flower/pull/4582))"
+msgstr ""
+
+#: ../../source/ref-changelog.md:27
+msgid ""
+"Enhanced documentation across various aspects, including updates to "
+"translation workflows, Docker-related READMEs, and recommended datasets. "
+"Improvements also include formatting fixes for dataset partitioning docs "
+"and better references to resources in the datasets documentation index."
+msgstr ""
+
+#: ../../source/ref-changelog.md:29
+msgid ""
+"**Update Infrastructure and CI/CD** "
+"([#4577](https://github.com/adap/flower/pull/4577), "
+"[#4578](https://github.com/adap/flower/pull/4578), "
+"[#4558](https://github.com/adap/flower/pull/4558), "
+"[#4551](https://github.com/adap/flower/pull/4551), "
+"[#3356](https://github.com/adap/flower/pull/3356), "
+"[#4559](https://github.com/adap/flower/pull/4559), "
+"[#4575](https://github.com/adap/flower/pull/4575))"
+msgstr ""
+
+#: ../../source/ref-changelog.md:31
+msgid ""
+"**General improvements** "
+"([#4557](https://github.com/adap/flower/pull/4557), "
+"[#4564](https://github.com/adap/flower/pull/4564), "
+"[#4573](https://github.com/adap/flower/pull/4573), "
+"[#4561](https://github.com/adap/flower/pull/4561), "
+"[#4579](https://github.com/adap/flower/pull/4579), "
+"[#4572](https://github.com/adap/flower/pull/4572))"
+msgstr ""
+
+#: ../../source/ref-changelog.md:33 ../../source/ref-changelog.md:102
+#: ../../source/ref-changelog.md:198 ../../source/ref-changelog.md:301
+#: ../../source/ref-changelog.md:408
+msgid ""
+"As always, many parts of the Flower framework and quality infrastructure "
+"were improved and updated."
+msgstr ""
+
+#: ../../source/ref-changelog.md:35
+msgid "v1.13.0 (2024-11-20)"
+msgstr ""
+
+#: ../../source/ref-changelog.md:41
+msgid ""
 "`Adam Narozniak`, `Charles Beauville`, `Chong Shen Ng`, `Daniel J. "
 "Beutel`, `Daniel Nata Nugraha`, `Dimitris Stripelis`, `Heng Pan`, "
 "`Javier`, `Mohammad Naseri`, `Robert Steiner`, `Waris Gill`, `William "
 "Lindskog`, `Yan Gao`, `Yao Xu`, `wwjang` <!---TOKEN_v1.13.0-->"
 msgstr ""
 
-#: ../../source/ref-changelog.md:23
+#: ../../source/ref-changelog.md:45
 msgid ""
 "**Introduce `flwr ls` command** "
 "([#4460](https://github.com/adap/flower/pull/4460), "
@@ -16740,30 +16813,30 @@ msgid ""
 "[#4477](https://github.com/adap/flower/pull/4477))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:25
+#: ../../source/ref-changelog.md:47
 msgid ""
 "The `flwr ls` command is now available to display details about all runs "
 "(or one specific run). It supports the following usage options:"
 msgstr ""
 
-#: ../../source/ref-changelog.md:27
+#: ../../source/ref-changelog.md:49
 msgid "`flwr ls --runs [<app>] [<federation>]`: Lists all runs."
 msgstr ""
 
-#: ../../source/ref-changelog.md:28
+#: ../../source/ref-changelog.md:50
 msgid ""
 "`flwr ls --run-id <run-id> [<app>] [<federation>]`: Displays details for "
 "a specific run."
 msgstr ""
 
-#: ../../source/ref-changelog.md:30
+#: ../../source/ref-changelog.md:52
 msgid ""
 "This command provides information including the run ID, FAB ID and "
 "version, run status, elapsed time, and timestamps for when the run was "
 "created, started running, and finished."
 msgstr ""
 
-#: ../../source/ref-changelog.md:32
+#: ../../source/ref-changelog.md:54
 msgid ""
 "**Fuse SuperLink and SuperExec** "
 "([#4358](https://github.com/adap/flower/pull/4358), "
@@ -16777,7 +16850,7 @@ msgid ""
 "[#4352](https://github.com/adap/flower/pull/4352))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:34
+#: ../../source/ref-changelog.md:56
 msgid ""
 "SuperExec has been integrated into SuperLink, enabling SuperLink to "
 "directly manage ServerApp processes (`flwr-serverapp`). The `flwr` CLI "
@@ -16787,7 +16860,7 @@ msgid ""
 "{subprocess,process}` flag."
 msgstr ""
 
-#: ../../source/ref-changelog.md:36
+#: ../../source/ref-changelog.md:58
 msgid ""
 "**Introduce `flwr-serverapp` command** "
 "([#4394](https://github.com/adap/flower/pull/4394), "
@@ -16802,7 +16875,7 @@ msgid ""
 "[#4402](https://github.com/adap/flower/pull/4402))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:38
+#: ../../source/ref-changelog.md:60
 msgid ""
 "The `flwr-serverapp` command has been introduced as a CLI entry point "
 "that runs a `ServerApp` process. This process communicates with SuperLink"
@@ -16810,7 +16883,7 @@ msgid ""
 "and more flexible deployment."
 msgstr ""
 
-#: ../../source/ref-changelog.md:40
+#: ../../source/ref-changelog.md:62
 msgid ""
 "**Improve simulation engine and introduce `flwr-simulation` command** "
 "([#4433](https://github.com/adap/flower/pull/4433), "
@@ -16823,7 +16896,7 @@ msgid ""
 "[#4462](https://github.com/adap/flower/pull/4462))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:42
+#: ../../source/ref-changelog.md:64
 msgid ""
 "The simulation engine has been significantly improved, resulting in "
 "dramatically faster simulations. Additionally, the `flwr-simulation` "
@@ -16831,14 +16904,14 @@ msgid ""
 "dedicated entry point for running simulations."
 msgstr ""
 
-#: ../../source/ref-changelog.md:44
+#: ../../source/ref-changelog.md:66
 msgid ""
 "**Improve SuperLink message management** "
 "([#4378](https://github.com/adap/flower/pull/4378), "
 "[#4369](https://github.com/adap/flower/pull/4369))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:46
+#: ../../source/ref-changelog.md:68
 msgid ""
 "SuperLink now validates the destination node ID of instruction messages "
 "and checks the TTL (time-to-live) for reply messages. When pulling reply "
@@ -16847,13 +16920,13 @@ msgid ""
 "reply message exists but has expired."
 msgstr ""
 
-#: ../../source/ref-changelog.md:48
+#: ../../source/ref-changelog.md:70
 msgid ""
 "**Introduce FedDebug baseline** "
 "([#3783](https://github.com/adap/flower/pull/3783))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:50
+#: ../../source/ref-changelog.md:72
 msgid ""
 "FedDebug is a framework that enhances debugging in Federated Learning by "
 "enabling interactive inspection of the training process and automatically"
@@ -16863,7 +16936,7 @@ msgid ""
 "documentation](https://flower.ai/docs/baselines/feddebug.html)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:52
+#: ../../source/ref-changelog.md:74
 msgid ""
 "**Update documentation** "
 "([#4511](https://github.com/adap/flower/pull/4511), "
@@ -16908,7 +16981,7 @@ msgid ""
 "[#4533](https://github.com/adap/flower/pull/4533))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:54
+#: ../../source/ref-changelog.md:76
 msgid ""
 "Many documentation pages and tutorials have been updated to improve "
 "clarity, fix typos, incorporate user feedback, and stay aligned with the "
@@ -16922,7 +16995,7 @@ msgid ""
 "aggregation-protocols.html) page has also been updated."
 msgstr ""
 
-#: ../../source/ref-changelog.md:56
+#: ../../source/ref-changelog.md:78
 msgid ""
 "**Update examples and templates** "
 "([#4510](https://github.com/adap/flower/pull/4510), "
@@ -16936,7 +17009,7 @@ msgid ""
 "[#4408](https://github.com/adap/flower/pull/4408))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:58
+#: ../../source/ref-changelog.md:80
 msgid ""
 "Multiple examples and templates have been updated to enhance usability "
 "and correctness. The updates include the `30-minute-tutorial`, "
@@ -16944,7 +17017,7 @@ msgid ""
 "and the FlowerTune template."
 msgstr ""
 
-#: ../../source/ref-changelog.md:60
+#: ../../source/ref-changelog.md:82
 msgid ""
 "**Improve Docker support** "
 "([#4506](https://github.com/adap/flower/pull/4506), "
@@ -16960,7 +17033,7 @@ msgid ""
 "[#4540](https://github.com/adap/flower/pull/4540))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:62
+#: ../../source/ref-changelog.md:84
 msgid ""
 "Docker images and configurations have been updated, including updating "
 "Docker Compose files to version 1.13.0, refactoring the Docker build "
@@ -16968,21 +17041,21 @@ msgid ""
 " 6.9.0, and improving Docker documentation."
 msgstr ""
 
-#: ../../source/ref-changelog.md:64
+#: ../../source/ref-changelog.md:86
 msgid ""
 "**Allow app installation without internet access** "
 "([#4479](https://github.com/adap/flower/pull/4479), "
 "[#4475](https://github.com/adap/flower/pull/4475))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:66
+#: ../../source/ref-changelog.md:88
 msgid ""
 "The `flwr build` command now includes a wheel file in the FAB, enabling "
 "Flower app installation in environments without internet access via `flwr"
 " install`."
 msgstr ""
 
-#: ../../source/ref-changelog.md:68
+#: ../../source/ref-changelog.md:90
 msgid ""
 "**Improve `flwr log` command** "
 "([#4391](https://github.com/adap/flower/pull/4391), "
@@ -16991,7 +17064,7 @@ msgid ""
 "[#4397](https://github.com/adap/flower/pull/4397))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:70
+#: ../../source/ref-changelog.md:92
 msgid ""
 "**Refactor SuperNode for better maintainability and efficiency** "
 "([#4439](https://github.com/adap/flower/pull/4439), "
@@ -17000,13 +17073,13 @@ msgid ""
 "[#4485](https://github.com/adap/flower/pull/4485))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:72
+#: ../../source/ref-changelog.md:94
 msgid ""
 "**Support NumPy `2.0`** "
 "([#4440](https://github.com/adap/flower/pull/4440))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:74
+#: ../../source/ref-changelog.md:96
 msgid ""
 "**Update infrastructure and CI/CD** "
 "([#4466](https://github.com/adap/flower/pull/4466), "
@@ -17018,7 +17091,7 @@ msgid ""
 "[#4415](https://github.com/adap/flower/pull/4415))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:76
+#: ../../source/ref-changelog.md:98
 msgid ""
 "**Bugfixes** ([#4404](https://github.com/adap/flower/pull/4404), "
 "[#4518](https://github.com/adap/flower/pull/4518), "
@@ -17032,7 +17105,7 @@ msgid ""
 "[#4515](https://github.com/adap/flower/pull/4515))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:78
+#: ../../source/ref-changelog.md:100
 msgid ""
 "**General improvements** "
 "([#4454](https://github.com/adap/flower/pull/4454), "
@@ -17088,25 +17161,18 @@ msgid ""
 "[#4481](https://github.com/adap/flower/pull/4481))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:80 ../../source/ref-changelog.md:176
-#: ../../source/ref-changelog.md:279 ../../source/ref-changelog.md:386
-msgid ""
-"As always, many parts of the Flower framework and quality infrastructure "
-"were improved and updated."
-msgstr ""
-
-#: ../../source/ref-changelog.md:82 ../../source/ref-changelog.md:281
-#: ../../source/ref-changelog.md:398 ../../source/ref-changelog.md:490
-#: ../../source/ref-changelog.md:1473
+#: ../../source/ref-changelog.md:104 ../../source/ref-changelog.md:303
+#: ../../source/ref-changelog.md:420 ../../source/ref-changelog.md:512
+#: ../../source/ref-changelog.md:1495
 msgid "Deprecations"
 msgstr ""
 
-#: ../../source/ref-changelog.md:84
+#: ../../source/ref-changelog.md:106
 #, fuzzy
 msgid "**Deprecate Python 3.9**"
 msgstr "**PR 만들기**"
 
-#: ../../source/ref-changelog.md:86
+#: ../../source/ref-changelog.md:108
 msgid ""
 "Flower is deprecating support for Python 3.9 as several of its "
 "dependencies are phasing out compatibility with this version. While no "
@@ -17114,13 +17180,26 @@ msgid ""
 "upgrading to a supported Python version."
 msgstr ""
 
-#: ../../source/ref-changelog.md:90
+#: ../../source/ref-changelog.md:110 ../../source/ref-changelog.md:200
+#: ../../source/ref-changelog.md:234 ../../source/ref-changelog.md:314
+#: ../../source/ref-changelog.md:430 ../../source/ref-changelog.md:526
+#: ../../source/ref-changelog.md:600 ../../source/ref-changelog.md:675
+#: ../../source/ref-changelog.md:787 ../../source/ref-changelog.md:877
+#: ../../source/ref-changelog.md:941 ../../source/ref-changelog.md:999
+#: ../../source/ref-changelog.md:1068 ../../source/ref-changelog.md:1130
+#: ../../source/ref-changelog.md:1149 ../../source/ref-changelog.md:1305
+#: ../../source/ref-changelog.md:1376 ../../source/ref-changelog.md:1413
+#: ../../source/ref-changelog.md:1456
+msgid "Incompatible changes"
+msgstr ""
+
+#: ../../source/ref-changelog.md:112
 msgid ""
 "**Remove `flower-superexec` command** "
 "([#4351](https://github.com/adap/flower/pull/4351))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:92
+#: ../../source/ref-changelog.md:114
 msgid ""
 "The `flower-superexec` command, previously used to launch SuperExec, is "
 "no longer functional as SuperExec has been merged into SuperLink. "
@@ -17128,63 +17207,63 @@ msgid ""
 " initiated."
 msgstr ""
 
-#: ../../source/ref-changelog.md:94
+#: ../../source/ref-changelog.md:116
 msgid ""
 "**Remove `flower-server-app` command** "
 "([#4490](https://github.com/adap/flower/pull/4490))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:96
+#: ../../source/ref-changelog.md:118
 msgid ""
 "The `flower-server-app` command has been removed. To start a Flower app, "
 "please use the `flwr run` command instead."
 msgstr ""
 
-#: ../../source/ref-changelog.md:98
+#: ../../source/ref-changelog.md:120
 msgid ""
 "**Remove `app` argument from `flower-supernode` command** "
 "([#4497](https://github.com/adap/flower/pull/4497))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:100
+#: ../../source/ref-changelog.md:122
 msgid ""
 "The usage of `flower-supernode <app-dir>` has been removed. SuperNode "
 "will now load the FAB delivered by SuperLink, and it is no longer "
 "possible to directly specify an app directory."
 msgstr ""
 
-#: ../../source/ref-changelog.md:102
+#: ../../source/ref-changelog.md:124
 msgid ""
 "**Remove support for non-app simulations** "
 "([#4431](https://github.com/adap/flower/pull/4431))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:104
+#: ../../source/ref-changelog.md:126
 msgid ""
 "The simulation engine (via `flower-simulation`) now exclusively supports "
 "passing an app."
 msgstr ""
 
-#: ../../source/ref-changelog.md:106
+#: ../../source/ref-changelog.md:128
 msgid ""
 "**Rename CLI arguments for `flower-superlink` command** "
 "([#4412](https://github.com/adap/flower/pull/4412))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:108
+#: ../../source/ref-changelog.md:130
 msgid ""
 "The `--driver-api-address` argument has been renamed to `--serverappio-"
 "api-address` in the `flower-superlink` command to reflect the renaming of"
 " the `Driver` service to the `ServerAppIo` service."
 msgstr ""
 
-#: ../../source/ref-changelog.md:110
+#: ../../source/ref-changelog.md:132
 msgid ""
 "**Rename CLI arguments for `flwr-serverapp` and `flwr-clientapp` "
 "commands** ([#4495](https://github.com/adap/flower/pull/4495))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:112
+#: ../../source/ref-changelog.md:134
 msgid ""
 "The CLI arguments have been renamed for clarity and consistency. "
 "Specifically, `--superlink` for `flwr-serverapp` is now `--serverappio-"
@@ -17192,11 +17271,11 @@ msgid ""
 "`--clientappio-api-address`."
 msgstr ""
 
-#: ../../source/ref-changelog.md:114
+#: ../../source/ref-changelog.md:136
 msgid "v1.12.0 (2024-10-14)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:120
+#: ../../source/ref-changelog.md:142
 msgid ""
 "`Adam Narozniak`, `Audris`, `Charles Beauville`, `Chong Shen Ng`, `Daniel"
 " J. Beutel`, `Daniel Nata Nugraha`, `Heng Pan`, `Javier`, `Jiahao Tan`, "
@@ -17204,7 +17283,7 @@ msgid ""
 "Gao`, `xiliguguagua` <!---TOKEN_v1.12.0-->"
 msgstr ""
 
-#: ../../source/ref-changelog.md:124
+#: ../../source/ref-changelog.md:146
 msgid ""
 "**Introduce SuperExec log streaming** "
 "([#3577](https://github.com/adap/flower/pull/3577), "
@@ -17214,7 +17293,7 @@ msgid ""
 "[#3613](https://github.com/adap/flower/pull/3613))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:126
+#: ../../source/ref-changelog.md:148
 msgid ""
 "Flower now supports log streaming from a remote SuperExec using the `flwr"
 " log` command. This new feature allows you to monitor logs from SuperExec"
@@ -17222,7 +17301,7 @@ msgid ""
 "<federation>`)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:128
+#: ../../source/ref-changelog.md:150
 msgid ""
 "**Improve `flwr new` templates** "
 "([#4291](https://github.com/adap/flower/pull/4291), "
@@ -17232,14 +17311,14 @@ msgid ""
 "[#4295](https://github.com/adap/flower/pull/4295))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:130
+#: ../../source/ref-changelog.md:152
 msgid ""
 "The `flwr new` command templates for MLX, NumPy, sklearn, JAX, and "
 "PyTorch have been updated to improve usability and consistency across "
 "frameworks."
 msgstr ""
 
-#: ../../source/ref-changelog.md:132
+#: ../../source/ref-changelog.md:154
 msgid ""
 "**Migrate ID handling to use unsigned 64-bit integers** "
 "([#4170](https://github.com/adap/flower/pull/4170), "
@@ -17247,7 +17326,7 @@ msgid ""
 "[#4243](https://github.com/adap/flower/pull/4243))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:134
+#: ../../source/ref-changelog.md:156
 msgid ""
 "Node IDs, run IDs, and related fields have been migrated from signed "
 "64-bit integers (`sint64`) to unsigned 64-bit integers (`uint64`). To "
@@ -17258,13 +17337,13 @@ msgid ""
 "`uint64`."
 msgstr ""
 
-#: ../../source/ref-changelog.md:136
+#: ../../source/ref-changelog.md:158
 msgid ""
 "**Add Flower architecture explanation** "
 "([#3270](https://github.com/adap/flower/pull/3270))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:138
+#: ../../source/ref-changelog.md:160
 msgid ""
 "A new [Flower architecture explainer](https://flower.ai/docs/framework"
 "/explanation-flower-architecture.html) page introduces Flower components "
@@ -17272,13 +17351,13 @@ msgid ""
 "documentation if you're interested."
 msgstr ""
 
-#: ../../source/ref-changelog.md:140
+#: ../../source/ref-changelog.md:162
 msgid ""
 "**Introduce FedRep baseline** "
 "([#3790](https://github.com/adap/flower/pull/3790))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:142
+#: ../../source/ref-changelog.md:164
 msgid ""
 "FedRep is a federated learning algorithm that learns shared data "
 "representations across clients while allowing each to maintain "
@@ -17288,7 +17367,7 @@ msgid ""
 "([arxiv](https://arxiv.org/abs/2102.07078))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:144
+#: ../../source/ref-changelog.md:166
 msgid ""
 "**Improve FlowerTune template and LLM evaluation pipelines** "
 "([#4286](https://github.com/adap/flower/pull/4286), "
@@ -17309,7 +17388,7 @@ msgid ""
 "[#4327](https://github.com/adap/flower/pull/4327))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:146
+#: ../../source/ref-changelog.md:168
 msgid ""
 "Refined evaluation pipelines, metrics, and documentation for the upcoming"
 " FlowerTune LLM Leaderboard across multiple domains including Finance, "
@@ -17318,7 +17397,7 @@ msgid ""
 "exciting challenge!"
 msgstr ""
 
-#: ../../source/ref-changelog.md:148
+#: ../../source/ref-changelog.md:170
 msgid ""
 "**Enhance Docker Support and Documentation** "
 "([#4191](https://github.com/adap/flower/pull/4191), "
@@ -17337,7 +17416,7 @@ msgid ""
 "[#4226](https://github.com/adap/flower/pull/4226))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:150
+#: ../../source/ref-changelog.md:172
 msgid ""
 "Upgraded Ubuntu base image to 24.04, added SBOM and gcc to Docker images,"
 " and comprehensively updated [Docker "
@@ -17345,14 +17424,14 @@ msgid ""
 "including quickstart guides and distributed Docker Compose instructions."
 msgstr ""
 
-#: ../../source/ref-changelog.md:152
+#: ../../source/ref-changelog.md:174
 msgid ""
 "**Introduce Flower glossary** "
 "([#4165](https://github.com/adap/flower/pull/4165), "
 "[#4235](https://github.com/adap/flower/pull/4235))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:154
+#: ../../source/ref-changelog.md:176
 msgid ""
 "Added the [Federated Learning glossary](https://flower.ai/glossary/) to "
 "the Flower repository, located under the `flower/glossary/` directory. "
@@ -17362,7 +17441,7 @@ msgid ""
 "become a Flower contributor!"
 msgstr ""
 
-#: ../../source/ref-changelog.md:156
+#: ../../source/ref-changelog.md:178
 msgid ""
 "**Implement Message Time-to-Live (TTL)** "
 "([#3620](https://github.com/adap/flower/pull/3620), "
@@ -17372,7 +17451,7 @@ msgid ""
 "[#3635](https://github.com/adap/flower/pull/3635))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:158
+#: ../../source/ref-changelog.md:180
 msgid ""
 "Added comprehensive TTL support for messages in Flower's SuperLink. "
 "Messages are now automatically expired and cleaned up based on "
@@ -17380,7 +17459,7 @@ msgid ""
 " default in the high-level API)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:160
+#: ../../source/ref-changelog.md:182
 msgid ""
 "**Improve FAB handling** "
 "([#4303](https://github.com/adap/flower/pull/4303), "
@@ -17389,14 +17468,14 @@ msgid ""
 "[#4304](https://github.com/adap/flower/pull/4304))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:162
+#: ../../source/ref-changelog.md:184
 msgid ""
 "An 8-character hash is now appended to the FAB file name. The `flwr "
 "install` command installs FABs with a more flattened folder structure, "
 "reducing it from 3 levels to 1."
 msgstr ""
 
-#: ../../source/ref-changelog.md:164
+#: ../../source/ref-changelog.md:186
 msgid ""
 "**Update documentation** "
 "([#3341](https://github.com/adap/flower/pull/3341), "
@@ -17407,7 +17486,7 @@ msgid ""
 "[#3993](https://github.com/adap/flower/pull/3993))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:166
+#: ../../source/ref-changelog.md:188
 msgid ""
 "Updated quickstart tutorials (PyTorch Lightning, TensorFlow, Hugging "
 "Face, Fastai) to use the new `flwr run` command and removed default title"
@@ -17415,7 +17494,7 @@ msgid ""
 "added to FAQ."
 msgstr ""
 
-#: ../../source/ref-changelog.md:168
+#: ../../source/ref-changelog.md:190
 msgid ""
 "**Update example projects** "
 "([#3716](https://github.com/adap/flower/pull/3716), "
@@ -17428,7 +17507,7 @@ msgid ""
 "[#4331](https://github.com/adap/flower/pull/4331))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:170
+#: ../../source/ref-changelog.md:192
 msgid ""
 "Refreshed multiple example projects including vertical FL, PyTorch "
 "(advanced), Pandas, Secure Aggregation, and XGBoost examples. Optimized "
@@ -17436,7 +17515,7 @@ msgid ""
 "simulation examples."
 msgstr ""
 
-#: ../../source/ref-changelog.md:172
+#: ../../source/ref-changelog.md:194
 msgid ""
 "**Update translations** "
 "([#4070](https://github.com/adap/flower/pull/4070), "
@@ -17448,7 +17527,7 @@ msgid ""
 "[#4259](https://github.com/adap/flower/pull/4259))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:174
+#: ../../source/ref-changelog.md:196
 msgid ""
 "**General improvements** "
 "([#4239](https://github.com/adap/flower/pull/4239), "
@@ -17495,7 +17574,7 @@ msgid ""
 "[#4333](https://github.com/adap/flower/pull/4333))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:180
+#: ../../source/ref-changelog.md:202
 msgid ""
 "**Drop Python 3.8 support and update minimum version to 3.9** "
 "([#4180](https://github.com/adap/flower/pull/4180), "
@@ -17508,7 +17587,7 @@ msgid ""
 "[#4194](https://github.com/adap/flower/pull/4194))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:182
+#: ../../source/ref-changelog.md:204
 msgid ""
 "Python 3.8 support was deprecated in Flower 1.9, and this release removes"
 " support. Flower now requires Python 3.9 or later (Python 3.11 is "
@@ -17516,80 +17595,80 @@ msgid ""
 "minimum supported version. Flower now supports Python 3.9 to 3.12."
 msgstr ""
 
-#: ../../source/ref-changelog.md:184
+#: ../../source/ref-changelog.md:206
 msgid "v1.11.1 (2024-09-11)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:190
+#: ../../source/ref-changelog.md:212
 msgid ""
 "`Charles Beauville`, `Chong Shen Ng`, `Daniel J. Beutel`, `Heng Pan`, "
 "`Javier`, `Robert Steiner`, `Yan Gao` <!---TOKEN_v1.11.1-->"
 msgstr ""
 
-#: ../../source/ref-changelog.md:192
+#: ../../source/ref-changelog.md:214
 #, fuzzy
 msgid "Improvements"
 msgstr "선택적 개선 사항"
 
-#: ../../source/ref-changelog.md:194
+#: ../../source/ref-changelog.md:216
 msgid ""
 "**Implement** `keys/values/items` **methods for** `TypedDict` "
 "([#4146](https://github.com/adap/flower/pull/4146))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:196
+#: ../../source/ref-changelog.md:218
 msgid ""
 "**Fix parsing of** `--executor-config` **if present** "
 "([#4125](https://github.com/adap/flower/pull/4125))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:198
+#: ../../source/ref-changelog.md:220
 msgid ""
 "**Adjust framework name in templates docstrings** "
 "([#4127](https://github.com/adap/flower/pull/4127))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:200
+#: ../../source/ref-changelog.md:222
 msgid ""
 "**Update** `flwr new` **Hugging Face template** "
 "([#4169](https://github.com/adap/flower/pull/4169))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:202
+#: ../../source/ref-changelog.md:224
 msgid ""
 "**Fix** `flwr new` **FlowerTune template** "
 "([#4123](https://github.com/adap/flower/pull/4123))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:204
+#: ../../source/ref-changelog.md:226
 msgid ""
 "**Add buffer time after** `ServerApp` **thread initialization** "
 "([#4119](https://github.com/adap/flower/pull/4119))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:206
+#: ../../source/ref-changelog.md:228
 msgid ""
 "**Handle unsuitable resources for simulation** "
 "([#4143](https://github.com/adap/flower/pull/4143))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:208
+#: ../../source/ref-changelog.md:230
 msgid ""
 "**Update example READMEs** "
 "([#4117](https://github.com/adap/flower/pull/4117))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:210
+#: ../../source/ref-changelog.md:232
 msgid ""
 "**Update SuperNode authentication docs** "
 "([#4160](https://github.com/adap/flower/pull/4160))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:216
+#: ../../source/ref-changelog.md:238
 msgid "v1.11.0 (2024-08-30)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:222
+#: ../../source/ref-changelog.md:244
 msgid ""
 "`Adam Narozniak`, `Charles Beauville`, `Chong Shen Ng`, `Daniel J. "
 "Beutel`, `Daniel Nata Nugraha`, `Danny`, `Edoardo Gabrielli`, `Heng Pan`,"
@@ -17598,7 +17677,7 @@ msgid ""
 "TOKEN_v1.11.0-->"
 msgstr ""
 
-#: ../../source/ref-changelog.md:226
+#: ../../source/ref-changelog.md:248
 msgid ""
 "**Deliver Flower App Bundle (FAB) to SuperLink and SuperNodes** "
 "([#4006](https://github.com/adap/flower/pull/4006), "
@@ -17625,14 +17704,14 @@ msgid ""
 "[#3619](https://github.com/adap/flower/pull/3619))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:228
+#: ../../source/ref-changelog.md:250
 msgid ""
 "Dynamic code updates are here! `flwr run` can now ship and install the "
 "latest version of your `ServerApp` and `ClientApp` to an already-running "
 "federation (SuperLink and SuperNodes)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:230
+#: ../../source/ref-changelog.md:252
 msgid ""
 "How does it work? `flwr run` bundles your Flower app into a single FAB "
 "(Flower App Bundle) file. It then ships this FAB file, via the SuperExec,"
@@ -17642,11 +17721,11 @@ msgid ""
 "projects!) dynamically."
 msgstr ""
 
-#: ../../source/ref-changelog.md:232
+#: ../../source/ref-changelog.md:254
 msgid "`flwr run` is all you need."
 msgstr ""
 
-#: ../../source/ref-changelog.md:234
+#: ../../source/ref-changelog.md:256
 msgid ""
 "**Introduce isolated** `ClientApp` **execution** "
 "([#3970](https://github.com/adap/flower/pull/3970), "
@@ -17666,30 +17745,30 @@ msgid ""
 "[#4032](https://github.com/adap/flower/pull/4032))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:236
+#: ../../source/ref-changelog.md:258
 msgid ""
 "The SuperNode can now run your `ClientApp` in a fully isolated way. In an"
 " enterprise deployment, this allows you to set strict limits on what the "
 "`ClientApp` can and cannot do."
 msgstr ""
 
-#: ../../source/ref-changelog.md:238
+#: ../../source/ref-changelog.md:260
 msgid "`flower-supernode` supports three `--isolation` modes:"
 msgstr ""
 
-#: ../../source/ref-changelog.md:240
+#: ../../source/ref-changelog.md:262
 msgid ""
 "Unset: The SuperNode runs the `ClientApp` in the same process (as in "
 "previous versions of Flower). This is the default mode."
 msgstr ""
 
-#: ../../source/ref-changelog.md:241
+#: ../../source/ref-changelog.md:263
 msgid ""
 "`--isolation=subprocess`: The SuperNode starts a subprocess to run the "
 "`ClientApp`."
 msgstr ""
 
-#: ../../source/ref-changelog.md:242
+#: ../../source/ref-changelog.md:264
 msgid ""
 "`--isolation=process`: The SuperNode expects an externally-managed "
 "process to run the `ClientApp`. This external process is not managed by "
@@ -17698,7 +17777,7 @@ msgid ""
 "`flwr/clientapp` Docker image."
 msgstr ""
 
-#: ../../source/ref-changelog.md:244
+#: ../../source/ref-changelog.md:266
 msgid ""
 "**Improve Docker support for enterprise deployments** "
 "([#4050](https://github.com/adap/flower/pull/4050), "
@@ -17709,17 +17788,17 @@ msgid ""
 "[#3722](https://github.com/adap/flower/pull/3722))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:246
+#: ../../source/ref-changelog.md:268
 msgid ""
 "Flower 1.11 ships many Docker improvements that are especially useful for"
 " enterprise deployments:"
 msgstr ""
 
-#: ../../source/ref-changelog.md:248
+#: ../../source/ref-changelog.md:270
 msgid "`flwr/supernode` comes with a new Alpine Docker image."
 msgstr ""
 
-#: ../../source/ref-changelog.md:249
+#: ../../source/ref-changelog.md:271
 msgid ""
 "`flwr/clientapp` is a new image to be used with the `--isolation=process`"
 " option. In this mode, SuperNode and `ClientApp` run in two different "
@@ -17729,19 +17808,19 @@ msgid ""
 "enterprise settings."
 msgstr ""
 
-#: ../../source/ref-changelog.md:250
+#: ../../source/ref-changelog.md:272
 msgid ""
 "New all-in-one Docker Compose enables you to easily start a full Flower "
 "Deployment Engine on a single machine."
 msgstr ""
 
-#: ../../source/ref-changelog.md:251
+#: ../../source/ref-changelog.md:273
 msgid ""
 "Completely new Docker documentation: "
 "https://flower.ai/docs/framework/docker/index.html"
 msgstr ""
 
-#: ../../source/ref-changelog.md:253
+#: ../../source/ref-changelog.md:275
 msgid ""
 "**Improve SuperNode authentication** "
 "([#4043](https://github.com/adap/flower/pull/4043), "
@@ -17749,13 +17828,13 @@ msgid ""
 "[#4074](https://github.com/adap/flower/pull/4074))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:255
+#: ../../source/ref-changelog.md:277
 msgid ""
 "SuperNode auth has been improved in several ways, including improved "
 "logging, improved testing, and improved error handling."
 msgstr ""
 
-#: ../../source/ref-changelog.md:257
+#: ../../source/ref-changelog.md:279
 msgid ""
 "**Update** `flwr new` **templates** "
 "([#3933](https://github.com/adap/flower/pull/3933), "
@@ -17769,13 +17848,13 @@ msgid ""
 "[#4064](https://github.com/adap/flower/pull/4064))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:259
+#: ../../source/ref-changelog.md:281
 msgid ""
 "All `flwr new` templates have been updated to show the latest recommended"
 " use of Flower APIs."
 msgstr ""
 
-#: ../../source/ref-changelog.md:261
+#: ../../source/ref-changelog.md:283
 msgid ""
 "**Improve Simulation Engine** "
 "([#4095](https://github.com/adap/flower/pull/4095), "
@@ -17787,14 +17866,14 @@ msgid ""
 "[#3988](https://github.com/adap/flower/pull/3988))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:263
+#: ../../source/ref-changelog.md:285
 msgid ""
 "The Flower Simulation Engine comes with several updates, including "
 "improved run config support, verbose logging, simulation backend "
 "configuration via `flwr run`, and more."
 msgstr ""
 
-#: ../../source/ref-changelog.md:265
+#: ../../source/ref-changelog.md:287
 msgid ""
 "**Improve** `RecordSet` "
 "([#4052](https://github.com/adap/flower/pull/4052), "
@@ -17802,7 +17881,7 @@ msgid ""
 "[#4016](https://github.com/adap/flower/pull/4016))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:267
+#: ../../source/ref-changelog.md:289
 msgid ""
 "`RecordSet` is the core object to exchange model parameters, "
 "configuration values and metrics between `ClientApp` and `ServerApp`. "
@@ -17810,7 +17889,7 @@ msgid ""
 "related `*Record` types."
 msgstr ""
 
-#: ../../source/ref-changelog.md:269
+#: ../../source/ref-changelog.md:291
 msgid ""
 "**Update documentation** "
 "([#3972](https://github.com/adap/flower/pull/3972), "
@@ -17829,14 +17908,14 @@ msgid ""
 "[#3916](https://github.com/adap/flower/pull/3916))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:271
+#: ../../source/ref-changelog.md:293
 msgid ""
 "Many parts of the documentation, including the main tutorial, have been "
 "migrated to show new Flower APIs and other new Flower features like the "
 "improved Docker support."
 msgstr ""
 
-#: ../../source/ref-changelog.md:273
+#: ../../source/ref-changelog.md:295
 msgid ""
 "**Migrate code example to use new Flower APIs** "
 "([#3758](https://github.com/adap/flower/pull/3758), "
@@ -17862,11 +17941,11 @@ msgid ""
 "[#3313](https://github.com/adap/flower/pull/3313))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:275
+#: ../../source/ref-changelog.md:297
 msgid "Many code examples have been migrated to use new Flower APIs."
 msgstr ""
 
-#: ../../source/ref-changelog.md:277
+#: ../../source/ref-changelog.md:299
 msgid ""
 "**Update Flower framework, framework internals and quality "
 "infrastructure** ([#4018](https://github.com/adap/flower/pull/4018), "
@@ -17908,13 +17987,13 @@ msgid ""
 "[#4038](https://github.com/adap/flower/pull/4038))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:283
+#: ../../source/ref-changelog.md:305
 msgid ""
 "**Deprecate accessing `Context` via `Client.context`** "
 "([#3797](https://github.com/adap/flower/pull/3797))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:285
+#: ../../source/ref-changelog.md:307
 msgid ""
 "Now that both `client_fn` and `server_fn` receive a `Context` object, "
 "accessing `Context` via `Client.context` is deprecated. `Client.context` "
@@ -17923,7 +18002,7 @@ msgid ""
 " instance in `client_fn`:"
 msgstr ""
 
-#: ../../source/ref-changelog.md:294
+#: ../../source/ref-changelog.md:316
 msgid ""
 "**Update CLIs to accept an app directory instead of** `ClientApp` **and**"
 " `ServerApp` ([#3952](https://github.com/adap/flower/pull/3952), "
@@ -17931,7 +18010,7 @@ msgid ""
 "[#3850](https://github.com/adap/flower/pull/3850))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:296
+#: ../../source/ref-changelog.md:318
 msgid ""
 "The CLI commands `flower-supernode` and `flower-server-app` now accept an"
 " app directory as argument (instead of references to a `ClientApp` or "
@@ -17941,49 +18020,49 @@ msgid ""
 "`flwr new`."
 msgstr ""
 
-#: ../../source/ref-changelog.md:298
+#: ../../source/ref-changelog.md:320
 msgid ""
 "**Disable** `flower-client-app` **CLI command** "
 "([#4022](https://github.com/adap/flower/pull/4022))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:300
+#: ../../source/ref-changelog.md:322
 msgid "`flower-client-app` has been disabled. Use `flower-supernode` instead."
 msgstr ""
 
-#: ../../source/ref-changelog.md:302
+#: ../../source/ref-changelog.md:324
 msgid ""
 "**Use spaces instead of commas for separating config args** "
 "([#4000](https://github.com/adap/flower/pull/4000))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:304
+#: ../../source/ref-changelog.md:326
 msgid ""
 "When passing configs (run config, node config) to Flower, you now need to"
 " separate key-value pairs using spaces instead of commas. For example:"
 msgstr ""
 
-#: ../../source/ref-changelog.md:310
+#: ../../source/ref-changelog.md:332
 msgid "Previously, you could pass configs using commas, like this:"
 msgstr ""
 
-#: ../../source/ref-changelog.md:316
+#: ../../source/ref-changelog.md:338
 msgid ""
 "**Remove** `flwr example` **CLI command** "
 "([#4084](https://github.com/adap/flower/pull/4084))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:318
+#: ../../source/ref-changelog.md:340
 msgid ""
 "The experimental `flwr example` CLI command has been removed. Use `flwr "
 "new` to generate a project and then run it using `flwr run`."
 msgstr ""
 
-#: ../../source/ref-changelog.md:320
+#: ../../source/ref-changelog.md:342
 msgid "v1.10.0 (2024-07-24)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:326
+#: ../../source/ref-changelog.md:348
 msgid ""
 "`Adam Narozniak`, `Charles Beauville`, `Chong Shen Ng`, `Daniel J. "
 "Beutel`, `Daniel Nata Nugraha`, `Danny`, `Gustavo Bertoli`, `Heng Pan`, "
@@ -17992,7 +18071,7 @@ msgid ""
 "---TOKEN_v1.10.0-->"
 msgstr ""
 
-#: ../../source/ref-changelog.md:330
+#: ../../source/ref-changelog.md:352
 msgid ""
 "**Introduce** `flwr run` **(beta)** "
 "([#3810](https://github.com/adap/flower/pull/3810), "
@@ -18006,7 +18085,7 @@ msgid ""
 "[#3819](https://github.com/adap/flower/pull/3819))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:332
+#: ../../source/ref-changelog.md:354
 msgid ""
 "Flower 1.10 ships the first beta release of the new `flwr run` command. "
 "`flwr run` can run different projects using `flwr run path/to/project`, "
@@ -18019,7 +18098,7 @@ msgid ""
 "`flwr new` to generate a project and then run it using `flwr run`."
 msgstr ""
 
-#: ../../source/ref-changelog.md:334
+#: ../../source/ref-changelog.md:356
 msgid ""
 "**Introduce run config** "
 "([#3751](https://github.com/adap/flower/pull/3751), "
@@ -18039,7 +18118,7 @@ msgid ""
 "[#3815](https://github.com/adap/flower/pull/3815))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:336
+#: ../../source/ref-changelog.md:358
 msgid ""
 "The new run config feature allows you to run your Flower project in "
 "different configurations without having to change a single line of code. "
@@ -18052,7 +18131,7 @@ msgid ""
 "new project using `flwr new` to see run config in action."
 msgstr ""
 
-#: ../../source/ref-changelog.md:338
+#: ../../source/ref-changelog.md:360
 msgid ""
 "**Generalize** `client_fn` **signature to** `client_fn(context: Context) "
 "-> Client` ([#3779](https://github.com/adap/flower/pull/3779), "
@@ -18061,7 +18140,7 @@ msgid ""
 "[#3696](https://github.com/adap/flower/pull/3696))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:340
+#: ../../source/ref-changelog.md:362
 msgid ""
 "The `client_fn` signature has been generalized to `client_fn(context: "
 "Context) -> Client`. It now receives a `Context` object instead of the "
@@ -18071,14 +18150,14 @@ msgid ""
 "system."
 msgstr ""
 
-#: ../../source/ref-changelog.md:342
+#: ../../source/ref-changelog.md:364
 msgid ""
 "The previous signature `client_fn(cid: str)` is now deprecated and "
 "support for it will be removed in a future release. Use "
 "`client_fn(context: Context) -> Client` everywhere."
 msgstr ""
 
-#: ../../source/ref-changelog.md:344
+#: ../../source/ref-changelog.md:366
 msgid ""
 "**Introduce new** `server_fn(context)` "
 "([#3773](https://github.com/adap/flower/pull/3773), "
@@ -18086,7 +18165,7 @@ msgid ""
 "[#3771](https://github.com/adap/flower/pull/3771))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:346
+#: ../../source/ref-changelog.md:368
 msgid ""
 "In addition to the new `client_fn(context:Context)`, a new "
 "`server_fn(context: Context) -> ServerAppComponents` can now be passed to"
@@ -18095,7 +18174,7 @@ msgid ""
 "build a configurable `ServerApp`."
 msgstr ""
 
-#: ../../source/ref-changelog.md:348
+#: ../../source/ref-changelog.md:370
 msgid ""
 "**Relaunch all** `flwr new` **templates** "
 "([#3877](https://github.com/adap/flower/pull/3877), "
@@ -18107,7 +18186,7 @@ msgid ""
 "[#3760](https://github.com/adap/flower/pull/3760))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:350
+#: ../../source/ref-changelog.md:372
 msgid ""
 "All `flwr new` templates have been significantly updated to showcase new "
 "Flower features and best practices. This includes using `flwr run` and "
@@ -18116,13 +18195,13 @@ msgid ""
 "run` it."
 msgstr ""
 
-#: ../../source/ref-changelog.md:352
+#: ../../source/ref-changelog.md:374
 msgid ""
 "**Introduce** `flower-supernode` **(preview)** "
 "([#3353](https://github.com/adap/flower/pull/3353))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:354
+#: ../../source/ref-changelog.md:376
 msgid ""
 "The new `flower-supernode` CLI is here to replace `flower-client-app`. "
 "`flower-supernode` brings full multi-app support to the Flower client-"
@@ -18131,7 +18210,7 @@ msgid ""
 "`client_fn(context: Context)` signature)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:356
+#: ../../source/ref-changelog.md:378
 msgid ""
 "**Introduce node config** "
 "([#3782](https://github.com/adap/flower/pull/3782), "
@@ -18140,7 +18219,7 @@ msgid ""
 "[#3886](https://github.com/adap/flower/pull/3886))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:358
+#: ../../source/ref-changelog.md:380
 msgid ""
 "A new node config feature allows you to pass a static configuration to "
 "the SuperNode. This configuration is read-only and available to every "
@@ -18148,7 +18227,7 @@ msgid ""
 "config via `Context` (`context.node_config`)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:360
+#: ../../source/ref-changelog.md:382
 msgid ""
 "**Introduce SuperExec (experimental)** "
 "([#3605](https://github.com/adap/flower/pull/3605), "
@@ -18169,26 +18248,26 @@ msgid ""
 "[#3629](https://github.com/adap/flower/pull/3629))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:362
+#: ../../source/ref-changelog.md:384
 msgid ""
 "This is the first experimental release of Flower SuperExec, a new service"
 " that executes your runs. It's not ready for production deployment just "
 "yet, but don't hesitate to give it a try if you're interested."
 msgstr ""
 
-#: ../../source/ref-changelog.md:364
+#: ../../source/ref-changelog.md:386
 msgid ""
 "**Add new federated learning with tabular data example** "
 "([#3568](https://github.com/adap/flower/pull/3568))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:366
+#: ../../source/ref-changelog.md:388
 msgid ""
 "A new code example exemplifies a federated learning setup using the "
 "Flower framework on the Adult Census Income tabular dataset."
 msgstr ""
 
-#: ../../source/ref-changelog.md:368
+#: ../../source/ref-changelog.md:390
 msgid ""
 "**Create generic adapter layer (preview)** "
 "([#3538](https://github.com/adap/flower/pull/3538), "
@@ -18196,7 +18275,7 @@ msgid ""
 "[#3540](https://github.com/adap/flower/pull/3540))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:370
+#: ../../source/ref-changelog.md:392
 msgid ""
 "A new generic gRPC adapter layer allows 3rd-party frameworks to integrate"
 " with Flower in a transparent way. This makes Flower more modular and "
@@ -18204,7 +18283,7 @@ msgid ""
 "platforms."
 msgstr ""
 
-#: ../../source/ref-changelog.md:372
+#: ../../source/ref-changelog.md:394
 msgid ""
 "**Refactor Flower Simulation Engine** "
 "([#3581](https://github.com/adap/flower/pull/3581), "
@@ -18220,7 +18299,7 @@ msgid ""
 "[#3469](https://github.com/adap/flower/pull/3469))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:374
+#: ../../source/ref-changelog.md:396
 msgid ""
 "The Simulation Engine was significantly refactored. This results in "
 "faster and more stable simulations. It is also the foundation for "
@@ -18228,31 +18307,31 @@ msgid ""
 "configurability in federated learning simulations."
 msgstr ""
 
-#: ../../source/ref-changelog.md:376
+#: ../../source/ref-changelog.md:398
 msgid ""
 "**Optimize Docker containers** "
 "([#3591](https://github.com/adap/flower/pull/3591))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:378
+#: ../../source/ref-changelog.md:400
 msgid ""
 "Flower Docker containers were optimized and updated to use that latest "
 "Flower framework features."
 msgstr ""
 
-#: ../../source/ref-changelog.md:380
+#: ../../source/ref-changelog.md:402
 msgid ""
 "**Improve logging** ([#3776](https://github.com/adap/flower/pull/3776), "
 "[#3789](https://github.com/adap/flower/pull/3789))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:382
+#: ../../source/ref-changelog.md:404
 msgid ""
 "Improved logging aims to be more concise and helpful to show you the "
 "details you actually care about."
 msgstr ""
 
-#: ../../source/ref-changelog.md:384
+#: ../../source/ref-changelog.md:406
 msgid ""
 "**Refactor framework internals** "
 "([#3621](https://github.com/adap/flower/pull/3621), "
@@ -18266,13 +18345,18 @@ msgid ""
 "[#3569](https://github.com/adap/flower/pull/3569))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:390
+#: ../../source/ref-changelog.md:410
+#, fuzzy
+msgid "Documentation improvements"
+msgstr "선택적 개선 사항"
+
+#: ../../source/ref-changelog.md:412
 msgid ""
 "**Add 🇰🇷 Korean translations** "
 "([#3680](https://github.com/adap/flower/pull/3680))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:392
+#: ../../source/ref-changelog.md:414
 msgid ""
 "**Update translations** "
 "([#3586](https://github.com/adap/flower/pull/3586), "
@@ -18286,7 +18370,7 @@ msgid ""
 "[#3631](https://github.com/adap/flower/pull/3631))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:394
+#: ../../source/ref-changelog.md:416
 msgid ""
 "**Update documentation** "
 "([#3864](https://github.com/adap/flower/pull/3864), "
@@ -18300,18 +18384,18 @@ msgid ""
 "[#3707](https://github.com/adap/flower/pull/3707))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:396
+#: ../../source/ref-changelog.md:418
 msgid ""
 "Updated documentation includes new install instructions for different "
 "shells, a new Flower Code Examples documentation landing page, new `flwr`"
 " CLI docs and an updated federated XGBoost code example."
 msgstr ""
 
-#: ../../source/ref-changelog.md:400
+#: ../../source/ref-changelog.md:422
 msgid "**Deprecate** `client_fn(cid: str)`"
 msgstr ""
 
-#: ../../source/ref-changelog.md:402
+#: ../../source/ref-changelog.md:424
 msgid ""
 "`client_fn` used to have a signature `client_fn(cid: str) -> Client`. "
 "This signature is now deprecated. Use the new signature "
@@ -18324,13 +18408,13 @@ msgid ""
 " the dataset on each simulated or deployed SuperNode."
 msgstr ""
 
-#: ../../source/ref-changelog.md:404
+#: ../../source/ref-changelog.md:426
 msgid ""
 "**Deprecate passing** `Server/ServerConfig/Strategy/ClientManager` **to**"
 " `ServerApp` **directly**"
 msgstr ""
 
-#: ../../source/ref-changelog.md:406
+#: ../../source/ref-changelog.md:428
 msgid ""
 "Creating `ServerApp` using `ServerApp(config=config, strategy=strategy)` "
 "is now deprecated. Instead of passing "
@@ -18343,13 +18427,13 @@ msgid ""
 " the `run_config`)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:410
+#: ../../source/ref-changelog.md:432
 msgid ""
 "**Remove support for `client_ids` in `start_simulation`** "
 "([#3699](https://github.com/adap/flower/pull/3699))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:412
+#: ../../source/ref-changelog.md:434
 msgid ""
 "The (rarely used) feature that allowed passing custom `client_ids` to the"
 " `start_simulation` function was removed. This removal is part of a "
@@ -18357,24 +18441,24 @@ msgid ""
 "internals work in simulation and deployment."
 msgstr ""
 
-#: ../../source/ref-changelog.md:414
+#: ../../source/ref-changelog.md:436
 msgid ""
 "**Remove `flower-driver-api` and `flower-fleet-api`** "
 "([#3418](https://github.com/adap/flower/pull/3418))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:416
+#: ../../source/ref-changelog.md:438
 msgid ""
 "The two deprecated CLI commands `flower-driver-api` and `flower-fleet-"
 "api` were removed in an effort to streamline the SuperLink developer "
 "experience. Use `flower-superlink` instead."
 msgstr ""
 
-#: ../../source/ref-changelog.md:418
+#: ../../source/ref-changelog.md:440
 msgid "v1.9.0 (2024-06-10)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:424
+#: ../../source/ref-changelog.md:446
 msgid ""
 "`Adam Narozniak`, `Charles Beauville`, `Chong Shen Ng`, `Daniel J. "
 "Beutel`, `Daniel Nata Nugraha`, `Heng Pan`, `Javier`, `Mahdi Beitollahi`,"
@@ -18382,7 +18466,7 @@ msgid ""
 "---TOKEN_v1.9.0-->"
 msgstr ""
 
-#: ../../source/ref-changelog.md:428
+#: ../../source/ref-changelog.md:450
 msgid ""
 "**Introduce built-in authentication (preview)** "
 "([#2946](https://github.com/adap/flower/pull/2946), "
@@ -18401,7 +18485,7 @@ msgid ""
 "[#3357](https://github.com/adap/flower/pull/3357))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:430
+#: ../../source/ref-changelog.md:452
 msgid ""
 "Flower 1.9 introduces the first build-in version of client node "
 "authentication. In previous releases, users often wrote glue code to "
@@ -18413,14 +18497,14 @@ msgid ""
 "authentication) help you to get started."
 msgstr ""
 
-#: ../../source/ref-changelog.md:432
+#: ../../source/ref-changelog.md:454
 msgid ""
 "This is the first preview release of the Flower-native authentication "
 "system. Many additional features are on the roadmap for upcoming Flower "
 "releases - stay tuned."
 msgstr ""
 
-#: ../../source/ref-changelog.md:434
+#: ../../source/ref-changelog.md:456
 msgid ""
 "**Introduce end-to-end Docker support** "
 "([#3483](https://github.com/adap/flower/pull/3483), "
@@ -18437,7 +18521,7 @@ msgid ""
 "[#3290](https://github.com/adap/flower/pull/3290))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:436
+#: ../../source/ref-changelog.md:458
 msgid ""
 "Full Flower Next Docker support is here! With the release of Flower 1.9, "
 "Flower provides stable Docker images for the Flower SuperLink, the Flower"
@@ -18447,7 +18531,7 @@ msgid ""
 "docker.html) to get stated."
 msgstr ""
 
-#: ../../source/ref-changelog.md:438
+#: ../../source/ref-changelog.md:460
 msgid ""
 "**Re-architect Flower Next simulation engine** "
 "([#3307](https://github.com/adap/flower/pull/3307), "
@@ -18460,7 +18544,7 @@ msgid ""
 "[#3326](https://github.com/adap/flower/pull/3326))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:440
+#: ../../source/ref-changelog.md:462
 msgid ""
 "Flower Next simulations now use a new in-memory `Driver` that improves "
 "the reliability of simulations, especially in notebook environments. This"
@@ -18468,7 +18552,7 @@ msgid ""
 "simulation architecture."
 msgstr ""
 
-#: ../../source/ref-changelog.md:442
+#: ../../source/ref-changelog.md:464
 msgid ""
 "**Upgrade simulation engine** "
 "([#3354](https://github.com/adap/flower/pull/3354), "
@@ -18480,20 +18564,20 @@ msgid ""
 "[#3494](https://github.com/adap/flower/pull/3494))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:444
+#: ../../source/ref-changelog.md:466
 msgid ""
 "The Flower Next simulation engine comes with improved and configurable "
 "logging. The Ray-based simulation backend in Flower 1.9 was updated to "
 "use Ray 2.10."
 msgstr ""
 
-#: ../../source/ref-changelog.md:446
+#: ../../source/ref-changelog.md:468
 msgid ""
 "**Introduce FedPFT baseline** "
 "([#3268](https://github.com/adap/flower/pull/3268))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:448
+#: ../../source/ref-changelog.md:470
 msgid ""
 "FedPFT allows you to perform one-shot Federated Learning by leveraging "
 "widely available foundational models, dramatically reducing communication"
@@ -18504,7 +18588,7 @@ msgid ""
 "([arxiv](https://arxiv.org/abs/2402.01862))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:450
+#: ../../source/ref-changelog.md:472
 msgid ""
 "**Launch additional** `flwr new` **templates for Apple MLX, Hugging Face "
 "Transformers, scikit-learn and TensorFlow** "
@@ -18516,7 +18600,7 @@ msgid ""
 "[#3287](https://github.com/adap/flower/pull/3287))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:452
+#: ../../source/ref-changelog.md:474
 msgid ""
 "The `flwr` CLI's `flwr new` command is starting to become everone's "
 "favorite way of creating new Flower projects. This release introduces "
@@ -18525,7 +18609,7 @@ msgid ""
 "also received updates."
 msgstr ""
 
-#: ../../source/ref-changelog.md:454
+#: ../../source/ref-changelog.md:476
 msgid ""
 "**Refine** `RecordSet` **API** "
 "([#3209](https://github.com/adap/flower/pull/3209), "
@@ -18536,14 +18620,14 @@ msgid ""
 "[#3368](https://github.com/adap/flower/pull/3368))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:456
+#: ../../source/ref-changelog.md:478
 msgid ""
 "`RecordSet` is part of the Flower Next low-level API preview release. In "
 "Flower 1.9, `RecordSet` received a number of usability improvements that "
 "make it easier to build `RecordSet`-based `ServerApp`s and `ClientApp`s."
 msgstr ""
 
-#: ../../source/ref-changelog.md:458
+#: ../../source/ref-changelog.md:480
 msgid ""
 "**Beautify logging** ([#3379](https://github.com/adap/flower/pull/3379), "
 "[#3430](https://github.com/adap/flower/pull/3430), "
@@ -18552,13 +18636,13 @@ msgid ""
 "[#3433](https://github.com/adap/flower/pull/3433))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:460
+#: ../../source/ref-changelog.md:482
 msgid ""
 "Logs received a substantial update. Not only are logs now much nicer to "
 "look at, but they are also more configurable."
 msgstr ""
 
-#: ../../source/ref-changelog.md:462
+#: ../../source/ref-changelog.md:484
 msgid ""
 "**Improve reliability** "
 "([#3564](https://github.com/adap/flower/pull/3564), "
@@ -18571,27 +18655,27 @@ msgid ""
 "[#3372](https://github.com/adap/flower/pull/3372))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:464
+#: ../../source/ref-changelog.md:486
 msgid ""
 "Flower 1.9 includes reliability improvements across many parts of the "
 "system. One example is a much improved SuperNode shutdown procedure."
 msgstr ""
 
-#: ../../source/ref-changelog.md:466
+#: ../../source/ref-changelog.md:488
 msgid ""
 "**Update Swift and C++ SDKs** "
 "([#3321](https://github.com/adap/flower/pull/3321), "
 "[#2763](https://github.com/adap/flower/pull/2763))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:468
+#: ../../source/ref-changelog.md:490
 msgid ""
 "In the C++ SDK, communication-related code is now separate from main "
 "client logic. A new abstract class `Communicator` has been introduced "
 "alongside a gRPC implementation of it."
 msgstr ""
 
-#: ../../source/ref-changelog.md:470
+#: ../../source/ref-changelog.md:492
 msgid ""
 "**Improve testing, tooling and CI/CD infrastructure** "
 "([#3294](https://github.com/adap/flower/pull/3294), "
@@ -18625,13 +18709,13 @@ msgid ""
 "[#3271](https://github.com/adap/flower/pull/3271))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:472
+#: ../../source/ref-changelog.md:494
 msgid ""
 "As always, the Flower tooling, testing, and CI/CD infrastructure has "
 "received many updates."
 msgstr ""
 
-#: ../../source/ref-changelog.md:474
+#: ../../source/ref-changelog.md:496
 msgid ""
 "**Improve documentation** "
 "([#3530](https://github.com/adap/flower/pull/3530), "
@@ -18656,32 +18740,32 @@ msgid ""
 "[#3274](https://github.com/adap/flower/pull/3274))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:476
+#: ../../source/ref-changelog.md:498
 msgid ""
 "As always, the Flower documentation has received many updates. Notable "
 "new pages include:"
 msgstr ""
 
-#: ../../source/ref-changelog.md:478
+#: ../../source/ref-changelog.md:500
 msgid ""
 "[How-to upgrate to Flower Next (Flower Next migration "
 "guide)](https://flower.ai/docs/framework/how-to-upgrade-to-flower-"
 "next.html)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:480
+#: ../../source/ref-changelog.md:502
 msgid ""
 "[How-to run Flower using Docker](https://flower.ai/docs/framework/how-to-"
 "run-flower-using-docker.html)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:482
+#: ../../source/ref-changelog.md:504
 msgid ""
 "[Flower Mods reference](https://flower.ai/docs/framework/ref-"
 "api/flwr.client.mod.html#module-flwr.client.mod)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:484
+#: ../../source/ref-changelog.md:506
 msgid ""
 "**General updates to Flower Examples** "
 "([#3205](https://github.com/adap/flower/pull/3205), "
@@ -18704,11 +18788,11 @@ msgid ""
 "[#3269](https://github.com/adap/flower/pull/3269))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:486
+#: ../../source/ref-changelog.md:508
 msgid "As always, Flower code examples have received many updates."
 msgstr ""
 
-#: ../../source/ref-changelog.md:488
+#: ../../source/ref-changelog.md:510
 msgid ""
 "**General improvements** "
 "([#3532](https://github.com/adap/flower/pull/3532), "
@@ -18747,45 +18831,45 @@ msgid ""
 "[#3261](https://github.com/adap/flower/pull/3261))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:492
+#: ../../source/ref-changelog.md:514
 msgid "**Deprecate Python 3.8 support**"
 msgstr ""
 
-#: ../../source/ref-changelog.md:494
+#: ../../source/ref-changelog.md:516
 msgid ""
 "Python 3.8 will stop receiving security fixes in [October "
 "2024](https://devguide.python.org/versions/). Support for Python 3.8 is "
 "now deprecated and will be removed in an upcoming release."
 msgstr ""
 
-#: ../../source/ref-changelog.md:496
+#: ../../source/ref-changelog.md:518
 msgid ""
 "**Deprecate (experimental)** `flower-driver-api` **and** `flower-fleet-"
 "api` ([#3416](https://github.com/adap/flower/pull/3416), "
 "[#3420](https://github.com/adap/flower/pull/3420))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:498
+#: ../../source/ref-changelog.md:520
 msgid ""
 "Flower 1.9 deprecates the two (experimental) commands `flower-driver-api`"
 " and `flower-fleet-api`. Both commands will be removed in an upcoming "
 "release. Use `flower-superlink` instead."
 msgstr ""
 
-#: ../../source/ref-changelog.md:500
+#: ../../source/ref-changelog.md:522
 msgid ""
 "**Deprecate** `--server` **in favor of** `--superlink` "
 "([#3518](https://github.com/adap/flower/pull/3518))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:502
+#: ../../source/ref-changelog.md:524
 msgid ""
 "The commands `flower-server-app` and `flower-client-app` should use "
 "`--superlink` instead of the now deprecated `--server`. Support for "
 "`--server` will be removed in a future release."
 msgstr ""
 
-#: ../../source/ref-changelog.md:506
+#: ../../source/ref-changelog.md:528
 msgid ""
 "**Replace** `flower-superlink` **CLI option** `--certificates` **with** "
 "`--ssl-ca-certfile` **,** `--ssl-certfile` **and** `--ssl-keyfile` "
@@ -18793,7 +18877,7 @@ msgid ""
 "[#3408](https://github.com/adap/flower/pull/3408))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:508
+#: ../../source/ref-changelog.md:530
 msgid ""
 "SSL-related `flower-superlink` CLI arguments were restructured in an "
 "incompatible way. Instead of passing a single `--certificates` flag with "
@@ -18803,26 +18887,26 @@ msgid ""
 "connections.html) documentation page for details."
 msgstr ""
 
-#: ../../source/ref-changelog.md:510
+#: ../../source/ref-changelog.md:532
 msgid ""
 "**Remove SuperLink** `--vce` **option** "
 "([#3513](https://github.com/adap/flower/pull/3513))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:512
+#: ../../source/ref-changelog.md:534
 msgid ""
 "Instead of separately starting a SuperLink and a `ServerApp` for "
 "simulation, simulations must now be started using the single `flower-"
 "simulation` command."
 msgstr ""
 
-#: ../../source/ref-changelog.md:514
+#: ../../source/ref-changelog.md:536
 msgid ""
 "**Merge** `--grpc-rere` **and** `--rest` **SuperLink options** "
 "([#3527](https://github.com/adap/flower/pull/3527))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:516
+#: ../../source/ref-changelog.md:538
 msgid ""
 "To simplify the usage of `flower-superlink`, previously separate sets of "
 "CLI options for gRPC and REST were merged into one unified set of "
@@ -18831,11 +18915,11 @@ msgid ""
 "details."
 msgstr ""
 
-#: ../../source/ref-changelog.md:518
+#: ../../source/ref-changelog.md:540
 msgid "v1.8.0 (2024-04-03)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:524
+#: ../../source/ref-changelog.md:546
 msgid ""
 "`Adam Narozniak`, `Charles Beauville`, `Daniel J. Beutel`, `Daniel Nata "
 "Nugraha`, `Danny`, `Gustavo Bertoli`, `Heng Pan`, `Ikko Eltociear "
@@ -18844,7 +18928,7 @@ msgid ""
 "`tabdar-khan` <!---TOKEN_v1.8.0-->"
 msgstr ""
 
-#: ../../source/ref-changelog.md:528
+#: ../../source/ref-changelog.md:550
 msgid ""
 "**Introduce Flower Next high-level API (stable)** "
 "([#3002](https://github.com/adap/flower/pull/3002), "
@@ -18874,7 +18958,7 @@ msgid ""
 "[#3197](https://github.com/adap/flower/pull/3197))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:530
+#: ../../source/ref-changelog.md:552
 msgid ""
 "The Flower Next high-level API is stable! Flower Next is the future of "
 "Flower - all new features (like Flower Mods) will be built on top of it. "
@@ -18888,7 +18972,7 @@ msgid ""
 "projects that use `Strategy`, `NumPyClient` & co."
 msgstr ""
 
-#: ../../source/ref-changelog.md:532
+#: ../../source/ref-changelog.md:554
 msgid ""
 "**Introduce Flower Next low-level API (preview)** "
 "([#3062](https://github.com/adap/flower/pull/3062), "
@@ -18896,7 +18980,7 @@ msgid ""
 "[#3069](https://github.com/adap/flower/pull/3069))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:534
+#: ../../source/ref-changelog.md:556
 msgid ""
 "In addition to the Flower Next *high-level* API that uses `Strategy`, "
 "`NumPyClient` & co, Flower 1.8 also comes with a preview version of the "
@@ -18913,7 +18997,7 @@ msgid ""
 "custom SMPC protocols, to name just a few."
 msgstr ""
 
-#: ../../source/ref-changelog.md:536
+#: ../../source/ref-changelog.md:558
 msgid ""
 "**Introduce Flower Mods (preview)** "
 "([#3054](https://github.com/adap/flower/pull/3054), "
@@ -18921,7 +19005,7 @@ msgid ""
 "[#3083](https://github.com/adap/flower/pull/3083))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:538
+#: ../../source/ref-changelog.md:560
 msgid ""
 "Flower Modifiers (we call them Mods) can intercept messages and analyze, "
 "edit or handle them directly. Mods can be used to develop pluggable "
@@ -18933,7 +19017,7 @@ msgid ""
 "can already use it to experiment with arbirtrary SMPC protocols."
 msgstr ""
 
-#: ../../source/ref-changelog.md:540
+#: ../../source/ref-changelog.md:562
 msgid ""
 "**Fine-tune LLMs with LLM FlowerTune** "
 "([#3029](https://github.com/adap/flower/pull/3029), "
@@ -18945,7 +19029,7 @@ msgid ""
 "[#3172](https://github.com/adap/flower/pull/3172))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:542
+#: ../../source/ref-changelog.md:564
 msgid ""
 "We are introducing LLM FlowerTune, an introductory example that "
 "demonstrates federated LLM fine-tuning of pre-trained Llama2 models on "
@@ -18955,7 +19039,7 @@ msgid ""
 "-llm-flowertune-federated-llm-finetuning-with-flower/) for more details."
 msgstr ""
 
-#: ../../source/ref-changelog.md:544
+#: ../../source/ref-changelog.md:566
 msgid ""
 "**Introduce built-in Differential Privacy (preview)** "
 "([#2798](https://github.com/adap/flower/pull/2798), "
@@ -18969,7 +19053,7 @@ msgid ""
 "[#3074](https://github.com/adap/flower/pull/3074))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:546
+#: ../../source/ref-changelog.md:568
 msgid ""
 "Built-in Differential Privacy is here! Flower supports both central and "
 "local differential privacy (DP). Central DP can be configured with either"
@@ -18982,7 +19066,7 @@ msgid ""
 "/how-to-use-differential-privacy.html) in Flower."
 msgstr ""
 
-#: ../../source/ref-changelog.md:548
+#: ../../source/ref-changelog.md:570
 msgid ""
 "**Introduce built-in Secure Aggregation (preview)** "
 "([#3120](https://github.com/adap/flower/pull/3120), "
@@ -18990,7 +19074,7 @@ msgid ""
 "[#3108](https://github.com/adap/flower/pull/3108))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:550
+#: ../../source/ref-changelog.md:572
 msgid ""
 "Built-in Secure Aggregation is here! Flower now supports different secure"
 " aggregation protocols out-of-the-box. The best part? You can add secure "
@@ -19003,7 +19087,7 @@ msgid ""
 "in the same project."
 msgstr ""
 
-#: ../../source/ref-changelog.md:552
+#: ../../source/ref-changelog.md:574
 msgid ""
 "**Introduce** `flwr` **CLI (preview)** "
 "([#2942](https://github.com/adap/flower/pull/2942), "
@@ -19017,13 +19101,13 @@ msgid ""
 "[#3142](https://github.com/adap/flower/pull/3142))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:554
+#: ../../source/ref-changelog.md:576
 msgid ""
 "A new `flwr` CLI command allows creating new Flower projects (`flwr new`)"
 " and then running them using the Simulation Engine (`flwr run`)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:556
+#: ../../source/ref-changelog.md:578
 msgid ""
 "**Introduce Flower Next Simulation Engine** "
 "([#3024](https://github.com/adap/flower/pull/3024), "
@@ -19038,20 +19122,20 @@ msgid ""
 "[#3008](https://github.com/adap/flower/pull/3008))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:558
+#: ../../source/ref-changelog.md:580
 msgid ""
 "The Flower Simulation Engine can now run Flower Next projects. For "
 "notebook environments, there's also a new `run_simulation` function that "
 "can run `ServerApp` and `ClientApp`."
 msgstr ""
 
-#: ../../source/ref-changelog.md:560
+#: ../../source/ref-changelog.md:582
 msgid ""
 "**Handle SuperNode connection errors** "
 "([#2969](https://github.com/adap/flower/pull/2969))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:562
+#: ../../source/ref-changelog.md:584
 msgid ""
 "A SuperNode will now try to reconnect indefinitely to the SuperLink in "
 "case of connection errors. The arguments `--max-retries` and `--max-wait-"
@@ -19062,7 +19146,7 @@ msgid ""
 "reconnect to the SuperLink."
 msgstr ""
 
-#: ../../source/ref-changelog.md:564
+#: ../../source/ref-changelog.md:586
 msgid ""
 "**General updates to Flower Baselines** "
 "([#2904](https://github.com/adap/flower/pull/2904), "
@@ -19071,13 +19155,13 @@ msgid ""
 "[#2968](https://github.com/adap/flower/pull/2968))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:566
+#: ../../source/ref-changelog.md:588
 msgid ""
 "There's a new [FedStar](https://flower.ai/docs/baselines/fedstar.html) "
 "baseline. Several other baselined have been updated as well."
 msgstr ""
 
-#: ../../source/ref-changelog.md:568
+#: ../../source/ref-changelog.md:590
 msgid ""
 "**Improve documentation and translations** "
 "([#3050](https://github.com/adap/flower/pull/3050), "
@@ -19098,14 +19182,14 @@ msgid ""
 "[#2989](https://github.com/adap/flower/pull/2989))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:570
+#: ../../source/ref-changelog.md:592
 msgid ""
 "As usual, we merged many smaller and larger improvements to the "
 "documentation. A special thank you goes to [Sebastian van der "
 "Voort](https://github.com/svdvoort) for landing a big documentation PR!"
 msgstr ""
 
-#: ../../source/ref-changelog.md:572
+#: ../../source/ref-changelog.md:594
 msgid ""
 "**General updates to Flower Examples** "
 "([3134](https://github.com/adap/flower/pull/3134), "
@@ -19121,7 +19205,7 @@ msgid ""
 "[#3117](https://github.com/adap/flower/pull/3117))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:574
+#: ../../source/ref-changelog.md:596
 msgid ""
 "Two new examples show federated training of a Vision Transformer (ViT) "
 "and federated learning in a medical context using the popular MONAI "
@@ -19130,7 +19214,7 @@ msgid ""
 "received considerable updates as well."
 msgstr ""
 
-#: ../../source/ref-changelog.md:576
+#: ../../source/ref-changelog.md:598
 msgid ""
 "**General improvements** "
 "([#3171](https://github.com/adap/flower/pull/3171), "
@@ -19208,11 +19292,11 @@ msgid ""
 "[#2954](https://github.com/adap/flower/pull/2954))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:582
+#: ../../source/ref-changelog.md:604
 msgid "v1.7.0 (2024-02-05)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:588
+#: ../../source/ref-changelog.md:610
 msgid ""
 "`Aasheesh Singh`, `Adam Narozniak`, `Aml Hassan Esmil`, `Charles "
 "Beauville`, `Daniel J. Beutel`, `Daniel Nata Nugraha`, `Edoardo "
@@ -19222,7 +19306,7 @@ msgid ""
 "Shaaban`, `Yan Gao`, `Yasar Abbas` <!---TOKEN_v1.7.0-->"
 msgstr ""
 
-#: ../../source/ref-changelog.md:592
+#: ../../source/ref-changelog.md:614
 msgid ""
 "**Introduce stateful clients (experimental)** "
 "([#2770](https://github.com/adap/flower/pull/2770), "
@@ -19232,7 +19316,7 @@ msgid ""
 "[#2769](https://github.com/adap/flower/pull/2769))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:594
+#: ../../source/ref-changelog.md:616
 msgid ""
 "Subclasses of `Client` and `NumPyClient` can now store local state that "
 "remains on the client. Let's start with the highlight first: this new "
@@ -19245,13 +19329,13 @@ msgid ""
 "unified way across simulation and deployment."
 msgstr ""
 
-#: ../../source/ref-changelog.md:596
+#: ../../source/ref-changelog.md:618
 msgid ""
 "**Improve performance** "
 "([#2293](https://github.com/adap/flower/pull/2293))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:598
+#: ../../source/ref-changelog.md:620
 msgid ""
 "Flower is faster than ever. All `FedAvg`-derived strategies now use in-"
 "place aggregation to reduce memory consumption. The Flower client "
@@ -19260,27 +19344,27 @@ msgid ""
 "training time is short."
 msgstr ""
 
-#: ../../source/ref-changelog.md:600
+#: ../../source/ref-changelog.md:622
 msgid ""
 "**Support Federated Learning with Apple MLX and Flower** "
 "([#2693](https://github.com/adap/flower/pull/2693))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:602
+#: ../../source/ref-changelog.md:624
 msgid ""
 "Flower has official support for federated learning using [Apple "
 "MLX](https://ml-explore.github.io/mlx) via the new `quickstart-mlx` code "
 "example."
 msgstr ""
 
-#: ../../source/ref-changelog.md:604
+#: ../../source/ref-changelog.md:626
 msgid ""
 "**Introduce new XGBoost cyclic strategy** "
 "([#2666](https://github.com/adap/flower/pull/2666), "
 "[#2668](https://github.com/adap/flower/pull/2668))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:606
+#: ../../source/ref-changelog.md:628
 msgid ""
 "A new strategy called `FedXgbCyclic` supports a client-by-client style of"
 " training (often called cyclic). The `xgboost-comprehensive` code example"
@@ -19289,31 +19373,31 @@ msgid ""
 "offers best-in-class XGBoost support."
 msgstr ""
 
-#: ../../source/ref-changelog.md:608
+#: ../../source/ref-changelog.md:630
 msgid ""
 "**Support Python 3.11** "
 "([#2394](https://github.com/adap/flower/pull/2394))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:610
+#: ../../source/ref-changelog.md:632
 msgid ""
 "Framework tests now run on Python 3.8, 3.9, 3.10, and 3.11. This will "
 "ensure better support for users using more recent Python versions."
 msgstr ""
 
-#: ../../source/ref-changelog.md:612
+#: ../../source/ref-changelog.md:634
 msgid ""
 "**Update gRPC and ProtoBuf dependencies** "
 "([#2814](https://github.com/adap/flower/pull/2814))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:614
+#: ../../source/ref-changelog.md:636
 msgid ""
 "The `grpcio` and `protobuf` dependencies were updated to their latest "
 "versions for improved security and performance."
 msgstr ""
 
-#: ../../source/ref-changelog.md:616
+#: ../../source/ref-changelog.md:638
 msgid ""
 "**Introduce Docker image for Flower server** "
 "([#2700](https://github.com/adap/flower/pull/2700), "
@@ -19327,7 +19411,7 @@ msgid ""
 "[#2701](https://github.com/adap/flower/pull/2701))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:618
+#: ../../source/ref-changelog.md:640
 msgid ""
 "The Flower server can now be run using an official Docker image. A new "
 "how-to guide explains [how to run Flower using "
@@ -19335,25 +19419,25 @@ msgid ""
 "docker.html). An official Flower client Docker image will follow."
 msgstr ""
 
-#: ../../source/ref-changelog.md:620
+#: ../../source/ref-changelog.md:642
 msgid ""
 "**Introduce** `flower-via-docker-compose` **example** "
 "([#2626](https://github.com/adap/flower/pull/2626))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:622
+#: ../../source/ref-changelog.md:644
 msgid ""
 "**Introduce** `quickstart-sklearn-tabular` **example** "
 "([#2719](https://github.com/adap/flower/pull/2719))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:624
+#: ../../source/ref-changelog.md:646
 msgid ""
 "**Introduce** `custom-metrics` **example** "
 "([#1958](https://github.com/adap/flower/pull/1958))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:626
+#: ../../source/ref-changelog.md:648
 msgid ""
 "**Update code examples to use Flower Datasets** "
 "([#2450](https://github.com/adap/flower/pull/2450), "
@@ -19362,13 +19446,13 @@ msgid ""
 "[#2712](https://github.com/adap/flower/pull/2712))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:628
+#: ../../source/ref-changelog.md:650
 msgid ""
 "Several code examples were updated to use [Flower "
 "Datasets](https://flower.ai/docs/datasets/)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:630
+#: ../../source/ref-changelog.md:652
 msgid ""
 "**General updates to Flower Examples** "
 "([#2381](https://github.com/adap/flower/pull/2381), "
@@ -19383,41 +19467,41 @@ msgid ""
 "[#2655](https://github.com/adap/flower/pull/2655))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:632
+#: ../../source/ref-changelog.md:654
 msgid "Many Flower code examples received substantial updates."
 msgstr ""
 
-#: ../../source/ref-changelog.md:634 ../../source/ref-changelog.md:727
+#: ../../source/ref-changelog.md:656 ../../source/ref-changelog.md:749
 msgid "**Update Flower Baselines**"
 msgstr ""
 
-#: ../../source/ref-changelog.md:636
+#: ../../source/ref-changelog.md:658
 msgid ""
 "HFedXGBoost ([#2226](https://github.com/adap/flower/pull/2226), "
 "[#2771](https://github.com/adap/flower/pull/2771))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:637
+#: ../../source/ref-changelog.md:659
 msgid "FedVSSL ([#2412](https://github.com/adap/flower/pull/2412))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:638
+#: ../../source/ref-changelog.md:660
 msgid "FedNova ([#2179](https://github.com/adap/flower/pull/2179))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:639
+#: ../../source/ref-changelog.md:661
 msgid "HeteroFL ([#2439](https://github.com/adap/flower/pull/2439))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:640
+#: ../../source/ref-changelog.md:662
 msgid "FedAvgM ([#2246](https://github.com/adap/flower/pull/2246))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:641
+#: ../../source/ref-changelog.md:663
 msgid "FedPara ([#2722](https://github.com/adap/flower/pull/2722))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:643
+#: ../../source/ref-changelog.md:665
 msgid ""
 "**Improve documentation** "
 "([#2674](https://github.com/adap/flower/pull/2674), "
@@ -19428,7 +19512,7 @@ msgid ""
 "[#2900](https://github.com/adap/flower/pull/2900))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:645
+#: ../../source/ref-changelog.md:667
 msgid ""
 "**Improved testing and development infrastructure** "
 "([#2797](https://github.com/adap/flower/pull/2797), "
@@ -19462,13 +19546,13 @@ msgid ""
 "[#2398](https://github.com/adap/flower/pull/2398))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:647
+#: ../../source/ref-changelog.md:669
 msgid ""
 "The Flower testing and development infrastructure has received "
 "substantial updates. This makes Flower 1.7 the most tested release ever."
 msgstr ""
 
-#: ../../source/ref-changelog.md:649
+#: ../../source/ref-changelog.md:671
 msgid ""
 "**Update dependencies** "
 "([#2753](https://github.com/adap/flower/pull/2753), "
@@ -19492,7 +19576,7 @@ msgid ""
 "[#2789](https://github.com/adap/flower/pull/2789))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:651
+#: ../../source/ref-changelog.md:673
 msgid ""
 "**General improvements** "
 "([#2803](https://github.com/adap/flower/pull/2803), "
@@ -19533,14 +19617,14 @@ msgid ""
 "[#2759](https://github.com/adap/flower/pull/2759))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:655
+#: ../../source/ref-changelog.md:677
 msgid ""
 "**Deprecate** `start_numpy_client` "
 "([#2563](https://github.com/adap/flower/pull/2563), "
 "[#2718](https://github.com/adap/flower/pull/2718))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:657
+#: ../../source/ref-changelog.md:679
 msgid ""
 "Until now, clients of type `NumPyClient` needed to be started via "
 "`start_numpy_client`. In our efforts to consolidate framework APIs, we "
@@ -19551,63 +19635,63 @@ msgid ""
 "updated accordingly."
 msgstr ""
 
-#: ../../source/ref-changelog.md:659
+#: ../../source/ref-changelog.md:681
 msgid ""
 "**Deprecate legacy DP wrappers** "
 "([#2749](https://github.com/adap/flower/pull/2749))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:661
+#: ../../source/ref-changelog.md:683
 msgid ""
 "Legacy DP wrapper classes are deprecated, but still functional. This is "
 "in preparation for an all-new pluggable version of differential privacy "
 "support in Flower."
 msgstr ""
 
-#: ../../source/ref-changelog.md:663
+#: ../../source/ref-changelog.md:685
 msgid ""
 "**Make optional arg** `--callable` **in** `flower-client` **a required "
 "positional arg** ([#2673](https://github.com/adap/flower/pull/2673))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:665
+#: ../../source/ref-changelog.md:687
 msgid ""
 "**Rename** `certificates` **to** `root_certificates` **in** `Driver` "
 "([#2890](https://github.com/adap/flower/pull/2890))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:667
+#: ../../source/ref-changelog.md:689
 msgid ""
 "**Drop experimental** `Task` **fields** "
 "([#2866](https://github.com/adap/flower/pull/2866), "
 "[#2865](https://github.com/adap/flower/pull/2865))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:669
+#: ../../source/ref-changelog.md:691
 msgid ""
 "Experimental fields `sa`, `legacy_server_message` and "
 "`legacy_client_message` were removed from `Task` message. The removed "
 "fields are superseded by the new `RecordSet` abstraction."
 msgstr ""
 
-#: ../../source/ref-changelog.md:671
+#: ../../source/ref-changelog.md:693
 msgid ""
 "**Retire MXNet examples** "
 "([#2724](https://github.com/adap/flower/pull/2724))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:673
+#: ../../source/ref-changelog.md:695
 msgid ""
 "The development of the MXNet fremework has ended and the project is now "
 "[archived on GitHub](https://github.com/apache/mxnet). Existing MXNet "
 "examples won't receive updates."
 msgstr ""
 
-#: ../../source/ref-changelog.md:675
+#: ../../source/ref-changelog.md:697
 msgid "v1.6.0 (2023-11-28)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:681
+#: ../../source/ref-changelog.md:703
 msgid ""
 "`Aashish Kolluri`, `Adam Narozniak`, `Alessio Mora`, `Barathwaja S`, "
 "`Charles Beauville`, `Daniel J. Beutel`, `Daniel Nata Nugraha`, `Gabriel "
@@ -19617,13 +19701,13 @@ msgid ""
 "`cnxdeveloper`, `k3nfalt` <!---TOKEN_v1.6.0-->"
 msgstr ""
 
-#: ../../source/ref-changelog.md:685
+#: ../../source/ref-changelog.md:707
 msgid ""
 "**Add experimental support for Python 3.12** "
 "([#2565](https://github.com/adap/flower/pull/2565))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:687
+#: ../../source/ref-changelog.md:709
 msgid ""
 "**Add new XGBoost examples** "
 "([#2612](https://github.com/adap/flower/pull/2612), "
@@ -19634,19 +19718,19 @@ msgid ""
 "[#2567](https://github.com/adap/flower/pull/2567))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:689
+#: ../../source/ref-changelog.md:711
 msgid ""
 "We have added a new `xgboost-quickstart` example alongside a new "
 "`xgboost-comprehensive` example that goes more in-depth."
 msgstr ""
 
-#: ../../source/ref-changelog.md:691
+#: ../../source/ref-changelog.md:713
 msgid ""
 "**Add Vertical FL example** "
 "([#2598](https://github.com/adap/flower/pull/2598))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:693
+#: ../../source/ref-changelog.md:715
 msgid ""
 "We had many questions about Vertical Federated Learning using Flower, so "
 "we decided to add an simple example for it on the [Titanic "
@@ -19654,29 +19738,29 @@ msgid ""
 "tutorial (in the README)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:695
+#: ../../source/ref-changelog.md:717
 msgid ""
 "**Support custom** `ClientManager` **in** `start_driver()` "
 "([#2292](https://github.com/adap/flower/pull/2292))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:697
+#: ../../source/ref-changelog.md:719
 msgid ""
 "**Update REST API to support create and delete nodes** "
 "([#2283](https://github.com/adap/flower/pull/2283))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:699
+#: ../../source/ref-changelog.md:721
 msgid ""
 "**Update the Android SDK** "
 "([#2187](https://github.com/adap/flower/pull/2187))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:701
+#: ../../source/ref-changelog.md:723
 msgid "Add gRPC request-response capability to the Android SDK."
 msgstr ""
 
-#: ../../source/ref-changelog.md:703
+#: ../../source/ref-changelog.md:725
 msgid ""
 "**Update the C++ SDK** "
 "([#2537](https://github.com/adap/flower/pull/2537), "
@@ -19685,18 +19769,18 @@ msgid ""
 "[#2522](https://github.com/adap/flower/pull/2522))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:705
+#: ../../source/ref-changelog.md:727
 msgid "Add gRPC request-response capability to the C++ SDK."
 msgstr ""
 
-#: ../../source/ref-changelog.md:707
+#: ../../source/ref-changelog.md:729
 msgid ""
 "**Make HTTPS the new default** "
 "([#2591](https://github.com/adap/flower/pull/2591), "
 "[#2636](https://github.com/adap/flower/pull/2636))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:709
+#: ../../source/ref-changelog.md:731
 msgid ""
 "Flower is moving to HTTPS by default. The new `flower-server` requires "
 "passing `--certificates`, but users can enable `--insecure` to use HTTP "
@@ -19706,21 +19790,21 @@ msgid ""
 "enable insecure HTTP connections."
 msgstr ""
 
-#: ../../source/ref-changelog.md:711
+#: ../../source/ref-changelog.md:733
 msgid ""
 "For backward compatibility, `start_client()` and `start_numpy_client()` "
 "will still start in insecure mode by default. In a future release, "
 "insecure connections will require user opt-in by passing `insecure=True`."
 msgstr ""
 
-#: ../../source/ref-changelog.md:713
+#: ../../source/ref-changelog.md:735
 msgid ""
 "**Unify client API** ([#2303](https://github.com/adap/flower/pull/2303), "
 "[#2390](https://github.com/adap/flower/pull/2390), "
 "[#2493](https://github.com/adap/flower/pull/2493))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:715
+#: ../../source/ref-changelog.md:737
 msgid ""
 "Using the `client_fn`, Flower clients can interchangeably run as "
 "standalone processes (i.e. via `start_client`) or in simulation (i.e. via"
@@ -19729,92 +19813,92 @@ msgid ""
 "convert a `NumPyClient` to a `Client`."
 msgstr ""
 
-#: ../../source/ref-changelog.md:717
+#: ../../source/ref-changelog.md:739
 msgid ""
 "**Add new** `Bulyan` **strategy** "
 "([#1817](https://github.com/adap/flower/pull/1817), "
 "[#1891](https://github.com/adap/flower/pull/1891))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:719
+#: ../../source/ref-changelog.md:741
 msgid ""
 "The new `Bulyan` strategy implements Bulyan by [El Mhamdi et al., "
 "2018](https://arxiv.org/abs/1802.07927)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:721
+#: ../../source/ref-changelog.md:743
 msgid ""
 "**Add new** `XGB Bagging` **strategy** "
 "([#2611](https://github.com/adap/flower/pull/2611))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:723 ../../source/ref-changelog.md:725
+#: ../../source/ref-changelog.md:745 ../../source/ref-changelog.md:747
 msgid ""
 "**Introduce `WorkloadState`** "
 "([#2564](https://github.com/adap/flower/pull/2564), "
 "[#2632](https://github.com/adap/flower/pull/2632))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:729
+#: ../../source/ref-changelog.md:751
 msgid ""
 "FedProx ([#2210](https://github.com/adap/flower/pull/2210), "
 "[#2286](https://github.com/adap/flower/pull/2286), "
 "[#2509](https://github.com/adap/flower/pull/2509))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:731
+#: ../../source/ref-changelog.md:753
 msgid ""
 "Baselines Docs ([#2290](https://github.com/adap/flower/pull/2290), "
 "[#2400](https://github.com/adap/flower/pull/2400))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:733
+#: ../../source/ref-changelog.md:755
 msgid ""
 "FedMLB ([#2340](https://github.com/adap/flower/pull/2340), "
 "[#2507](https://github.com/adap/flower/pull/2507))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:735
+#: ../../source/ref-changelog.md:757
 msgid ""
 "TAMUNA ([#2254](https://github.com/adap/flower/pull/2254), "
 "[#2508](https://github.com/adap/flower/pull/2508))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:737
+#: ../../source/ref-changelog.md:759
 msgid "FedMeta [#2438](https://github.com/adap/flower/pull/2438)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:739
+#: ../../source/ref-changelog.md:761
 msgid "FjORD [#2431](https://github.com/adap/flower/pull/2431)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:741
+#: ../../source/ref-changelog.md:763
 msgid "MOON [#2421](https://github.com/adap/flower/pull/2421)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:743
+#: ../../source/ref-changelog.md:765
 msgid "DepthFL [#2295](https://github.com/adap/flower/pull/2295)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:745
+#: ../../source/ref-changelog.md:767
 msgid "FedPer [#2266](https://github.com/adap/flower/pull/2266)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:747
+#: ../../source/ref-changelog.md:769
 msgid "FedWav2vec [#2551](https://github.com/adap/flower/pull/2551)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:749
+#: ../../source/ref-changelog.md:771
 msgid "niid-Bench [#2428](https://github.com/adap/flower/pull/2428)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:751
+#: ../../source/ref-changelog.md:773
 msgid ""
 "FedBN ([#2608](https://github.com/adap/flower/pull/2608), "
 "[#2615](https://github.com/adap/flower/pull/2615))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:753
+#: ../../source/ref-changelog.md:775
 msgid ""
 "**General updates to Flower Examples** "
 "([#2384](https://github.com/adap/flower/pull/2384), "
@@ -19824,7 +19908,7 @@ msgid ""
 "[#2545](https://github.com/adap/flower/pull/2545))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:755
+#: ../../source/ref-changelog.md:777
 msgid ""
 "**General updates to Flower Baselines** "
 "([#2301](https://github.com/adap/flower/pull/2301), "
@@ -19842,7 +19926,7 @@ msgid ""
 "[#2470](https://github.com/adap/flower/pull/2470))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:757
+#: ../../source/ref-changelog.md:779
 msgid ""
 "**General updates to the simulation engine** "
 "([#2331](https://github.com/adap/flower/pull/2331), "
@@ -19851,7 +19935,7 @@ msgid ""
 "[#2294](https://github.com/adap/flower/pull/2294))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:759
+#: ../../source/ref-changelog.md:781
 msgid ""
 "**General updates to Flower SDKs** "
 "([#2288](https://github.com/adap/flower/pull/2288), "
@@ -19863,7 +19947,7 @@ msgid ""
 "[#2623](https://github.com/adap/flower/pull/2623))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:761
+#: ../../source/ref-changelog.md:783
 msgid ""
 "**General improvements** "
 "([#2309](https://github.com/adap/flower/pull/2309), "
@@ -19895,13 +19979,13 @@ msgid ""
 "[#2596](https://github.com/adap/flower/pull/2596))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:763 ../../source/ref-changelog.md:853
-#: ../../source/ref-changelog.md:917 ../../source/ref-changelog.md:971
-#: ../../source/ref-changelog.md:1038
+#: ../../source/ref-changelog.md:785 ../../source/ref-changelog.md:875
+#: ../../source/ref-changelog.md:939 ../../source/ref-changelog.md:993
+#: ../../source/ref-changelog.md:1060
 msgid "Flower received many improvements under the hood, too many to list here."
 msgstr ""
 
-#: ../../source/ref-changelog.md:767
+#: ../../source/ref-changelog.md:789
 msgid ""
 "**Remove support for Python 3.7** "
 "([#2280](https://github.com/adap/flower/pull/2280), "
@@ -19912,30 +19996,30 @@ msgid ""
 "[#2356](https://github.com/adap/flower/pull/2356))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:769
+#: ../../source/ref-changelog.md:791
 msgid ""
 "Python 3.7 support was deprecated in Flower 1.5, and this release removes"
 " support. Flower now requires Python 3.8."
 msgstr ""
 
-#: ../../source/ref-changelog.md:771
+#: ../../source/ref-changelog.md:793
 msgid ""
 "**Remove experimental argument** `rest` **from** `start_client` "
 "([#2324](https://github.com/adap/flower/pull/2324))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:773
+#: ../../source/ref-changelog.md:795
 msgid ""
 "The (still experimental) argument `rest` was removed from `start_client` "
 "and `start_numpy_client`. Use `transport=\"rest\"` to opt into the "
 "experimental REST API instead."
 msgstr ""
 
-#: ../../source/ref-changelog.md:775
+#: ../../source/ref-changelog.md:797
 msgid "v1.5.0 (2023-08-31)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:781
+#: ../../source/ref-changelog.md:803
 msgid ""
 "`Adam Narozniak`, `Anass Anhari`, `Charles Beauville`, `Dana-Farber`, "
 "`Daniel J. Beutel`, `Daniel Nata Nugraha`, `Edoardo Gabrielli`, `Gustavo "
@@ -19944,7 +20028,7 @@ msgid ""
 "TOKEN_v1.5.0-->"
 msgstr ""
 
-#: ../../source/ref-changelog.md:785
+#: ../../source/ref-changelog.md:807
 msgid ""
 "**Introduce new simulation engine** "
 "([#1969](https://github.com/adap/flower/pull/1969), "
@@ -19952,7 +20036,7 @@ msgid ""
 "[#2248](https://github.com/adap/flower/pull/2248))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:787
+#: ../../source/ref-changelog.md:809
 msgid ""
 "The new simulation engine has been rewritten from the ground up, yet it "
 "remains fully backwards compatible. It offers much improved stability and"
@@ -19961,7 +20045,7 @@ msgid ""
 "only, CPU+GPU, multi-GPU, or multi-node multi-GPU environments."
 msgstr ""
 
-#: ../../source/ref-changelog.md:789
+#: ../../source/ref-changelog.md:811
 msgid ""
 "Comprehensive documentation includes a new [how-to run "
 "simulations](https://flower.ai/docs/framework/how-to-run-"
@@ -19972,7 +20056,7 @@ msgid ""
 "series](https://www.youtube.com/watch?v=cRebUIGB5RU&list=PLNG4feLHqCWlnj8a_E1A_n5zr2-8pafTB)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:791
+#: ../../source/ref-changelog.md:813
 msgid ""
 "**Restructure Flower Docs** "
 "([#1824](https://github.com/adap/flower/pull/1824), "
@@ -20004,7 +20088,7 @@ msgid ""
 "[#2227](https://github.com/adap/flower/pull/2227))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:793
+#: ../../source/ref-changelog.md:815
 msgid ""
 "Much effort went into a completely restructured Flower docs experience. "
 "The documentation on [flower.ai/docs](https://flower.ai/docs) is now "
@@ -20012,34 +20096,34 @@ msgid ""
 "Flower iOS SDK, and code example projects."
 msgstr ""
 
-#: ../../source/ref-changelog.md:795
+#: ../../source/ref-changelog.md:817
 msgid ""
 "**Introduce Flower Swift SDK** "
 "([#1858](https://github.com/adap/flower/pull/1858), "
 "[#1897](https://github.com/adap/flower/pull/1897))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:797
+#: ../../source/ref-changelog.md:819
 msgid ""
 "This is the first preview release of the Flower Swift SDK. Flower support"
 " on iOS is improving, and alongside the Swift SDK and code example, there"
 " is now also an iOS quickstart tutorial."
 msgstr ""
 
-#: ../../source/ref-changelog.md:799
+#: ../../source/ref-changelog.md:821
 msgid ""
 "**Introduce Flower Android SDK** "
 "([#2131](https://github.com/adap/flower/pull/2131))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:801
+#: ../../source/ref-changelog.md:823
 msgid ""
 "This is the first preview release of the Flower Kotlin SDK. Flower "
 "support on Android is improving, and alongside the Kotlin SDK and code "
 "example, there is now also an Android quickstart tutorial."
 msgstr ""
 
-#: ../../source/ref-changelog.md:803
+#: ../../source/ref-changelog.md:825
 msgid ""
 "**Introduce new end-to-end testing infrastructure** "
 "([#1842](https://github.com/adap/flower/pull/1842), "
@@ -20061,42 +20145,42 @@ msgid ""
 "[#2165](https://github.com/adap/flower/pull/2165))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:805
+#: ../../source/ref-changelog.md:827
 msgid ""
 "A new testing infrastructure ensures that new changes stay compatible "
 "with existing framework integrations or strategies."
 msgstr ""
 
-#: ../../source/ref-changelog.md:807
+#: ../../source/ref-changelog.md:829
 msgid "**Deprecate Python 3.7**"
 msgstr ""
 
-#: ../../source/ref-changelog.md:809
+#: ../../source/ref-changelog.md:831
 msgid ""
 "Since Python 3.7 reached its end of life (EOL) on 2023-06-27, support for"
 " Python 3.7 is now deprecated and will be removed in an upcoming release."
 msgstr ""
 
-#: ../../source/ref-changelog.md:811
+#: ../../source/ref-changelog.md:833
 msgid ""
 "**Add new** `FedTrimmedAvg` **strategy** "
 "([#1769](https://github.com/adap/flower/pull/1769), "
 "[#1853](https://github.com/adap/flower/pull/1853))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:813
+#: ../../source/ref-changelog.md:835
 msgid ""
 "The new `FedTrimmedAvg` strategy implements Trimmed Mean by [Dong Yin, "
 "2018](https://arxiv.org/abs/1803.01498)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:815
+#: ../../source/ref-changelog.md:837
 msgid ""
 "**Introduce start_driver** "
 "([#1697](https://github.com/adap/flower/pull/1697))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:817
+#: ../../source/ref-changelog.md:839
 msgid ""
 "In addition to `start_server` and using the raw Driver API, there is a "
 "new `start_driver` function that allows for running `start_server` "
@@ -20105,13 +20189,13 @@ msgid ""
 "`start_driver`."
 msgstr ""
 
-#: ../../source/ref-changelog.md:819
+#: ../../source/ref-changelog.md:841
 msgid ""
 "**Add parameter aggregation to** `mt-pytorch` **code example** "
 "([#1785](https://github.com/adap/flower/pull/1785))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:821
+#: ../../source/ref-changelog.md:843
 msgid ""
 "The `mt-pytorch` example shows how to aggregate parameters when writing a"
 " driver script. The included `driver.py` and `server.py` have been "
@@ -20119,53 +20203,53 @@ msgid ""
 "building server-side logic."
 msgstr ""
 
-#: ../../source/ref-changelog.md:823
+#: ../../source/ref-changelog.md:845
 msgid ""
 "**Migrate experimental REST API to Starlette** "
 "([2171](https://github.com/adap/flower/pull/2171))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:825
+#: ../../source/ref-changelog.md:847
 msgid ""
 "The (experimental) REST API used to be implemented in "
 "[FastAPI](https://fastapi.tiangolo.com/), but it has now been migrated to"
 " use [Starlette](https://www.starlette.io/) directly."
 msgstr ""
 
-#: ../../source/ref-changelog.md:827
+#: ../../source/ref-changelog.md:849
 msgid ""
 "Please note: The REST request-response API is still experimental and will"
 " likely change significantly over time."
 msgstr ""
 
-#: ../../source/ref-changelog.md:829
+#: ../../source/ref-changelog.md:851
 msgid ""
 "**Introduce experimental gRPC request-response API** "
 "([#1867](https://github.com/adap/flower/pull/1867), "
 "[#1901](https://github.com/adap/flower/pull/1901))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:831
+#: ../../source/ref-changelog.md:853
 msgid ""
 "In addition to the existing gRPC API (based on bidirectional streaming) "
 "and the experimental REST API, there is now a new gRPC API that uses a "
 "request-response model to communicate with client nodes."
 msgstr ""
 
-#: ../../source/ref-changelog.md:833
+#: ../../source/ref-changelog.md:855
 msgid ""
 "Please note: The gRPC request-response API is still experimental and will"
 " likely change significantly over time."
 msgstr ""
 
-#: ../../source/ref-changelog.md:835
+#: ../../source/ref-changelog.md:857
 msgid ""
 "**Replace the experimental** `start_client(rest=True)` **with the new** "
 "`start_client(transport=\"rest\")` "
 "([#1880](https://github.com/adap/flower/pull/1880))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:837
+#: ../../source/ref-changelog.md:859
 msgid ""
 "The (experimental) `start_client` argument `rest` was deprecated in "
 "favour of a new argument `transport`. `start_client(transport=\"rest\")` "
@@ -20174,30 +20258,30 @@ msgid ""
 "argument `rest` will be removed in a future release."
 msgstr ""
 
-#: ../../source/ref-changelog.md:839
+#: ../../source/ref-changelog.md:861
 msgid ""
 "**Add a new gRPC option** "
 "([#2197](https://github.com/adap/flower/pull/2197))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:841
+#: ../../source/ref-changelog.md:863
 msgid ""
 "We now start a gRPC server with the `grpc.keepalive_permit_without_calls`"
 " option set to 0 by default. This prevents the clients from sending "
 "keepalive pings when there is no outstanding stream."
 msgstr ""
 
-#: ../../source/ref-changelog.md:843
+#: ../../source/ref-changelog.md:865
 msgid ""
 "**Improve example notebooks** "
 "([#2005](https://github.com/adap/flower/pull/2005))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:845
+#: ../../source/ref-changelog.md:867
 msgid "There's a new 30min Federated Learning PyTorch tutorial!"
 msgstr ""
 
-#: ../../source/ref-changelog.md:847
+#: ../../source/ref-changelog.md:869
 msgid ""
 "**Example updates** ([#1772](https://github.com/adap/flower/pull/1772), "
 "[#1873](https://github.com/adap/flower/pull/1873), "
@@ -20212,7 +20296,7 @@ msgid ""
 "[#2183](https://github.com/adap/flower/pull/2183))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:849
+#: ../../source/ref-changelog.md:871
 msgid ""
 "Many examples have received significant updates, including simplified "
 "advanced-tensorflow and advanced-pytorch examples, improved macOS "
@@ -20221,7 +20305,7 @@ msgid ""
 "(in addition to `pyproject.toml`)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:851
+#: ../../source/ref-changelog.md:873
 msgid ""
 "**General improvements** "
 "([#1872](https://github.com/adap/flower/pull/1872), "
@@ -20232,11 +20316,11 @@ msgid ""
 "[#2171](https://github.com/adap/flower/pull/2171))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:859
+#: ../../source/ref-changelog.md:881
 msgid "v1.4.0 (2023-04-21)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:865
+#: ../../source/ref-changelog.md:887
 msgid ""
 "`Adam Narozniak`, `Alexander Viala Bellander`, `Charles Beauville`, "
 "`Chenyang Ma (Danny)`, `Daniel J. Beutel`, `Edoardo`, `Gautam Jajoo`, "
@@ -20246,7 +20330,7 @@ msgid ""
 "`Steve Laskaridis`, `Steven Hé (Sīchàng)`, `Taner Topal`"
 msgstr ""
 
-#: ../../source/ref-changelog.md:869
+#: ../../source/ref-changelog.md:891
 msgid ""
 "**Introduce support for XGBoost (**`FedXgbNnAvg` **strategy and "
 "example)** ([#1694](https://github.com/adap/flower/pull/1694), "
@@ -20257,7 +20341,7 @@ msgid ""
 "[#1795](https://github.com/adap/flower/pull/1795))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:871
+#: ../../source/ref-changelog.md:893
 msgid ""
 "XGBoost is a tree-based ensemble machine learning algorithm that uses "
 "gradient boosting to improve model accuracy. We added a new `FedXgbNnAvg`"
@@ -20268,14 +20352,14 @@ msgid ""
 "an XGBoost project."
 msgstr ""
 
-#: ../../source/ref-changelog.md:873
+#: ../../source/ref-changelog.md:895
 msgid ""
 "**Introduce iOS SDK (preview)** "
 "([#1621](https://github.com/adap/flower/pull/1621), "
 "[#1764](https://github.com/adap/flower/pull/1764))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:875
+#: ../../source/ref-changelog.md:897
 msgid ""
 "This is a major update for anyone wanting to implement Federated Learning"
 " on iOS mobile devices. We now have a swift iOS SDK present under "
@@ -20286,14 +20370,14 @@ msgid ""
 "been updated!"
 msgstr ""
 
-#: ../../source/ref-changelog.md:877
+#: ../../source/ref-changelog.md:899
 msgid ""
 "**Introduce new \"What is Federated Learning?\" tutorial** "
 "([#1657](https://github.com/adap/flower/pull/1657), "
 "[#1721](https://github.com/adap/flower/pull/1721))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:879
+#: ../../source/ref-changelog.md:901
 msgid ""
 "A new [entry-level tutorial](https://flower.ai/docs/framework/tutorial-"
 "what-is-federated-learning.html) in our documentation explains the basics"
@@ -20302,7 +20386,7 @@ msgid ""
 "interested in Federated Learning!"
 msgstr ""
 
-#: ../../source/ref-changelog.md:881
+#: ../../source/ref-changelog.md:903
 msgid ""
 "**Introduce new Flower Baseline: FedProx MNIST** "
 "([#1513](https://github.com/adap/flower/pull/1513), "
@@ -20311,7 +20395,7 @@ msgid ""
 "[#1679](https://github.com/adap/flower/pull/1679))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:883
+#: ../../source/ref-changelog.md:905
 msgid ""
 "This new baseline replicates the MNIST+CNN task from the paper [Federated"
 " Optimization in Heterogeneous Networks (Li et al., "
@@ -20319,13 +20403,13 @@ msgid ""
 " which aims at making convergence more robust in heterogeneous settings."
 msgstr ""
 
-#: ../../source/ref-changelog.md:885
+#: ../../source/ref-changelog.md:907
 msgid ""
 "**Introduce new Flower Baseline: FedAvg FEMNIST** "
 "([#1655](https://github.com/adap/flower/pull/1655))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:887
+#: ../../source/ref-changelog.md:909
 msgid ""
 "This new baseline replicates an experiment evaluating the performance of "
 "the FedAvg algorithm on the FEMNIST dataset from the paper [LEAF: A "
@@ -20333,7 +20417,7 @@ msgid ""
 "2018)](https://arxiv.org/abs/1812.01097)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:889
+#: ../../source/ref-changelog.md:911
 msgid ""
 "**Introduce (experimental) REST API** "
 "([#1594](https://github.com/adap/flower/pull/1594), "
@@ -20345,20 +20429,20 @@ msgid ""
 "[#1733](https://github.com/adap/flower/pull/1733))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:891
+#: ../../source/ref-changelog.md:913
 msgid ""
 "A new REST API has been introduced as an alternative to the gRPC-based "
 "communication stack. In this initial version, the REST API only supports "
 "anonymous clients."
 msgstr ""
 
-#: ../../source/ref-changelog.md:893
+#: ../../source/ref-changelog.md:915
 msgid ""
 "Please note: The REST API is still experimental and will likely change "
 "significantly over time."
 msgstr ""
 
-#: ../../source/ref-changelog.md:895
+#: ../../source/ref-changelog.md:917
 msgid ""
 "**Improve the (experimental) Driver API** "
 "([#1663](https://github.com/adap/flower/pull/1663), "
@@ -20372,7 +20456,7 @@ msgid ""
 "[#1794](https://github.com/adap/flower/pull/1794))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:897
+#: ../../source/ref-changelog.md:919
 msgid ""
 "The Driver API is still an experimental feature, but this release "
 "introduces some major upgrades. One of the main improvements is the "
@@ -20382,26 +20466,26 @@ msgid ""
 "improves the memory efficiency of a long-running Flower server."
 msgstr ""
 
-#: ../../source/ref-changelog.md:899
+#: ../../source/ref-changelog.md:921
 msgid ""
 "**Fix spilling issues related to Ray during simulations** "
 "([#1698](https://github.com/adap/flower/pull/1698))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:901
+#: ../../source/ref-changelog.md:923
 msgid ""
 "While running long simulations, `ray` was sometimes spilling huge amounts"
 " of data that would make the training unable to continue. This is now "
 "fixed! 🎉"
 msgstr ""
 
-#: ../../source/ref-changelog.md:903
+#: ../../source/ref-changelog.md:925
 msgid ""
 "**Add new example using** `TabNet` **and Flower** "
 "([#1725](https://github.com/adap/flower/pull/1725))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:905
+#: ../../source/ref-changelog.md:927
 msgid ""
 "TabNet is a powerful and flexible framework for training machine learning"
 " models on tabular data. We now have a federated example using Flower: "
@@ -20409,32 +20493,32 @@ msgid ""
 "/quickstart-tabnet)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:907
+#: ../../source/ref-changelog.md:929
 msgid ""
 "**Add new how-to guide for monitoring simulations** "
 "([#1649](https://github.com/adap/flower/pull/1649))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:909
+#: ../../source/ref-changelog.md:931
 msgid ""
 "We now have a documentation guide to help users monitor their performance"
 " during simulations."
 msgstr ""
 
-#: ../../source/ref-changelog.md:911
+#: ../../source/ref-changelog.md:933
 msgid ""
 "**Add training metrics to** `History` **object during simulations** "
 "([#1696](https://github.com/adap/flower/pull/1696))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:913
+#: ../../source/ref-changelog.md:935
 msgid ""
 "The `fit_metrics_aggregation_fn` can be used to aggregate training "
 "metrics, but previous releases did not save the results in the `History` "
 "object. This is now the case!"
 msgstr ""
 
-#: ../../source/ref-changelog.md:915
+#: ../../source/ref-changelog.md:937
 msgid ""
 "**General improvements** "
 "([#1659](https://github.com/adap/flower/pull/1659), "
@@ -20488,23 +20572,23 @@ msgid ""
 "[#1805](https://github.com/adap/flower/pull/1805))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:923
+#: ../../source/ref-changelog.md:945
 msgid "v1.3.0 (2023-02-06)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:929
+#: ../../source/ref-changelog.md:951
 msgid ""
 "`Adam Narozniak`, `Alexander Viala Bellander`, `Charles Beauville`, "
 "`Daniel J. Beutel`, `JDRanpariya`, `Lennart Behme`, `Taner Topal`"
 msgstr ""
 
-#: ../../source/ref-changelog.md:933
+#: ../../source/ref-changelog.md:955
 msgid ""
 "**Add support for** `workload_id` **and** `group_id` **in Driver API** "
 "([#1595](https://github.com/adap/flower/pull/1595))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:935
+#: ../../source/ref-changelog.md:957
 msgid ""
 "The (experimental) Driver API now supports a `workload_id` that can be "
 "used to identify which workload a task belongs to. It also supports a new"
@@ -20513,36 +20597,36 @@ msgid ""
 " to decide whether they want to handle a task or not."
 msgstr ""
 
-#: ../../source/ref-changelog.md:937
+#: ../../source/ref-changelog.md:959
 msgid ""
 "**Make Driver API and Fleet API address configurable** "
 "([#1637](https://github.com/adap/flower/pull/1637))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:939
+#: ../../source/ref-changelog.md:961
 msgid ""
 "The (experimental) long-running Flower server (Driver API and Fleet API) "
 "can now configure the server address of both Driver API (via `--driver-"
 "api-address`) and Fleet API (via `--fleet-api-address`) when starting:"
 msgstr ""
 
-#: ../../source/ref-changelog.md:941
+#: ../../source/ref-changelog.md:963
 msgid ""
 "`flower-server --driver-api-address \"0.0.0.0:8081\" --fleet-api-address "
 "\"0.0.0.0:8086\"`"
 msgstr ""
 
-#: ../../source/ref-changelog.md:943
+#: ../../source/ref-changelog.md:965
 msgid "Both IPv4 and IPv6 addresses are supported."
 msgstr ""
 
-#: ../../source/ref-changelog.md:945
+#: ../../source/ref-changelog.md:967
 msgid ""
 "**Add new example of Federated Learning using fastai and Flower** "
 "([#1598](https://github.com/adap/flower/pull/1598))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:947
+#: ../../source/ref-changelog.md:969
 msgid ""
 "A new code example (`quickstart-fastai`) demonstrates federated learning "
 "with [fastai](https://www.fast.ai/) and Flower. You can find it here: "
@@ -20550,14 +20634,14 @@ msgid ""
 "/quickstart-fastai)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:949
+#: ../../source/ref-changelog.md:971
 msgid ""
 "**Make Android example compatible with** `flwr >= 1.0.0` **and the latest"
 " versions of Android** "
 "([#1603](https://github.com/adap/flower/pull/1603))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:951
+#: ../../source/ref-changelog.md:973
 msgid ""
 "The Android code example has received a substantial update: the project "
 "is compatible with Flower 1.0 (and later), the UI received a full "
@@ -20565,13 +20649,13 @@ msgid ""
 "tooling."
 msgstr ""
 
-#: ../../source/ref-changelog.md:953
+#: ../../source/ref-changelog.md:975
 msgid ""
 "**Add new `FedProx` strategy** "
 "([#1619](https://github.com/adap/flower/pull/1619))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:955
+#: ../../source/ref-changelog.md:977
 msgid ""
 "This "
 "[strategy](https://github.com/adap/flower/blob/main/src/py/flwr/server/strategy/fedprox.py)"
@@ -20583,25 +20667,25 @@ msgid ""
 "respect to the global models."
 msgstr ""
 
-#: ../../source/ref-changelog.md:957
+#: ../../source/ref-changelog.md:979
 msgid ""
 "**Add new metrics to telemetry events** "
 "([#1640](https://github.com/adap/flower/pull/1640))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:959
+#: ../../source/ref-changelog.md:981
 msgid ""
 "An updated event structure allows, for example, the clustering of events "
 "within the same workload."
 msgstr ""
 
-#: ../../source/ref-changelog.md:961
+#: ../../source/ref-changelog.md:983
 msgid ""
 "**Add new custom strategy tutorial section** "
 "[#1623](https://github.com/adap/flower/pull/1623)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:963
+#: ../../source/ref-changelog.md:985
 msgid ""
 "The Flower tutorial now has a new section that covers implementing a "
 "custom strategy from scratch: [Open in "
@@ -20609,13 +20693,13 @@ msgid ""
 "/tutorial-build-a-strategy-from-scratch-pytorch.ipynb)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:965
+#: ../../source/ref-changelog.md:987
 msgid ""
 "**Add new custom serialization tutorial section** "
 "([#1622](https://github.com/adap/flower/pull/1622))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:967
+#: ../../source/ref-changelog.md:989
 msgid ""
 "The Flower tutorial now has a new section that covers custom "
 "serialization: [Open in "
@@ -20623,7 +20707,7 @@ msgid ""
 "/tutorial-customize-the-client-pytorch.ipynb)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:969
+#: ../../source/ref-changelog.md:991
 msgid ""
 "**General improvements** "
 "([#1638](https://github.com/adap/flower/pull/1638), "
@@ -20661,7 +20745,7 @@ msgid ""
 "[#1586](https://github.com/adap/flower/pull/1586))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:973
+#: ../../source/ref-changelog.md:995
 msgid ""
 "**Updated documentation** "
 "([#1629](https://github.com/adap/flower/pull/1629), "
@@ -20673,31 +20757,31 @@ msgid ""
 "[#1614](https://github.com/adap/flower/pull/1614))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:975 ../../source/ref-changelog.md:1042
+#: ../../source/ref-changelog.md:997 ../../source/ref-changelog.md:1064
 msgid ""
 "As usual, the documentation has improved quite a bit. It is another step "
 "in our effort to make the Flower documentation the best documentation of "
 "any project. Stay tuned and as always, feel free to provide feedback!"
 msgstr ""
 
-#: ../../source/ref-changelog.md:981
+#: ../../source/ref-changelog.md:1003
 msgid "v1.2.0 (2023-01-13)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:987
+#: ../../source/ref-changelog.md:1009
 msgid ""
 "`Adam Narozniak`, `Charles Beauville`, `Daniel J. Beutel`, `Edoardo`, `L."
 " Jiang`, `Ragy`, `Taner Topal`, `dannymcy`"
 msgstr ""
 
-#: ../../source/ref-changelog.md:991
+#: ../../source/ref-changelog.md:1013
 msgid ""
 "**Introduce new Flower Baseline: FedAvg MNIST** "
 "([#1497](https://github.com/adap/flower/pull/1497), "
 "[#1552](https://github.com/adap/flower/pull/1552))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:993
+#: ../../source/ref-changelog.md:1015
 msgid ""
 "Over the coming weeks, we will be releasing a number of new reference "
 "implementations useful especially to FL newcomers. They will typically "
@@ -20708,13 +20792,13 @@ msgid ""
 "pack-fedavg-mnist-cnn/)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:995
+#: ../../source/ref-changelog.md:1017
 msgid ""
 "**Improve GPU support in simulations** "
 "([#1555](https://github.com/adap/flower/pull/1555))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:997
+#: ../../source/ref-changelog.md:1019
 msgid ""
 "The Ray-based Virtual Client Engine (`start_simulation`) has been updated"
 " to improve GPU support. The update includes some of the hard-earned "
@@ -20722,45 +20806,45 @@ msgid ""
 "defaults make running GPU-based simulations substantially more robust."
 msgstr ""
 
-#: ../../source/ref-changelog.md:999
+#: ../../source/ref-changelog.md:1021
 msgid ""
 "**Improve GPU support in Jupyter Notebook tutorials** "
 "([#1527](https://github.com/adap/flower/pull/1527), "
 "[#1558](https://github.com/adap/flower/pull/1558))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1001
+#: ../../source/ref-changelog.md:1023
 msgid ""
 "Some users reported that Jupyter Notebooks have not always been easy to "
 "use on GPU instances. We listened and made improvements to all of our "
 "Jupyter notebooks! Check out the updated notebooks here:"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1003
+#: ../../source/ref-changelog.md:1025
 msgid ""
 "[An Introduction to Federated Learning](https://flower.ai/docs/framework"
 "/tutorial-get-started-with-flower-pytorch.html)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1004
+#: ../../source/ref-changelog.md:1026
 msgid ""
 "[Strategies in Federated Learning](https://flower.ai/docs/framework"
 "/tutorial-use-a-federated-learning-strategy-pytorch.html)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1005
+#: ../../source/ref-changelog.md:1027
 msgid ""
 "[Building a Strategy](https://flower.ai/docs/framework/tutorial-build-a"
 "-strategy-from-scratch-pytorch.html)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1006
+#: ../../source/ref-changelog.md:1028
 msgid ""
 "[Client and NumPyClient](https://flower.ai/docs/framework/tutorial-"
 "customize-the-client-pytorch.html)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1008
+#: ../../source/ref-changelog.md:1030
 msgid ""
 "**Introduce optional telemetry** "
 "([#1533](https://github.com/adap/flower/pull/1533), "
@@ -20768,7 +20852,7 @@ msgid ""
 "[#1584](https://github.com/adap/flower/pull/1584))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1010
+#: ../../source/ref-changelog.md:1032
 msgid ""
 "After a [request for "
 "feedback](https://github.com/adap/flower/issues/1534) from the community,"
@@ -20778,7 +20862,7 @@ msgid ""
 "used and what challenges users might face."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1012
+#: ../../source/ref-changelog.md:1034
 msgid ""
 "**Flower is a friendly framework for collaborative AI and data science.**"
 " Staying true to this statement, Flower makes it easy to disable "
@@ -20786,7 +20870,7 @@ msgid ""
 "[Read more.](https://flower.ai/docs/telemetry.html)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1014
+#: ../../source/ref-changelog.md:1036
 msgid ""
 "**Introduce (experimental) Driver API** "
 "([#1520](https://github.com/adap/flower/pull/1520), "
@@ -20798,7 +20882,7 @@ msgid ""
 "[#1567](https://github.com/adap/flower/pull/1567))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1016
+#: ../../source/ref-changelog.md:1038
 msgid ""
 "Flower now has a new (experimental) Driver API which will enable fully "
 "programmable, async, and multi-tenant Federated Learning and Federated "
@@ -20807,7 +20891,7 @@ msgid ""
 "and you can start building those things now, too."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1018
+#: ../../source/ref-changelog.md:1040
 msgid ""
 "The Driver API also enables a new execution mode in which the server runs"
 " indefinitely. Multiple individual workloads can run concurrently and "
@@ -20815,26 +20899,26 @@ msgid ""
 "especially useful for users who want to deploy Flower in production."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1020
+#: ../../source/ref-changelog.md:1042
 msgid ""
 "To learn more, check out the `mt-pytorch` code example. We look forward "
 "to you feedback!"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1022
+#: ../../source/ref-changelog.md:1044
 msgid ""
 "Please note: *The Driver API is still experimental and will likely change"
 " significantly over time.*"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1024
+#: ../../source/ref-changelog.md:1046
 msgid ""
 "**Add new Federated Analytics with Pandas example** "
 "([#1469](https://github.com/adap/flower/pull/1469), "
 "[#1535](https://github.com/adap/flower/pull/1535))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1026
+#: ../../source/ref-changelog.md:1048
 msgid ""
 "A new code example (`quickstart-pandas`) demonstrates federated analytics"
 " with Pandas and Flower. You can find it here: [quickstart-"
@@ -20842,32 +20926,32 @@ msgid ""
 "pandas)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1028
+#: ../../source/ref-changelog.md:1050
 msgid ""
 "**Add new strategies: Krum and MultiKrum** "
 "([#1481](https://github.com/adap/flower/pull/1481))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1030
+#: ../../source/ref-changelog.md:1052
 msgid ""
 "Edoardo, a computer science student at the Sapienza University of Rome, "
 "contributed a new `Krum` strategy that enables users to easily use Krum "
 "and MultiKrum in their workloads."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1032
+#: ../../source/ref-changelog.md:1054
 msgid ""
 "**Update C++ example to be compatible with Flower v1.2.0** "
 "([#1495](https://github.com/adap/flower/pull/1495))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1034
+#: ../../source/ref-changelog.md:1056
 msgid ""
 "The C++ code example has received a substantial update to make it "
 "compatible with the latest version of Flower."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1036
+#: ../../source/ref-changelog.md:1058
 msgid ""
 "**General improvements** "
 "([#1491](https://github.com/adap/flower/pull/1491), "
@@ -20885,7 +20969,7 @@ msgid ""
 "[#1566](https://github.com/adap/flower/pull/1566))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1040
+#: ../../source/ref-changelog.md:1062
 msgid ""
 "**Updated documentation** "
 "([#1494](https://github.com/adap/flower/pull/1494), "
@@ -20899,24 +20983,24 @@ msgid ""
 "[#1515](https://github.com/adap/flower/pull/1515))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1044
+#: ../../source/ref-changelog.md:1066
 msgid ""
 "One highlight is the new [first time contributor "
 "guide](https://flower.ai/docs/first-time-contributors.html): if you've "
 "never contributed on GitHub before, this is the perfect place to start!"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1050
+#: ../../source/ref-changelog.md:1072
 msgid "v1.1.0 (2022-10-31)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1054
+#: ../../source/ref-changelog.md:1076
 msgid ""
 "We would like to give our **special thanks** to all the contributors who "
 "made the new version of Flower possible (in `git shortlog` order):"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1056
+#: ../../source/ref-changelog.md:1078
 msgid ""
 "`Akis Linardos`, `Christopher S`, `Daniel J. Beutel`, `George`, `Jan "
 "Schlicht`, `Mohammad Fares`, `Pedro Porto Buarque de Gusmão`, `Philipp "
@@ -20924,14 +21008,14 @@ msgid ""
 "`danielnugraha`, `edogab33`"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1060
+#: ../../source/ref-changelog.md:1082
 msgid ""
 "**Introduce Differential Privacy wrappers (preview)** "
 "([#1357](https://github.com/adap/flower/pull/1357), "
 "[#1460](https://github.com/adap/flower/pull/1460))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1062
+#: ../../source/ref-changelog.md:1084
 msgid ""
 "The first (experimental) preview of pluggable Differential Privacy "
 "wrappers enables easy configuration and usage of differential privacy "
@@ -20940,13 +21024,13 @@ msgid ""
 "over to the Flower docs, a new explainer goes into more detail."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1064
+#: ../../source/ref-changelog.md:1086
 msgid ""
 "**New iOS CoreML code example** "
 "([#1289](https://github.com/adap/flower/pull/1289))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1066
+#: ../../source/ref-changelog.md:1088
 msgid ""
 "Flower goes iOS! A massive new code example shows how Flower clients can "
 "be built for iOS. The code example contains both Flower iOS SDK "
@@ -20954,39 +21038,39 @@ msgid ""
 "on CoreML."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1068
+#: ../../source/ref-changelog.md:1090
 msgid ""
 "**New FedMedian strategy** "
 "([#1461](https://github.com/adap/flower/pull/1461))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1070
+#: ../../source/ref-changelog.md:1092
 msgid ""
 "The new `FedMedian` strategy implements Federated Median (FedMedian) by "
 "[Yin et al., 2018](https://arxiv.org/pdf/1803.01498v1.pdf)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1072
+#: ../../source/ref-changelog.md:1094
 msgid ""
 "**Log** `Client` **exceptions in Virtual Client Engine** "
 "([#1493](https://github.com/adap/flower/pull/1493))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1074
+#: ../../source/ref-changelog.md:1096
 msgid ""
 "All `Client` exceptions happening in the VCE are now logged by default "
 "and not just exposed to the configured `Strategy` (via the `failures` "
 "argument)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1076
+#: ../../source/ref-changelog.md:1098
 msgid ""
 "**Improve Virtual Client Engine internals** "
 "([#1401](https://github.com/adap/flower/pull/1401), "
 "[#1453](https://github.com/adap/flower/pull/1453))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1078
+#: ../../source/ref-changelog.md:1100
 msgid ""
 "Some internals of the Virtual Client Engine have been revamped. The VCE "
 "now uses Ray 2.0 under the hood, the value type of the `client_resources`"
@@ -20994,25 +21078,25 @@ msgid ""
 "allocated."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1080
+#: ../../source/ref-changelog.md:1102
 msgid ""
 "**Support optional** `Client`**/**`NumPyClient` **methods in Virtual "
 "Client Engine**"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1082
+#: ../../source/ref-changelog.md:1104
 msgid ""
 "The Virtual Client Engine now has full support for optional `Client` (and"
 " `NumPyClient`) methods."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1084
+#: ../../source/ref-changelog.md:1106
 msgid ""
 "**Provide type information to packages using** `flwr` "
 "([#1377](https://github.com/adap/flower/pull/1377))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1086
+#: ../../source/ref-changelog.md:1108
 msgid ""
 "The package `flwr` is now bundled with a `py.typed` file indicating that "
 "the package is typed. This enables typing support for projects or "
@@ -21020,20 +21104,20 @@ msgid ""
 "static type checkers like `mypy`."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1088
+#: ../../source/ref-changelog.md:1110
 msgid ""
 "**Updated code example** "
 "([#1344](https://github.com/adap/flower/pull/1344), "
 "[#1347](https://github.com/adap/flower/pull/1347))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1090
+#: ../../source/ref-changelog.md:1112
 msgid ""
 "The code examples covering scikit-learn and PyTorch Lightning have been "
 "updated to work with the latest version of Flower."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1092
+#: ../../source/ref-changelog.md:1114
 msgid ""
 "**Updated documentation** "
 "([#1355](https://github.com/adap/flower/pull/1355), "
@@ -21055,32 +21139,32 @@ msgid ""
 "[#1467](https://github.com/adap/flower/pull/1467))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1094
+#: ../../source/ref-changelog.md:1116
 msgid ""
 "There have been so many documentation updates that it doesn't even make "
 "sense to list them individually."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1096
+#: ../../source/ref-changelog.md:1118
 msgid ""
 "**Restructured documentation** "
 "([#1387](https://github.com/adap/flower/pull/1387))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1098
+#: ../../source/ref-changelog.md:1120
 msgid ""
 "The documentation has been restructured to make it easier to navigate. "
 "This is just the first step in a larger effort to make the Flower "
 "documentation the best documentation of any project ever. Stay tuned!"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1100
+#: ../../source/ref-changelog.md:1122
 msgid ""
 "**Open in Colab button** "
 "([#1389](https://github.com/adap/flower/pull/1389))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1102
+#: ../../source/ref-changelog.md:1124
 msgid ""
 "The four parts of the Flower Federated Learning Tutorial now come with a "
 "new `Open in Colab` button. No need to install anything on your local "
@@ -21088,7 +21172,7 @@ msgid ""
 "only a single click away."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1104
+#: ../../source/ref-changelog.md:1126
 msgid ""
 "**Improved tutorial** ([#1468](https://github.com/adap/flower/pull/1468),"
 " [#1470](https://github.com/adap/flower/pull/1470), "
@@ -21098,7 +21182,7 @@ msgid ""
 "[#1475](https://github.com/adap/flower/pull/1475))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1106
+#: ../../source/ref-changelog.md:1128
 msgid ""
 "The Flower Federated Learning Tutorial has two brand-new parts covering "
 "custom strategies (still WIP) and the distinction between `Client` and "
@@ -21106,40 +21190,40 @@ msgid ""
 "(many small changes and fixes)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1112
+#: ../../source/ref-changelog.md:1134
 msgid "v1.0.0 (2022-07-28)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1114
+#: ../../source/ref-changelog.md:1136
 msgid "Highlights"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1116
+#: ../../source/ref-changelog.md:1138
 msgid "Stable **Virtual Client Engine** (accessible via `start_simulation`)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1117
+#: ../../source/ref-changelog.md:1139
 msgid "All `Client`/`NumPyClient` methods are now optional"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1118
+#: ../../source/ref-changelog.md:1140
 msgid "Configurable `get_parameters`"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1119
+#: ../../source/ref-changelog.md:1141
 msgid ""
 "Tons of small API cleanups resulting in a more coherent developer "
 "experience"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1123
+#: ../../source/ref-changelog.md:1145
 msgid ""
 "We would like to give our **special thanks** to all the contributors who "
 "made Flower 1.0 possible (in reverse [GitHub "
 "Contributors](https://github.com/adap/flower/graphs/contributors) order):"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1125
+#: ../../source/ref-changelog.md:1147
 msgid ""
 "[@rtaiello](https://github.com/rtaiello), "
 "[@g-pichler](https://github.com/g-pichler), [@rob-"
@@ -21179,13 +21263,13 @@ msgid ""
 "[@danieljanes](https://github.com/danieljanes)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1129
+#: ../../source/ref-changelog.md:1151
 msgid ""
 "**All arguments must be passed as keyword arguments** "
 "([#1338](https://github.com/adap/flower/pull/1338))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1131
+#: ../../source/ref-changelog.md:1153
 msgid ""
 "Pass all arguments as keyword arguments, positional arguments are not "
 "longer supported. Code that uses positional arguments (e.g., "
@@ -21195,14 +21279,14 @@ msgid ""
 "client=FlowerClient())`)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1133
+#: ../../source/ref-changelog.md:1155
 msgid ""
 "**Introduce configuration object** `ServerConfig` **in** `start_server` "
 "**and** `start_simulation` "
 "([#1317](https://github.com/adap/flower/pull/1317))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1135
+#: ../../source/ref-changelog.md:1157
 msgid ""
 "Instead of a config dictionary `{\"num_rounds\": 3, \"round_timeout\": "
 "600.0}`, `start_server` and `start_simulation` now expect a configuration"
@@ -21211,37 +21295,37 @@ msgid ""
 "safe code easier and the default parameters values more transparent."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1137
+#: ../../source/ref-changelog.md:1159
 msgid ""
 "**Rename built-in strategy parameters for clarity** "
 "([#1334](https://github.com/adap/flower/pull/1334))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1139
+#: ../../source/ref-changelog.md:1161
 msgid ""
 "The following built-in strategy parameters were renamed to improve "
 "readability and consistency with other API's:"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1141
+#: ../../source/ref-changelog.md:1163
 msgid "`fraction_eval` --> `fraction_evaluate`"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1142
+#: ../../source/ref-changelog.md:1164
 msgid "`min_eval_clients` --> `min_evaluate_clients`"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1143
+#: ../../source/ref-changelog.md:1165
 msgid "`eval_fn` --> `evaluate_fn`"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1145
+#: ../../source/ref-changelog.md:1167
 msgid ""
 "**Update default arguments of built-in strategies** "
 "([#1278](https://github.com/adap/flower/pull/1278))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1147
+#: ../../source/ref-changelog.md:1169
 msgid ""
 "All built-in strategies now use `fraction_fit=1.0` and "
 "`fraction_evaluate=1.0`, which means they select *all* currently "
@@ -21250,29 +21334,29 @@ msgid ""
 "initializing the strategy in the following way:"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1149
+#: ../../source/ref-changelog.md:1171
 msgid "`strategy = FedAvg(fraction_fit=0.1, fraction_evaluate=0.1)`"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1151
+#: ../../source/ref-changelog.md:1173
 msgid ""
 "**Add** `server_round` **to** `Strategy.evaluate` "
 "([#1334](https://github.com/adap/flower/pull/1334))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1153
+#: ../../source/ref-changelog.md:1175
 msgid ""
 "The `Strategy` method `evaluate` now receives the current round of "
 "federated learning/evaluation as the first parameter."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1155
+#: ../../source/ref-changelog.md:1177
 msgid ""
 "**Add** `server_round` **and** `config` **parameters to** `evaluate_fn` "
 "([#1334](https://github.com/adap/flower/pull/1334))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1157
+#: ../../source/ref-changelog.md:1179
 msgid ""
 "The `evaluate_fn` passed to built-in strategies like `FedAvg` now takes "
 "three parameters: (1) The current round of federated learning/evaluation "
@@ -21280,13 +21364,13 @@ msgid ""
 "and (3) a config dictionary (`config`)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1159
+#: ../../source/ref-changelog.md:1181
 msgid ""
 "**Rename** `rnd` **to** `server_round` "
 "([#1321](https://github.com/adap/flower/pull/1321))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1161
+#: ../../source/ref-changelog.md:1183
 msgid ""
 "Several Flower methods and functions (`evaluate_fn`, `configure_fit`, "
 "`aggregate_fit`, `configure_evaluate`, `aggregate_evaluate`) receive the "
@@ -21295,73 +21379,73 @@ msgid ""
 "has been renamed from `rnd` to `server_round`."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1163
+#: ../../source/ref-changelog.md:1185
 msgid ""
 "**Move** `flwr.dataset` **to** `flwr_baselines` "
 "([#1273](https://github.com/adap/flower/pull/1273))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1165
+#: ../../source/ref-changelog.md:1187
 msgid "The experimental package `flwr.dataset` was migrated to Flower Baselines."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1167
+#: ../../source/ref-changelog.md:1189
 msgid ""
 "**Remove experimental strategies** "
 "([#1280](https://github.com/adap/flower/pull/1280))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1169
+#: ../../source/ref-changelog.md:1191
 msgid ""
 "Remove unmaintained experimental strategies (`FastAndSlow`, `FedFSv0`, "
 "`FedFSv1`)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1171
+#: ../../source/ref-changelog.md:1193
 msgid ""
 "**Rename** `Weights` **to** `NDArrays` "
 "([#1258](https://github.com/adap/flower/pull/1258), "
 "[#1259](https://github.com/adap/flower/pull/1259))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1173
+#: ../../source/ref-changelog.md:1195
 msgid ""
 "`flwr.common.Weights` was renamed to `flwr.common.NDArrays` to better "
 "capture what this type is all about."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1175
+#: ../../source/ref-changelog.md:1197
 msgid ""
 "**Remove antiquated** `force_final_distributed_eval` **from** "
 "`start_server` ([#1258](https://github.com/adap/flower/pull/1258), "
 "[#1259](https://github.com/adap/flower/pull/1259))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1177
+#: ../../source/ref-changelog.md:1199
 msgid ""
 "The `start_server` parameter `force_final_distributed_eval` has long been"
 " a historic artefact, in this release it is finally gone for good."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1179
+#: ../../source/ref-changelog.md:1201
 msgid ""
 "**Make** `get_parameters` **configurable** "
 "([#1242](https://github.com/adap/flower/pull/1242))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1181
+#: ../../source/ref-changelog.md:1203
 msgid ""
 "The `get_parameters` method now accepts a configuration dictionary, just "
 "like `get_properties`, `fit`, and `evaluate`."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1183
+#: ../../source/ref-changelog.md:1205
 msgid ""
 "**Replace** `num_rounds` **in** `start_simulation` **with new** `config` "
 "**parameter** ([#1281](https://github.com/adap/flower/pull/1281))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1185
+#: ../../source/ref-changelog.md:1207
 msgid ""
 "The `start_simulation` function now accepts a configuration dictionary "
 "`config` instead of the `num_rounds` integer. This improves the "
@@ -21369,26 +21453,26 @@ msgid ""
 "transitioning between the two easier."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1189
+#: ../../source/ref-changelog.md:1211
 msgid ""
 "**Support Python 3.10** "
 "([#1320](https://github.com/adap/flower/pull/1320))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1191
+#: ../../source/ref-changelog.md:1213
 msgid ""
 "The previous Flower release introduced experimental support for Python "
 "3.10, this release declares Python 3.10 support as stable."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1193
+#: ../../source/ref-changelog.md:1215
 msgid ""
 "**Make all** `Client` **and** `NumPyClient` **methods optional** "
 "([#1260](https://github.com/adap/flower/pull/1260), "
 "[#1277](https://github.com/adap/flower/pull/1277))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1195
+#: ../../source/ref-changelog.md:1217
 msgid ""
 "The `Client`/`NumPyClient` methods `get_properties`, `get_parameters`, "
 "`fit`, and `evaluate` are all optional. This enables writing clients that"
@@ -21396,13 +21480,13 @@ msgid ""
 "implement `evaluate` when using centralized evaluation!"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1197
+#: ../../source/ref-changelog.md:1219
 msgid ""
 "**Enable passing a** `Server` **instance to** `start_simulation` "
 "([#1281](https://github.com/adap/flower/pull/1281))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1199
+#: ../../source/ref-changelog.md:1221
 msgid ""
 "Similar to `start_server`, `start_simulation` now accepts a full `Server`"
 " instance. This enables users to heavily customize the execution of "
@@ -21410,7 +21494,7 @@ msgid ""
 " Virtual Client Engine."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1201
+#: ../../source/ref-changelog.md:1223
 msgid ""
 "**Update code examples** "
 "([#1291](https://github.com/adap/flower/pull/1291), "
@@ -21418,50 +21502,50 @@ msgid ""
 "[#1282](https://github.com/adap/flower/pull/1282))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1203
+#: ../../source/ref-changelog.md:1225
 msgid ""
 "Many code examples received small or even large maintenance updates, "
 "among them are"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1205
+#: ../../source/ref-changelog.md:1227
 msgid "`scikit-learn`"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1206
+#: ../../source/ref-changelog.md:1228
 msgid "`simulation_pytorch`"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1207
+#: ../../source/ref-changelog.md:1229
 msgid "`quickstart_pytorch`"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1208
+#: ../../source/ref-changelog.md:1230
 msgid "`quickstart_simulation`"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1209
+#: ../../source/ref-changelog.md:1231
 msgid "`quickstart_tensorflow`"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1210
+#: ../../source/ref-changelog.md:1232
 msgid "`advanced_tensorflow`"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1212
+#: ../../source/ref-changelog.md:1234
 msgid ""
 "**Remove the obsolete simulation example** "
 "([#1328](https://github.com/adap/flower/pull/1328))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1214
+#: ../../source/ref-changelog.md:1236
 msgid ""
 "Removes the obsolete `simulation` example and renames "
 "`quickstart_simulation` to `simulation_tensorflow` so it fits withs the "
 "naming of `simulation_pytorch`"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1216
+#: ../../source/ref-changelog.md:1238
 msgid ""
 "**Update documentation** "
 "([#1223](https://github.com/adap/flower/pull/1223), "
@@ -21476,7 +21560,7 @@ msgid ""
 "[#1307](https://github.com/adap/flower/pull/1307))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1218
+#: ../../source/ref-changelog.md:1240
 msgid ""
 "One substantial documentation update fixes multiple smaller rendering "
 "issues, makes titles more succinct to improve navigation, removes a "
@@ -21486,24 +21570,24 @@ msgid ""
 "fixes a number of smaller details!"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1220 ../../source/ref-changelog.md:1275
-#: ../../source/ref-changelog.md:1344 ../../source/ref-changelog.md:1383
+#: ../../source/ref-changelog.md:1242 ../../source/ref-changelog.md:1297
+#: ../../source/ref-changelog.md:1366 ../../source/ref-changelog.md:1405
 msgid "**Minor updates**"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1222
+#: ../../source/ref-changelog.md:1244
 msgid ""
 "Add round number to fit and evaluate log messages "
 "([#1266](https://github.com/adap/flower/pull/1266))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1223
+#: ../../source/ref-changelog.md:1245
 msgid ""
 "Add secure gRPC connection to the `advanced_tensorflow` code example "
 "([#847](https://github.com/adap/flower/pull/847))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1224
+#: ../../source/ref-changelog.md:1246
 msgid ""
 "Update developer tooling "
 "([#1231](https://github.com/adap/flower/pull/1231), "
@@ -21512,7 +21596,7 @@ msgid ""
 "[#1310](https://github.com/adap/flower/pull/1310))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1225
+#: ../../source/ref-changelog.md:1247
 msgid ""
 "Rename ProtoBuf messages to improve consistency "
 "([#1214](https://github.com/adap/flower/pull/1214), "
@@ -21520,11 +21604,11 @@ msgid ""
 "[#1259](https://github.com/adap/flower/pull/1259))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1227
+#: ../../source/ref-changelog.md:1249
 msgid "v0.19.0 (2022-05-18)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1231
+#: ../../source/ref-changelog.md:1253
 msgid ""
 "**Flower Baselines (preview): FedOpt, FedBN, FedAvgM** "
 "([#919](https://github.com/adap/flower/pull/919), "
@@ -21532,7 +21616,7 @@ msgid ""
 "[#914](https://github.com/adap/flower/pull/914))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1233
+#: ../../source/ref-changelog.md:1255
 msgid ""
 "The first preview release of Flower Baselines has arrived! We're "
 "kickstarting Flower Baselines with implementations of FedOpt (FedYogi, "
@@ -21543,39 +21627,39 @@ msgid ""
 "contribute-baselines.html)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1235
+#: ../../source/ref-changelog.md:1257
 msgid ""
 "**C++ client SDK (preview) and code example** "
 "([#1111](https://github.com/adap/flower/pull/1111))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1237
+#: ../../source/ref-changelog.md:1259
 msgid ""
 "Preview support for Flower clients written in C++. The C++ preview "
 "includes a Flower client SDK and a quickstart code example that "
 "demonstrates a simple C++ client using the SDK."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1239
+#: ../../source/ref-changelog.md:1261
 msgid ""
 "**Add experimental support for Python 3.10 and Python 3.11** "
 "([#1135](https://github.com/adap/flower/pull/1135))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1241
+#: ../../source/ref-changelog.md:1263
 msgid ""
 "Python 3.10 is the latest stable release of Python and Python 3.11 is due"
 " to be released in October. This Flower release adds experimental support"
 " for both Python versions."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1243
+#: ../../source/ref-changelog.md:1265
 msgid ""
 "**Aggregate custom metrics through user-provided functions** "
 "([#1144](https://github.com/adap/flower/pull/1144))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1245
+#: ../../source/ref-changelog.md:1267
 msgid ""
 "Custom metrics (e.g., `accuracy`) can now be aggregated without having to"
 " customize the strategy. Built-in strategies support two new arguments, "
@@ -21583,13 +21667,13 @@ msgid ""
 "allow passing custom metric aggregation functions."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1247
+#: ../../source/ref-changelog.md:1269
 msgid ""
 "**User-configurable round timeout** "
 "([#1162](https://github.com/adap/flower/pull/1162))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1249
+#: ../../source/ref-changelog.md:1271
 msgid ""
 "A new configuration value allows the round timeout to be set for "
 "`start_server` and `start_simulation`. If the `config` dictionary "
@@ -21598,14 +21682,14 @@ msgid ""
 "connection."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1251
+#: ../../source/ref-changelog.md:1273
 msgid ""
 "**Enable both federated evaluation and centralized evaluation to be used "
 "at the same time in all built-in strategies** "
 "([#1091](https://github.com/adap/flower/pull/1091))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1253
+#: ../../source/ref-changelog.md:1275
 msgid ""
 "Built-in strategies can now perform both federated evaluation (i.e., "
 "client-side) and centralized evaluation (i.e., server-side) in the same "
@@ -21613,82 +21697,82 @@ msgid ""
 " `0.0`."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1255
+#: ../../source/ref-changelog.md:1277
 msgid ""
 "**Two new Jupyter Notebook tutorials** "
 "([#1141](https://github.com/adap/flower/pull/1141))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1257
+#: ../../source/ref-changelog.md:1279
 msgid ""
 "Two Jupyter Notebook tutorials (compatible with Google Colab) explain "
 "basic and intermediate Flower features:"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1259
+#: ../../source/ref-changelog.md:1281
 msgid ""
 "*An Introduction to Federated Learning*: [Open in "
 "Colab](https://colab.research.google.com/github/adap/flower/blob/main/tutorials/Flower-1"
 "-Intro-to-FL-PyTorch.ipynb)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1261
+#: ../../source/ref-changelog.md:1283
 msgid ""
 "*Using Strategies in Federated Learning*: [Open in "
 "Colab](https://colab.research.google.com/github/adap/flower/blob/main/tutorials/Flower-2"
 "-Strategies-in-FL-PyTorch.ipynb)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1263
+#: ../../source/ref-changelog.md:1285
 msgid ""
 "**New FedAvgM strategy (Federated Averaging with Server Momentum)** "
 "([#1076](https://github.com/adap/flower/pull/1076))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1265
+#: ../../source/ref-changelog.md:1287
 msgid ""
 "The new `FedAvgM` strategy implements Federated Averaging with Server "
 "Momentum \\[Hsu et al., 2019\\]."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1267
+#: ../../source/ref-changelog.md:1289
 msgid ""
 "**New advanced PyTorch code example** "
 "([#1007](https://github.com/adap/flower/pull/1007))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1269
+#: ../../source/ref-changelog.md:1291
 msgid ""
 "A new code example (`advanced_pytorch`) demonstrates advanced Flower "
 "concepts with PyTorch."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1271
+#: ../../source/ref-changelog.md:1293
 msgid ""
 "**New JAX code example** "
 "([#906](https://github.com/adap/flower/pull/906), "
 "[#1143](https://github.com/adap/flower/pull/1143))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1273
+#: ../../source/ref-changelog.md:1295
 msgid ""
 "A new code example (`jax_from_centralized_to_federated`) shows federated "
 "learning with JAX and Flower."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1277
+#: ../../source/ref-changelog.md:1299
 msgid ""
 "New option to keep Ray running if Ray was already initialized in "
 "`start_simulation` ([#1177](https://github.com/adap/flower/pull/1177))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1278
+#: ../../source/ref-changelog.md:1300
 msgid ""
 "Add support for custom `ClientManager` as a `start_simulation` parameter "
 "([#1171](https://github.com/adap/flower/pull/1171))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1279
+#: ../../source/ref-changelog.md:1301
 msgid ""
 "New documentation for [implementing "
 "strategies](https://flower.ai/docs/framework/how-to-implement-"
@@ -21696,72 +21780,72 @@ msgid ""
 "[#1175](https://github.com/adap/flower/pull/1175))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1280
+#: ../../source/ref-changelog.md:1302
 msgid ""
 "New mobile-friendly documentation theme "
 "([#1174](https://github.com/adap/flower/pull/1174))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1281
+#: ../../source/ref-changelog.md:1303
 msgid ""
 "Limit version range for (optional) `ray` dependency to include only "
 "compatible releases (`>=1.9.2,<1.12.0`) "
 "([#1205](https://github.com/adap/flower/pull/1205))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1285
+#: ../../source/ref-changelog.md:1307
 msgid ""
 "**Remove deprecated support for Python 3.6** "
 "([#871](https://github.com/adap/flower/pull/871))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1286
+#: ../../source/ref-changelog.md:1308
 msgid ""
 "**Remove deprecated KerasClient** "
 "([#857](https://github.com/adap/flower/pull/857))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1287
+#: ../../source/ref-changelog.md:1309
 msgid ""
 "**Remove deprecated no-op extra installs** "
 "([#973](https://github.com/adap/flower/pull/973))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1288
+#: ../../source/ref-changelog.md:1310
 msgid ""
 "**Remove deprecated proto fields from** `FitRes` **and** `EvaluateRes` "
 "([#869](https://github.com/adap/flower/pull/869))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1289
+#: ../../source/ref-changelog.md:1311
 msgid ""
 "**Remove deprecated QffedAvg strategy (replaced by QFedAvg)** "
 "([#1107](https://github.com/adap/flower/pull/1107))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1290
+#: ../../source/ref-changelog.md:1312
 msgid ""
 "**Remove deprecated DefaultStrategy strategy** "
 "([#1142](https://github.com/adap/flower/pull/1142))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1291
+#: ../../source/ref-changelog.md:1313
 msgid ""
 "**Remove deprecated support for eval_fn accuracy return value** "
 "([#1142](https://github.com/adap/flower/pull/1142))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1292
+#: ../../source/ref-changelog.md:1314
 msgid ""
 "**Remove deprecated support for passing initial parameters as NumPy "
 "ndarrays** ([#1142](https://github.com/adap/flower/pull/1142))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1294
+#: ../../source/ref-changelog.md:1316
 msgid "v0.18.0 (2022-02-28)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1298
+#: ../../source/ref-changelog.md:1320
 msgid ""
 "**Improved Virtual Client Engine compatibility with Jupyter Notebook / "
 "Google Colab** ([#866](https://github.com/adap/flower/pull/866), "
@@ -21770,7 +21854,7 @@ msgid ""
 "[#1036](https://github.com/adap/flower/pull/1036))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1300
+#: ../../source/ref-changelog.md:1322
 msgid ""
 "Simulations (using the Virtual Client Engine through `start_simulation`) "
 "now work more smoothly on Jupyter Notebooks (incl. Google Colab) after "
@@ -21778,38 +21862,38 @@ msgid ""
 "'flwr[simulation]'`)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1302
+#: ../../source/ref-changelog.md:1324
 msgid ""
 "**New Jupyter Notebook code example** "
 "([#833](https://github.com/adap/flower/pull/833))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1304
+#: ../../source/ref-changelog.md:1326
 msgid ""
 "A new code example (`quickstart_simulation`) demonstrates Flower "
 "simulations using the Virtual Client Engine through Jupyter Notebook "
 "(incl. Google Colab)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1306
+#: ../../source/ref-changelog.md:1328
 msgid ""
 "**Client properties (feature preview)** "
 "([#795](https://github.com/adap/flower/pull/795))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1308
+#: ../../source/ref-changelog.md:1330
 msgid ""
 "Clients can implement a new method `get_properties` to enable server-side"
 " strategies to query client properties."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1310
+#: ../../source/ref-changelog.md:1332
 msgid ""
 "**Experimental Android support with TFLite** "
 "([#865](https://github.com/adap/flower/pull/865))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1312
+#: ../../source/ref-changelog.md:1334
 msgid ""
 "Android support has finally arrived in `main`! Flower is both client-"
 "agnostic and framework-agnostic by design. One can integrate arbitrary "
@@ -21817,7 +21901,7 @@ msgid ""
 "become a lot easier."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1314
+#: ../../source/ref-changelog.md:1336
 msgid ""
 "The example uses TFLite on the client side, along with a new "
 "`FedAvgAndroid` strategy. The Android client and `FedAvgAndroid` are "
@@ -21826,13 +21910,13 @@ msgid ""
 " functionality from `FedAvgAndroid`."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1316
+#: ../../source/ref-changelog.md:1338
 msgid ""
 "**Make gRPC keepalive time user-configurable and decrease default "
 "keepalive time** ([#1069](https://github.com/adap/flower/pull/1069))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1318
+#: ../../source/ref-changelog.md:1340
 msgid ""
 "The default gRPC keepalive time has been reduced to increase the "
 "compatibility of Flower with more cloud environments (for example, "
@@ -21840,31 +21924,31 @@ msgid ""
 " gRPC stack based on specific requirements."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1320
+#: ../../source/ref-changelog.md:1342
 msgid ""
 "**New differential privacy example using Opacus and PyTorch** "
 "([#805](https://github.com/adap/flower/pull/805))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1322
+#: ../../source/ref-changelog.md:1344
 msgid ""
 "A new code example (`opacus`) demonstrates differentially-private "
 "federated learning with Opacus, PyTorch, and Flower."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1324
+#: ../../source/ref-changelog.md:1346
 msgid ""
 "**New Hugging Face Transformers code example** "
 "([#863](https://github.com/adap/flower/pull/863))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1326
+#: ../../source/ref-changelog.md:1348
 msgid ""
 "A new code example (`quickstart_huggingface`) demonstrates usage of "
 "Hugging Face Transformers with Flower."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1328
+#: ../../source/ref-changelog.md:1350
 msgid ""
 "**New MLCube code example** "
 "([#779](https://github.com/adap/flower/pull/779), "
@@ -21873,13 +21957,13 @@ msgid ""
 "[#1090](https://github.com/adap/flower/pull/1090))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1330
+#: ../../source/ref-changelog.md:1352
 msgid ""
 "A new code example (`quickstart_mlcube`) demonstrates usage of MLCube "
 "with Flower."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1332
+#: ../../source/ref-changelog.md:1354
 msgid ""
 "**SSL-enabled server and client** "
 "([#842](https://github.com/adap/flower/pull/842),  "
@@ -21890,33 +21974,33 @@ msgid ""
 "[#994](https://github.com/adap/flower/pull/994))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1334
+#: ../../source/ref-changelog.md:1356
 msgid ""
 "SSL enables secure encrypted connections between clients and servers. "
 "This release open-sources the Flower secure gRPC implementation to make "
 "encrypted communication channels accessible to all Flower users."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1336
+#: ../../source/ref-changelog.md:1358
 msgid ""
 "**Updated** `FedAdam` **and** `FedYogi` **strategies** "
 "([#885](https://github.com/adap/flower/pull/885), "
 "[#895](https://github.com/adap/flower/pull/895))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1338
+#: ../../source/ref-changelog.md:1360
 msgid ""
 "`FedAdam` and `FedAdam` match the latest version of the Adaptive "
 "Federated Optimization paper."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1340
+#: ../../source/ref-changelog.md:1362
 msgid ""
 "**Initialize** `start_simulation` **with a list of client IDs** "
 "([#860](https://github.com/adap/flower/pull/860))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1342
+#: ../../source/ref-changelog.md:1364
 msgid ""
 "`start_simulation` can now be called with a list of client IDs "
 "(`clients_ids`, type: `List[str]`). Those IDs will be passed to the "
@@ -21925,55 +22009,55 @@ msgid ""
 "identifiers."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1346
+#: ../../source/ref-changelog.md:1368
 msgid ""
 "Update `num_examples` calculation in PyTorch code examples in "
 "([#909](https://github.com/adap/flower/pull/909))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1347
+#: ../../source/ref-changelog.md:1369
 msgid ""
 "Expose Flower version through `flwr.__version__` "
 "([#952](https://github.com/adap/flower/pull/952))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1348
+#: ../../source/ref-changelog.md:1370
 msgid ""
 "`start_server` in `app.py` now returns a `History` object containing "
 "metrics from training ([#974](https://github.com/adap/flower/pull/974))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1349
+#: ../../source/ref-changelog.md:1371
 msgid ""
 "Make `max_workers` (used by `ThreadPoolExecutor`) configurable "
 "([#978](https://github.com/adap/flower/pull/978))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1350
+#: ../../source/ref-changelog.md:1372
 msgid ""
 "Increase sleep time after server start to three seconds in all code "
 "examples ([#1086](https://github.com/adap/flower/pull/1086))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1351
+#: ../../source/ref-changelog.md:1373
 msgid ""
 "Added a new FAQ section to the documentation "
 "([#948](https://github.com/adap/flower/pull/948))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1352
+#: ../../source/ref-changelog.md:1374
 msgid ""
 "And many more under-the-hood changes, library updates, documentation "
 "changes, and tooling improvements!"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1356
+#: ../../source/ref-changelog.md:1378
 msgid ""
 "**Removed** `flwr_example` **and** `flwr_experimental` **from release "
 "build** ([#869](https://github.com/adap/flower/pull/869))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1358
+#: ../../source/ref-changelog.md:1380
 msgid ""
 "The packages `flwr_example` and `flwr_experimental` have been deprecated "
 "since Flower 0.12.0 and they are not longer included in Flower release "
@@ -21982,11 +22066,11 @@ msgid ""
 "an upcoming release."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1360
+#: ../../source/ref-changelog.md:1382
 msgid "v0.17.0 (2021-09-24)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1364
+#: ../../source/ref-changelog.md:1386
 msgid ""
 "**Experimental virtual client engine** "
 "([#781](https://github.com/adap/flower/pull/781) "
@@ -21994,7 +22078,7 @@ msgid ""
 "[#791](https://github.com/adap/flower/pull/791))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1366
+#: ../../source/ref-changelog.md:1388
 msgid ""
 "One of Flower's goals is to enable research at scale. This release "
 "enables a first (experimental) peek at a major new feature, codenamed the"
@@ -22004,7 +22088,7 @@ msgid ""
 "code examples called `quickstart_simulation` and `simulation_pytorch`."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1368
+#: ../../source/ref-changelog.md:1390
 msgid ""
 "The feature is still experimental, so there's no stability guarantee for "
 "the API. It's also not quite ready for prime time and comes with a few "
@@ -22012,86 +22096,86 @@ msgid ""
 "out and share their thoughts."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1370
+#: ../../source/ref-changelog.md:1392
 msgid ""
 "**New built-in strategies** "
 "([#828](https://github.com/adap/flower/pull/828) "
 "[#822](https://github.com/adap/flower/pull/822))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1372
+#: ../../source/ref-changelog.md:1394
 msgid ""
 "FedYogi - Federated learning strategy using Yogi on server-side. "
 "Implementation based on https://arxiv.org/abs/2003.00295"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1373
+#: ../../source/ref-changelog.md:1395
 msgid ""
 "FedAdam - Federated learning strategy using Adam on server-side. "
 "Implementation based on https://arxiv.org/abs/2003.00295"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1375
+#: ../../source/ref-changelog.md:1397
 msgid ""
 "**New PyTorch Lightning code example** "
 "([#617](https://github.com/adap/flower/pull/617))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1377
+#: ../../source/ref-changelog.md:1399
 msgid ""
 "**New Variational Auto-Encoder code example** "
 "([#752](https://github.com/adap/flower/pull/752))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1379
+#: ../../source/ref-changelog.md:1401
 msgid ""
 "**New scikit-learn code example** "
 "([#748](https://github.com/adap/flower/pull/748))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1381
+#: ../../source/ref-changelog.md:1403
 msgid ""
 "**New experimental TensorBoard strategy** "
 "([#789](https://github.com/adap/flower/pull/789))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1385
+#: ../../source/ref-changelog.md:1407
 msgid ""
 "Improved advanced TensorFlow code example "
 "([#769](https://github.com/adap/flower/pull/769))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1386
+#: ../../source/ref-changelog.md:1408
 msgid ""
 "Warning when `min_available_clients` is misconfigured "
 "([#830](https://github.com/adap/flower/pull/830))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1387
+#: ../../source/ref-changelog.md:1409
 msgid ""
 "Improved gRPC server docs "
 "([#841](https://github.com/adap/flower/pull/841))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1388
+#: ../../source/ref-changelog.md:1410
 msgid ""
 "Improved error message in `NumPyClient` "
 "([#851](https://github.com/adap/flower/pull/851))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1389
+#: ../../source/ref-changelog.md:1411
 msgid ""
 "Improved PyTorch quickstart code example "
 "([#852](https://github.com/adap/flower/pull/852))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1393
+#: ../../source/ref-changelog.md:1415
 msgid ""
 "**Disabled final distributed evaluation** "
 "([#800](https://github.com/adap/flower/pull/800))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1395
+#: ../../source/ref-changelog.md:1417
 msgid ""
 "Prior behaviour was to perform a final round of distributed evaluation on"
 " all connected clients, which is often not required (e.g., when using "
@@ -22099,13 +22183,13 @@ msgid ""
 "`force_final_distributed_eval=True` to `start_server`."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1397
+#: ../../source/ref-changelog.md:1419
 msgid ""
 "**Renamed q-FedAvg strategy** "
 "([#802](https://github.com/adap/flower/pull/802))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1399
+#: ../../source/ref-changelog.md:1421
 msgid ""
 "The strategy named `QffedAvg` was renamed to `QFedAvg` to better reflect "
 "the notation given in the original paper (q-FFL is the optimization "
@@ -22114,14 +22198,14 @@ msgid ""
 " (it will be removed in a future release)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1401
+#: ../../source/ref-changelog.md:1423
 msgid ""
 "**Deprecated and renamed code example** `simulation_pytorch` **to** "
 "`simulation_pytorch_legacy` "
 "([#791](https://github.com/adap/flower/pull/791))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1403
+#: ../../source/ref-changelog.md:1425
 msgid ""
 "This example has been replaced by a new example. The new example is based"
 " on the experimental virtual client engine, which will become the new "
@@ -22130,27 +22214,27 @@ msgid ""
 "removed in the future."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1405
+#: ../../source/ref-changelog.md:1427
 msgid "v0.16.0 (2021-05-11)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1409
+#: ../../source/ref-changelog.md:1431
 msgid ""
 "**New built-in strategies** "
 "([#549](https://github.com/adap/flower/pull/549))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1411
+#: ../../source/ref-changelog.md:1433
 msgid "(abstract) FedOpt"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1414
+#: ../../source/ref-changelog.md:1436
 msgid ""
 "**Custom metrics for server and strategies** "
 "([#717](https://github.com/adap/flower/pull/717))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1416
+#: ../../source/ref-changelog.md:1438
 msgid ""
 "The Flower server is now fully task-agnostic, all remaining instances of "
 "task-specific metrics (such as `accuracy`) have been replaced by custom "
@@ -22159,7 +22243,7 @@ msgid ""
 "release, custom metrics replace task-specific metrics on the server."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1418
+#: ../../source/ref-changelog.md:1440
 msgid ""
 "Custom metric dictionaries are now used in two user-facing APIs: they are"
 " returned from Strategy methods `aggregate_fit`/`aggregate_evaluate` and "
@@ -22169,7 +22253,7 @@ msgid ""
 "track of."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1420
+#: ../../source/ref-changelog.md:1442
 msgid ""
 "Strategy implementations should migrate their `aggregate_fit` and "
 "`aggregate_evaluate` methods to the new return type (e.g., by simply "
@@ -22177,19 +22261,19 @@ msgid ""
 " from `return loss, accuracy` to `return loss, {\"accuracy\": accuracy}`."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1422
+#: ../../source/ref-changelog.md:1444
 msgid ""
 "Flower 0.15-style return types are deprecated (but still supported), "
 "compatibility will be removed in a future release."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1424
+#: ../../source/ref-changelog.md:1446
 msgid ""
 "**Migration warnings for deprecated functionality** "
 "([#690](https://github.com/adap/flower/pull/690))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1426
+#: ../../source/ref-changelog.md:1448
 msgid ""
 "Earlier versions of Flower were often migrated to new APIs, while "
 "maintaining compatibility with legacy APIs. This release introduces "
@@ -22198,7 +22282,7 @@ msgid ""
 "recent APIs, thus easing the transition from one release to another."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1428
+#: ../../source/ref-changelog.md:1450
 msgid ""
 "Improved docs and docstrings "
 "([#691](https://github.com/adap/flower/pull/691) "
@@ -22206,11 +22290,11 @@ msgid ""
 "[#713](https://github.com/adap/flower/pull/713))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1430
+#: ../../source/ref-changelog.md:1452
 msgid "MXNet example and documentation"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1432
+#: ../../source/ref-changelog.md:1454
 msgid ""
 "FedBN implementation in example PyTorch: From Centralized To Federated "
 "([#696](https://github.com/adap/flower/pull/696) "
@@ -22218,13 +22302,13 @@ msgid ""
 "[#705](https://github.com/adap/flower/pull/705))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1436
+#: ../../source/ref-changelog.md:1458
 msgid ""
 "**Serialization-agnostic server** "
 "([#721](https://github.com/adap/flower/pull/721))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1438
+#: ../../source/ref-changelog.md:1460
 msgid ""
 "The Flower server is now fully serialization-agnostic. Prior usage of "
 "class `Weights` (which represents parameters as deserialized NumPy "
@@ -22235,7 +22319,7 @@ msgid ""
 "serialization/deserialization)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1440
+#: ../../source/ref-changelog.md:1462
 msgid ""
 "Built-in strategies implement this approach by handling serialization and"
 " deserialization to/from `Weights` internally. Custom/3rd-party Strategy "
@@ -22245,31 +22329,31 @@ msgid ""
 " easily migrate to the new format."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1442
+#: ../../source/ref-changelog.md:1464
 msgid ""
 "Deprecated `flwr.server.Server.evaluate`, use "
 "`flwr.server.Server.evaluate_round` instead "
 "([#717](https://github.com/adap/flower/pull/717))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1444
+#: ../../source/ref-changelog.md:1466
 msgid "v0.15.0 (2021-03-12)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1448
+#: ../../source/ref-changelog.md:1470
 msgid ""
 "**Server-side parameter initialization** "
 "([#658](https://github.com/adap/flower/pull/658))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1450
+#: ../../source/ref-changelog.md:1472
 msgid ""
 "Model parameters can now be initialized on the server-side. Server-side "
 "parameter initialization works via a new `Strategy` method called "
 "`initialize_parameters`."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1452
+#: ../../source/ref-changelog.md:1474
 msgid ""
 "Built-in strategies support a new constructor argument called "
 "`initial_parameters` to set the initial parameters. Built-in strategies "
@@ -22277,7 +22361,7 @@ msgid ""
 "delete them to free the memory afterwards."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1471
+#: ../../source/ref-changelog.md:1493
 msgid ""
 "If no initial parameters are provided to the strategy, the server will "
 "continue to use the current behaviour (namely, it will ask one of the "
@@ -22285,17 +22369,17 @@ msgid ""
 "parameters)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1475
+#: ../../source/ref-changelog.md:1497
 msgid ""
 "Deprecate `flwr.server.strategy.DefaultStrategy` (migrate to "
 "`flwr.server.strategy.FedAvg`, which is equivalent)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1477
+#: ../../source/ref-changelog.md:1499
 msgid "v0.14.0 (2021-02-18)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1481
+#: ../../source/ref-changelog.md:1503
 msgid ""
 "**Generalized** `Client.fit` **and** `Client.evaluate` **return values** "
 "([#610](https://github.com/adap/flower/pull/610) "
@@ -22303,7 +22387,7 @@ msgid ""
 "[#633](https://github.com/adap/flower/pull/633))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1483
+#: ../../source/ref-changelog.md:1505
 msgid ""
 "Clients can now return an additional dictionary mapping `str` keys to "
 "values of the following types: `bool`, `bytes`, `float`, `int`, `str`. "
@@ -22311,7 +22395,7 @@ msgid ""
 "and make use of them on the server side!"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1485
+#: ../../source/ref-changelog.md:1507
 msgid ""
 "This improvement also allowed for more consistent return types between "
 "`fit` and `evaluate`: `evaluate` should now return a tuple `(float, int, "
@@ -22319,7 +22403,7 @@ msgid ""
 "holding arbitrary problem-specific values like accuracy."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1487
+#: ../../source/ref-changelog.md:1509
 msgid ""
 "In case you wondered: this feature is compatible with existing projects, "
 "the additional dictionary return value is optional. New code should "
@@ -22329,19 +22413,19 @@ msgid ""
 "details."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1489
+#: ../../source/ref-changelog.md:1511
 msgid ""
 "*Code example:* note the additional dictionary return values in both "
 "`FlwrClient.fit` and `FlwrClient.evaluate`:"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1504
+#: ../../source/ref-changelog.md:1526
 msgid ""
 "**Generalized** `config` **argument in** `Client.fit` **and** "
 "`Client.evaluate` ([#595](https://github.com/adap/flower/pull/595))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1506
+#: ../../source/ref-changelog.md:1528
 msgid ""
 "The `config` argument used to be of type `Dict[str, str]`, which means "
 "that dictionary values were expected to be strings. The new release "
@@ -22349,58 +22433,58 @@ msgid ""
 "`bytes`, `float`, `int`, `str`."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1508
+#: ../../source/ref-changelog.md:1530
 msgid ""
 "This means one can now pass almost arbitrary values to `fit`/`evaluate` "
 "using the `config` dictionary. Yay, no more `str(epochs)` on the server-"
 "side and `int(config[\"epochs\"])` on the client side!"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1510
+#: ../../source/ref-changelog.md:1532
 msgid ""
 "*Code example:* note that the `config` dictionary now contains non-`str` "
 "values in both `Client.fit` and `Client.evaluate`:"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1527
+#: ../../source/ref-changelog.md:1549
 msgid "v0.13.0 (2021-01-08)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1531
+#: ../../source/ref-changelog.md:1553
 msgid ""
 "New example: PyTorch From Centralized To Federated "
 "([#549](https://github.com/adap/flower/pull/549))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1532
+#: ../../source/ref-changelog.md:1554
 msgid "Improved documentation"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1533
+#: ../../source/ref-changelog.md:1555
 msgid "New documentation theme ([#551](https://github.com/adap/flower/pull/551))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1534
+#: ../../source/ref-changelog.md:1556
 msgid "New API reference ([#554](https://github.com/adap/flower/pull/554))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1535
+#: ../../source/ref-changelog.md:1557
 msgid ""
 "Updated examples documentation "
 "([#549](https://github.com/adap/flower/pull/549))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1536
+#: ../../source/ref-changelog.md:1558
 msgid ""
 "Removed obsolete documentation "
 "([#548](https://github.com/adap/flower/pull/548))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1538
+#: ../../source/ref-changelog.md:1560
 msgid "Bugfix:"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1540
+#: ../../source/ref-changelog.md:1562
 msgid ""
 "`Server.fit` does not disconnect clients when finished, disconnecting the"
 " clients is now handled in `flwr.server.start_server` "
@@ -22408,28 +22492,28 @@ msgid ""
 "[#540](https://github.com/adap/flower/issues/540))."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1542
+#: ../../source/ref-changelog.md:1564
 msgid "v0.12.0 (2020-12-07)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1544 ../../source/ref-changelog.md:1560
+#: ../../source/ref-changelog.md:1566 ../../source/ref-changelog.md:1582
 msgid "Important changes:"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1546
+#: ../../source/ref-changelog.md:1568
 msgid ""
 "Added an example for embedded devices "
 "([#507](https://github.com/adap/flower/pull/507))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1547
+#: ../../source/ref-changelog.md:1569
 msgid ""
 "Added a new NumPyClient (in addition to the existing KerasClient) "
 "([#504](https://github.com/adap/flower/pull/504) "
 "[#508](https://github.com/adap/flower/pull/508))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1548
+#: ../../source/ref-changelog.md:1570
 msgid ""
 "Deprecated `flwr_example` package and started to migrate examples into "
 "the top-level `examples` directory "
@@ -22437,15 +22521,15 @@ msgid ""
 "[#512](https://github.com/adap/flower/pull/512))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1550
+#: ../../source/ref-changelog.md:1572
 msgid "v0.11.0 (2020-11-30)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1552
+#: ../../source/ref-changelog.md:1574
 msgid "Incompatible changes:"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1554
+#: ../../source/ref-changelog.md:1576
 msgid ""
 "Renamed strategy methods "
 "([#486](https://github.com/adap/flower/pull/486)) to unify the naming of "
@@ -22455,48 +22539,48 @@ msgid ""
 "migrate rename the following `Strategy` methods accordingly:"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1555
+#: ../../source/ref-changelog.md:1577
 msgid "`on_configure_evaluate` => `configure_evaluate`"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1556
+#: ../../source/ref-changelog.md:1578
 msgid "`on_aggregate_evaluate` => `aggregate_evaluate`"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1557
+#: ../../source/ref-changelog.md:1579
 msgid "`on_configure_fit` => `configure_fit`"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1558
+#: ../../source/ref-changelog.md:1580
 msgid "`on_aggregate_fit` => `aggregate_fit`"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1562
+#: ../../source/ref-changelog.md:1584
 msgid ""
 "Deprecated `DefaultStrategy` "
 "([#479](https://github.com/adap/flower/pull/479)). To migrate use "
 "`FedAvg` instead."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1563
+#: ../../source/ref-changelog.md:1585
 msgid ""
 "Simplified examples and baselines "
 "([#484](https://github.com/adap/flower/pull/484))."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1564
+#: ../../source/ref-changelog.md:1586
 msgid ""
 "Removed presently unused `on_conclude_round` from strategy interface "
 "([#483](https://github.com/adap/flower/pull/483))."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1565
+#: ../../source/ref-changelog.md:1587
 msgid ""
 "Set minimal Python version to 3.6.1 instead of 3.6.9 "
 "([#471](https://github.com/adap/flower/pull/471))."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1566
+#: ../../source/ref-changelog.md:1588
 msgid ""
 "Improved `Strategy` docstrings "
 "([#470](https://github.com/adap/flower/pull/470))."
@@ -25900,7 +25984,7 @@ msgstr ""
 " 수도 있습니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:41
-msgid "|cf5fe148406b44b9a8b842fb01b5a7ea|"
+msgid "|f150b8d6e0074250822c9f6f7a8de3e0|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:109
@@ -25917,7 +26001,7 @@ msgstr ""
 " 바둑과 같은 게임을 하는 것일 수 있습니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:53
-msgid "|ba25c91426d64cc1ae2d3febc5715b35|"
+msgid "|72772d10debc4abd8373c0bc82985422|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:111
@@ -25943,7 +26027,7 @@ msgstr ""
 "부르리는 것을 듣는 스마트 스피커에서 비롯됩니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:67
-msgid "|fca67f83aaab4389aa9ebb4d9c5cd75e|"
+msgid "|5815398552ad41d290a3a2631fe8f6ca|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:113
@@ -25961,7 +26045,7 @@ msgstr ""
 "있습니다. 하지만 여러 조직이 모두 같은 작업을 위해 데이터를 생성하는 것일 수도 있습니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:79
-msgid "|6f2e8f95c95443379b0df00ca9824654|"
+msgid "|e6ac20744bf149378be20ac3dc309356|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:115
@@ -25980,7 +26064,7 @@ msgstr ""
 "서버는 데이터 센터 어딘가에 있을 수도 있고 클라우드 어딘가에 있을 수도 있습니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:91
-msgid "|c0ab3a1a733d4dbc9e1677aa608e8038|"
+msgid "|a4011ef443c14725b15a8cf33b0e3443|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:117
@@ -25997,7 +26081,7 @@ msgstr ""
 " 우리가 기본적으로 사용해 온 머신러닝 방법입니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:103
-msgid "|8f0491bde07341ab9f2e23d50593c0be|"
+msgid "|a22faa3617404c06803731525e1c609f|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:119
@@ -26020,7 +26104,7 @@ msgstr ""
 "트래픽을 분석하는 것이 있습니다. 이러한 사례에서 모든 데이터는 자연스럽게 중앙 서버에 존재합니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:138
-msgid "|762fc099899943688361562252c5e600|"
+msgid "|84a5c9b5041c43c3beab9786197c3e4e|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:173
@@ -26037,7 +26121,7 @@ msgstr ""
 "좋은 모델을 훈련하기에 충분하지 않을 수 있습니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:150
-msgid "|f62d365fd0ae405b975d3ca01e7183fd|"
+msgid "|b5c4be0b52d4493ba8c4af14d7c2db97|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:175
@@ -26216,7 +26300,7 @@ msgstr ""
 "체크포인트에서 모델 매개변수를 초기화합니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:210
-msgid "|2c78fc1816b143289f4d909388f92a80|"
+msgid "|c1c784183d18481186ff65dc261d1335|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:307
@@ -26244,7 +26328,7 @@ msgstr ""
 "개의 연결 노드만 사용합니다. 그 이유는 점점 더 많은 클라이언트 노드를 선택하면 학습의 효율성이 감소하기 때문입니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:225
-msgid "|4230725aeebe497d8ad84a3efc2a912b|"
+msgid "|669fcd1f44ab42f5bbd196c3cf1ecbc2|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:309
@@ -26271,7 +26355,7 @@ msgstr ""
 "데이터에서 한 단계 정도로 짧거나 몇 단계(mini-batches)에 불과할 수 있습니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:240
-msgid "|64b66a88417240eabe52f5cc55d89d0b|"
+msgid "|edfb08758c9441afb6736045a59e154c|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:311
@@ -26297,7 +26381,7 @@ msgstr ""
 "보냅니다. 보내는 모델 업데이트는 전체 모델 파라미터거나 로컬 교육 중에 누적된 그레디언트(gradient)일 수 있습니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:255
-msgid "|726c8eca58bc4f859b06aa24a587b253|"
+msgid "|82338b8bbad24d5ea9df3801aab37852|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:313
@@ -26347,7 +26431,7 @@ msgstr ""
 "많은 영향을 미칩니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:273
-msgid "|f9d869e4b33c4093b29cf24ed8dff80a|"
+msgid "|518d994dd2c844898b441da03b858326|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:315
@@ -26467,7 +26551,7 @@ msgstr ""
 "사용자는 모든 워크로드, 머신러닝 프레임워크 및 모든 프로그래밍 언어를 통합할 수 있습니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:334
-msgid "|4ab50bc01a9f426a91a2c0cbc3ab7a84|"
+msgid "|7bfcfcb57ae5403f8e18486f45ca48b4|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:340
@@ -33296,3 +33380,51 @@ msgstr ""
 #~ msgid "|dd4434075f374e99ac07f509a883778f|"
 #~ msgstr ""
 
+#~ msgid "Unreleased"
+#~ msgstr "릴리즈 빌드"
+
+#~ msgid "Other changes"
+#~ msgstr "**변경사항 스테이징**"
+
+#~ msgid "|cf5fe148406b44b9a8b842fb01b5a7ea|"
+#~ msgstr ""
+
+#~ msgid "|ba25c91426d64cc1ae2d3febc5715b35|"
+#~ msgstr ""
+
+#~ msgid "|fca67f83aaab4389aa9ebb4d9c5cd75e|"
+#~ msgstr ""
+
+#~ msgid "|6f2e8f95c95443379b0df00ca9824654|"
+#~ msgstr ""
+
+#~ msgid "|c0ab3a1a733d4dbc9e1677aa608e8038|"
+#~ msgstr ""
+
+#~ msgid "|8f0491bde07341ab9f2e23d50593c0be|"
+#~ msgstr ""
+
+#~ msgid "|762fc099899943688361562252c5e600|"
+#~ msgstr ""
+
+#~ msgid "|f62d365fd0ae405b975d3ca01e7183fd|"
+#~ msgstr ""
+
+#~ msgid "|2c78fc1816b143289f4d909388f92a80|"
+#~ msgstr ""
+
+#~ msgid "|4230725aeebe497d8ad84a3efc2a912b|"
+#~ msgstr ""
+
+#~ msgid "|64b66a88417240eabe52f5cc55d89d0b|"
+#~ msgstr ""
+
+#~ msgid "|726c8eca58bc4f859b06aa24a587b253|"
+#~ msgstr ""
+
+#~ msgid "|f9d869e4b33c4093b29cf24ed8dff80a|"
+#~ msgstr ""
+
+#~ msgid "|4ab50bc01a9f426a91a2c0cbc3ab7a84|"
+#~ msgstr ""
+
diff --git a/doc/locales/pt_BR/LC_MESSAGES/framework-docs.po b/doc/locales/pt_BR/LC_MESSAGES/framework-docs.po
index c2670e8f6b0f..017acf217ab0 100644
--- a/doc/locales/pt_BR/LC_MESSAGES/framework-docs.po
+++ b/doc/locales/pt_BR/LC_MESSAGES/framework-docs.po
@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Flower main\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-11-22 08:46+0000\n"
+"POT-Creation-Date: 2024-11-28 00:32+0000\n"
 "PO-Revision-Date: 2024-05-25 11:09+0000\n"
 "Last-Translator: Gustavo Bertoli <gubertoli@gmail.com>\n"
 "Language: pt_BR\n"
@@ -3101,10 +3101,10 @@ msgstr ""
 #: ../../source/docker/run-quickstart-examples-docker-compose.rst:119
 #: ../../source/docker/run-quickstart-examples-docker-compose.rst:121
 #: ../../source/docker/run-quickstart-examples-docker-compose.rst:125
-#: ../../source/ref-changelog.md:214 ../../source/ref-changelog.md:580
-#: ../../source/ref-changelog.md:857 ../../source/ref-changelog.md:921
-#: ../../source/ref-changelog.md:979 ../../source/ref-changelog.md:1048
-#: ../../source/ref-changelog.md:1110
+#: ../../source/ref-changelog.md:236 ../../source/ref-changelog.md:602
+#: ../../source/ref-changelog.md:879 ../../source/ref-changelog.md:943
+#: ../../source/ref-changelog.md:1001 ../../source/ref-changelog.md:1070
+#: ../../source/ref-changelog.md:1132
 msgid "None"
 msgstr ""
 
@@ -13588,7 +13588,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/ref-api/flwr.server.strategy.FedAdagrad.rst:2
-#: ../../source/ref-changelog.md:1412
+#: ../../source/ref-changelog.md:1434
 msgid "FedAdagrad"
 msgstr ""
 
@@ -15368,80 +15368,156 @@ msgid "Changelog"
 msgstr ""
 
 #: ../../source/ref-changelog.md:3
-msgid "Unreleased"
-msgstr ""
-
-#: ../../source/ref-changelog.md:5 ../../source/ref-changelog.md:21
-#: ../../source/ref-changelog.md:122 ../../source/ref-changelog.md:224
-#: ../../source/ref-changelog.md:328 ../../source/ref-changelog.md:426
-#: ../../source/ref-changelog.md:526 ../../source/ref-changelog.md:590
-#: ../../source/ref-changelog.md:683 ../../source/ref-changelog.md:783
-#: ../../source/ref-changelog.md:867 ../../source/ref-changelog.md:931
-#: ../../source/ref-changelog.md:989 ../../source/ref-changelog.md:1058
-#: ../../source/ref-changelog.md:1187 ../../source/ref-changelog.md:1229
-#: ../../source/ref-changelog.md:1296 ../../source/ref-changelog.md:1362
-#: ../../source/ref-changelog.md:1407 ../../source/ref-changelog.md:1446
-#: ../../source/ref-changelog.md:1479 ../../source/ref-changelog.md:1529
-msgid "What's new?"
+msgid "v1.13.1 (2024-11-26)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:7
-msgid "Other changes"
+#: ../../source/ref-changelog.md:5 ../../source/ref-changelog.md:37
+#: ../../source/ref-changelog.md:138 ../../source/ref-changelog.md:208
+#: ../../source/ref-changelog.md:240 ../../source/ref-changelog.md:344
+#: ../../source/ref-changelog.md:442 ../../source/ref-changelog.md:542
+#: ../../source/ref-changelog.md:606 ../../source/ref-changelog.md:699
+#: ../../source/ref-changelog.md:799 ../../source/ref-changelog.md:883
+#: ../../source/ref-changelog.md:947 ../../source/ref-changelog.md:1005
+#: ../../source/ref-changelog.md:1074 ../../source/ref-changelog.md:1143
+msgid "Thanks to our contributors"
 msgstr ""
 
-#: ../../source/ref-changelog.md:9 ../../source/ref-changelog.md:388
-msgid "Documentation improvements"
+#: ../../source/ref-changelog.md:7 ../../source/ref-changelog.md:39
+#: ../../source/ref-changelog.md:140 ../../source/ref-changelog.md:210
+#: ../../source/ref-changelog.md:242 ../../source/ref-changelog.md:346
+#: ../../source/ref-changelog.md:444 ../../source/ref-changelog.md:544
+#: ../../source/ref-changelog.md:608 ../../source/ref-changelog.md:701
+#: ../../source/ref-changelog.md:801 ../../source/ref-changelog.md:885
+#: ../../source/ref-changelog.md:949 ../../source/ref-changelog.md:1007
+msgid ""
+"We would like to give our special thanks to all the contributors who made"
+" the new version of Flower possible (in `git shortlog` order):"
 msgstr ""
 
-#: ../../source/ref-changelog.md:11 ../../source/ref-changelog.md:88
-#: ../../source/ref-changelog.md:178 ../../source/ref-changelog.md:212
-#: ../../source/ref-changelog.md:292 ../../source/ref-changelog.md:408
-#: ../../source/ref-changelog.md:504 ../../source/ref-changelog.md:578
-#: ../../source/ref-changelog.md:653 ../../source/ref-changelog.md:765
-#: ../../source/ref-changelog.md:855 ../../source/ref-changelog.md:919
-#: ../../source/ref-changelog.md:977 ../../source/ref-changelog.md:1046
-#: ../../source/ref-changelog.md:1108 ../../source/ref-changelog.md:1127
-#: ../../source/ref-changelog.md:1283 ../../source/ref-changelog.md:1354
-#: ../../source/ref-changelog.md:1391 ../../source/ref-changelog.md:1434
-msgid "Incompatible changes"
+#: ../../source/ref-changelog.md:9
+msgid ""
+"`Adam Narozniak`, `Charles Beauville`, `Heng Pan`, `Javier`, `Robert "
+"Steiner` <!---TOKEN_v1.13.1-->"
+msgstr ""
+
+#: ../../source/ref-changelog.md:11 ../../source/ref-changelog.md:43
+#: ../../source/ref-changelog.md:144 ../../source/ref-changelog.md:246
+#: ../../source/ref-changelog.md:350 ../../source/ref-changelog.md:448
+#: ../../source/ref-changelog.md:548 ../../source/ref-changelog.md:612
+#: ../../source/ref-changelog.md:705 ../../source/ref-changelog.md:805
+#: ../../source/ref-changelog.md:889 ../../source/ref-changelog.md:953
+#: ../../source/ref-changelog.md:1011 ../../source/ref-changelog.md:1080
+#: ../../source/ref-changelog.md:1209 ../../source/ref-changelog.md:1251
+#: ../../source/ref-changelog.md:1318 ../../source/ref-changelog.md:1384
+#: ../../source/ref-changelog.md:1429 ../../source/ref-changelog.md:1468
+#: ../../source/ref-changelog.md:1501 ../../source/ref-changelog.md:1551
+msgid "What's new?"
 msgstr ""
 
 #: ../../source/ref-changelog.md:13
-msgid "v1.13.0 (2024-11-20)"
+msgid ""
+"**Fix `SimulationEngine` Executor for SuperLink** "
+"([#4563](https://github.com/adap/flower/pull/4563), "
+"[#4568](https://github.com/adap/flower/pull/4568), "
+"[#4570](https://github.com/adap/flower/pull/4570))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:15 ../../source/ref-changelog.md:116
-#: ../../source/ref-changelog.md:186 ../../source/ref-changelog.md:218
-#: ../../source/ref-changelog.md:322 ../../source/ref-changelog.md:420
-#: ../../source/ref-changelog.md:520 ../../source/ref-changelog.md:584
-#: ../../source/ref-changelog.md:677 ../../source/ref-changelog.md:777
-#: ../../source/ref-changelog.md:861 ../../source/ref-changelog.md:925
-#: ../../source/ref-changelog.md:983 ../../source/ref-changelog.md:1052
-#: ../../source/ref-changelog.md:1121
-msgid "Thanks to our contributors"
+#: ../../source/ref-changelog.md:15
+msgid ""
+"Resolved an issue that prevented SuperLink from functioning correctly "
+"when using the `SimulationEngine` executor."
 msgstr ""
 
-#: ../../source/ref-changelog.md:17 ../../source/ref-changelog.md:118
-#: ../../source/ref-changelog.md:188 ../../source/ref-changelog.md:220
-#: ../../source/ref-changelog.md:324 ../../source/ref-changelog.md:422
-#: ../../source/ref-changelog.md:522 ../../source/ref-changelog.md:586
-#: ../../source/ref-changelog.md:679 ../../source/ref-changelog.md:779
-#: ../../source/ref-changelog.md:863 ../../source/ref-changelog.md:927
-#: ../../source/ref-changelog.md:985
+#: ../../source/ref-changelog.md:17
 msgid ""
-"We would like to give our special thanks to all the contributors who made"
-" the new version of Flower possible (in `git shortlog` order):"
+"**Improve FAB build and install** "
+"([#4571](https://github.com/adap/flower/pull/4571))"
 msgstr ""
 
 #: ../../source/ref-changelog.md:19
 msgid ""
+"An updated FAB build and install process produces smaller FAB files and "
+"doesn't rely on `pip install` any more. It also resolves an issue where "
+"all files were unnecessarily included in the FAB file. The `flwr` CLI "
+"commands now correctly pack only the necessary files, such as `.md`, "
+"`.toml` and `.py`, ensuring more efficient and accurate packaging."
+msgstr ""
+
+#: ../../source/ref-changelog.md:21
+msgid ""
+"**Update** `embedded-devices` **example** "
+"([#4381](https://github.com/adap/flower/pull/4381))"
+msgstr ""
+
+#: ../../source/ref-changelog.md:23
+msgid "The example now uses the `flwr run` command and the Deployment Engine."
+msgstr ""
+
+#: ../../source/ref-changelog.md:25
+msgid ""
+"**Update Documentation** "
+"([#4566](https://github.com/adap/flower/pull/4566), "
+"[#4569](https://github.com/adap/flower/pull/4569), "
+"[#4560](https://github.com/adap/flower/pull/4560), "
+"[#4556](https://github.com/adap/flower/pull/4556), "
+"[#4581](https://github.com/adap/flower/pull/4581), "
+"[#4537](https://github.com/adap/flower/pull/4537), "
+"[#4562](https://github.com/adap/flower/pull/4562), "
+"[#4582](https://github.com/adap/flower/pull/4582))"
+msgstr ""
+
+#: ../../source/ref-changelog.md:27
+msgid ""
+"Enhanced documentation across various aspects, including updates to "
+"translation workflows, Docker-related READMEs, and recommended datasets. "
+"Improvements also include formatting fixes for dataset partitioning docs "
+"and better references to resources in the datasets documentation index."
+msgstr ""
+
+#: ../../source/ref-changelog.md:29
+msgid ""
+"**Update Infrastructure and CI/CD** "
+"([#4577](https://github.com/adap/flower/pull/4577), "
+"[#4578](https://github.com/adap/flower/pull/4578), "
+"[#4558](https://github.com/adap/flower/pull/4558), "
+"[#4551](https://github.com/adap/flower/pull/4551), "
+"[#3356](https://github.com/adap/flower/pull/3356), "
+"[#4559](https://github.com/adap/flower/pull/4559), "
+"[#4575](https://github.com/adap/flower/pull/4575))"
+msgstr ""
+
+#: ../../source/ref-changelog.md:31
+msgid ""
+"**General improvements** "
+"([#4557](https://github.com/adap/flower/pull/4557), "
+"[#4564](https://github.com/adap/flower/pull/4564), "
+"[#4573](https://github.com/adap/flower/pull/4573), "
+"[#4561](https://github.com/adap/flower/pull/4561), "
+"[#4579](https://github.com/adap/flower/pull/4579), "
+"[#4572](https://github.com/adap/flower/pull/4572))"
+msgstr ""
+
+#: ../../source/ref-changelog.md:33 ../../source/ref-changelog.md:102
+#: ../../source/ref-changelog.md:198 ../../source/ref-changelog.md:301
+#: ../../source/ref-changelog.md:408
+msgid ""
+"As always, many parts of the Flower framework and quality infrastructure "
+"were improved and updated."
+msgstr ""
+
+#: ../../source/ref-changelog.md:35
+msgid "v1.13.0 (2024-11-20)"
+msgstr ""
+
+#: ../../source/ref-changelog.md:41
+msgid ""
 "`Adam Narozniak`, `Charles Beauville`, `Chong Shen Ng`, `Daniel J. "
 "Beutel`, `Daniel Nata Nugraha`, `Dimitris Stripelis`, `Heng Pan`, "
 "`Javier`, `Mohammad Naseri`, `Robert Steiner`, `Waris Gill`, `William "
 "Lindskog`, `Yan Gao`, `Yao Xu`, `wwjang` <!---TOKEN_v1.13.0-->"
 msgstr ""
 
-#: ../../source/ref-changelog.md:23
+#: ../../source/ref-changelog.md:45
 msgid ""
 "**Introduce `flwr ls` command** "
 "([#4460](https://github.com/adap/flower/pull/4460), "
@@ -15449,30 +15525,30 @@ msgid ""
 "[#4477](https://github.com/adap/flower/pull/4477))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:25
+#: ../../source/ref-changelog.md:47
 msgid ""
 "The `flwr ls` command is now available to display details about all runs "
 "(or one specific run). It supports the following usage options:"
 msgstr ""
 
-#: ../../source/ref-changelog.md:27
+#: ../../source/ref-changelog.md:49
 msgid "`flwr ls --runs [<app>] [<federation>]`: Lists all runs."
 msgstr ""
 
-#: ../../source/ref-changelog.md:28
+#: ../../source/ref-changelog.md:50
 msgid ""
 "`flwr ls --run-id <run-id> [<app>] [<federation>]`: Displays details for "
 "a specific run."
 msgstr ""
 
-#: ../../source/ref-changelog.md:30
+#: ../../source/ref-changelog.md:52
 msgid ""
 "This command provides information including the run ID, FAB ID and "
 "version, run status, elapsed time, and timestamps for when the run was "
 "created, started running, and finished."
 msgstr ""
 
-#: ../../source/ref-changelog.md:32
+#: ../../source/ref-changelog.md:54
 msgid ""
 "**Fuse SuperLink and SuperExec** "
 "([#4358](https://github.com/adap/flower/pull/4358), "
@@ -15486,7 +15562,7 @@ msgid ""
 "[#4352](https://github.com/adap/flower/pull/4352))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:34
+#: ../../source/ref-changelog.md:56
 msgid ""
 "SuperExec has been integrated into SuperLink, enabling SuperLink to "
 "directly manage ServerApp processes (`flwr-serverapp`). The `flwr` CLI "
@@ -15496,7 +15572,7 @@ msgid ""
 "{subprocess,process}` flag."
 msgstr ""
 
-#: ../../source/ref-changelog.md:36
+#: ../../source/ref-changelog.md:58
 msgid ""
 "**Introduce `flwr-serverapp` command** "
 "([#4394](https://github.com/adap/flower/pull/4394), "
@@ -15511,7 +15587,7 @@ msgid ""
 "[#4402](https://github.com/adap/flower/pull/4402))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:38
+#: ../../source/ref-changelog.md:60
 msgid ""
 "The `flwr-serverapp` command has been introduced as a CLI entry point "
 "that runs a `ServerApp` process. This process communicates with SuperLink"
@@ -15519,7 +15595,7 @@ msgid ""
 "and more flexible deployment."
 msgstr ""
 
-#: ../../source/ref-changelog.md:40
+#: ../../source/ref-changelog.md:62
 msgid ""
 "**Improve simulation engine and introduce `flwr-simulation` command** "
 "([#4433](https://github.com/adap/flower/pull/4433), "
@@ -15532,7 +15608,7 @@ msgid ""
 "[#4462](https://github.com/adap/flower/pull/4462))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:42
+#: ../../source/ref-changelog.md:64
 msgid ""
 "The simulation engine has been significantly improved, resulting in "
 "dramatically faster simulations. Additionally, the `flwr-simulation` "
@@ -15540,14 +15616,14 @@ msgid ""
 "dedicated entry point for running simulations."
 msgstr ""
 
-#: ../../source/ref-changelog.md:44
+#: ../../source/ref-changelog.md:66
 msgid ""
 "**Improve SuperLink message management** "
 "([#4378](https://github.com/adap/flower/pull/4378), "
 "[#4369](https://github.com/adap/flower/pull/4369))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:46
+#: ../../source/ref-changelog.md:68
 msgid ""
 "SuperLink now validates the destination node ID of instruction messages "
 "and checks the TTL (time-to-live) for reply messages. When pulling reply "
@@ -15556,13 +15632,13 @@ msgid ""
 "reply message exists but has expired."
 msgstr ""
 
-#: ../../source/ref-changelog.md:48
+#: ../../source/ref-changelog.md:70
 msgid ""
 "**Introduce FedDebug baseline** "
 "([#3783](https://github.com/adap/flower/pull/3783))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:50
+#: ../../source/ref-changelog.md:72
 msgid ""
 "FedDebug is a framework that enhances debugging in Federated Learning by "
 "enabling interactive inspection of the training process and automatically"
@@ -15572,7 +15648,7 @@ msgid ""
 "documentation](https://flower.ai/docs/baselines/feddebug.html)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:52
+#: ../../source/ref-changelog.md:74
 msgid ""
 "**Update documentation** "
 "([#4511](https://github.com/adap/flower/pull/4511), "
@@ -15617,7 +15693,7 @@ msgid ""
 "[#4533](https://github.com/adap/flower/pull/4533))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:54
+#: ../../source/ref-changelog.md:76
 msgid ""
 "Many documentation pages and tutorials have been updated to improve "
 "clarity, fix typos, incorporate user feedback, and stay aligned with the "
@@ -15631,7 +15707,7 @@ msgid ""
 "aggregation-protocols.html) page has also been updated."
 msgstr ""
 
-#: ../../source/ref-changelog.md:56
+#: ../../source/ref-changelog.md:78
 msgid ""
 "**Update examples and templates** "
 "([#4510](https://github.com/adap/flower/pull/4510), "
@@ -15645,7 +15721,7 @@ msgid ""
 "[#4408](https://github.com/adap/flower/pull/4408))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:58
+#: ../../source/ref-changelog.md:80
 msgid ""
 "Multiple examples and templates have been updated to enhance usability "
 "and correctness. The updates include the `30-minute-tutorial`, "
@@ -15653,7 +15729,7 @@ msgid ""
 "and the FlowerTune template."
 msgstr ""
 
-#: ../../source/ref-changelog.md:60
+#: ../../source/ref-changelog.md:82
 msgid ""
 "**Improve Docker support** "
 "([#4506](https://github.com/adap/flower/pull/4506), "
@@ -15669,7 +15745,7 @@ msgid ""
 "[#4540](https://github.com/adap/flower/pull/4540))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:62
+#: ../../source/ref-changelog.md:84
 msgid ""
 "Docker images and configurations have been updated, including updating "
 "Docker Compose files to version 1.13.0, refactoring the Docker build "
@@ -15677,21 +15753,21 @@ msgid ""
 " 6.9.0, and improving Docker documentation."
 msgstr ""
 
-#: ../../source/ref-changelog.md:64
+#: ../../source/ref-changelog.md:86
 msgid ""
 "**Allow app installation without internet access** "
 "([#4479](https://github.com/adap/flower/pull/4479), "
 "[#4475](https://github.com/adap/flower/pull/4475))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:66
+#: ../../source/ref-changelog.md:88
 msgid ""
 "The `flwr build` command now includes a wheel file in the FAB, enabling "
 "Flower app installation in environments without internet access via `flwr"
 " install`."
 msgstr ""
 
-#: ../../source/ref-changelog.md:68
+#: ../../source/ref-changelog.md:90
 msgid ""
 "**Improve `flwr log` command** "
 "([#4391](https://github.com/adap/flower/pull/4391), "
@@ -15700,7 +15776,7 @@ msgid ""
 "[#4397](https://github.com/adap/flower/pull/4397))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:70
+#: ../../source/ref-changelog.md:92
 msgid ""
 "**Refactor SuperNode for better maintainability and efficiency** "
 "([#4439](https://github.com/adap/flower/pull/4439), "
@@ -15709,13 +15785,13 @@ msgid ""
 "[#4485](https://github.com/adap/flower/pull/4485))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:72
+#: ../../source/ref-changelog.md:94
 msgid ""
 "**Support NumPy `2.0`** "
 "([#4440](https://github.com/adap/flower/pull/4440))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:74
+#: ../../source/ref-changelog.md:96
 msgid ""
 "**Update infrastructure and CI/CD** "
 "([#4466](https://github.com/adap/flower/pull/4466), "
@@ -15727,7 +15803,7 @@ msgid ""
 "[#4415](https://github.com/adap/flower/pull/4415))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:76
+#: ../../source/ref-changelog.md:98
 msgid ""
 "**Bugfixes** ([#4404](https://github.com/adap/flower/pull/4404), "
 "[#4518](https://github.com/adap/flower/pull/4518), "
@@ -15741,7 +15817,7 @@ msgid ""
 "[#4515](https://github.com/adap/flower/pull/4515))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:78
+#: ../../source/ref-changelog.md:100
 msgid ""
 "**General improvements** "
 "([#4454](https://github.com/adap/flower/pull/4454), "
@@ -15797,24 +15873,17 @@ msgid ""
 "[#4481](https://github.com/adap/flower/pull/4481))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:80 ../../source/ref-changelog.md:176
-#: ../../source/ref-changelog.md:279 ../../source/ref-changelog.md:386
-msgid ""
-"As always, many parts of the Flower framework and quality infrastructure "
-"were improved and updated."
-msgstr ""
-
-#: ../../source/ref-changelog.md:82 ../../source/ref-changelog.md:281
-#: ../../source/ref-changelog.md:398 ../../source/ref-changelog.md:490
-#: ../../source/ref-changelog.md:1473
+#: ../../source/ref-changelog.md:104 ../../source/ref-changelog.md:303
+#: ../../source/ref-changelog.md:420 ../../source/ref-changelog.md:512
+#: ../../source/ref-changelog.md:1495
 msgid "Deprecations"
 msgstr ""
 
-#: ../../source/ref-changelog.md:84
+#: ../../source/ref-changelog.md:106
 msgid "**Deprecate Python 3.9**"
 msgstr ""
 
-#: ../../source/ref-changelog.md:86
+#: ../../source/ref-changelog.md:108
 msgid ""
 "Flower is deprecating support for Python 3.9 as several of its "
 "dependencies are phasing out compatibility with this version. While no "
@@ -15822,13 +15891,26 @@ msgid ""
 "upgrading to a supported Python version."
 msgstr ""
 
-#: ../../source/ref-changelog.md:90
+#: ../../source/ref-changelog.md:110 ../../source/ref-changelog.md:200
+#: ../../source/ref-changelog.md:234 ../../source/ref-changelog.md:314
+#: ../../source/ref-changelog.md:430 ../../source/ref-changelog.md:526
+#: ../../source/ref-changelog.md:600 ../../source/ref-changelog.md:675
+#: ../../source/ref-changelog.md:787 ../../source/ref-changelog.md:877
+#: ../../source/ref-changelog.md:941 ../../source/ref-changelog.md:999
+#: ../../source/ref-changelog.md:1068 ../../source/ref-changelog.md:1130
+#: ../../source/ref-changelog.md:1149 ../../source/ref-changelog.md:1305
+#: ../../source/ref-changelog.md:1376 ../../source/ref-changelog.md:1413
+#: ../../source/ref-changelog.md:1456
+msgid "Incompatible changes"
+msgstr ""
+
+#: ../../source/ref-changelog.md:112
 msgid ""
 "**Remove `flower-superexec` command** "
 "([#4351](https://github.com/adap/flower/pull/4351))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:92
+#: ../../source/ref-changelog.md:114
 msgid ""
 "The `flower-superexec` command, previously used to launch SuperExec, is "
 "no longer functional as SuperExec has been merged into SuperLink. "
@@ -15836,63 +15918,63 @@ msgid ""
 " initiated."
 msgstr ""
 
-#: ../../source/ref-changelog.md:94
+#: ../../source/ref-changelog.md:116
 msgid ""
 "**Remove `flower-server-app` command** "
 "([#4490](https://github.com/adap/flower/pull/4490))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:96
+#: ../../source/ref-changelog.md:118
 msgid ""
 "The `flower-server-app` command has been removed. To start a Flower app, "
 "please use the `flwr run` command instead."
 msgstr ""
 
-#: ../../source/ref-changelog.md:98
+#: ../../source/ref-changelog.md:120
 msgid ""
 "**Remove `app` argument from `flower-supernode` command** "
 "([#4497](https://github.com/adap/flower/pull/4497))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:100
+#: ../../source/ref-changelog.md:122
 msgid ""
 "The usage of `flower-supernode <app-dir>` has been removed. SuperNode "
 "will now load the FAB delivered by SuperLink, and it is no longer "
 "possible to directly specify an app directory."
 msgstr ""
 
-#: ../../source/ref-changelog.md:102
+#: ../../source/ref-changelog.md:124
 msgid ""
 "**Remove support for non-app simulations** "
 "([#4431](https://github.com/adap/flower/pull/4431))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:104
+#: ../../source/ref-changelog.md:126
 msgid ""
 "The simulation engine (via `flower-simulation`) now exclusively supports "
 "passing an app."
 msgstr ""
 
-#: ../../source/ref-changelog.md:106
+#: ../../source/ref-changelog.md:128
 msgid ""
 "**Rename CLI arguments for `flower-superlink` command** "
 "([#4412](https://github.com/adap/flower/pull/4412))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:108
+#: ../../source/ref-changelog.md:130
 msgid ""
 "The `--driver-api-address` argument has been renamed to `--serverappio-"
 "api-address` in the `flower-superlink` command to reflect the renaming of"
 " the `Driver` service to the `ServerAppIo` service."
 msgstr ""
 
-#: ../../source/ref-changelog.md:110
+#: ../../source/ref-changelog.md:132
 msgid ""
 "**Rename CLI arguments for `flwr-serverapp` and `flwr-clientapp` "
 "commands** ([#4495](https://github.com/adap/flower/pull/4495))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:112
+#: ../../source/ref-changelog.md:134
 msgid ""
 "The CLI arguments have been renamed for clarity and consistency. "
 "Specifically, `--superlink` for `flwr-serverapp` is now `--serverappio-"
@@ -15900,11 +15982,11 @@ msgid ""
 "`--clientappio-api-address`."
 msgstr ""
 
-#: ../../source/ref-changelog.md:114
+#: ../../source/ref-changelog.md:136
 msgid "v1.12.0 (2024-10-14)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:120
+#: ../../source/ref-changelog.md:142
 msgid ""
 "`Adam Narozniak`, `Audris`, `Charles Beauville`, `Chong Shen Ng`, `Daniel"
 " J. Beutel`, `Daniel Nata Nugraha`, `Heng Pan`, `Javier`, `Jiahao Tan`, "
@@ -15912,7 +15994,7 @@ msgid ""
 "Gao`, `xiliguguagua` <!---TOKEN_v1.12.0-->"
 msgstr ""
 
-#: ../../source/ref-changelog.md:124
+#: ../../source/ref-changelog.md:146
 msgid ""
 "**Introduce SuperExec log streaming** "
 "([#3577](https://github.com/adap/flower/pull/3577), "
@@ -15922,7 +16004,7 @@ msgid ""
 "[#3613](https://github.com/adap/flower/pull/3613))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:126
+#: ../../source/ref-changelog.md:148
 msgid ""
 "Flower now supports log streaming from a remote SuperExec using the `flwr"
 " log` command. This new feature allows you to monitor logs from SuperExec"
@@ -15930,7 +16012,7 @@ msgid ""
 "<federation>`)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:128
+#: ../../source/ref-changelog.md:150
 msgid ""
 "**Improve `flwr new` templates** "
 "([#4291](https://github.com/adap/flower/pull/4291), "
@@ -15940,14 +16022,14 @@ msgid ""
 "[#4295](https://github.com/adap/flower/pull/4295))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:130
+#: ../../source/ref-changelog.md:152
 msgid ""
 "The `flwr new` command templates for MLX, NumPy, sklearn, JAX, and "
 "PyTorch have been updated to improve usability and consistency across "
 "frameworks."
 msgstr ""
 
-#: ../../source/ref-changelog.md:132
+#: ../../source/ref-changelog.md:154
 msgid ""
 "**Migrate ID handling to use unsigned 64-bit integers** "
 "([#4170](https://github.com/adap/flower/pull/4170), "
@@ -15955,7 +16037,7 @@ msgid ""
 "[#4243](https://github.com/adap/flower/pull/4243))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:134
+#: ../../source/ref-changelog.md:156
 msgid ""
 "Node IDs, run IDs, and related fields have been migrated from signed "
 "64-bit integers (`sint64`) to unsigned 64-bit integers (`uint64`). To "
@@ -15966,13 +16048,13 @@ msgid ""
 "`uint64`."
 msgstr ""
 
-#: ../../source/ref-changelog.md:136
+#: ../../source/ref-changelog.md:158
 msgid ""
 "**Add Flower architecture explanation** "
 "([#3270](https://github.com/adap/flower/pull/3270))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:138
+#: ../../source/ref-changelog.md:160
 msgid ""
 "A new [Flower architecture explainer](https://flower.ai/docs/framework"
 "/explanation-flower-architecture.html) page introduces Flower components "
@@ -15980,13 +16062,13 @@ msgid ""
 "documentation if you're interested."
 msgstr ""
 
-#: ../../source/ref-changelog.md:140
+#: ../../source/ref-changelog.md:162
 msgid ""
 "**Introduce FedRep baseline** "
 "([#3790](https://github.com/adap/flower/pull/3790))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:142
+#: ../../source/ref-changelog.md:164
 msgid ""
 "FedRep is a federated learning algorithm that learns shared data "
 "representations across clients while allowing each to maintain "
@@ -15996,7 +16078,7 @@ msgid ""
 "([arxiv](https://arxiv.org/abs/2102.07078))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:144
+#: ../../source/ref-changelog.md:166
 msgid ""
 "**Improve FlowerTune template and LLM evaluation pipelines** "
 "([#4286](https://github.com/adap/flower/pull/4286), "
@@ -16017,7 +16099,7 @@ msgid ""
 "[#4327](https://github.com/adap/flower/pull/4327))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:146
+#: ../../source/ref-changelog.md:168
 msgid ""
 "Refined evaluation pipelines, metrics, and documentation for the upcoming"
 " FlowerTune LLM Leaderboard across multiple domains including Finance, "
@@ -16026,7 +16108,7 @@ msgid ""
 "exciting challenge!"
 msgstr ""
 
-#: ../../source/ref-changelog.md:148
+#: ../../source/ref-changelog.md:170
 msgid ""
 "**Enhance Docker Support and Documentation** "
 "([#4191](https://github.com/adap/flower/pull/4191), "
@@ -16045,7 +16127,7 @@ msgid ""
 "[#4226](https://github.com/adap/flower/pull/4226))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:150
+#: ../../source/ref-changelog.md:172
 msgid ""
 "Upgraded Ubuntu base image to 24.04, added SBOM and gcc to Docker images,"
 " and comprehensively updated [Docker "
@@ -16053,14 +16135,14 @@ msgid ""
 "including quickstart guides and distributed Docker Compose instructions."
 msgstr ""
 
-#: ../../source/ref-changelog.md:152
+#: ../../source/ref-changelog.md:174
 msgid ""
 "**Introduce Flower glossary** "
 "([#4165](https://github.com/adap/flower/pull/4165), "
 "[#4235](https://github.com/adap/flower/pull/4235))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:154
+#: ../../source/ref-changelog.md:176
 msgid ""
 "Added the [Federated Learning glossary](https://flower.ai/glossary/) to "
 "the Flower repository, located under the `flower/glossary/` directory. "
@@ -16070,7 +16152,7 @@ msgid ""
 "become a Flower contributor!"
 msgstr ""
 
-#: ../../source/ref-changelog.md:156
+#: ../../source/ref-changelog.md:178
 msgid ""
 "**Implement Message Time-to-Live (TTL)** "
 "([#3620](https://github.com/adap/flower/pull/3620), "
@@ -16080,7 +16162,7 @@ msgid ""
 "[#3635](https://github.com/adap/flower/pull/3635))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:158
+#: ../../source/ref-changelog.md:180
 msgid ""
 "Added comprehensive TTL support for messages in Flower's SuperLink. "
 "Messages are now automatically expired and cleaned up based on "
@@ -16088,7 +16170,7 @@ msgid ""
 " default in the high-level API)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:160
+#: ../../source/ref-changelog.md:182
 msgid ""
 "**Improve FAB handling** "
 "([#4303](https://github.com/adap/flower/pull/4303), "
@@ -16097,14 +16179,14 @@ msgid ""
 "[#4304](https://github.com/adap/flower/pull/4304))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:162
+#: ../../source/ref-changelog.md:184
 msgid ""
 "An 8-character hash is now appended to the FAB file name. The `flwr "
 "install` command installs FABs with a more flattened folder structure, "
 "reducing it from 3 levels to 1."
 msgstr ""
 
-#: ../../source/ref-changelog.md:164
+#: ../../source/ref-changelog.md:186
 msgid ""
 "**Update documentation** "
 "([#3341](https://github.com/adap/flower/pull/3341), "
@@ -16115,7 +16197,7 @@ msgid ""
 "[#3993](https://github.com/adap/flower/pull/3993))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:166
+#: ../../source/ref-changelog.md:188
 msgid ""
 "Updated quickstart tutorials (PyTorch Lightning, TensorFlow, Hugging "
 "Face, Fastai) to use the new `flwr run` command and removed default title"
@@ -16123,7 +16205,7 @@ msgid ""
 "added to FAQ."
 msgstr ""
 
-#: ../../source/ref-changelog.md:168
+#: ../../source/ref-changelog.md:190
 msgid ""
 "**Update example projects** "
 "([#3716](https://github.com/adap/flower/pull/3716), "
@@ -16136,7 +16218,7 @@ msgid ""
 "[#4331](https://github.com/adap/flower/pull/4331))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:170
+#: ../../source/ref-changelog.md:192
 msgid ""
 "Refreshed multiple example projects including vertical FL, PyTorch "
 "(advanced), Pandas, Secure Aggregation, and XGBoost examples. Optimized "
@@ -16144,7 +16226,7 @@ msgid ""
 "simulation examples."
 msgstr ""
 
-#: ../../source/ref-changelog.md:172
+#: ../../source/ref-changelog.md:194
 msgid ""
 "**Update translations** "
 "([#4070](https://github.com/adap/flower/pull/4070), "
@@ -16156,7 +16238,7 @@ msgid ""
 "[#4259](https://github.com/adap/flower/pull/4259))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:174
+#: ../../source/ref-changelog.md:196
 msgid ""
 "**General improvements** "
 "([#4239](https://github.com/adap/flower/pull/4239), "
@@ -16203,7 +16285,7 @@ msgid ""
 "[#4333](https://github.com/adap/flower/pull/4333))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:180
+#: ../../source/ref-changelog.md:202
 msgid ""
 "**Drop Python 3.8 support and update minimum version to 3.9** "
 "([#4180](https://github.com/adap/flower/pull/4180), "
@@ -16216,7 +16298,7 @@ msgid ""
 "[#4194](https://github.com/adap/flower/pull/4194))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:182
+#: ../../source/ref-changelog.md:204
 msgid ""
 "Python 3.8 support was deprecated in Flower 1.9, and this release removes"
 " support. Flower now requires Python 3.9 or later (Python 3.11 is "
@@ -16224,79 +16306,79 @@ msgid ""
 "minimum supported version. Flower now supports Python 3.9 to 3.12."
 msgstr ""
 
-#: ../../source/ref-changelog.md:184
+#: ../../source/ref-changelog.md:206
 msgid "v1.11.1 (2024-09-11)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:190
+#: ../../source/ref-changelog.md:212
 msgid ""
 "`Charles Beauville`, `Chong Shen Ng`, `Daniel J. Beutel`, `Heng Pan`, "
 "`Javier`, `Robert Steiner`, `Yan Gao` <!---TOKEN_v1.11.1-->"
 msgstr ""
 
-#: ../../source/ref-changelog.md:192
+#: ../../source/ref-changelog.md:214
 msgid "Improvements"
 msgstr ""
 
-#: ../../source/ref-changelog.md:194
+#: ../../source/ref-changelog.md:216
 msgid ""
 "**Implement** `keys/values/items` **methods for** `TypedDict` "
 "([#4146](https://github.com/adap/flower/pull/4146))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:196
+#: ../../source/ref-changelog.md:218
 msgid ""
 "**Fix parsing of** `--executor-config` **if present** "
 "([#4125](https://github.com/adap/flower/pull/4125))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:198
+#: ../../source/ref-changelog.md:220
 msgid ""
 "**Adjust framework name in templates docstrings** "
 "([#4127](https://github.com/adap/flower/pull/4127))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:200
+#: ../../source/ref-changelog.md:222
 msgid ""
 "**Update** `flwr new` **Hugging Face template** "
 "([#4169](https://github.com/adap/flower/pull/4169))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:202
+#: ../../source/ref-changelog.md:224
 msgid ""
 "**Fix** `flwr new` **FlowerTune template** "
 "([#4123](https://github.com/adap/flower/pull/4123))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:204
+#: ../../source/ref-changelog.md:226
 msgid ""
 "**Add buffer time after** `ServerApp` **thread initialization** "
 "([#4119](https://github.com/adap/flower/pull/4119))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:206
+#: ../../source/ref-changelog.md:228
 msgid ""
 "**Handle unsuitable resources for simulation** "
 "([#4143](https://github.com/adap/flower/pull/4143))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:208
+#: ../../source/ref-changelog.md:230
 msgid ""
 "**Update example READMEs** "
 "([#4117](https://github.com/adap/flower/pull/4117))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:210
+#: ../../source/ref-changelog.md:232
 msgid ""
 "**Update SuperNode authentication docs** "
 "([#4160](https://github.com/adap/flower/pull/4160))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:216
+#: ../../source/ref-changelog.md:238
 msgid "v1.11.0 (2024-08-30)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:222
+#: ../../source/ref-changelog.md:244
 msgid ""
 "`Adam Narozniak`, `Charles Beauville`, `Chong Shen Ng`, `Daniel J. "
 "Beutel`, `Daniel Nata Nugraha`, `Danny`, `Edoardo Gabrielli`, `Heng Pan`,"
@@ -16305,7 +16387,7 @@ msgid ""
 "TOKEN_v1.11.0-->"
 msgstr ""
 
-#: ../../source/ref-changelog.md:226
+#: ../../source/ref-changelog.md:248
 msgid ""
 "**Deliver Flower App Bundle (FAB) to SuperLink and SuperNodes** "
 "([#4006](https://github.com/adap/flower/pull/4006), "
@@ -16332,14 +16414,14 @@ msgid ""
 "[#3619](https://github.com/adap/flower/pull/3619))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:228
+#: ../../source/ref-changelog.md:250
 msgid ""
 "Dynamic code updates are here! `flwr run` can now ship and install the "
 "latest version of your `ServerApp` and `ClientApp` to an already-running "
 "federation (SuperLink and SuperNodes)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:230
+#: ../../source/ref-changelog.md:252
 msgid ""
 "How does it work? `flwr run` bundles your Flower app into a single FAB "
 "(Flower App Bundle) file. It then ships this FAB file, via the SuperExec,"
@@ -16349,11 +16431,11 @@ msgid ""
 "projects!) dynamically."
 msgstr ""
 
-#: ../../source/ref-changelog.md:232
+#: ../../source/ref-changelog.md:254
 msgid "`flwr run` is all you need."
 msgstr ""
 
-#: ../../source/ref-changelog.md:234
+#: ../../source/ref-changelog.md:256
 msgid ""
 "**Introduce isolated** `ClientApp` **execution** "
 "([#3970](https://github.com/adap/flower/pull/3970), "
@@ -16373,30 +16455,30 @@ msgid ""
 "[#4032](https://github.com/adap/flower/pull/4032))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:236
+#: ../../source/ref-changelog.md:258
 msgid ""
 "The SuperNode can now run your `ClientApp` in a fully isolated way. In an"
 " enterprise deployment, this allows you to set strict limits on what the "
 "`ClientApp` can and cannot do."
 msgstr ""
 
-#: ../../source/ref-changelog.md:238
+#: ../../source/ref-changelog.md:260
 msgid "`flower-supernode` supports three `--isolation` modes:"
 msgstr ""
 
-#: ../../source/ref-changelog.md:240
+#: ../../source/ref-changelog.md:262
 msgid ""
 "Unset: The SuperNode runs the `ClientApp` in the same process (as in "
 "previous versions of Flower). This is the default mode."
 msgstr ""
 
-#: ../../source/ref-changelog.md:241
+#: ../../source/ref-changelog.md:263
 msgid ""
 "`--isolation=subprocess`: The SuperNode starts a subprocess to run the "
 "`ClientApp`."
 msgstr ""
 
-#: ../../source/ref-changelog.md:242
+#: ../../source/ref-changelog.md:264
 msgid ""
 "`--isolation=process`: The SuperNode expects an externally-managed "
 "process to run the `ClientApp`. This external process is not managed by "
@@ -16405,7 +16487,7 @@ msgid ""
 "`flwr/clientapp` Docker image."
 msgstr ""
 
-#: ../../source/ref-changelog.md:244
+#: ../../source/ref-changelog.md:266
 msgid ""
 "**Improve Docker support for enterprise deployments** "
 "([#4050](https://github.com/adap/flower/pull/4050), "
@@ -16416,17 +16498,17 @@ msgid ""
 "[#3722](https://github.com/adap/flower/pull/3722))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:246
+#: ../../source/ref-changelog.md:268
 msgid ""
 "Flower 1.11 ships many Docker improvements that are especially useful for"
 " enterprise deployments:"
 msgstr ""
 
-#: ../../source/ref-changelog.md:248
+#: ../../source/ref-changelog.md:270
 msgid "`flwr/supernode` comes with a new Alpine Docker image."
 msgstr ""
 
-#: ../../source/ref-changelog.md:249
+#: ../../source/ref-changelog.md:271
 msgid ""
 "`flwr/clientapp` is a new image to be used with the `--isolation=process`"
 " option. In this mode, SuperNode and `ClientApp` run in two different "
@@ -16436,19 +16518,19 @@ msgid ""
 "enterprise settings."
 msgstr ""
 
-#: ../../source/ref-changelog.md:250
+#: ../../source/ref-changelog.md:272
 msgid ""
 "New all-in-one Docker Compose enables you to easily start a full Flower "
 "Deployment Engine on a single machine."
 msgstr ""
 
-#: ../../source/ref-changelog.md:251
+#: ../../source/ref-changelog.md:273
 msgid ""
 "Completely new Docker documentation: "
 "https://flower.ai/docs/framework/docker/index.html"
 msgstr ""
 
-#: ../../source/ref-changelog.md:253
+#: ../../source/ref-changelog.md:275
 msgid ""
 "**Improve SuperNode authentication** "
 "([#4043](https://github.com/adap/flower/pull/4043), "
@@ -16456,13 +16538,13 @@ msgid ""
 "[#4074](https://github.com/adap/flower/pull/4074))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:255
+#: ../../source/ref-changelog.md:277
 msgid ""
 "SuperNode auth has been improved in several ways, including improved "
 "logging, improved testing, and improved error handling."
 msgstr ""
 
-#: ../../source/ref-changelog.md:257
+#: ../../source/ref-changelog.md:279
 msgid ""
 "**Update** `flwr new` **templates** "
 "([#3933](https://github.com/adap/flower/pull/3933), "
@@ -16476,13 +16558,13 @@ msgid ""
 "[#4064](https://github.com/adap/flower/pull/4064))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:259
+#: ../../source/ref-changelog.md:281
 msgid ""
 "All `flwr new` templates have been updated to show the latest recommended"
 " use of Flower APIs."
 msgstr ""
 
-#: ../../source/ref-changelog.md:261
+#: ../../source/ref-changelog.md:283
 msgid ""
 "**Improve Simulation Engine** "
 "([#4095](https://github.com/adap/flower/pull/4095), "
@@ -16494,14 +16576,14 @@ msgid ""
 "[#3988](https://github.com/adap/flower/pull/3988))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:263
+#: ../../source/ref-changelog.md:285
 msgid ""
 "The Flower Simulation Engine comes with several updates, including "
 "improved run config support, verbose logging, simulation backend "
 "configuration via `flwr run`, and more."
 msgstr ""
 
-#: ../../source/ref-changelog.md:265
+#: ../../source/ref-changelog.md:287
 msgid ""
 "**Improve** `RecordSet` "
 "([#4052](https://github.com/adap/flower/pull/4052), "
@@ -16509,7 +16591,7 @@ msgid ""
 "[#4016](https://github.com/adap/flower/pull/4016))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:267
+#: ../../source/ref-changelog.md:289
 msgid ""
 "`RecordSet` is the core object to exchange model parameters, "
 "configuration values and metrics between `ClientApp` and `ServerApp`. "
@@ -16517,7 +16599,7 @@ msgid ""
 "related `*Record` types."
 msgstr ""
 
-#: ../../source/ref-changelog.md:269
+#: ../../source/ref-changelog.md:291
 msgid ""
 "**Update documentation** "
 "([#3972](https://github.com/adap/flower/pull/3972), "
@@ -16536,14 +16618,14 @@ msgid ""
 "[#3916](https://github.com/adap/flower/pull/3916))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:271
+#: ../../source/ref-changelog.md:293
 msgid ""
 "Many parts of the documentation, including the main tutorial, have been "
 "migrated to show new Flower APIs and other new Flower features like the "
 "improved Docker support."
 msgstr ""
 
-#: ../../source/ref-changelog.md:273
+#: ../../source/ref-changelog.md:295
 msgid ""
 "**Migrate code example to use new Flower APIs** "
 "([#3758](https://github.com/adap/flower/pull/3758), "
@@ -16569,11 +16651,11 @@ msgid ""
 "[#3313](https://github.com/adap/flower/pull/3313))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:275
+#: ../../source/ref-changelog.md:297
 msgid "Many code examples have been migrated to use new Flower APIs."
 msgstr ""
 
-#: ../../source/ref-changelog.md:277
+#: ../../source/ref-changelog.md:299
 msgid ""
 "**Update Flower framework, framework internals and quality "
 "infrastructure** ([#4018](https://github.com/adap/flower/pull/4018), "
@@ -16615,13 +16697,13 @@ msgid ""
 "[#4038](https://github.com/adap/flower/pull/4038))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:283
+#: ../../source/ref-changelog.md:305
 msgid ""
 "**Deprecate accessing `Context` via `Client.context`** "
 "([#3797](https://github.com/adap/flower/pull/3797))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:285
+#: ../../source/ref-changelog.md:307
 msgid ""
 "Now that both `client_fn` and `server_fn` receive a `Context` object, "
 "accessing `Context` via `Client.context` is deprecated. `Client.context` "
@@ -16630,7 +16712,7 @@ msgid ""
 " instance in `client_fn`:"
 msgstr ""
 
-#: ../../source/ref-changelog.md:294
+#: ../../source/ref-changelog.md:316
 msgid ""
 "**Update CLIs to accept an app directory instead of** `ClientApp` **and**"
 " `ServerApp` ([#3952](https://github.com/adap/flower/pull/3952), "
@@ -16638,7 +16720,7 @@ msgid ""
 "[#3850](https://github.com/adap/flower/pull/3850))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:296
+#: ../../source/ref-changelog.md:318
 msgid ""
 "The CLI commands `flower-supernode` and `flower-server-app` now accept an"
 " app directory as argument (instead of references to a `ClientApp` or "
@@ -16648,49 +16730,49 @@ msgid ""
 "`flwr new`."
 msgstr ""
 
-#: ../../source/ref-changelog.md:298
+#: ../../source/ref-changelog.md:320
 msgid ""
 "**Disable** `flower-client-app` **CLI command** "
 "([#4022](https://github.com/adap/flower/pull/4022))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:300
+#: ../../source/ref-changelog.md:322
 msgid "`flower-client-app` has been disabled. Use `flower-supernode` instead."
 msgstr ""
 
-#: ../../source/ref-changelog.md:302
+#: ../../source/ref-changelog.md:324
 msgid ""
 "**Use spaces instead of commas for separating config args** "
 "([#4000](https://github.com/adap/flower/pull/4000))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:304
+#: ../../source/ref-changelog.md:326
 msgid ""
 "When passing configs (run config, node config) to Flower, you now need to"
 " separate key-value pairs using spaces instead of commas. For example:"
 msgstr ""
 
-#: ../../source/ref-changelog.md:310
+#: ../../source/ref-changelog.md:332
 msgid "Previously, you could pass configs using commas, like this:"
 msgstr ""
 
-#: ../../source/ref-changelog.md:316
+#: ../../source/ref-changelog.md:338
 msgid ""
 "**Remove** `flwr example` **CLI command** "
 "([#4084](https://github.com/adap/flower/pull/4084))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:318
+#: ../../source/ref-changelog.md:340
 msgid ""
 "The experimental `flwr example` CLI command has been removed. Use `flwr "
 "new` to generate a project and then run it using `flwr run`."
 msgstr ""
 
-#: ../../source/ref-changelog.md:320
+#: ../../source/ref-changelog.md:342
 msgid "v1.10.0 (2024-07-24)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:326
+#: ../../source/ref-changelog.md:348
 msgid ""
 "`Adam Narozniak`, `Charles Beauville`, `Chong Shen Ng`, `Daniel J. "
 "Beutel`, `Daniel Nata Nugraha`, `Danny`, `Gustavo Bertoli`, `Heng Pan`, "
@@ -16699,7 +16781,7 @@ msgid ""
 "---TOKEN_v1.10.0-->"
 msgstr ""
 
-#: ../../source/ref-changelog.md:330
+#: ../../source/ref-changelog.md:352
 msgid ""
 "**Introduce** `flwr run` **(beta)** "
 "([#3810](https://github.com/adap/flower/pull/3810), "
@@ -16713,7 +16795,7 @@ msgid ""
 "[#3819](https://github.com/adap/flower/pull/3819))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:332
+#: ../../source/ref-changelog.md:354
 msgid ""
 "Flower 1.10 ships the first beta release of the new `flwr run` command. "
 "`flwr run` can run different projects using `flwr run path/to/project`, "
@@ -16726,7 +16808,7 @@ msgid ""
 "`flwr new` to generate a project and then run it using `flwr run`."
 msgstr ""
 
-#: ../../source/ref-changelog.md:334
+#: ../../source/ref-changelog.md:356
 msgid ""
 "**Introduce run config** "
 "([#3751](https://github.com/adap/flower/pull/3751), "
@@ -16746,7 +16828,7 @@ msgid ""
 "[#3815](https://github.com/adap/flower/pull/3815))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:336
+#: ../../source/ref-changelog.md:358
 msgid ""
 "The new run config feature allows you to run your Flower project in "
 "different configurations without having to change a single line of code. "
@@ -16759,7 +16841,7 @@ msgid ""
 "new project using `flwr new` to see run config in action."
 msgstr ""
 
-#: ../../source/ref-changelog.md:338
+#: ../../source/ref-changelog.md:360
 msgid ""
 "**Generalize** `client_fn` **signature to** `client_fn(context: Context) "
 "-> Client` ([#3779](https://github.com/adap/flower/pull/3779), "
@@ -16768,7 +16850,7 @@ msgid ""
 "[#3696](https://github.com/adap/flower/pull/3696))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:340
+#: ../../source/ref-changelog.md:362
 msgid ""
 "The `client_fn` signature has been generalized to `client_fn(context: "
 "Context) -> Client`. It now receives a `Context` object instead of the "
@@ -16778,14 +16860,14 @@ msgid ""
 "system."
 msgstr ""
 
-#: ../../source/ref-changelog.md:342
+#: ../../source/ref-changelog.md:364
 msgid ""
 "The previous signature `client_fn(cid: str)` is now deprecated and "
 "support for it will be removed in a future release. Use "
 "`client_fn(context: Context) -> Client` everywhere."
 msgstr ""
 
-#: ../../source/ref-changelog.md:344
+#: ../../source/ref-changelog.md:366
 msgid ""
 "**Introduce new** `server_fn(context)` "
 "([#3773](https://github.com/adap/flower/pull/3773), "
@@ -16793,7 +16875,7 @@ msgid ""
 "[#3771](https://github.com/adap/flower/pull/3771))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:346
+#: ../../source/ref-changelog.md:368
 msgid ""
 "In addition to the new `client_fn(context:Context)`, a new "
 "`server_fn(context: Context) -> ServerAppComponents` can now be passed to"
@@ -16802,7 +16884,7 @@ msgid ""
 "build a configurable `ServerApp`."
 msgstr ""
 
-#: ../../source/ref-changelog.md:348
+#: ../../source/ref-changelog.md:370
 msgid ""
 "**Relaunch all** `flwr new` **templates** "
 "([#3877](https://github.com/adap/flower/pull/3877), "
@@ -16814,7 +16896,7 @@ msgid ""
 "[#3760](https://github.com/adap/flower/pull/3760))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:350
+#: ../../source/ref-changelog.md:372
 msgid ""
 "All `flwr new` templates have been significantly updated to showcase new "
 "Flower features and best practices. This includes using `flwr run` and "
@@ -16823,13 +16905,13 @@ msgid ""
 "run` it."
 msgstr ""
 
-#: ../../source/ref-changelog.md:352
+#: ../../source/ref-changelog.md:374
 msgid ""
 "**Introduce** `flower-supernode` **(preview)** "
 "([#3353](https://github.com/adap/flower/pull/3353))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:354
+#: ../../source/ref-changelog.md:376
 msgid ""
 "The new `flower-supernode` CLI is here to replace `flower-client-app`. "
 "`flower-supernode` brings full multi-app support to the Flower client-"
@@ -16838,7 +16920,7 @@ msgid ""
 "`client_fn(context: Context)` signature)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:356
+#: ../../source/ref-changelog.md:378
 msgid ""
 "**Introduce node config** "
 "([#3782](https://github.com/adap/flower/pull/3782), "
@@ -16847,7 +16929,7 @@ msgid ""
 "[#3886](https://github.com/adap/flower/pull/3886))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:358
+#: ../../source/ref-changelog.md:380
 msgid ""
 "A new node config feature allows you to pass a static configuration to "
 "the SuperNode. This configuration is read-only and available to every "
@@ -16855,7 +16937,7 @@ msgid ""
 "config via `Context` (`context.node_config`)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:360
+#: ../../source/ref-changelog.md:382
 msgid ""
 "**Introduce SuperExec (experimental)** "
 "([#3605](https://github.com/adap/flower/pull/3605), "
@@ -16876,26 +16958,26 @@ msgid ""
 "[#3629](https://github.com/adap/flower/pull/3629))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:362
+#: ../../source/ref-changelog.md:384
 msgid ""
 "This is the first experimental release of Flower SuperExec, a new service"
 " that executes your runs. It's not ready for production deployment just "
 "yet, but don't hesitate to give it a try if you're interested."
 msgstr ""
 
-#: ../../source/ref-changelog.md:364
+#: ../../source/ref-changelog.md:386
 msgid ""
 "**Add new federated learning with tabular data example** "
 "([#3568](https://github.com/adap/flower/pull/3568))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:366
+#: ../../source/ref-changelog.md:388
 msgid ""
 "A new code example exemplifies a federated learning setup using the "
 "Flower framework on the Adult Census Income tabular dataset."
 msgstr ""
 
-#: ../../source/ref-changelog.md:368
+#: ../../source/ref-changelog.md:390
 msgid ""
 "**Create generic adapter layer (preview)** "
 "([#3538](https://github.com/adap/flower/pull/3538), "
@@ -16903,7 +16985,7 @@ msgid ""
 "[#3540](https://github.com/adap/flower/pull/3540))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:370
+#: ../../source/ref-changelog.md:392
 msgid ""
 "A new generic gRPC adapter layer allows 3rd-party frameworks to integrate"
 " with Flower in a transparent way. This makes Flower more modular and "
@@ -16911,7 +16993,7 @@ msgid ""
 "platforms."
 msgstr ""
 
-#: ../../source/ref-changelog.md:372
+#: ../../source/ref-changelog.md:394
 msgid ""
 "**Refactor Flower Simulation Engine** "
 "([#3581](https://github.com/adap/flower/pull/3581), "
@@ -16927,7 +17009,7 @@ msgid ""
 "[#3469](https://github.com/adap/flower/pull/3469))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:374
+#: ../../source/ref-changelog.md:396
 msgid ""
 "The Simulation Engine was significantly refactored. This results in "
 "faster and more stable simulations. It is also the foundation for "
@@ -16935,31 +17017,31 @@ msgid ""
 "configurability in federated learning simulations."
 msgstr ""
 
-#: ../../source/ref-changelog.md:376
+#: ../../source/ref-changelog.md:398
 msgid ""
 "**Optimize Docker containers** "
 "([#3591](https://github.com/adap/flower/pull/3591))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:378
+#: ../../source/ref-changelog.md:400
 msgid ""
 "Flower Docker containers were optimized and updated to use that latest "
 "Flower framework features."
 msgstr ""
 
-#: ../../source/ref-changelog.md:380
+#: ../../source/ref-changelog.md:402
 msgid ""
 "**Improve logging** ([#3776](https://github.com/adap/flower/pull/3776), "
 "[#3789](https://github.com/adap/flower/pull/3789))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:382
+#: ../../source/ref-changelog.md:404
 msgid ""
 "Improved logging aims to be more concise and helpful to show you the "
 "details you actually care about."
 msgstr ""
 
-#: ../../source/ref-changelog.md:384
+#: ../../source/ref-changelog.md:406
 msgid ""
 "**Refactor framework internals** "
 "([#3621](https://github.com/adap/flower/pull/3621), "
@@ -16973,13 +17055,17 @@ msgid ""
 "[#3569](https://github.com/adap/flower/pull/3569))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:390
+#: ../../source/ref-changelog.md:410
+msgid "Documentation improvements"
+msgstr ""
+
+#: ../../source/ref-changelog.md:412
 msgid ""
 "**Add 🇰🇷 Korean translations** "
 "([#3680](https://github.com/adap/flower/pull/3680))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:392
+#: ../../source/ref-changelog.md:414
 msgid ""
 "**Update translations** "
 "([#3586](https://github.com/adap/flower/pull/3586), "
@@ -16993,7 +17079,7 @@ msgid ""
 "[#3631](https://github.com/adap/flower/pull/3631))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:394
+#: ../../source/ref-changelog.md:416
 msgid ""
 "**Update documentation** "
 "([#3864](https://github.com/adap/flower/pull/3864), "
@@ -17007,18 +17093,18 @@ msgid ""
 "[#3707](https://github.com/adap/flower/pull/3707))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:396
+#: ../../source/ref-changelog.md:418
 msgid ""
 "Updated documentation includes new install instructions for different "
 "shells, a new Flower Code Examples documentation landing page, new `flwr`"
 " CLI docs and an updated federated XGBoost code example."
 msgstr ""
 
-#: ../../source/ref-changelog.md:400
+#: ../../source/ref-changelog.md:422
 msgid "**Deprecate** `client_fn(cid: str)`"
 msgstr ""
 
-#: ../../source/ref-changelog.md:402
+#: ../../source/ref-changelog.md:424
 msgid ""
 "`client_fn` used to have a signature `client_fn(cid: str) -> Client`. "
 "This signature is now deprecated. Use the new signature "
@@ -17031,13 +17117,13 @@ msgid ""
 " the dataset on each simulated or deployed SuperNode."
 msgstr ""
 
-#: ../../source/ref-changelog.md:404
+#: ../../source/ref-changelog.md:426
 msgid ""
 "**Deprecate passing** `Server/ServerConfig/Strategy/ClientManager` **to**"
 " `ServerApp` **directly**"
 msgstr ""
 
-#: ../../source/ref-changelog.md:406
+#: ../../source/ref-changelog.md:428
 msgid ""
 "Creating `ServerApp` using `ServerApp(config=config, strategy=strategy)` "
 "is now deprecated. Instead of passing "
@@ -17050,13 +17136,13 @@ msgid ""
 " the `run_config`)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:410
+#: ../../source/ref-changelog.md:432
 msgid ""
 "**Remove support for `client_ids` in `start_simulation`** "
 "([#3699](https://github.com/adap/flower/pull/3699))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:412
+#: ../../source/ref-changelog.md:434
 msgid ""
 "The (rarely used) feature that allowed passing custom `client_ids` to the"
 " `start_simulation` function was removed. This removal is part of a "
@@ -17064,24 +17150,24 @@ msgid ""
 "internals work in simulation and deployment."
 msgstr ""
 
-#: ../../source/ref-changelog.md:414
+#: ../../source/ref-changelog.md:436
 msgid ""
 "**Remove `flower-driver-api` and `flower-fleet-api`** "
 "([#3418](https://github.com/adap/flower/pull/3418))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:416
+#: ../../source/ref-changelog.md:438
 msgid ""
 "The two deprecated CLI commands `flower-driver-api` and `flower-fleet-"
 "api` were removed in an effort to streamline the SuperLink developer "
 "experience. Use `flower-superlink` instead."
 msgstr ""
 
-#: ../../source/ref-changelog.md:418
+#: ../../source/ref-changelog.md:440
 msgid "v1.9.0 (2024-06-10)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:424
+#: ../../source/ref-changelog.md:446
 msgid ""
 "`Adam Narozniak`, `Charles Beauville`, `Chong Shen Ng`, `Daniel J. "
 "Beutel`, `Daniel Nata Nugraha`, `Heng Pan`, `Javier`, `Mahdi Beitollahi`,"
@@ -17089,7 +17175,7 @@ msgid ""
 "---TOKEN_v1.9.0-->"
 msgstr ""
 
-#: ../../source/ref-changelog.md:428
+#: ../../source/ref-changelog.md:450
 msgid ""
 "**Introduce built-in authentication (preview)** "
 "([#2946](https://github.com/adap/flower/pull/2946), "
@@ -17108,7 +17194,7 @@ msgid ""
 "[#3357](https://github.com/adap/flower/pull/3357))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:430
+#: ../../source/ref-changelog.md:452
 msgid ""
 "Flower 1.9 introduces the first build-in version of client node "
 "authentication. In previous releases, users often wrote glue code to "
@@ -17120,14 +17206,14 @@ msgid ""
 "authentication) help you to get started."
 msgstr ""
 
-#: ../../source/ref-changelog.md:432
+#: ../../source/ref-changelog.md:454
 msgid ""
 "This is the first preview release of the Flower-native authentication "
 "system. Many additional features are on the roadmap for upcoming Flower "
 "releases - stay tuned."
 msgstr ""
 
-#: ../../source/ref-changelog.md:434
+#: ../../source/ref-changelog.md:456
 msgid ""
 "**Introduce end-to-end Docker support** "
 "([#3483](https://github.com/adap/flower/pull/3483), "
@@ -17144,7 +17230,7 @@ msgid ""
 "[#3290](https://github.com/adap/flower/pull/3290))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:436
+#: ../../source/ref-changelog.md:458
 msgid ""
 "Full Flower Next Docker support is here! With the release of Flower 1.9, "
 "Flower provides stable Docker images for the Flower SuperLink, the Flower"
@@ -17154,7 +17240,7 @@ msgid ""
 "docker.html) to get stated."
 msgstr ""
 
-#: ../../source/ref-changelog.md:438
+#: ../../source/ref-changelog.md:460
 msgid ""
 "**Re-architect Flower Next simulation engine** "
 "([#3307](https://github.com/adap/flower/pull/3307), "
@@ -17167,7 +17253,7 @@ msgid ""
 "[#3326](https://github.com/adap/flower/pull/3326))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:440
+#: ../../source/ref-changelog.md:462
 msgid ""
 "Flower Next simulations now use a new in-memory `Driver` that improves "
 "the reliability of simulations, especially in notebook environments. This"
@@ -17175,7 +17261,7 @@ msgid ""
 "simulation architecture."
 msgstr ""
 
-#: ../../source/ref-changelog.md:442
+#: ../../source/ref-changelog.md:464
 msgid ""
 "**Upgrade simulation engine** "
 "([#3354](https://github.com/adap/flower/pull/3354), "
@@ -17187,20 +17273,20 @@ msgid ""
 "[#3494](https://github.com/adap/flower/pull/3494))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:444
+#: ../../source/ref-changelog.md:466
 msgid ""
 "The Flower Next simulation engine comes with improved and configurable "
 "logging. The Ray-based simulation backend in Flower 1.9 was updated to "
 "use Ray 2.10."
 msgstr ""
 
-#: ../../source/ref-changelog.md:446
+#: ../../source/ref-changelog.md:468
 msgid ""
 "**Introduce FedPFT baseline** "
 "([#3268](https://github.com/adap/flower/pull/3268))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:448
+#: ../../source/ref-changelog.md:470
 msgid ""
 "FedPFT allows you to perform one-shot Federated Learning by leveraging "
 "widely available foundational models, dramatically reducing communication"
@@ -17211,7 +17297,7 @@ msgid ""
 "([arxiv](https://arxiv.org/abs/2402.01862))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:450
+#: ../../source/ref-changelog.md:472
 msgid ""
 "**Launch additional** `flwr new` **templates for Apple MLX, Hugging Face "
 "Transformers, scikit-learn and TensorFlow** "
@@ -17223,7 +17309,7 @@ msgid ""
 "[#3287](https://github.com/adap/flower/pull/3287))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:452
+#: ../../source/ref-changelog.md:474
 msgid ""
 "The `flwr` CLI's `flwr new` command is starting to become everone's "
 "favorite way of creating new Flower projects. This release introduces "
@@ -17232,7 +17318,7 @@ msgid ""
 "also received updates."
 msgstr ""
 
-#: ../../source/ref-changelog.md:454
+#: ../../source/ref-changelog.md:476
 msgid ""
 "**Refine** `RecordSet` **API** "
 "([#3209](https://github.com/adap/flower/pull/3209), "
@@ -17243,14 +17329,14 @@ msgid ""
 "[#3368](https://github.com/adap/flower/pull/3368))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:456
+#: ../../source/ref-changelog.md:478
 msgid ""
 "`RecordSet` is part of the Flower Next low-level API preview release. In "
 "Flower 1.9, `RecordSet` received a number of usability improvements that "
 "make it easier to build `RecordSet`-based `ServerApp`s and `ClientApp`s."
 msgstr ""
 
-#: ../../source/ref-changelog.md:458
+#: ../../source/ref-changelog.md:480
 msgid ""
 "**Beautify logging** ([#3379](https://github.com/adap/flower/pull/3379), "
 "[#3430](https://github.com/adap/flower/pull/3430), "
@@ -17259,13 +17345,13 @@ msgid ""
 "[#3433](https://github.com/adap/flower/pull/3433))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:460
+#: ../../source/ref-changelog.md:482
 msgid ""
 "Logs received a substantial update. Not only are logs now much nicer to "
 "look at, but they are also more configurable."
 msgstr ""
 
-#: ../../source/ref-changelog.md:462
+#: ../../source/ref-changelog.md:484
 msgid ""
 "**Improve reliability** "
 "([#3564](https://github.com/adap/flower/pull/3564), "
@@ -17278,27 +17364,27 @@ msgid ""
 "[#3372](https://github.com/adap/flower/pull/3372))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:464
+#: ../../source/ref-changelog.md:486
 msgid ""
 "Flower 1.9 includes reliability improvements across many parts of the "
 "system. One example is a much improved SuperNode shutdown procedure."
 msgstr ""
 
-#: ../../source/ref-changelog.md:466
+#: ../../source/ref-changelog.md:488
 msgid ""
 "**Update Swift and C++ SDKs** "
 "([#3321](https://github.com/adap/flower/pull/3321), "
 "[#2763](https://github.com/adap/flower/pull/2763))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:468
+#: ../../source/ref-changelog.md:490
 msgid ""
 "In the C++ SDK, communication-related code is now separate from main "
 "client logic. A new abstract class `Communicator` has been introduced "
 "alongside a gRPC implementation of it."
 msgstr ""
 
-#: ../../source/ref-changelog.md:470
+#: ../../source/ref-changelog.md:492
 msgid ""
 "**Improve testing, tooling and CI/CD infrastructure** "
 "([#3294](https://github.com/adap/flower/pull/3294), "
@@ -17332,13 +17418,13 @@ msgid ""
 "[#3271](https://github.com/adap/flower/pull/3271))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:472
+#: ../../source/ref-changelog.md:494
 msgid ""
 "As always, the Flower tooling, testing, and CI/CD infrastructure has "
 "received many updates."
 msgstr ""
 
-#: ../../source/ref-changelog.md:474
+#: ../../source/ref-changelog.md:496
 msgid ""
 "**Improve documentation** "
 "([#3530](https://github.com/adap/flower/pull/3530), "
@@ -17363,32 +17449,32 @@ msgid ""
 "[#3274](https://github.com/adap/flower/pull/3274))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:476
+#: ../../source/ref-changelog.md:498
 msgid ""
 "As always, the Flower documentation has received many updates. Notable "
 "new pages include:"
 msgstr ""
 
-#: ../../source/ref-changelog.md:478
+#: ../../source/ref-changelog.md:500
 msgid ""
 "[How-to upgrate to Flower Next (Flower Next migration "
 "guide)](https://flower.ai/docs/framework/how-to-upgrade-to-flower-"
 "next.html)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:480
+#: ../../source/ref-changelog.md:502
 msgid ""
 "[How-to run Flower using Docker](https://flower.ai/docs/framework/how-to-"
 "run-flower-using-docker.html)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:482
+#: ../../source/ref-changelog.md:504
 msgid ""
 "[Flower Mods reference](https://flower.ai/docs/framework/ref-"
 "api/flwr.client.mod.html#module-flwr.client.mod)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:484
+#: ../../source/ref-changelog.md:506
 msgid ""
 "**General updates to Flower Examples** "
 "([#3205](https://github.com/adap/flower/pull/3205), "
@@ -17411,11 +17497,11 @@ msgid ""
 "[#3269](https://github.com/adap/flower/pull/3269))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:486
+#: ../../source/ref-changelog.md:508
 msgid "As always, Flower code examples have received many updates."
 msgstr ""
 
-#: ../../source/ref-changelog.md:488
+#: ../../source/ref-changelog.md:510
 msgid ""
 "**General improvements** "
 "([#3532](https://github.com/adap/flower/pull/3532), "
@@ -17454,45 +17540,45 @@ msgid ""
 "[#3261](https://github.com/adap/flower/pull/3261))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:492
+#: ../../source/ref-changelog.md:514
 msgid "**Deprecate Python 3.8 support**"
 msgstr ""
 
-#: ../../source/ref-changelog.md:494
+#: ../../source/ref-changelog.md:516
 msgid ""
 "Python 3.8 will stop receiving security fixes in [October "
 "2024](https://devguide.python.org/versions/). Support for Python 3.8 is "
 "now deprecated and will be removed in an upcoming release."
 msgstr ""
 
-#: ../../source/ref-changelog.md:496
+#: ../../source/ref-changelog.md:518
 msgid ""
 "**Deprecate (experimental)** `flower-driver-api` **and** `flower-fleet-"
 "api` ([#3416](https://github.com/adap/flower/pull/3416), "
 "[#3420](https://github.com/adap/flower/pull/3420))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:498
+#: ../../source/ref-changelog.md:520
 msgid ""
 "Flower 1.9 deprecates the two (experimental) commands `flower-driver-api`"
 " and `flower-fleet-api`. Both commands will be removed in an upcoming "
 "release. Use `flower-superlink` instead."
 msgstr ""
 
-#: ../../source/ref-changelog.md:500
+#: ../../source/ref-changelog.md:522
 msgid ""
 "**Deprecate** `--server` **in favor of** `--superlink` "
 "([#3518](https://github.com/adap/flower/pull/3518))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:502
+#: ../../source/ref-changelog.md:524
 msgid ""
 "The commands `flower-server-app` and `flower-client-app` should use "
 "`--superlink` instead of the now deprecated `--server`. Support for "
 "`--server` will be removed in a future release."
 msgstr ""
 
-#: ../../source/ref-changelog.md:506
+#: ../../source/ref-changelog.md:528
 msgid ""
 "**Replace** `flower-superlink` **CLI option** `--certificates` **with** "
 "`--ssl-ca-certfile` **,** `--ssl-certfile` **and** `--ssl-keyfile` "
@@ -17500,7 +17586,7 @@ msgid ""
 "[#3408](https://github.com/adap/flower/pull/3408))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:508
+#: ../../source/ref-changelog.md:530
 msgid ""
 "SSL-related `flower-superlink` CLI arguments were restructured in an "
 "incompatible way. Instead of passing a single `--certificates` flag with "
@@ -17510,26 +17596,26 @@ msgid ""
 "connections.html) documentation page for details."
 msgstr ""
 
-#: ../../source/ref-changelog.md:510
+#: ../../source/ref-changelog.md:532
 msgid ""
 "**Remove SuperLink** `--vce` **option** "
 "([#3513](https://github.com/adap/flower/pull/3513))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:512
+#: ../../source/ref-changelog.md:534
 msgid ""
 "Instead of separately starting a SuperLink and a `ServerApp` for "
 "simulation, simulations must now be started using the single `flower-"
 "simulation` command."
 msgstr ""
 
-#: ../../source/ref-changelog.md:514
+#: ../../source/ref-changelog.md:536
 msgid ""
 "**Merge** `--grpc-rere` **and** `--rest` **SuperLink options** "
 "([#3527](https://github.com/adap/flower/pull/3527))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:516
+#: ../../source/ref-changelog.md:538
 msgid ""
 "To simplify the usage of `flower-superlink`, previously separate sets of "
 "CLI options for gRPC and REST were merged into one unified set of "
@@ -17538,11 +17624,11 @@ msgid ""
 "details."
 msgstr ""
 
-#: ../../source/ref-changelog.md:518
+#: ../../source/ref-changelog.md:540
 msgid "v1.8.0 (2024-04-03)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:524
+#: ../../source/ref-changelog.md:546
 msgid ""
 "`Adam Narozniak`, `Charles Beauville`, `Daniel J. Beutel`, `Daniel Nata "
 "Nugraha`, `Danny`, `Gustavo Bertoli`, `Heng Pan`, `Ikko Eltociear "
@@ -17551,7 +17637,7 @@ msgid ""
 "`tabdar-khan` <!---TOKEN_v1.8.0-->"
 msgstr ""
 
-#: ../../source/ref-changelog.md:528
+#: ../../source/ref-changelog.md:550
 msgid ""
 "**Introduce Flower Next high-level API (stable)** "
 "([#3002](https://github.com/adap/flower/pull/3002), "
@@ -17581,7 +17667,7 @@ msgid ""
 "[#3197](https://github.com/adap/flower/pull/3197))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:530
+#: ../../source/ref-changelog.md:552
 msgid ""
 "The Flower Next high-level API is stable! Flower Next is the future of "
 "Flower - all new features (like Flower Mods) will be built on top of it. "
@@ -17595,7 +17681,7 @@ msgid ""
 "projects that use `Strategy`, `NumPyClient` & co."
 msgstr ""
 
-#: ../../source/ref-changelog.md:532
+#: ../../source/ref-changelog.md:554
 msgid ""
 "**Introduce Flower Next low-level API (preview)** "
 "([#3062](https://github.com/adap/flower/pull/3062), "
@@ -17603,7 +17689,7 @@ msgid ""
 "[#3069](https://github.com/adap/flower/pull/3069))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:534
+#: ../../source/ref-changelog.md:556
 msgid ""
 "In addition to the Flower Next *high-level* API that uses `Strategy`, "
 "`NumPyClient` & co, Flower 1.8 also comes with a preview version of the "
@@ -17620,7 +17706,7 @@ msgid ""
 "custom SMPC protocols, to name just a few."
 msgstr ""
 
-#: ../../source/ref-changelog.md:536
+#: ../../source/ref-changelog.md:558
 msgid ""
 "**Introduce Flower Mods (preview)** "
 "([#3054](https://github.com/adap/flower/pull/3054), "
@@ -17628,7 +17714,7 @@ msgid ""
 "[#3083](https://github.com/adap/flower/pull/3083))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:538
+#: ../../source/ref-changelog.md:560
 msgid ""
 "Flower Modifiers (we call them Mods) can intercept messages and analyze, "
 "edit or handle them directly. Mods can be used to develop pluggable "
@@ -17640,7 +17726,7 @@ msgid ""
 "can already use it to experiment with arbirtrary SMPC protocols."
 msgstr ""
 
-#: ../../source/ref-changelog.md:540
+#: ../../source/ref-changelog.md:562
 msgid ""
 "**Fine-tune LLMs with LLM FlowerTune** "
 "([#3029](https://github.com/adap/flower/pull/3029), "
@@ -17652,7 +17738,7 @@ msgid ""
 "[#3172](https://github.com/adap/flower/pull/3172))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:542
+#: ../../source/ref-changelog.md:564
 msgid ""
 "We are introducing LLM FlowerTune, an introductory example that "
 "demonstrates federated LLM fine-tuning of pre-trained Llama2 models on "
@@ -17662,7 +17748,7 @@ msgid ""
 "-llm-flowertune-federated-llm-finetuning-with-flower/) for more details."
 msgstr ""
 
-#: ../../source/ref-changelog.md:544
+#: ../../source/ref-changelog.md:566
 msgid ""
 "**Introduce built-in Differential Privacy (preview)** "
 "([#2798](https://github.com/adap/flower/pull/2798), "
@@ -17676,7 +17762,7 @@ msgid ""
 "[#3074](https://github.com/adap/flower/pull/3074))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:546
+#: ../../source/ref-changelog.md:568
 msgid ""
 "Built-in Differential Privacy is here! Flower supports both central and "
 "local differential privacy (DP). Central DP can be configured with either"
@@ -17689,7 +17775,7 @@ msgid ""
 "/how-to-use-differential-privacy.html) in Flower."
 msgstr ""
 
-#: ../../source/ref-changelog.md:548
+#: ../../source/ref-changelog.md:570
 msgid ""
 "**Introduce built-in Secure Aggregation (preview)** "
 "([#3120](https://github.com/adap/flower/pull/3120), "
@@ -17697,7 +17783,7 @@ msgid ""
 "[#3108](https://github.com/adap/flower/pull/3108))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:550
+#: ../../source/ref-changelog.md:572
 msgid ""
 "Built-in Secure Aggregation is here! Flower now supports different secure"
 " aggregation protocols out-of-the-box. The best part? You can add secure "
@@ -17710,7 +17796,7 @@ msgid ""
 "in the same project."
 msgstr ""
 
-#: ../../source/ref-changelog.md:552
+#: ../../source/ref-changelog.md:574
 msgid ""
 "**Introduce** `flwr` **CLI (preview)** "
 "([#2942](https://github.com/adap/flower/pull/2942), "
@@ -17724,13 +17810,13 @@ msgid ""
 "[#3142](https://github.com/adap/flower/pull/3142))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:554
+#: ../../source/ref-changelog.md:576
 msgid ""
 "A new `flwr` CLI command allows creating new Flower projects (`flwr new`)"
 " and then running them using the Simulation Engine (`flwr run`)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:556
+#: ../../source/ref-changelog.md:578
 msgid ""
 "**Introduce Flower Next Simulation Engine** "
 "([#3024](https://github.com/adap/flower/pull/3024), "
@@ -17745,20 +17831,20 @@ msgid ""
 "[#3008](https://github.com/adap/flower/pull/3008))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:558
+#: ../../source/ref-changelog.md:580
 msgid ""
 "The Flower Simulation Engine can now run Flower Next projects. For "
 "notebook environments, there's also a new `run_simulation` function that "
 "can run `ServerApp` and `ClientApp`."
 msgstr ""
 
-#: ../../source/ref-changelog.md:560
+#: ../../source/ref-changelog.md:582
 msgid ""
 "**Handle SuperNode connection errors** "
 "([#2969](https://github.com/adap/flower/pull/2969))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:562
+#: ../../source/ref-changelog.md:584
 msgid ""
 "A SuperNode will now try to reconnect indefinitely to the SuperLink in "
 "case of connection errors. The arguments `--max-retries` and `--max-wait-"
@@ -17769,7 +17855,7 @@ msgid ""
 "reconnect to the SuperLink."
 msgstr ""
 
-#: ../../source/ref-changelog.md:564
+#: ../../source/ref-changelog.md:586
 msgid ""
 "**General updates to Flower Baselines** "
 "([#2904](https://github.com/adap/flower/pull/2904), "
@@ -17778,13 +17864,13 @@ msgid ""
 "[#2968](https://github.com/adap/flower/pull/2968))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:566
+#: ../../source/ref-changelog.md:588
 msgid ""
 "There's a new [FedStar](https://flower.ai/docs/baselines/fedstar.html) "
 "baseline. Several other baselined have been updated as well."
 msgstr ""
 
-#: ../../source/ref-changelog.md:568
+#: ../../source/ref-changelog.md:590
 msgid ""
 "**Improve documentation and translations** "
 "([#3050](https://github.com/adap/flower/pull/3050), "
@@ -17805,14 +17891,14 @@ msgid ""
 "[#2989](https://github.com/adap/flower/pull/2989))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:570
+#: ../../source/ref-changelog.md:592
 msgid ""
 "As usual, we merged many smaller and larger improvements to the "
 "documentation. A special thank you goes to [Sebastian van der "
 "Voort](https://github.com/svdvoort) for landing a big documentation PR!"
 msgstr ""
 
-#: ../../source/ref-changelog.md:572
+#: ../../source/ref-changelog.md:594
 msgid ""
 "**General updates to Flower Examples** "
 "([3134](https://github.com/adap/flower/pull/3134), "
@@ -17828,7 +17914,7 @@ msgid ""
 "[#3117](https://github.com/adap/flower/pull/3117))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:574
+#: ../../source/ref-changelog.md:596
 msgid ""
 "Two new examples show federated training of a Vision Transformer (ViT) "
 "and federated learning in a medical context using the popular MONAI "
@@ -17837,7 +17923,7 @@ msgid ""
 "received considerable updates as well."
 msgstr ""
 
-#: ../../source/ref-changelog.md:576
+#: ../../source/ref-changelog.md:598
 msgid ""
 "**General improvements** "
 "([#3171](https://github.com/adap/flower/pull/3171), "
@@ -17915,11 +18001,11 @@ msgid ""
 "[#2954](https://github.com/adap/flower/pull/2954))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:582
+#: ../../source/ref-changelog.md:604
 msgid "v1.7.0 (2024-02-05)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:588
+#: ../../source/ref-changelog.md:610
 msgid ""
 "`Aasheesh Singh`, `Adam Narozniak`, `Aml Hassan Esmil`, `Charles "
 "Beauville`, `Daniel J. Beutel`, `Daniel Nata Nugraha`, `Edoardo "
@@ -17929,7 +18015,7 @@ msgid ""
 "Shaaban`, `Yan Gao`, `Yasar Abbas` <!---TOKEN_v1.7.0-->"
 msgstr ""
 
-#: ../../source/ref-changelog.md:592
+#: ../../source/ref-changelog.md:614
 msgid ""
 "**Introduce stateful clients (experimental)** "
 "([#2770](https://github.com/adap/flower/pull/2770), "
@@ -17939,7 +18025,7 @@ msgid ""
 "[#2769](https://github.com/adap/flower/pull/2769))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:594
+#: ../../source/ref-changelog.md:616
 msgid ""
 "Subclasses of `Client` and `NumPyClient` can now store local state that "
 "remains on the client. Let's start with the highlight first: this new "
@@ -17952,13 +18038,13 @@ msgid ""
 "unified way across simulation and deployment."
 msgstr ""
 
-#: ../../source/ref-changelog.md:596
+#: ../../source/ref-changelog.md:618
 msgid ""
 "**Improve performance** "
 "([#2293](https://github.com/adap/flower/pull/2293))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:598
+#: ../../source/ref-changelog.md:620
 msgid ""
 "Flower is faster than ever. All `FedAvg`-derived strategies now use in-"
 "place aggregation to reduce memory consumption. The Flower client "
@@ -17967,27 +18053,27 @@ msgid ""
 "training time is short."
 msgstr ""
 
-#: ../../source/ref-changelog.md:600
+#: ../../source/ref-changelog.md:622
 msgid ""
 "**Support Federated Learning with Apple MLX and Flower** "
 "([#2693](https://github.com/adap/flower/pull/2693))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:602
+#: ../../source/ref-changelog.md:624
 msgid ""
 "Flower has official support for federated learning using [Apple "
 "MLX](https://ml-explore.github.io/mlx) via the new `quickstart-mlx` code "
 "example."
 msgstr ""
 
-#: ../../source/ref-changelog.md:604
+#: ../../source/ref-changelog.md:626
 msgid ""
 "**Introduce new XGBoost cyclic strategy** "
 "([#2666](https://github.com/adap/flower/pull/2666), "
 "[#2668](https://github.com/adap/flower/pull/2668))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:606
+#: ../../source/ref-changelog.md:628
 msgid ""
 "A new strategy called `FedXgbCyclic` supports a client-by-client style of"
 " training (often called cyclic). The `xgboost-comprehensive` code example"
@@ -17996,31 +18082,31 @@ msgid ""
 "offers best-in-class XGBoost support."
 msgstr ""
 
-#: ../../source/ref-changelog.md:608
+#: ../../source/ref-changelog.md:630
 msgid ""
 "**Support Python 3.11** "
 "([#2394](https://github.com/adap/flower/pull/2394))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:610
+#: ../../source/ref-changelog.md:632
 msgid ""
 "Framework tests now run on Python 3.8, 3.9, 3.10, and 3.11. This will "
 "ensure better support for users using more recent Python versions."
 msgstr ""
 
-#: ../../source/ref-changelog.md:612
+#: ../../source/ref-changelog.md:634
 msgid ""
 "**Update gRPC and ProtoBuf dependencies** "
 "([#2814](https://github.com/adap/flower/pull/2814))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:614
+#: ../../source/ref-changelog.md:636
 msgid ""
 "The `grpcio` and `protobuf` dependencies were updated to their latest "
 "versions for improved security and performance."
 msgstr ""
 
-#: ../../source/ref-changelog.md:616
+#: ../../source/ref-changelog.md:638
 msgid ""
 "**Introduce Docker image for Flower server** "
 "([#2700](https://github.com/adap/flower/pull/2700), "
@@ -18034,7 +18120,7 @@ msgid ""
 "[#2701](https://github.com/adap/flower/pull/2701))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:618
+#: ../../source/ref-changelog.md:640
 msgid ""
 "The Flower server can now be run using an official Docker image. A new "
 "how-to guide explains [how to run Flower using "
@@ -18042,25 +18128,25 @@ msgid ""
 "docker.html). An official Flower client Docker image will follow."
 msgstr ""
 
-#: ../../source/ref-changelog.md:620
+#: ../../source/ref-changelog.md:642
 msgid ""
 "**Introduce** `flower-via-docker-compose` **example** "
 "([#2626](https://github.com/adap/flower/pull/2626))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:622
+#: ../../source/ref-changelog.md:644
 msgid ""
 "**Introduce** `quickstart-sklearn-tabular` **example** "
 "([#2719](https://github.com/adap/flower/pull/2719))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:624
+#: ../../source/ref-changelog.md:646
 msgid ""
 "**Introduce** `custom-metrics` **example** "
 "([#1958](https://github.com/adap/flower/pull/1958))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:626
+#: ../../source/ref-changelog.md:648
 msgid ""
 "**Update code examples to use Flower Datasets** "
 "([#2450](https://github.com/adap/flower/pull/2450), "
@@ -18069,13 +18155,13 @@ msgid ""
 "[#2712](https://github.com/adap/flower/pull/2712))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:628
+#: ../../source/ref-changelog.md:650
 msgid ""
 "Several code examples were updated to use [Flower "
 "Datasets](https://flower.ai/docs/datasets/)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:630
+#: ../../source/ref-changelog.md:652
 msgid ""
 "**General updates to Flower Examples** "
 "([#2381](https://github.com/adap/flower/pull/2381), "
@@ -18090,41 +18176,41 @@ msgid ""
 "[#2655](https://github.com/adap/flower/pull/2655))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:632
+#: ../../source/ref-changelog.md:654
 msgid "Many Flower code examples received substantial updates."
 msgstr ""
 
-#: ../../source/ref-changelog.md:634 ../../source/ref-changelog.md:727
+#: ../../source/ref-changelog.md:656 ../../source/ref-changelog.md:749
 msgid "**Update Flower Baselines**"
 msgstr ""
 
-#: ../../source/ref-changelog.md:636
+#: ../../source/ref-changelog.md:658
 msgid ""
 "HFedXGBoost ([#2226](https://github.com/adap/flower/pull/2226), "
 "[#2771](https://github.com/adap/flower/pull/2771))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:637
+#: ../../source/ref-changelog.md:659
 msgid "FedVSSL ([#2412](https://github.com/adap/flower/pull/2412))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:638
+#: ../../source/ref-changelog.md:660
 msgid "FedNova ([#2179](https://github.com/adap/flower/pull/2179))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:639
+#: ../../source/ref-changelog.md:661
 msgid "HeteroFL ([#2439](https://github.com/adap/flower/pull/2439))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:640
+#: ../../source/ref-changelog.md:662
 msgid "FedAvgM ([#2246](https://github.com/adap/flower/pull/2246))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:641
+#: ../../source/ref-changelog.md:663
 msgid "FedPara ([#2722](https://github.com/adap/flower/pull/2722))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:643
+#: ../../source/ref-changelog.md:665
 msgid ""
 "**Improve documentation** "
 "([#2674](https://github.com/adap/flower/pull/2674), "
@@ -18135,7 +18221,7 @@ msgid ""
 "[#2900](https://github.com/adap/flower/pull/2900))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:645
+#: ../../source/ref-changelog.md:667
 msgid ""
 "**Improved testing and development infrastructure** "
 "([#2797](https://github.com/adap/flower/pull/2797), "
@@ -18169,13 +18255,13 @@ msgid ""
 "[#2398](https://github.com/adap/flower/pull/2398))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:647
+#: ../../source/ref-changelog.md:669
 msgid ""
 "The Flower testing and development infrastructure has received "
 "substantial updates. This makes Flower 1.7 the most tested release ever."
 msgstr ""
 
-#: ../../source/ref-changelog.md:649
+#: ../../source/ref-changelog.md:671
 msgid ""
 "**Update dependencies** "
 "([#2753](https://github.com/adap/flower/pull/2753), "
@@ -18199,7 +18285,7 @@ msgid ""
 "[#2789](https://github.com/adap/flower/pull/2789))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:651
+#: ../../source/ref-changelog.md:673
 msgid ""
 "**General improvements** "
 "([#2803](https://github.com/adap/flower/pull/2803), "
@@ -18240,14 +18326,14 @@ msgid ""
 "[#2759](https://github.com/adap/flower/pull/2759))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:655
+#: ../../source/ref-changelog.md:677
 msgid ""
 "**Deprecate** `start_numpy_client` "
 "([#2563](https://github.com/adap/flower/pull/2563), "
 "[#2718](https://github.com/adap/flower/pull/2718))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:657
+#: ../../source/ref-changelog.md:679
 msgid ""
 "Until now, clients of type `NumPyClient` needed to be started via "
 "`start_numpy_client`. In our efforts to consolidate framework APIs, we "
@@ -18258,63 +18344,63 @@ msgid ""
 "updated accordingly."
 msgstr ""
 
-#: ../../source/ref-changelog.md:659
+#: ../../source/ref-changelog.md:681
 msgid ""
 "**Deprecate legacy DP wrappers** "
 "([#2749](https://github.com/adap/flower/pull/2749))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:661
+#: ../../source/ref-changelog.md:683
 msgid ""
 "Legacy DP wrapper classes are deprecated, but still functional. This is "
 "in preparation for an all-new pluggable version of differential privacy "
 "support in Flower."
 msgstr ""
 
-#: ../../source/ref-changelog.md:663
+#: ../../source/ref-changelog.md:685
 msgid ""
 "**Make optional arg** `--callable` **in** `flower-client` **a required "
 "positional arg** ([#2673](https://github.com/adap/flower/pull/2673))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:665
+#: ../../source/ref-changelog.md:687
 msgid ""
 "**Rename** `certificates` **to** `root_certificates` **in** `Driver` "
 "([#2890](https://github.com/adap/flower/pull/2890))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:667
+#: ../../source/ref-changelog.md:689
 msgid ""
 "**Drop experimental** `Task` **fields** "
 "([#2866](https://github.com/adap/flower/pull/2866), "
 "[#2865](https://github.com/adap/flower/pull/2865))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:669
+#: ../../source/ref-changelog.md:691
 msgid ""
 "Experimental fields `sa`, `legacy_server_message` and "
 "`legacy_client_message` were removed from `Task` message. The removed "
 "fields are superseded by the new `RecordSet` abstraction."
 msgstr ""
 
-#: ../../source/ref-changelog.md:671
+#: ../../source/ref-changelog.md:693
 msgid ""
 "**Retire MXNet examples** "
 "([#2724](https://github.com/adap/flower/pull/2724))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:673
+#: ../../source/ref-changelog.md:695
 msgid ""
 "The development of the MXNet fremework has ended and the project is now "
 "[archived on GitHub](https://github.com/apache/mxnet). Existing MXNet "
 "examples won't receive updates."
 msgstr ""
 
-#: ../../source/ref-changelog.md:675
+#: ../../source/ref-changelog.md:697
 msgid "v1.6.0 (2023-11-28)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:681
+#: ../../source/ref-changelog.md:703
 msgid ""
 "`Aashish Kolluri`, `Adam Narozniak`, `Alessio Mora`, `Barathwaja S`, "
 "`Charles Beauville`, `Daniel J. Beutel`, `Daniel Nata Nugraha`, `Gabriel "
@@ -18324,13 +18410,13 @@ msgid ""
 "`cnxdeveloper`, `k3nfalt` <!---TOKEN_v1.6.0-->"
 msgstr ""
 
-#: ../../source/ref-changelog.md:685
+#: ../../source/ref-changelog.md:707
 msgid ""
 "**Add experimental support for Python 3.12** "
 "([#2565](https://github.com/adap/flower/pull/2565))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:687
+#: ../../source/ref-changelog.md:709
 msgid ""
 "**Add new XGBoost examples** "
 "([#2612](https://github.com/adap/flower/pull/2612), "
@@ -18341,19 +18427,19 @@ msgid ""
 "[#2567](https://github.com/adap/flower/pull/2567))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:689
+#: ../../source/ref-changelog.md:711
 msgid ""
 "We have added a new `xgboost-quickstart` example alongside a new "
 "`xgboost-comprehensive` example that goes more in-depth."
 msgstr ""
 
-#: ../../source/ref-changelog.md:691
+#: ../../source/ref-changelog.md:713
 msgid ""
 "**Add Vertical FL example** "
 "([#2598](https://github.com/adap/flower/pull/2598))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:693
+#: ../../source/ref-changelog.md:715
 msgid ""
 "We had many questions about Vertical Federated Learning using Flower, so "
 "we decided to add an simple example for it on the [Titanic "
@@ -18361,29 +18447,29 @@ msgid ""
 "tutorial (in the README)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:695
+#: ../../source/ref-changelog.md:717
 msgid ""
 "**Support custom** `ClientManager` **in** `start_driver()` "
 "([#2292](https://github.com/adap/flower/pull/2292))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:697
+#: ../../source/ref-changelog.md:719
 msgid ""
 "**Update REST API to support create and delete nodes** "
 "([#2283](https://github.com/adap/flower/pull/2283))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:699
+#: ../../source/ref-changelog.md:721
 msgid ""
 "**Update the Android SDK** "
 "([#2187](https://github.com/adap/flower/pull/2187))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:701
+#: ../../source/ref-changelog.md:723
 msgid "Add gRPC request-response capability to the Android SDK."
 msgstr ""
 
-#: ../../source/ref-changelog.md:703
+#: ../../source/ref-changelog.md:725
 msgid ""
 "**Update the C++ SDK** "
 "([#2537](https://github.com/adap/flower/pull/2537), "
@@ -18392,18 +18478,18 @@ msgid ""
 "[#2522](https://github.com/adap/flower/pull/2522))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:705
+#: ../../source/ref-changelog.md:727
 msgid "Add gRPC request-response capability to the C++ SDK."
 msgstr ""
 
-#: ../../source/ref-changelog.md:707
+#: ../../source/ref-changelog.md:729
 msgid ""
 "**Make HTTPS the new default** "
 "([#2591](https://github.com/adap/flower/pull/2591), "
 "[#2636](https://github.com/adap/flower/pull/2636))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:709
+#: ../../source/ref-changelog.md:731
 msgid ""
 "Flower is moving to HTTPS by default. The new `flower-server` requires "
 "passing `--certificates`, but users can enable `--insecure` to use HTTP "
@@ -18413,21 +18499,21 @@ msgid ""
 "enable insecure HTTP connections."
 msgstr ""
 
-#: ../../source/ref-changelog.md:711
+#: ../../source/ref-changelog.md:733
 msgid ""
 "For backward compatibility, `start_client()` and `start_numpy_client()` "
 "will still start in insecure mode by default. In a future release, "
 "insecure connections will require user opt-in by passing `insecure=True`."
 msgstr ""
 
-#: ../../source/ref-changelog.md:713
+#: ../../source/ref-changelog.md:735
 msgid ""
 "**Unify client API** ([#2303](https://github.com/adap/flower/pull/2303), "
 "[#2390](https://github.com/adap/flower/pull/2390), "
 "[#2493](https://github.com/adap/flower/pull/2493))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:715
+#: ../../source/ref-changelog.md:737
 msgid ""
 "Using the `client_fn`, Flower clients can interchangeably run as "
 "standalone processes (i.e. via `start_client`) or in simulation (i.e. via"
@@ -18436,92 +18522,92 @@ msgid ""
 "convert a `NumPyClient` to a `Client`."
 msgstr ""
 
-#: ../../source/ref-changelog.md:717
+#: ../../source/ref-changelog.md:739
 msgid ""
 "**Add new** `Bulyan` **strategy** "
 "([#1817](https://github.com/adap/flower/pull/1817), "
 "[#1891](https://github.com/adap/flower/pull/1891))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:719
+#: ../../source/ref-changelog.md:741
 msgid ""
 "The new `Bulyan` strategy implements Bulyan by [El Mhamdi et al., "
 "2018](https://arxiv.org/abs/1802.07927)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:721
+#: ../../source/ref-changelog.md:743
 msgid ""
 "**Add new** `XGB Bagging` **strategy** "
 "([#2611](https://github.com/adap/flower/pull/2611))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:723 ../../source/ref-changelog.md:725
+#: ../../source/ref-changelog.md:745 ../../source/ref-changelog.md:747
 msgid ""
 "**Introduce `WorkloadState`** "
 "([#2564](https://github.com/adap/flower/pull/2564), "
 "[#2632](https://github.com/adap/flower/pull/2632))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:729
+#: ../../source/ref-changelog.md:751
 msgid ""
 "FedProx ([#2210](https://github.com/adap/flower/pull/2210), "
 "[#2286](https://github.com/adap/flower/pull/2286), "
 "[#2509](https://github.com/adap/flower/pull/2509))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:731
+#: ../../source/ref-changelog.md:753
 msgid ""
 "Baselines Docs ([#2290](https://github.com/adap/flower/pull/2290), "
 "[#2400](https://github.com/adap/flower/pull/2400))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:733
+#: ../../source/ref-changelog.md:755
 msgid ""
 "FedMLB ([#2340](https://github.com/adap/flower/pull/2340), "
 "[#2507](https://github.com/adap/flower/pull/2507))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:735
+#: ../../source/ref-changelog.md:757
 msgid ""
 "TAMUNA ([#2254](https://github.com/adap/flower/pull/2254), "
 "[#2508](https://github.com/adap/flower/pull/2508))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:737
+#: ../../source/ref-changelog.md:759
 msgid "FedMeta [#2438](https://github.com/adap/flower/pull/2438)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:739
+#: ../../source/ref-changelog.md:761
 msgid "FjORD [#2431](https://github.com/adap/flower/pull/2431)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:741
+#: ../../source/ref-changelog.md:763
 msgid "MOON [#2421](https://github.com/adap/flower/pull/2421)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:743
+#: ../../source/ref-changelog.md:765
 msgid "DepthFL [#2295](https://github.com/adap/flower/pull/2295)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:745
+#: ../../source/ref-changelog.md:767
 msgid "FedPer [#2266](https://github.com/adap/flower/pull/2266)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:747
+#: ../../source/ref-changelog.md:769
 msgid "FedWav2vec [#2551](https://github.com/adap/flower/pull/2551)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:749
+#: ../../source/ref-changelog.md:771
 msgid "niid-Bench [#2428](https://github.com/adap/flower/pull/2428)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:751
+#: ../../source/ref-changelog.md:773
 msgid ""
 "FedBN ([#2608](https://github.com/adap/flower/pull/2608), "
 "[#2615](https://github.com/adap/flower/pull/2615))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:753
+#: ../../source/ref-changelog.md:775
 msgid ""
 "**General updates to Flower Examples** "
 "([#2384](https://github.com/adap/flower/pull/2384), "
@@ -18531,7 +18617,7 @@ msgid ""
 "[#2545](https://github.com/adap/flower/pull/2545))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:755
+#: ../../source/ref-changelog.md:777
 msgid ""
 "**General updates to Flower Baselines** "
 "([#2301](https://github.com/adap/flower/pull/2301), "
@@ -18549,7 +18635,7 @@ msgid ""
 "[#2470](https://github.com/adap/flower/pull/2470))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:757
+#: ../../source/ref-changelog.md:779
 msgid ""
 "**General updates to the simulation engine** "
 "([#2331](https://github.com/adap/flower/pull/2331), "
@@ -18558,7 +18644,7 @@ msgid ""
 "[#2294](https://github.com/adap/flower/pull/2294))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:759
+#: ../../source/ref-changelog.md:781
 msgid ""
 "**General updates to Flower SDKs** "
 "([#2288](https://github.com/adap/flower/pull/2288), "
@@ -18570,7 +18656,7 @@ msgid ""
 "[#2623](https://github.com/adap/flower/pull/2623))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:761
+#: ../../source/ref-changelog.md:783
 msgid ""
 "**General improvements** "
 "([#2309](https://github.com/adap/flower/pull/2309), "
@@ -18602,13 +18688,13 @@ msgid ""
 "[#2596](https://github.com/adap/flower/pull/2596))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:763 ../../source/ref-changelog.md:853
-#: ../../source/ref-changelog.md:917 ../../source/ref-changelog.md:971
-#: ../../source/ref-changelog.md:1038
+#: ../../source/ref-changelog.md:785 ../../source/ref-changelog.md:875
+#: ../../source/ref-changelog.md:939 ../../source/ref-changelog.md:993
+#: ../../source/ref-changelog.md:1060
 msgid "Flower received many improvements under the hood, too many to list here."
 msgstr ""
 
-#: ../../source/ref-changelog.md:767
+#: ../../source/ref-changelog.md:789
 msgid ""
 "**Remove support for Python 3.7** "
 "([#2280](https://github.com/adap/flower/pull/2280), "
@@ -18619,30 +18705,30 @@ msgid ""
 "[#2356](https://github.com/adap/flower/pull/2356))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:769
+#: ../../source/ref-changelog.md:791
 msgid ""
 "Python 3.7 support was deprecated in Flower 1.5, and this release removes"
 " support. Flower now requires Python 3.8."
 msgstr ""
 
-#: ../../source/ref-changelog.md:771
+#: ../../source/ref-changelog.md:793
 msgid ""
 "**Remove experimental argument** `rest` **from** `start_client` "
 "([#2324](https://github.com/adap/flower/pull/2324))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:773
+#: ../../source/ref-changelog.md:795
 msgid ""
 "The (still experimental) argument `rest` was removed from `start_client` "
 "and `start_numpy_client`. Use `transport=\"rest\"` to opt into the "
 "experimental REST API instead."
 msgstr ""
 
-#: ../../source/ref-changelog.md:775
+#: ../../source/ref-changelog.md:797
 msgid "v1.5.0 (2023-08-31)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:781
+#: ../../source/ref-changelog.md:803
 msgid ""
 "`Adam Narozniak`, `Anass Anhari`, `Charles Beauville`, `Dana-Farber`, "
 "`Daniel J. Beutel`, `Daniel Nata Nugraha`, `Edoardo Gabrielli`, `Gustavo "
@@ -18651,7 +18737,7 @@ msgid ""
 "TOKEN_v1.5.0-->"
 msgstr ""
 
-#: ../../source/ref-changelog.md:785
+#: ../../source/ref-changelog.md:807
 msgid ""
 "**Introduce new simulation engine** "
 "([#1969](https://github.com/adap/flower/pull/1969), "
@@ -18659,7 +18745,7 @@ msgid ""
 "[#2248](https://github.com/adap/flower/pull/2248))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:787
+#: ../../source/ref-changelog.md:809
 msgid ""
 "The new simulation engine has been rewritten from the ground up, yet it "
 "remains fully backwards compatible. It offers much improved stability and"
@@ -18668,7 +18754,7 @@ msgid ""
 "only, CPU+GPU, multi-GPU, or multi-node multi-GPU environments."
 msgstr ""
 
-#: ../../source/ref-changelog.md:789
+#: ../../source/ref-changelog.md:811
 msgid ""
 "Comprehensive documentation includes a new [how-to run "
 "simulations](https://flower.ai/docs/framework/how-to-run-"
@@ -18679,7 +18765,7 @@ msgid ""
 "series](https://www.youtube.com/watch?v=cRebUIGB5RU&list=PLNG4feLHqCWlnj8a_E1A_n5zr2-8pafTB)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:791
+#: ../../source/ref-changelog.md:813
 msgid ""
 "**Restructure Flower Docs** "
 "([#1824](https://github.com/adap/flower/pull/1824), "
@@ -18711,7 +18797,7 @@ msgid ""
 "[#2227](https://github.com/adap/flower/pull/2227))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:793
+#: ../../source/ref-changelog.md:815
 msgid ""
 "Much effort went into a completely restructured Flower docs experience. "
 "The documentation on [flower.ai/docs](https://flower.ai/docs) is now "
@@ -18719,34 +18805,34 @@ msgid ""
 "Flower iOS SDK, and code example projects."
 msgstr ""
 
-#: ../../source/ref-changelog.md:795
+#: ../../source/ref-changelog.md:817
 msgid ""
 "**Introduce Flower Swift SDK** "
 "([#1858](https://github.com/adap/flower/pull/1858), "
 "[#1897](https://github.com/adap/flower/pull/1897))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:797
+#: ../../source/ref-changelog.md:819
 msgid ""
 "This is the first preview release of the Flower Swift SDK. Flower support"
 " on iOS is improving, and alongside the Swift SDK and code example, there"
 " is now also an iOS quickstart tutorial."
 msgstr ""
 
-#: ../../source/ref-changelog.md:799
+#: ../../source/ref-changelog.md:821
 msgid ""
 "**Introduce Flower Android SDK** "
 "([#2131](https://github.com/adap/flower/pull/2131))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:801
+#: ../../source/ref-changelog.md:823
 msgid ""
 "This is the first preview release of the Flower Kotlin SDK. Flower "
 "support on Android is improving, and alongside the Kotlin SDK and code "
 "example, there is now also an Android quickstart tutorial."
 msgstr ""
 
-#: ../../source/ref-changelog.md:803
+#: ../../source/ref-changelog.md:825
 msgid ""
 "**Introduce new end-to-end testing infrastructure** "
 "([#1842](https://github.com/adap/flower/pull/1842), "
@@ -18768,42 +18854,42 @@ msgid ""
 "[#2165](https://github.com/adap/flower/pull/2165))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:805
+#: ../../source/ref-changelog.md:827
 msgid ""
 "A new testing infrastructure ensures that new changes stay compatible "
 "with existing framework integrations or strategies."
 msgstr ""
 
-#: ../../source/ref-changelog.md:807
+#: ../../source/ref-changelog.md:829
 msgid "**Deprecate Python 3.7**"
 msgstr ""
 
-#: ../../source/ref-changelog.md:809
+#: ../../source/ref-changelog.md:831
 msgid ""
 "Since Python 3.7 reached its end of life (EOL) on 2023-06-27, support for"
 " Python 3.7 is now deprecated and will be removed in an upcoming release."
 msgstr ""
 
-#: ../../source/ref-changelog.md:811
+#: ../../source/ref-changelog.md:833
 msgid ""
 "**Add new** `FedTrimmedAvg` **strategy** "
 "([#1769](https://github.com/adap/flower/pull/1769), "
 "[#1853](https://github.com/adap/flower/pull/1853))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:813
+#: ../../source/ref-changelog.md:835
 msgid ""
 "The new `FedTrimmedAvg` strategy implements Trimmed Mean by [Dong Yin, "
 "2018](https://arxiv.org/abs/1803.01498)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:815
+#: ../../source/ref-changelog.md:837
 msgid ""
 "**Introduce start_driver** "
 "([#1697](https://github.com/adap/flower/pull/1697))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:817
+#: ../../source/ref-changelog.md:839
 msgid ""
 "In addition to `start_server` and using the raw Driver API, there is a "
 "new `start_driver` function that allows for running `start_server` "
@@ -18812,13 +18898,13 @@ msgid ""
 "`start_driver`."
 msgstr ""
 
-#: ../../source/ref-changelog.md:819
+#: ../../source/ref-changelog.md:841
 msgid ""
 "**Add parameter aggregation to** `mt-pytorch` **code example** "
 "([#1785](https://github.com/adap/flower/pull/1785))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:821
+#: ../../source/ref-changelog.md:843
 msgid ""
 "The `mt-pytorch` example shows how to aggregate parameters when writing a"
 " driver script. The included `driver.py` and `server.py` have been "
@@ -18826,53 +18912,53 @@ msgid ""
 "building server-side logic."
 msgstr ""
 
-#: ../../source/ref-changelog.md:823
+#: ../../source/ref-changelog.md:845
 msgid ""
 "**Migrate experimental REST API to Starlette** "
 "([2171](https://github.com/adap/flower/pull/2171))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:825
+#: ../../source/ref-changelog.md:847
 msgid ""
 "The (experimental) REST API used to be implemented in "
 "[FastAPI](https://fastapi.tiangolo.com/), but it has now been migrated to"
 " use [Starlette](https://www.starlette.io/) directly."
 msgstr ""
 
-#: ../../source/ref-changelog.md:827
+#: ../../source/ref-changelog.md:849
 msgid ""
 "Please note: The REST request-response API is still experimental and will"
 " likely change significantly over time."
 msgstr ""
 
-#: ../../source/ref-changelog.md:829
+#: ../../source/ref-changelog.md:851
 msgid ""
 "**Introduce experimental gRPC request-response API** "
 "([#1867](https://github.com/adap/flower/pull/1867), "
 "[#1901](https://github.com/adap/flower/pull/1901))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:831
+#: ../../source/ref-changelog.md:853
 msgid ""
 "In addition to the existing gRPC API (based on bidirectional streaming) "
 "and the experimental REST API, there is now a new gRPC API that uses a "
 "request-response model to communicate with client nodes."
 msgstr ""
 
-#: ../../source/ref-changelog.md:833
+#: ../../source/ref-changelog.md:855
 msgid ""
 "Please note: The gRPC request-response API is still experimental and will"
 " likely change significantly over time."
 msgstr ""
 
-#: ../../source/ref-changelog.md:835
+#: ../../source/ref-changelog.md:857
 msgid ""
 "**Replace the experimental** `start_client(rest=True)` **with the new** "
 "`start_client(transport=\"rest\")` "
 "([#1880](https://github.com/adap/flower/pull/1880))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:837
+#: ../../source/ref-changelog.md:859
 msgid ""
 "The (experimental) `start_client` argument `rest` was deprecated in "
 "favour of a new argument `transport`. `start_client(transport=\"rest\")` "
@@ -18881,30 +18967,30 @@ msgid ""
 "argument `rest` will be removed in a future release."
 msgstr ""
 
-#: ../../source/ref-changelog.md:839
+#: ../../source/ref-changelog.md:861
 msgid ""
 "**Add a new gRPC option** "
 "([#2197](https://github.com/adap/flower/pull/2197))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:841
+#: ../../source/ref-changelog.md:863
 msgid ""
 "We now start a gRPC server with the `grpc.keepalive_permit_without_calls`"
 " option set to 0 by default. This prevents the clients from sending "
 "keepalive pings when there is no outstanding stream."
 msgstr ""
 
-#: ../../source/ref-changelog.md:843
+#: ../../source/ref-changelog.md:865
 msgid ""
 "**Improve example notebooks** "
 "([#2005](https://github.com/adap/flower/pull/2005))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:845
+#: ../../source/ref-changelog.md:867
 msgid "There's a new 30min Federated Learning PyTorch tutorial!"
 msgstr ""
 
-#: ../../source/ref-changelog.md:847
+#: ../../source/ref-changelog.md:869
 msgid ""
 "**Example updates** ([#1772](https://github.com/adap/flower/pull/1772), "
 "[#1873](https://github.com/adap/flower/pull/1873), "
@@ -18919,7 +19005,7 @@ msgid ""
 "[#2183](https://github.com/adap/flower/pull/2183))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:849
+#: ../../source/ref-changelog.md:871
 msgid ""
 "Many examples have received significant updates, including simplified "
 "advanced-tensorflow and advanced-pytorch examples, improved macOS "
@@ -18928,7 +19014,7 @@ msgid ""
 "(in addition to `pyproject.toml`)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:851
+#: ../../source/ref-changelog.md:873
 msgid ""
 "**General improvements** "
 "([#1872](https://github.com/adap/flower/pull/1872), "
@@ -18939,11 +19025,11 @@ msgid ""
 "[#2171](https://github.com/adap/flower/pull/2171))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:859
+#: ../../source/ref-changelog.md:881
 msgid "v1.4.0 (2023-04-21)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:865
+#: ../../source/ref-changelog.md:887
 msgid ""
 "`Adam Narozniak`, `Alexander Viala Bellander`, `Charles Beauville`, "
 "`Chenyang Ma (Danny)`, `Daniel J. Beutel`, `Edoardo`, `Gautam Jajoo`, "
@@ -18953,7 +19039,7 @@ msgid ""
 "`Steve Laskaridis`, `Steven Hé (Sīchàng)`, `Taner Topal`"
 msgstr ""
 
-#: ../../source/ref-changelog.md:869
+#: ../../source/ref-changelog.md:891
 msgid ""
 "**Introduce support for XGBoost (**`FedXgbNnAvg` **strategy and "
 "example)** ([#1694](https://github.com/adap/flower/pull/1694), "
@@ -18964,7 +19050,7 @@ msgid ""
 "[#1795](https://github.com/adap/flower/pull/1795))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:871
+#: ../../source/ref-changelog.md:893
 msgid ""
 "XGBoost is a tree-based ensemble machine learning algorithm that uses "
 "gradient boosting to improve model accuracy. We added a new `FedXgbNnAvg`"
@@ -18975,14 +19061,14 @@ msgid ""
 "an XGBoost project."
 msgstr ""
 
-#: ../../source/ref-changelog.md:873
+#: ../../source/ref-changelog.md:895
 msgid ""
 "**Introduce iOS SDK (preview)** "
 "([#1621](https://github.com/adap/flower/pull/1621), "
 "[#1764](https://github.com/adap/flower/pull/1764))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:875
+#: ../../source/ref-changelog.md:897
 msgid ""
 "This is a major update for anyone wanting to implement Federated Learning"
 " on iOS mobile devices. We now have a swift iOS SDK present under "
@@ -18993,14 +19079,14 @@ msgid ""
 "been updated!"
 msgstr ""
 
-#: ../../source/ref-changelog.md:877
+#: ../../source/ref-changelog.md:899
 msgid ""
 "**Introduce new \"What is Federated Learning?\" tutorial** "
 "([#1657](https://github.com/adap/flower/pull/1657), "
 "[#1721](https://github.com/adap/flower/pull/1721))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:879
+#: ../../source/ref-changelog.md:901
 msgid ""
 "A new [entry-level tutorial](https://flower.ai/docs/framework/tutorial-"
 "what-is-federated-learning.html) in our documentation explains the basics"
@@ -19009,7 +19095,7 @@ msgid ""
 "interested in Federated Learning!"
 msgstr ""
 
-#: ../../source/ref-changelog.md:881
+#: ../../source/ref-changelog.md:903
 msgid ""
 "**Introduce new Flower Baseline: FedProx MNIST** "
 "([#1513](https://github.com/adap/flower/pull/1513), "
@@ -19018,7 +19104,7 @@ msgid ""
 "[#1679](https://github.com/adap/flower/pull/1679))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:883
+#: ../../source/ref-changelog.md:905
 msgid ""
 "This new baseline replicates the MNIST+CNN task from the paper [Federated"
 " Optimization in Heterogeneous Networks (Li et al., "
@@ -19026,13 +19112,13 @@ msgid ""
 " which aims at making convergence more robust in heterogeneous settings."
 msgstr ""
 
-#: ../../source/ref-changelog.md:885
+#: ../../source/ref-changelog.md:907
 msgid ""
 "**Introduce new Flower Baseline: FedAvg FEMNIST** "
 "([#1655](https://github.com/adap/flower/pull/1655))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:887
+#: ../../source/ref-changelog.md:909
 msgid ""
 "This new baseline replicates an experiment evaluating the performance of "
 "the FedAvg algorithm on the FEMNIST dataset from the paper [LEAF: A "
@@ -19040,7 +19126,7 @@ msgid ""
 "2018)](https://arxiv.org/abs/1812.01097)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:889
+#: ../../source/ref-changelog.md:911
 msgid ""
 "**Introduce (experimental) REST API** "
 "([#1594](https://github.com/adap/flower/pull/1594), "
@@ -19052,20 +19138,20 @@ msgid ""
 "[#1733](https://github.com/adap/flower/pull/1733))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:891
+#: ../../source/ref-changelog.md:913
 msgid ""
 "A new REST API has been introduced as an alternative to the gRPC-based "
 "communication stack. In this initial version, the REST API only supports "
 "anonymous clients."
 msgstr ""
 
-#: ../../source/ref-changelog.md:893
+#: ../../source/ref-changelog.md:915
 msgid ""
 "Please note: The REST API is still experimental and will likely change "
 "significantly over time."
 msgstr ""
 
-#: ../../source/ref-changelog.md:895
+#: ../../source/ref-changelog.md:917
 msgid ""
 "**Improve the (experimental) Driver API** "
 "([#1663](https://github.com/adap/flower/pull/1663), "
@@ -19079,7 +19165,7 @@ msgid ""
 "[#1794](https://github.com/adap/flower/pull/1794))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:897
+#: ../../source/ref-changelog.md:919
 msgid ""
 "The Driver API is still an experimental feature, but this release "
 "introduces some major upgrades. One of the main improvements is the "
@@ -19089,26 +19175,26 @@ msgid ""
 "improves the memory efficiency of a long-running Flower server."
 msgstr ""
 
-#: ../../source/ref-changelog.md:899
+#: ../../source/ref-changelog.md:921
 msgid ""
 "**Fix spilling issues related to Ray during simulations** "
 "([#1698](https://github.com/adap/flower/pull/1698))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:901
+#: ../../source/ref-changelog.md:923
 msgid ""
 "While running long simulations, `ray` was sometimes spilling huge amounts"
 " of data that would make the training unable to continue. This is now "
 "fixed! 🎉"
 msgstr ""
 
-#: ../../source/ref-changelog.md:903
+#: ../../source/ref-changelog.md:925
 msgid ""
 "**Add new example using** `TabNet` **and Flower** "
 "([#1725](https://github.com/adap/flower/pull/1725))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:905
+#: ../../source/ref-changelog.md:927
 msgid ""
 "TabNet is a powerful and flexible framework for training machine learning"
 " models on tabular data. We now have a federated example using Flower: "
@@ -19116,32 +19202,32 @@ msgid ""
 "/quickstart-tabnet)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:907
+#: ../../source/ref-changelog.md:929
 msgid ""
 "**Add new how-to guide for monitoring simulations** "
 "([#1649](https://github.com/adap/flower/pull/1649))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:909
+#: ../../source/ref-changelog.md:931
 msgid ""
 "We now have a documentation guide to help users monitor their performance"
 " during simulations."
 msgstr ""
 
-#: ../../source/ref-changelog.md:911
+#: ../../source/ref-changelog.md:933
 msgid ""
 "**Add training metrics to** `History` **object during simulations** "
 "([#1696](https://github.com/adap/flower/pull/1696))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:913
+#: ../../source/ref-changelog.md:935
 msgid ""
 "The `fit_metrics_aggregation_fn` can be used to aggregate training "
 "metrics, but previous releases did not save the results in the `History` "
 "object. This is now the case!"
 msgstr ""
 
-#: ../../source/ref-changelog.md:915
+#: ../../source/ref-changelog.md:937
 msgid ""
 "**General improvements** "
 "([#1659](https://github.com/adap/flower/pull/1659), "
@@ -19195,23 +19281,23 @@ msgid ""
 "[#1805](https://github.com/adap/flower/pull/1805))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:923
+#: ../../source/ref-changelog.md:945
 msgid "v1.3.0 (2023-02-06)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:929
+#: ../../source/ref-changelog.md:951
 msgid ""
 "`Adam Narozniak`, `Alexander Viala Bellander`, `Charles Beauville`, "
 "`Daniel J. Beutel`, `JDRanpariya`, `Lennart Behme`, `Taner Topal`"
 msgstr ""
 
-#: ../../source/ref-changelog.md:933
+#: ../../source/ref-changelog.md:955
 msgid ""
 "**Add support for** `workload_id` **and** `group_id` **in Driver API** "
 "([#1595](https://github.com/adap/flower/pull/1595))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:935
+#: ../../source/ref-changelog.md:957
 msgid ""
 "The (experimental) Driver API now supports a `workload_id` that can be "
 "used to identify which workload a task belongs to. It also supports a new"
@@ -19220,36 +19306,36 @@ msgid ""
 " to decide whether they want to handle a task or not."
 msgstr ""
 
-#: ../../source/ref-changelog.md:937
+#: ../../source/ref-changelog.md:959
 msgid ""
 "**Make Driver API and Fleet API address configurable** "
 "([#1637](https://github.com/adap/flower/pull/1637))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:939
+#: ../../source/ref-changelog.md:961
 msgid ""
 "The (experimental) long-running Flower server (Driver API and Fleet API) "
 "can now configure the server address of both Driver API (via `--driver-"
 "api-address`) and Fleet API (via `--fleet-api-address`) when starting:"
 msgstr ""
 
-#: ../../source/ref-changelog.md:941
+#: ../../source/ref-changelog.md:963
 msgid ""
 "`flower-server --driver-api-address \"0.0.0.0:8081\" --fleet-api-address "
 "\"0.0.0.0:8086\"`"
 msgstr ""
 
-#: ../../source/ref-changelog.md:943
+#: ../../source/ref-changelog.md:965
 msgid "Both IPv4 and IPv6 addresses are supported."
 msgstr ""
 
-#: ../../source/ref-changelog.md:945
+#: ../../source/ref-changelog.md:967
 msgid ""
 "**Add new example of Federated Learning using fastai and Flower** "
 "([#1598](https://github.com/adap/flower/pull/1598))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:947
+#: ../../source/ref-changelog.md:969
 msgid ""
 "A new code example (`quickstart-fastai`) demonstrates federated learning "
 "with [fastai](https://www.fast.ai/) and Flower. You can find it here: "
@@ -19257,14 +19343,14 @@ msgid ""
 "/quickstart-fastai)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:949
+#: ../../source/ref-changelog.md:971
 msgid ""
 "**Make Android example compatible with** `flwr >= 1.0.0` **and the latest"
 " versions of Android** "
 "([#1603](https://github.com/adap/flower/pull/1603))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:951
+#: ../../source/ref-changelog.md:973
 msgid ""
 "The Android code example has received a substantial update: the project "
 "is compatible with Flower 1.0 (and later), the UI received a full "
@@ -19272,13 +19358,13 @@ msgid ""
 "tooling."
 msgstr ""
 
-#: ../../source/ref-changelog.md:953
+#: ../../source/ref-changelog.md:975
 msgid ""
 "**Add new `FedProx` strategy** "
 "([#1619](https://github.com/adap/flower/pull/1619))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:955
+#: ../../source/ref-changelog.md:977
 msgid ""
 "This "
 "[strategy](https://github.com/adap/flower/blob/main/src/py/flwr/server/strategy/fedprox.py)"
@@ -19290,25 +19376,25 @@ msgid ""
 "respect to the global models."
 msgstr ""
 
-#: ../../source/ref-changelog.md:957
+#: ../../source/ref-changelog.md:979
 msgid ""
 "**Add new metrics to telemetry events** "
 "([#1640](https://github.com/adap/flower/pull/1640))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:959
+#: ../../source/ref-changelog.md:981
 msgid ""
 "An updated event structure allows, for example, the clustering of events "
 "within the same workload."
 msgstr ""
 
-#: ../../source/ref-changelog.md:961
+#: ../../source/ref-changelog.md:983
 msgid ""
 "**Add new custom strategy tutorial section** "
 "[#1623](https://github.com/adap/flower/pull/1623)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:963
+#: ../../source/ref-changelog.md:985
 msgid ""
 "The Flower tutorial now has a new section that covers implementing a "
 "custom strategy from scratch: [Open in "
@@ -19316,13 +19402,13 @@ msgid ""
 "/tutorial-build-a-strategy-from-scratch-pytorch.ipynb)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:965
+#: ../../source/ref-changelog.md:987
 msgid ""
 "**Add new custom serialization tutorial section** "
 "([#1622](https://github.com/adap/flower/pull/1622))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:967
+#: ../../source/ref-changelog.md:989
 msgid ""
 "The Flower tutorial now has a new section that covers custom "
 "serialization: [Open in "
@@ -19330,7 +19416,7 @@ msgid ""
 "/tutorial-customize-the-client-pytorch.ipynb)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:969
+#: ../../source/ref-changelog.md:991
 msgid ""
 "**General improvements** "
 "([#1638](https://github.com/adap/flower/pull/1638), "
@@ -19368,7 +19454,7 @@ msgid ""
 "[#1586](https://github.com/adap/flower/pull/1586))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:973
+#: ../../source/ref-changelog.md:995
 msgid ""
 "**Updated documentation** "
 "([#1629](https://github.com/adap/flower/pull/1629), "
@@ -19380,31 +19466,31 @@ msgid ""
 "[#1614](https://github.com/adap/flower/pull/1614))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:975 ../../source/ref-changelog.md:1042
+#: ../../source/ref-changelog.md:997 ../../source/ref-changelog.md:1064
 msgid ""
 "As usual, the documentation has improved quite a bit. It is another step "
 "in our effort to make the Flower documentation the best documentation of "
 "any project. Stay tuned and as always, feel free to provide feedback!"
 msgstr ""
 
-#: ../../source/ref-changelog.md:981
+#: ../../source/ref-changelog.md:1003
 msgid "v1.2.0 (2023-01-13)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:987
+#: ../../source/ref-changelog.md:1009
 msgid ""
 "`Adam Narozniak`, `Charles Beauville`, `Daniel J. Beutel`, `Edoardo`, `L."
 " Jiang`, `Ragy`, `Taner Topal`, `dannymcy`"
 msgstr ""
 
-#: ../../source/ref-changelog.md:991
+#: ../../source/ref-changelog.md:1013
 msgid ""
 "**Introduce new Flower Baseline: FedAvg MNIST** "
 "([#1497](https://github.com/adap/flower/pull/1497), "
 "[#1552](https://github.com/adap/flower/pull/1552))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:993
+#: ../../source/ref-changelog.md:1015
 msgid ""
 "Over the coming weeks, we will be releasing a number of new reference "
 "implementations useful especially to FL newcomers. They will typically "
@@ -19415,13 +19501,13 @@ msgid ""
 "pack-fedavg-mnist-cnn/)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:995
+#: ../../source/ref-changelog.md:1017
 msgid ""
 "**Improve GPU support in simulations** "
 "([#1555](https://github.com/adap/flower/pull/1555))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:997
+#: ../../source/ref-changelog.md:1019
 msgid ""
 "The Ray-based Virtual Client Engine (`start_simulation`) has been updated"
 " to improve GPU support. The update includes some of the hard-earned "
@@ -19429,45 +19515,45 @@ msgid ""
 "defaults make running GPU-based simulations substantially more robust."
 msgstr ""
 
-#: ../../source/ref-changelog.md:999
+#: ../../source/ref-changelog.md:1021
 msgid ""
 "**Improve GPU support in Jupyter Notebook tutorials** "
 "([#1527](https://github.com/adap/flower/pull/1527), "
 "[#1558](https://github.com/adap/flower/pull/1558))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1001
+#: ../../source/ref-changelog.md:1023
 msgid ""
 "Some users reported that Jupyter Notebooks have not always been easy to "
 "use on GPU instances. We listened and made improvements to all of our "
 "Jupyter notebooks! Check out the updated notebooks here:"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1003
+#: ../../source/ref-changelog.md:1025
 msgid ""
 "[An Introduction to Federated Learning](https://flower.ai/docs/framework"
 "/tutorial-get-started-with-flower-pytorch.html)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1004
+#: ../../source/ref-changelog.md:1026
 msgid ""
 "[Strategies in Federated Learning](https://flower.ai/docs/framework"
 "/tutorial-use-a-federated-learning-strategy-pytorch.html)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1005
+#: ../../source/ref-changelog.md:1027
 msgid ""
 "[Building a Strategy](https://flower.ai/docs/framework/tutorial-build-a"
 "-strategy-from-scratch-pytorch.html)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1006
+#: ../../source/ref-changelog.md:1028
 msgid ""
 "[Client and NumPyClient](https://flower.ai/docs/framework/tutorial-"
 "customize-the-client-pytorch.html)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1008
+#: ../../source/ref-changelog.md:1030
 msgid ""
 "**Introduce optional telemetry** "
 "([#1533](https://github.com/adap/flower/pull/1533), "
@@ -19475,7 +19561,7 @@ msgid ""
 "[#1584](https://github.com/adap/flower/pull/1584))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1010
+#: ../../source/ref-changelog.md:1032
 msgid ""
 "After a [request for "
 "feedback](https://github.com/adap/flower/issues/1534) from the community,"
@@ -19485,7 +19571,7 @@ msgid ""
 "used and what challenges users might face."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1012
+#: ../../source/ref-changelog.md:1034
 msgid ""
 "**Flower is a friendly framework for collaborative AI and data science.**"
 " Staying true to this statement, Flower makes it easy to disable "
@@ -19493,7 +19579,7 @@ msgid ""
 "[Read more.](https://flower.ai/docs/telemetry.html)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1014
+#: ../../source/ref-changelog.md:1036
 msgid ""
 "**Introduce (experimental) Driver API** "
 "([#1520](https://github.com/adap/flower/pull/1520), "
@@ -19505,7 +19591,7 @@ msgid ""
 "[#1567](https://github.com/adap/flower/pull/1567))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1016
+#: ../../source/ref-changelog.md:1038
 msgid ""
 "Flower now has a new (experimental) Driver API which will enable fully "
 "programmable, async, and multi-tenant Federated Learning and Federated "
@@ -19514,7 +19600,7 @@ msgid ""
 "and you can start building those things now, too."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1018
+#: ../../source/ref-changelog.md:1040
 msgid ""
 "The Driver API also enables a new execution mode in which the server runs"
 " indefinitely. Multiple individual workloads can run concurrently and "
@@ -19522,26 +19608,26 @@ msgid ""
 "especially useful for users who want to deploy Flower in production."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1020
+#: ../../source/ref-changelog.md:1042
 msgid ""
 "To learn more, check out the `mt-pytorch` code example. We look forward "
 "to you feedback!"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1022
+#: ../../source/ref-changelog.md:1044
 msgid ""
 "Please note: *The Driver API is still experimental and will likely change"
 " significantly over time.*"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1024
+#: ../../source/ref-changelog.md:1046
 msgid ""
 "**Add new Federated Analytics with Pandas example** "
 "([#1469](https://github.com/adap/flower/pull/1469), "
 "[#1535](https://github.com/adap/flower/pull/1535))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1026
+#: ../../source/ref-changelog.md:1048
 msgid ""
 "A new code example (`quickstart-pandas`) demonstrates federated analytics"
 " with Pandas and Flower. You can find it here: [quickstart-"
@@ -19549,32 +19635,32 @@ msgid ""
 "pandas)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1028
+#: ../../source/ref-changelog.md:1050
 msgid ""
 "**Add new strategies: Krum and MultiKrum** "
 "([#1481](https://github.com/adap/flower/pull/1481))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1030
+#: ../../source/ref-changelog.md:1052
 msgid ""
 "Edoardo, a computer science student at the Sapienza University of Rome, "
 "contributed a new `Krum` strategy that enables users to easily use Krum "
 "and MultiKrum in their workloads."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1032
+#: ../../source/ref-changelog.md:1054
 msgid ""
 "**Update C++ example to be compatible with Flower v1.2.0** "
 "([#1495](https://github.com/adap/flower/pull/1495))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1034
+#: ../../source/ref-changelog.md:1056
 msgid ""
 "The C++ code example has received a substantial update to make it "
 "compatible with the latest version of Flower."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1036
+#: ../../source/ref-changelog.md:1058
 msgid ""
 "**General improvements** "
 "([#1491](https://github.com/adap/flower/pull/1491), "
@@ -19592,7 +19678,7 @@ msgid ""
 "[#1566](https://github.com/adap/flower/pull/1566))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1040
+#: ../../source/ref-changelog.md:1062
 msgid ""
 "**Updated documentation** "
 "([#1494](https://github.com/adap/flower/pull/1494), "
@@ -19606,24 +19692,24 @@ msgid ""
 "[#1515](https://github.com/adap/flower/pull/1515))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1044
+#: ../../source/ref-changelog.md:1066
 msgid ""
 "One highlight is the new [first time contributor "
 "guide](https://flower.ai/docs/first-time-contributors.html): if you've "
 "never contributed on GitHub before, this is the perfect place to start!"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1050
+#: ../../source/ref-changelog.md:1072
 msgid "v1.1.0 (2022-10-31)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1054
+#: ../../source/ref-changelog.md:1076
 msgid ""
 "We would like to give our **special thanks** to all the contributors who "
 "made the new version of Flower possible (in `git shortlog` order):"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1056
+#: ../../source/ref-changelog.md:1078
 msgid ""
 "`Akis Linardos`, `Christopher S`, `Daniel J. Beutel`, `George`, `Jan "
 "Schlicht`, `Mohammad Fares`, `Pedro Porto Buarque de Gusmão`, `Philipp "
@@ -19631,14 +19717,14 @@ msgid ""
 "`danielnugraha`, `edogab33`"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1060
+#: ../../source/ref-changelog.md:1082
 msgid ""
 "**Introduce Differential Privacy wrappers (preview)** "
 "([#1357](https://github.com/adap/flower/pull/1357), "
 "[#1460](https://github.com/adap/flower/pull/1460))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1062
+#: ../../source/ref-changelog.md:1084
 msgid ""
 "The first (experimental) preview of pluggable Differential Privacy "
 "wrappers enables easy configuration and usage of differential privacy "
@@ -19647,13 +19733,13 @@ msgid ""
 "over to the Flower docs, a new explainer goes into more detail."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1064
+#: ../../source/ref-changelog.md:1086
 msgid ""
 "**New iOS CoreML code example** "
 "([#1289](https://github.com/adap/flower/pull/1289))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1066
+#: ../../source/ref-changelog.md:1088
 msgid ""
 "Flower goes iOS! A massive new code example shows how Flower clients can "
 "be built for iOS. The code example contains both Flower iOS SDK "
@@ -19661,39 +19747,39 @@ msgid ""
 "on CoreML."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1068
+#: ../../source/ref-changelog.md:1090
 msgid ""
 "**New FedMedian strategy** "
 "([#1461](https://github.com/adap/flower/pull/1461))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1070
+#: ../../source/ref-changelog.md:1092
 msgid ""
 "The new `FedMedian` strategy implements Federated Median (FedMedian) by "
 "[Yin et al., 2018](https://arxiv.org/pdf/1803.01498v1.pdf)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1072
+#: ../../source/ref-changelog.md:1094
 msgid ""
 "**Log** `Client` **exceptions in Virtual Client Engine** "
 "([#1493](https://github.com/adap/flower/pull/1493))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1074
+#: ../../source/ref-changelog.md:1096
 msgid ""
 "All `Client` exceptions happening in the VCE are now logged by default "
 "and not just exposed to the configured `Strategy` (via the `failures` "
 "argument)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1076
+#: ../../source/ref-changelog.md:1098
 msgid ""
 "**Improve Virtual Client Engine internals** "
 "([#1401](https://github.com/adap/flower/pull/1401), "
 "[#1453](https://github.com/adap/flower/pull/1453))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1078
+#: ../../source/ref-changelog.md:1100
 msgid ""
 "Some internals of the Virtual Client Engine have been revamped. The VCE "
 "now uses Ray 2.0 under the hood, the value type of the `client_resources`"
@@ -19701,25 +19787,25 @@ msgid ""
 "allocated."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1080
+#: ../../source/ref-changelog.md:1102
 msgid ""
 "**Support optional** `Client`**/**`NumPyClient` **methods in Virtual "
 "Client Engine**"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1082
+#: ../../source/ref-changelog.md:1104
 msgid ""
 "The Virtual Client Engine now has full support for optional `Client` (and"
 " `NumPyClient`) methods."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1084
+#: ../../source/ref-changelog.md:1106
 msgid ""
 "**Provide type information to packages using** `flwr` "
 "([#1377](https://github.com/adap/flower/pull/1377))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1086
+#: ../../source/ref-changelog.md:1108
 msgid ""
 "The package `flwr` is now bundled with a `py.typed` file indicating that "
 "the package is typed. This enables typing support for projects or "
@@ -19727,20 +19813,20 @@ msgid ""
 "static type checkers like `mypy`."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1088
+#: ../../source/ref-changelog.md:1110
 msgid ""
 "**Updated code example** "
 "([#1344](https://github.com/adap/flower/pull/1344), "
 "[#1347](https://github.com/adap/flower/pull/1347))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1090
+#: ../../source/ref-changelog.md:1112
 msgid ""
 "The code examples covering scikit-learn and PyTorch Lightning have been "
 "updated to work with the latest version of Flower."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1092
+#: ../../source/ref-changelog.md:1114
 msgid ""
 "**Updated documentation** "
 "([#1355](https://github.com/adap/flower/pull/1355), "
@@ -19762,32 +19848,32 @@ msgid ""
 "[#1467](https://github.com/adap/flower/pull/1467))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1094
+#: ../../source/ref-changelog.md:1116
 msgid ""
 "There have been so many documentation updates that it doesn't even make "
 "sense to list them individually."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1096
+#: ../../source/ref-changelog.md:1118
 msgid ""
 "**Restructured documentation** "
 "([#1387](https://github.com/adap/flower/pull/1387))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1098
+#: ../../source/ref-changelog.md:1120
 msgid ""
 "The documentation has been restructured to make it easier to navigate. "
 "This is just the first step in a larger effort to make the Flower "
 "documentation the best documentation of any project ever. Stay tuned!"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1100
+#: ../../source/ref-changelog.md:1122
 msgid ""
 "**Open in Colab button** "
 "([#1389](https://github.com/adap/flower/pull/1389))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1102
+#: ../../source/ref-changelog.md:1124
 msgid ""
 "The four parts of the Flower Federated Learning Tutorial now come with a "
 "new `Open in Colab` button. No need to install anything on your local "
@@ -19795,7 +19881,7 @@ msgid ""
 "only a single click away."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1104
+#: ../../source/ref-changelog.md:1126
 msgid ""
 "**Improved tutorial** ([#1468](https://github.com/adap/flower/pull/1468),"
 " [#1470](https://github.com/adap/flower/pull/1470), "
@@ -19805,7 +19891,7 @@ msgid ""
 "[#1475](https://github.com/adap/flower/pull/1475))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1106
+#: ../../source/ref-changelog.md:1128
 msgid ""
 "The Flower Federated Learning Tutorial has two brand-new parts covering "
 "custom strategies (still WIP) and the distinction between `Client` and "
@@ -19813,40 +19899,40 @@ msgid ""
 "(many small changes and fixes)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1112
+#: ../../source/ref-changelog.md:1134
 msgid "v1.0.0 (2022-07-28)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1114
+#: ../../source/ref-changelog.md:1136
 msgid "Highlights"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1116
+#: ../../source/ref-changelog.md:1138
 msgid "Stable **Virtual Client Engine** (accessible via `start_simulation`)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1117
+#: ../../source/ref-changelog.md:1139
 msgid "All `Client`/`NumPyClient` methods are now optional"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1118
+#: ../../source/ref-changelog.md:1140
 msgid "Configurable `get_parameters`"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1119
+#: ../../source/ref-changelog.md:1141
 msgid ""
 "Tons of small API cleanups resulting in a more coherent developer "
 "experience"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1123
+#: ../../source/ref-changelog.md:1145
 msgid ""
 "We would like to give our **special thanks** to all the contributors who "
 "made Flower 1.0 possible (in reverse [GitHub "
 "Contributors](https://github.com/adap/flower/graphs/contributors) order):"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1125
+#: ../../source/ref-changelog.md:1147
 msgid ""
 "[@rtaiello](https://github.com/rtaiello), "
 "[@g-pichler](https://github.com/g-pichler), [@rob-"
@@ -19886,13 +19972,13 @@ msgid ""
 "[@danieljanes](https://github.com/danieljanes)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1129
+#: ../../source/ref-changelog.md:1151
 msgid ""
 "**All arguments must be passed as keyword arguments** "
 "([#1338](https://github.com/adap/flower/pull/1338))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1131
+#: ../../source/ref-changelog.md:1153
 msgid ""
 "Pass all arguments as keyword arguments, positional arguments are not "
 "longer supported. Code that uses positional arguments (e.g., "
@@ -19902,14 +19988,14 @@ msgid ""
 "client=FlowerClient())`)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1133
+#: ../../source/ref-changelog.md:1155
 msgid ""
 "**Introduce configuration object** `ServerConfig` **in** `start_server` "
 "**and** `start_simulation` "
 "([#1317](https://github.com/adap/flower/pull/1317))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1135
+#: ../../source/ref-changelog.md:1157
 msgid ""
 "Instead of a config dictionary `{\"num_rounds\": 3, \"round_timeout\": "
 "600.0}`, `start_server` and `start_simulation` now expect a configuration"
@@ -19918,37 +20004,37 @@ msgid ""
 "safe code easier and the default parameters values more transparent."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1137
+#: ../../source/ref-changelog.md:1159
 msgid ""
 "**Rename built-in strategy parameters for clarity** "
 "([#1334](https://github.com/adap/flower/pull/1334))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1139
+#: ../../source/ref-changelog.md:1161
 msgid ""
 "The following built-in strategy parameters were renamed to improve "
 "readability and consistency with other API's:"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1141
+#: ../../source/ref-changelog.md:1163
 msgid "`fraction_eval` --> `fraction_evaluate`"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1142
+#: ../../source/ref-changelog.md:1164
 msgid "`min_eval_clients` --> `min_evaluate_clients`"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1143
+#: ../../source/ref-changelog.md:1165
 msgid "`eval_fn` --> `evaluate_fn`"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1145
+#: ../../source/ref-changelog.md:1167
 msgid ""
 "**Update default arguments of built-in strategies** "
 "([#1278](https://github.com/adap/flower/pull/1278))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1147
+#: ../../source/ref-changelog.md:1169
 msgid ""
 "All built-in strategies now use `fraction_fit=1.0` and "
 "`fraction_evaluate=1.0`, which means they select *all* currently "
@@ -19957,29 +20043,29 @@ msgid ""
 "initializing the strategy in the following way:"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1149
+#: ../../source/ref-changelog.md:1171
 msgid "`strategy = FedAvg(fraction_fit=0.1, fraction_evaluate=0.1)`"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1151
+#: ../../source/ref-changelog.md:1173
 msgid ""
 "**Add** `server_round` **to** `Strategy.evaluate` "
 "([#1334](https://github.com/adap/flower/pull/1334))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1153
+#: ../../source/ref-changelog.md:1175
 msgid ""
 "The `Strategy` method `evaluate` now receives the current round of "
 "federated learning/evaluation as the first parameter."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1155
+#: ../../source/ref-changelog.md:1177
 msgid ""
 "**Add** `server_round` **and** `config` **parameters to** `evaluate_fn` "
 "([#1334](https://github.com/adap/flower/pull/1334))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1157
+#: ../../source/ref-changelog.md:1179
 msgid ""
 "The `evaluate_fn` passed to built-in strategies like `FedAvg` now takes "
 "three parameters: (1) The current round of federated learning/evaluation "
@@ -19987,13 +20073,13 @@ msgid ""
 "and (3) a config dictionary (`config`)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1159
+#: ../../source/ref-changelog.md:1181
 msgid ""
 "**Rename** `rnd` **to** `server_round` "
 "([#1321](https://github.com/adap/flower/pull/1321))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1161
+#: ../../source/ref-changelog.md:1183
 msgid ""
 "Several Flower methods and functions (`evaluate_fn`, `configure_fit`, "
 "`aggregate_fit`, `configure_evaluate`, `aggregate_evaluate`) receive the "
@@ -20002,73 +20088,73 @@ msgid ""
 "has been renamed from `rnd` to `server_round`."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1163
+#: ../../source/ref-changelog.md:1185
 msgid ""
 "**Move** `flwr.dataset` **to** `flwr_baselines` "
 "([#1273](https://github.com/adap/flower/pull/1273))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1165
+#: ../../source/ref-changelog.md:1187
 msgid "The experimental package `flwr.dataset` was migrated to Flower Baselines."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1167
+#: ../../source/ref-changelog.md:1189
 msgid ""
 "**Remove experimental strategies** "
 "([#1280](https://github.com/adap/flower/pull/1280))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1169
+#: ../../source/ref-changelog.md:1191
 msgid ""
 "Remove unmaintained experimental strategies (`FastAndSlow`, `FedFSv0`, "
 "`FedFSv1`)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1171
+#: ../../source/ref-changelog.md:1193
 msgid ""
 "**Rename** `Weights` **to** `NDArrays` "
 "([#1258](https://github.com/adap/flower/pull/1258), "
 "[#1259](https://github.com/adap/flower/pull/1259))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1173
+#: ../../source/ref-changelog.md:1195
 msgid ""
 "`flwr.common.Weights` was renamed to `flwr.common.NDArrays` to better "
 "capture what this type is all about."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1175
+#: ../../source/ref-changelog.md:1197
 msgid ""
 "**Remove antiquated** `force_final_distributed_eval` **from** "
 "`start_server` ([#1258](https://github.com/adap/flower/pull/1258), "
 "[#1259](https://github.com/adap/flower/pull/1259))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1177
+#: ../../source/ref-changelog.md:1199
 msgid ""
 "The `start_server` parameter `force_final_distributed_eval` has long been"
 " a historic artefact, in this release it is finally gone for good."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1179
+#: ../../source/ref-changelog.md:1201
 msgid ""
 "**Make** `get_parameters` **configurable** "
 "([#1242](https://github.com/adap/flower/pull/1242))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1181
+#: ../../source/ref-changelog.md:1203
 msgid ""
 "The `get_parameters` method now accepts a configuration dictionary, just "
 "like `get_properties`, `fit`, and `evaluate`."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1183
+#: ../../source/ref-changelog.md:1205
 msgid ""
 "**Replace** `num_rounds` **in** `start_simulation` **with new** `config` "
 "**parameter** ([#1281](https://github.com/adap/flower/pull/1281))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1185
+#: ../../source/ref-changelog.md:1207
 msgid ""
 "The `start_simulation` function now accepts a configuration dictionary "
 "`config` instead of the `num_rounds` integer. This improves the "
@@ -20076,26 +20162,26 @@ msgid ""
 "transitioning between the two easier."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1189
+#: ../../source/ref-changelog.md:1211
 msgid ""
 "**Support Python 3.10** "
 "([#1320](https://github.com/adap/flower/pull/1320))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1191
+#: ../../source/ref-changelog.md:1213
 msgid ""
 "The previous Flower release introduced experimental support for Python "
 "3.10, this release declares Python 3.10 support as stable."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1193
+#: ../../source/ref-changelog.md:1215
 msgid ""
 "**Make all** `Client` **and** `NumPyClient` **methods optional** "
 "([#1260](https://github.com/adap/flower/pull/1260), "
 "[#1277](https://github.com/adap/flower/pull/1277))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1195
+#: ../../source/ref-changelog.md:1217
 msgid ""
 "The `Client`/`NumPyClient` methods `get_properties`, `get_parameters`, "
 "`fit`, and `evaluate` are all optional. This enables writing clients that"
@@ -20103,13 +20189,13 @@ msgid ""
 "implement `evaluate` when using centralized evaluation!"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1197
+#: ../../source/ref-changelog.md:1219
 msgid ""
 "**Enable passing a** `Server` **instance to** `start_simulation` "
 "([#1281](https://github.com/adap/flower/pull/1281))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1199
+#: ../../source/ref-changelog.md:1221
 msgid ""
 "Similar to `start_server`, `start_simulation` now accepts a full `Server`"
 " instance. This enables users to heavily customize the execution of "
@@ -20117,7 +20203,7 @@ msgid ""
 " Virtual Client Engine."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1201
+#: ../../source/ref-changelog.md:1223
 msgid ""
 "**Update code examples** "
 "([#1291](https://github.com/adap/flower/pull/1291), "
@@ -20125,50 +20211,50 @@ msgid ""
 "[#1282](https://github.com/adap/flower/pull/1282))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1203
+#: ../../source/ref-changelog.md:1225
 msgid ""
 "Many code examples received small or even large maintenance updates, "
 "among them are"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1205
+#: ../../source/ref-changelog.md:1227
 msgid "`scikit-learn`"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1206
+#: ../../source/ref-changelog.md:1228
 msgid "`simulation_pytorch`"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1207
+#: ../../source/ref-changelog.md:1229
 msgid "`quickstart_pytorch`"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1208
+#: ../../source/ref-changelog.md:1230
 msgid "`quickstart_simulation`"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1209
+#: ../../source/ref-changelog.md:1231
 msgid "`quickstart_tensorflow`"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1210
+#: ../../source/ref-changelog.md:1232
 msgid "`advanced_tensorflow`"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1212
+#: ../../source/ref-changelog.md:1234
 msgid ""
 "**Remove the obsolete simulation example** "
 "([#1328](https://github.com/adap/flower/pull/1328))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1214
+#: ../../source/ref-changelog.md:1236
 msgid ""
 "Removes the obsolete `simulation` example and renames "
 "`quickstart_simulation` to `simulation_tensorflow` so it fits withs the "
 "naming of `simulation_pytorch`"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1216
+#: ../../source/ref-changelog.md:1238
 msgid ""
 "**Update documentation** "
 "([#1223](https://github.com/adap/flower/pull/1223), "
@@ -20183,7 +20269,7 @@ msgid ""
 "[#1307](https://github.com/adap/flower/pull/1307))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1218
+#: ../../source/ref-changelog.md:1240
 msgid ""
 "One substantial documentation update fixes multiple smaller rendering "
 "issues, makes titles more succinct to improve navigation, removes a "
@@ -20193,24 +20279,24 @@ msgid ""
 "fixes a number of smaller details!"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1220 ../../source/ref-changelog.md:1275
-#: ../../source/ref-changelog.md:1344 ../../source/ref-changelog.md:1383
+#: ../../source/ref-changelog.md:1242 ../../source/ref-changelog.md:1297
+#: ../../source/ref-changelog.md:1366 ../../source/ref-changelog.md:1405
 msgid "**Minor updates**"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1222
+#: ../../source/ref-changelog.md:1244
 msgid ""
 "Add round number to fit and evaluate log messages "
 "([#1266](https://github.com/adap/flower/pull/1266))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1223
+#: ../../source/ref-changelog.md:1245
 msgid ""
 "Add secure gRPC connection to the `advanced_tensorflow` code example "
 "([#847](https://github.com/adap/flower/pull/847))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1224
+#: ../../source/ref-changelog.md:1246
 msgid ""
 "Update developer tooling "
 "([#1231](https://github.com/adap/flower/pull/1231), "
@@ -20219,7 +20305,7 @@ msgid ""
 "[#1310](https://github.com/adap/flower/pull/1310))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1225
+#: ../../source/ref-changelog.md:1247
 msgid ""
 "Rename ProtoBuf messages to improve consistency "
 "([#1214](https://github.com/adap/flower/pull/1214), "
@@ -20227,11 +20313,11 @@ msgid ""
 "[#1259](https://github.com/adap/flower/pull/1259))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1227
+#: ../../source/ref-changelog.md:1249
 msgid "v0.19.0 (2022-05-18)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1231
+#: ../../source/ref-changelog.md:1253
 msgid ""
 "**Flower Baselines (preview): FedOpt, FedBN, FedAvgM** "
 "([#919](https://github.com/adap/flower/pull/919), "
@@ -20239,7 +20325,7 @@ msgid ""
 "[#914](https://github.com/adap/flower/pull/914))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1233
+#: ../../source/ref-changelog.md:1255
 msgid ""
 "The first preview release of Flower Baselines has arrived! We're "
 "kickstarting Flower Baselines with implementations of FedOpt (FedYogi, "
@@ -20250,39 +20336,39 @@ msgid ""
 "contribute-baselines.html)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1235
+#: ../../source/ref-changelog.md:1257
 msgid ""
 "**C++ client SDK (preview) and code example** "
 "([#1111](https://github.com/adap/flower/pull/1111))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1237
+#: ../../source/ref-changelog.md:1259
 msgid ""
 "Preview support for Flower clients written in C++. The C++ preview "
 "includes a Flower client SDK and a quickstart code example that "
 "demonstrates a simple C++ client using the SDK."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1239
+#: ../../source/ref-changelog.md:1261
 msgid ""
 "**Add experimental support for Python 3.10 and Python 3.11** "
 "([#1135](https://github.com/adap/flower/pull/1135))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1241
+#: ../../source/ref-changelog.md:1263
 msgid ""
 "Python 3.10 is the latest stable release of Python and Python 3.11 is due"
 " to be released in October. This Flower release adds experimental support"
 " for both Python versions."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1243
+#: ../../source/ref-changelog.md:1265
 msgid ""
 "**Aggregate custom metrics through user-provided functions** "
 "([#1144](https://github.com/adap/flower/pull/1144))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1245
+#: ../../source/ref-changelog.md:1267
 msgid ""
 "Custom metrics (e.g., `accuracy`) can now be aggregated without having to"
 " customize the strategy. Built-in strategies support two new arguments, "
@@ -20290,13 +20376,13 @@ msgid ""
 "allow passing custom metric aggregation functions."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1247
+#: ../../source/ref-changelog.md:1269
 msgid ""
 "**User-configurable round timeout** "
 "([#1162](https://github.com/adap/flower/pull/1162))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1249
+#: ../../source/ref-changelog.md:1271
 msgid ""
 "A new configuration value allows the round timeout to be set for "
 "`start_server` and `start_simulation`. If the `config` dictionary "
@@ -20305,14 +20391,14 @@ msgid ""
 "connection."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1251
+#: ../../source/ref-changelog.md:1273
 msgid ""
 "**Enable both federated evaluation and centralized evaluation to be used "
 "at the same time in all built-in strategies** "
 "([#1091](https://github.com/adap/flower/pull/1091))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1253
+#: ../../source/ref-changelog.md:1275
 msgid ""
 "Built-in strategies can now perform both federated evaluation (i.e., "
 "client-side) and centralized evaluation (i.e., server-side) in the same "
@@ -20320,82 +20406,82 @@ msgid ""
 " `0.0`."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1255
+#: ../../source/ref-changelog.md:1277
 msgid ""
 "**Two new Jupyter Notebook tutorials** "
 "([#1141](https://github.com/adap/flower/pull/1141))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1257
+#: ../../source/ref-changelog.md:1279
 msgid ""
 "Two Jupyter Notebook tutorials (compatible with Google Colab) explain "
 "basic and intermediate Flower features:"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1259
+#: ../../source/ref-changelog.md:1281
 msgid ""
 "*An Introduction to Federated Learning*: [Open in "
 "Colab](https://colab.research.google.com/github/adap/flower/blob/main/tutorials/Flower-1"
 "-Intro-to-FL-PyTorch.ipynb)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1261
+#: ../../source/ref-changelog.md:1283
 msgid ""
 "*Using Strategies in Federated Learning*: [Open in "
 "Colab](https://colab.research.google.com/github/adap/flower/blob/main/tutorials/Flower-2"
 "-Strategies-in-FL-PyTorch.ipynb)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1263
+#: ../../source/ref-changelog.md:1285
 msgid ""
 "**New FedAvgM strategy (Federated Averaging with Server Momentum)** "
 "([#1076](https://github.com/adap/flower/pull/1076))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1265
+#: ../../source/ref-changelog.md:1287
 msgid ""
 "The new `FedAvgM` strategy implements Federated Averaging with Server "
 "Momentum \\[Hsu et al., 2019\\]."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1267
+#: ../../source/ref-changelog.md:1289
 msgid ""
 "**New advanced PyTorch code example** "
 "([#1007](https://github.com/adap/flower/pull/1007))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1269
+#: ../../source/ref-changelog.md:1291
 msgid ""
 "A new code example (`advanced_pytorch`) demonstrates advanced Flower "
 "concepts with PyTorch."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1271
+#: ../../source/ref-changelog.md:1293
 msgid ""
 "**New JAX code example** "
 "([#906](https://github.com/adap/flower/pull/906), "
 "[#1143](https://github.com/adap/flower/pull/1143))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1273
+#: ../../source/ref-changelog.md:1295
 msgid ""
 "A new code example (`jax_from_centralized_to_federated`) shows federated "
 "learning with JAX and Flower."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1277
+#: ../../source/ref-changelog.md:1299
 msgid ""
 "New option to keep Ray running if Ray was already initialized in "
 "`start_simulation` ([#1177](https://github.com/adap/flower/pull/1177))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1278
+#: ../../source/ref-changelog.md:1300
 msgid ""
 "Add support for custom `ClientManager` as a `start_simulation` parameter "
 "([#1171](https://github.com/adap/flower/pull/1171))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1279
+#: ../../source/ref-changelog.md:1301
 msgid ""
 "New documentation for [implementing "
 "strategies](https://flower.ai/docs/framework/how-to-implement-"
@@ -20403,72 +20489,72 @@ msgid ""
 "[#1175](https://github.com/adap/flower/pull/1175))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1280
+#: ../../source/ref-changelog.md:1302
 msgid ""
 "New mobile-friendly documentation theme "
 "([#1174](https://github.com/adap/flower/pull/1174))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1281
+#: ../../source/ref-changelog.md:1303
 msgid ""
 "Limit version range for (optional) `ray` dependency to include only "
 "compatible releases (`>=1.9.2,<1.12.0`) "
 "([#1205](https://github.com/adap/flower/pull/1205))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1285
+#: ../../source/ref-changelog.md:1307
 msgid ""
 "**Remove deprecated support for Python 3.6** "
 "([#871](https://github.com/adap/flower/pull/871))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1286
+#: ../../source/ref-changelog.md:1308
 msgid ""
 "**Remove deprecated KerasClient** "
 "([#857](https://github.com/adap/flower/pull/857))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1287
+#: ../../source/ref-changelog.md:1309
 msgid ""
 "**Remove deprecated no-op extra installs** "
 "([#973](https://github.com/adap/flower/pull/973))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1288
+#: ../../source/ref-changelog.md:1310
 msgid ""
 "**Remove deprecated proto fields from** `FitRes` **and** `EvaluateRes` "
 "([#869](https://github.com/adap/flower/pull/869))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1289
+#: ../../source/ref-changelog.md:1311
 msgid ""
 "**Remove deprecated QffedAvg strategy (replaced by QFedAvg)** "
 "([#1107](https://github.com/adap/flower/pull/1107))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1290
+#: ../../source/ref-changelog.md:1312
 msgid ""
 "**Remove deprecated DefaultStrategy strategy** "
 "([#1142](https://github.com/adap/flower/pull/1142))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1291
+#: ../../source/ref-changelog.md:1313
 msgid ""
 "**Remove deprecated support for eval_fn accuracy return value** "
 "([#1142](https://github.com/adap/flower/pull/1142))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1292
+#: ../../source/ref-changelog.md:1314
 msgid ""
 "**Remove deprecated support for passing initial parameters as NumPy "
 "ndarrays** ([#1142](https://github.com/adap/flower/pull/1142))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1294
+#: ../../source/ref-changelog.md:1316
 msgid "v0.18.0 (2022-02-28)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1298
+#: ../../source/ref-changelog.md:1320
 msgid ""
 "**Improved Virtual Client Engine compatibility with Jupyter Notebook / "
 "Google Colab** ([#866](https://github.com/adap/flower/pull/866), "
@@ -20477,7 +20563,7 @@ msgid ""
 "[#1036](https://github.com/adap/flower/pull/1036))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1300
+#: ../../source/ref-changelog.md:1322
 msgid ""
 "Simulations (using the Virtual Client Engine through `start_simulation`) "
 "now work more smoothly on Jupyter Notebooks (incl. Google Colab) after "
@@ -20485,38 +20571,38 @@ msgid ""
 "'flwr[simulation]'`)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1302
+#: ../../source/ref-changelog.md:1324
 msgid ""
 "**New Jupyter Notebook code example** "
 "([#833](https://github.com/adap/flower/pull/833))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1304
+#: ../../source/ref-changelog.md:1326
 msgid ""
 "A new code example (`quickstart_simulation`) demonstrates Flower "
 "simulations using the Virtual Client Engine through Jupyter Notebook "
 "(incl. Google Colab)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1306
+#: ../../source/ref-changelog.md:1328
 msgid ""
 "**Client properties (feature preview)** "
 "([#795](https://github.com/adap/flower/pull/795))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1308
+#: ../../source/ref-changelog.md:1330
 msgid ""
 "Clients can implement a new method `get_properties` to enable server-side"
 " strategies to query client properties."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1310
+#: ../../source/ref-changelog.md:1332
 msgid ""
 "**Experimental Android support with TFLite** "
 "([#865](https://github.com/adap/flower/pull/865))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1312
+#: ../../source/ref-changelog.md:1334
 msgid ""
 "Android support has finally arrived in `main`! Flower is both client-"
 "agnostic and framework-agnostic by design. One can integrate arbitrary "
@@ -20524,7 +20610,7 @@ msgid ""
 "become a lot easier."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1314
+#: ../../source/ref-changelog.md:1336
 msgid ""
 "The example uses TFLite on the client side, along with a new "
 "`FedAvgAndroid` strategy. The Android client and `FedAvgAndroid` are "
@@ -20533,13 +20619,13 @@ msgid ""
 " functionality from `FedAvgAndroid`."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1316
+#: ../../source/ref-changelog.md:1338
 msgid ""
 "**Make gRPC keepalive time user-configurable and decrease default "
 "keepalive time** ([#1069](https://github.com/adap/flower/pull/1069))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1318
+#: ../../source/ref-changelog.md:1340
 msgid ""
 "The default gRPC keepalive time has been reduced to increase the "
 "compatibility of Flower with more cloud environments (for example, "
@@ -20547,31 +20633,31 @@ msgid ""
 " gRPC stack based on specific requirements."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1320
+#: ../../source/ref-changelog.md:1342
 msgid ""
 "**New differential privacy example using Opacus and PyTorch** "
 "([#805](https://github.com/adap/flower/pull/805))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1322
+#: ../../source/ref-changelog.md:1344
 msgid ""
 "A new code example (`opacus`) demonstrates differentially-private "
 "federated learning with Opacus, PyTorch, and Flower."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1324
+#: ../../source/ref-changelog.md:1346
 msgid ""
 "**New Hugging Face Transformers code example** "
 "([#863](https://github.com/adap/flower/pull/863))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1326
+#: ../../source/ref-changelog.md:1348
 msgid ""
 "A new code example (`quickstart_huggingface`) demonstrates usage of "
 "Hugging Face Transformers with Flower."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1328
+#: ../../source/ref-changelog.md:1350
 msgid ""
 "**New MLCube code example** "
 "([#779](https://github.com/adap/flower/pull/779), "
@@ -20580,13 +20666,13 @@ msgid ""
 "[#1090](https://github.com/adap/flower/pull/1090))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1330
+#: ../../source/ref-changelog.md:1352
 msgid ""
 "A new code example (`quickstart_mlcube`) demonstrates usage of MLCube "
 "with Flower."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1332
+#: ../../source/ref-changelog.md:1354
 msgid ""
 "**SSL-enabled server and client** "
 "([#842](https://github.com/adap/flower/pull/842),  "
@@ -20597,33 +20683,33 @@ msgid ""
 "[#994](https://github.com/adap/flower/pull/994))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1334
+#: ../../source/ref-changelog.md:1356
 msgid ""
 "SSL enables secure encrypted connections between clients and servers. "
 "This release open-sources the Flower secure gRPC implementation to make "
 "encrypted communication channels accessible to all Flower users."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1336
+#: ../../source/ref-changelog.md:1358
 msgid ""
 "**Updated** `FedAdam` **and** `FedYogi` **strategies** "
 "([#885](https://github.com/adap/flower/pull/885), "
 "[#895](https://github.com/adap/flower/pull/895))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1338
+#: ../../source/ref-changelog.md:1360
 msgid ""
 "`FedAdam` and `FedAdam` match the latest version of the Adaptive "
 "Federated Optimization paper."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1340
+#: ../../source/ref-changelog.md:1362
 msgid ""
 "**Initialize** `start_simulation` **with a list of client IDs** "
 "([#860](https://github.com/adap/flower/pull/860))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1342
+#: ../../source/ref-changelog.md:1364
 msgid ""
 "`start_simulation` can now be called with a list of client IDs "
 "(`clients_ids`, type: `List[str]`). Those IDs will be passed to the "
@@ -20632,55 +20718,55 @@ msgid ""
 "identifiers."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1346
+#: ../../source/ref-changelog.md:1368
 msgid ""
 "Update `num_examples` calculation in PyTorch code examples in "
 "([#909](https://github.com/adap/flower/pull/909))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1347
+#: ../../source/ref-changelog.md:1369
 msgid ""
 "Expose Flower version through `flwr.__version__` "
 "([#952](https://github.com/adap/flower/pull/952))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1348
+#: ../../source/ref-changelog.md:1370
 msgid ""
 "`start_server` in `app.py` now returns a `History` object containing "
 "metrics from training ([#974](https://github.com/adap/flower/pull/974))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1349
+#: ../../source/ref-changelog.md:1371
 msgid ""
 "Make `max_workers` (used by `ThreadPoolExecutor`) configurable "
 "([#978](https://github.com/adap/flower/pull/978))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1350
+#: ../../source/ref-changelog.md:1372
 msgid ""
 "Increase sleep time after server start to three seconds in all code "
 "examples ([#1086](https://github.com/adap/flower/pull/1086))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1351
+#: ../../source/ref-changelog.md:1373
 msgid ""
 "Added a new FAQ section to the documentation "
 "([#948](https://github.com/adap/flower/pull/948))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1352
+#: ../../source/ref-changelog.md:1374
 msgid ""
 "And many more under-the-hood changes, library updates, documentation "
 "changes, and tooling improvements!"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1356
+#: ../../source/ref-changelog.md:1378
 msgid ""
 "**Removed** `flwr_example` **and** `flwr_experimental` **from release "
 "build** ([#869](https://github.com/adap/flower/pull/869))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1358
+#: ../../source/ref-changelog.md:1380
 msgid ""
 "The packages `flwr_example` and `flwr_experimental` have been deprecated "
 "since Flower 0.12.0 and they are not longer included in Flower release "
@@ -20689,11 +20775,11 @@ msgid ""
 "an upcoming release."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1360
+#: ../../source/ref-changelog.md:1382
 msgid "v0.17.0 (2021-09-24)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1364
+#: ../../source/ref-changelog.md:1386
 msgid ""
 "**Experimental virtual client engine** "
 "([#781](https://github.com/adap/flower/pull/781) "
@@ -20701,7 +20787,7 @@ msgid ""
 "[#791](https://github.com/adap/flower/pull/791))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1366
+#: ../../source/ref-changelog.md:1388
 msgid ""
 "One of Flower's goals is to enable research at scale. This release "
 "enables a first (experimental) peek at a major new feature, codenamed the"
@@ -20711,7 +20797,7 @@ msgid ""
 "code examples called `quickstart_simulation` and `simulation_pytorch`."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1368
+#: ../../source/ref-changelog.md:1390
 msgid ""
 "The feature is still experimental, so there's no stability guarantee for "
 "the API. It's also not quite ready for prime time and comes with a few "
@@ -20719,86 +20805,86 @@ msgid ""
 "out and share their thoughts."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1370
+#: ../../source/ref-changelog.md:1392
 msgid ""
 "**New built-in strategies** "
 "([#828](https://github.com/adap/flower/pull/828) "
 "[#822](https://github.com/adap/flower/pull/822))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1372
+#: ../../source/ref-changelog.md:1394
 msgid ""
 "FedYogi - Federated learning strategy using Yogi on server-side. "
 "Implementation based on https://arxiv.org/abs/2003.00295"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1373
+#: ../../source/ref-changelog.md:1395
 msgid ""
 "FedAdam - Federated learning strategy using Adam on server-side. "
 "Implementation based on https://arxiv.org/abs/2003.00295"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1375
+#: ../../source/ref-changelog.md:1397
 msgid ""
 "**New PyTorch Lightning code example** "
 "([#617](https://github.com/adap/flower/pull/617))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1377
+#: ../../source/ref-changelog.md:1399
 msgid ""
 "**New Variational Auto-Encoder code example** "
 "([#752](https://github.com/adap/flower/pull/752))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1379
+#: ../../source/ref-changelog.md:1401
 msgid ""
 "**New scikit-learn code example** "
 "([#748](https://github.com/adap/flower/pull/748))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1381
+#: ../../source/ref-changelog.md:1403
 msgid ""
 "**New experimental TensorBoard strategy** "
 "([#789](https://github.com/adap/flower/pull/789))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1385
+#: ../../source/ref-changelog.md:1407
 msgid ""
 "Improved advanced TensorFlow code example "
 "([#769](https://github.com/adap/flower/pull/769))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1386
+#: ../../source/ref-changelog.md:1408
 msgid ""
 "Warning when `min_available_clients` is misconfigured "
 "([#830](https://github.com/adap/flower/pull/830))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1387
+#: ../../source/ref-changelog.md:1409
 msgid ""
 "Improved gRPC server docs "
 "([#841](https://github.com/adap/flower/pull/841))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1388
+#: ../../source/ref-changelog.md:1410
 msgid ""
 "Improved error message in `NumPyClient` "
 "([#851](https://github.com/adap/flower/pull/851))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1389
+#: ../../source/ref-changelog.md:1411
 msgid ""
 "Improved PyTorch quickstart code example "
 "([#852](https://github.com/adap/flower/pull/852))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1393
+#: ../../source/ref-changelog.md:1415
 msgid ""
 "**Disabled final distributed evaluation** "
 "([#800](https://github.com/adap/flower/pull/800))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1395
+#: ../../source/ref-changelog.md:1417
 msgid ""
 "Prior behaviour was to perform a final round of distributed evaluation on"
 " all connected clients, which is often not required (e.g., when using "
@@ -20806,13 +20892,13 @@ msgid ""
 "`force_final_distributed_eval=True` to `start_server`."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1397
+#: ../../source/ref-changelog.md:1419
 msgid ""
 "**Renamed q-FedAvg strategy** "
 "([#802](https://github.com/adap/flower/pull/802))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1399
+#: ../../source/ref-changelog.md:1421
 msgid ""
 "The strategy named `QffedAvg` was renamed to `QFedAvg` to better reflect "
 "the notation given in the original paper (q-FFL is the optimization "
@@ -20821,14 +20907,14 @@ msgid ""
 " (it will be removed in a future release)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1401
+#: ../../source/ref-changelog.md:1423
 msgid ""
 "**Deprecated and renamed code example** `simulation_pytorch` **to** "
 "`simulation_pytorch_legacy` "
 "([#791](https://github.com/adap/flower/pull/791))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1403
+#: ../../source/ref-changelog.md:1425
 msgid ""
 "This example has been replaced by a new example. The new example is based"
 " on the experimental virtual client engine, which will become the new "
@@ -20837,27 +20923,27 @@ msgid ""
 "removed in the future."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1405
+#: ../../source/ref-changelog.md:1427
 msgid "v0.16.0 (2021-05-11)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1409
+#: ../../source/ref-changelog.md:1431
 msgid ""
 "**New built-in strategies** "
 "([#549](https://github.com/adap/flower/pull/549))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1411
+#: ../../source/ref-changelog.md:1433
 msgid "(abstract) FedOpt"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1414
+#: ../../source/ref-changelog.md:1436
 msgid ""
 "**Custom metrics for server and strategies** "
 "([#717](https://github.com/adap/flower/pull/717))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1416
+#: ../../source/ref-changelog.md:1438
 msgid ""
 "The Flower server is now fully task-agnostic, all remaining instances of "
 "task-specific metrics (such as `accuracy`) have been replaced by custom "
@@ -20866,7 +20952,7 @@ msgid ""
 "release, custom metrics replace task-specific metrics on the server."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1418
+#: ../../source/ref-changelog.md:1440
 msgid ""
 "Custom metric dictionaries are now used in two user-facing APIs: they are"
 " returned from Strategy methods `aggregate_fit`/`aggregate_evaluate` and "
@@ -20876,7 +20962,7 @@ msgid ""
 "track of."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1420
+#: ../../source/ref-changelog.md:1442
 msgid ""
 "Strategy implementations should migrate their `aggregate_fit` and "
 "`aggregate_evaluate` methods to the new return type (e.g., by simply "
@@ -20884,19 +20970,19 @@ msgid ""
 " from `return loss, accuracy` to `return loss, {\"accuracy\": accuracy}`."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1422
+#: ../../source/ref-changelog.md:1444
 msgid ""
 "Flower 0.15-style return types are deprecated (but still supported), "
 "compatibility will be removed in a future release."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1424
+#: ../../source/ref-changelog.md:1446
 msgid ""
 "**Migration warnings for deprecated functionality** "
 "([#690](https://github.com/adap/flower/pull/690))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1426
+#: ../../source/ref-changelog.md:1448
 msgid ""
 "Earlier versions of Flower were often migrated to new APIs, while "
 "maintaining compatibility with legacy APIs. This release introduces "
@@ -20905,7 +20991,7 @@ msgid ""
 "recent APIs, thus easing the transition from one release to another."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1428
+#: ../../source/ref-changelog.md:1450
 msgid ""
 "Improved docs and docstrings "
 "([#691](https://github.com/adap/flower/pull/691) "
@@ -20913,11 +20999,11 @@ msgid ""
 "[#713](https://github.com/adap/flower/pull/713))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1430
+#: ../../source/ref-changelog.md:1452
 msgid "MXNet example and documentation"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1432
+#: ../../source/ref-changelog.md:1454
 msgid ""
 "FedBN implementation in example PyTorch: From Centralized To Federated "
 "([#696](https://github.com/adap/flower/pull/696) "
@@ -20925,13 +21011,13 @@ msgid ""
 "[#705](https://github.com/adap/flower/pull/705))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1436
+#: ../../source/ref-changelog.md:1458
 msgid ""
 "**Serialization-agnostic server** "
 "([#721](https://github.com/adap/flower/pull/721))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1438
+#: ../../source/ref-changelog.md:1460
 msgid ""
 "The Flower server is now fully serialization-agnostic. Prior usage of "
 "class `Weights` (which represents parameters as deserialized NumPy "
@@ -20942,7 +21028,7 @@ msgid ""
 "serialization/deserialization)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1440
+#: ../../source/ref-changelog.md:1462
 msgid ""
 "Built-in strategies implement this approach by handling serialization and"
 " deserialization to/from `Weights` internally. Custom/3rd-party Strategy "
@@ -20952,31 +21038,31 @@ msgid ""
 " easily migrate to the new format."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1442
+#: ../../source/ref-changelog.md:1464
 msgid ""
 "Deprecated `flwr.server.Server.evaluate`, use "
 "`flwr.server.Server.evaluate_round` instead "
 "([#717](https://github.com/adap/flower/pull/717))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1444
+#: ../../source/ref-changelog.md:1466
 msgid "v0.15.0 (2021-03-12)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1448
+#: ../../source/ref-changelog.md:1470
 msgid ""
 "**Server-side parameter initialization** "
 "([#658](https://github.com/adap/flower/pull/658))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1450
+#: ../../source/ref-changelog.md:1472
 msgid ""
 "Model parameters can now be initialized on the server-side. Server-side "
 "parameter initialization works via a new `Strategy` method called "
 "`initialize_parameters`."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1452
+#: ../../source/ref-changelog.md:1474
 msgid ""
 "Built-in strategies support a new constructor argument called "
 "`initial_parameters` to set the initial parameters. Built-in strategies "
@@ -20984,7 +21070,7 @@ msgid ""
 "delete them to free the memory afterwards."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1471
+#: ../../source/ref-changelog.md:1493
 msgid ""
 "If no initial parameters are provided to the strategy, the server will "
 "continue to use the current behaviour (namely, it will ask one of the "
@@ -20992,17 +21078,17 @@ msgid ""
 "parameters)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1475
+#: ../../source/ref-changelog.md:1497
 msgid ""
 "Deprecate `flwr.server.strategy.DefaultStrategy` (migrate to "
 "`flwr.server.strategy.FedAvg`, which is equivalent)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1477
+#: ../../source/ref-changelog.md:1499
 msgid "v0.14.0 (2021-02-18)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1481
+#: ../../source/ref-changelog.md:1503
 msgid ""
 "**Generalized** `Client.fit` **and** `Client.evaluate` **return values** "
 "([#610](https://github.com/adap/flower/pull/610) "
@@ -21010,7 +21096,7 @@ msgid ""
 "[#633](https://github.com/adap/flower/pull/633))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1483
+#: ../../source/ref-changelog.md:1505
 msgid ""
 "Clients can now return an additional dictionary mapping `str` keys to "
 "values of the following types: `bool`, `bytes`, `float`, `int`, `str`. "
@@ -21018,7 +21104,7 @@ msgid ""
 "and make use of them on the server side!"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1485
+#: ../../source/ref-changelog.md:1507
 msgid ""
 "This improvement also allowed for more consistent return types between "
 "`fit` and `evaluate`: `evaluate` should now return a tuple `(float, int, "
@@ -21026,7 +21112,7 @@ msgid ""
 "holding arbitrary problem-specific values like accuracy."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1487
+#: ../../source/ref-changelog.md:1509
 msgid ""
 "In case you wondered: this feature is compatible with existing projects, "
 "the additional dictionary return value is optional. New code should "
@@ -21036,19 +21122,19 @@ msgid ""
 "details."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1489
+#: ../../source/ref-changelog.md:1511
 msgid ""
 "*Code example:* note the additional dictionary return values in both "
 "`FlwrClient.fit` and `FlwrClient.evaluate`:"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1504
+#: ../../source/ref-changelog.md:1526
 msgid ""
 "**Generalized** `config` **argument in** `Client.fit` **and** "
 "`Client.evaluate` ([#595](https://github.com/adap/flower/pull/595))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1506
+#: ../../source/ref-changelog.md:1528
 msgid ""
 "The `config` argument used to be of type `Dict[str, str]`, which means "
 "that dictionary values were expected to be strings. The new release "
@@ -21056,58 +21142,58 @@ msgid ""
 "`bytes`, `float`, `int`, `str`."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1508
+#: ../../source/ref-changelog.md:1530
 msgid ""
 "This means one can now pass almost arbitrary values to `fit`/`evaluate` "
 "using the `config` dictionary. Yay, no more `str(epochs)` on the server-"
 "side and `int(config[\"epochs\"])` on the client side!"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1510
+#: ../../source/ref-changelog.md:1532
 msgid ""
 "*Code example:* note that the `config` dictionary now contains non-`str` "
 "values in both `Client.fit` and `Client.evaluate`:"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1527
+#: ../../source/ref-changelog.md:1549
 msgid "v0.13.0 (2021-01-08)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1531
+#: ../../source/ref-changelog.md:1553
 msgid ""
 "New example: PyTorch From Centralized To Federated "
 "([#549](https://github.com/adap/flower/pull/549))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1532
+#: ../../source/ref-changelog.md:1554
 msgid "Improved documentation"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1533
+#: ../../source/ref-changelog.md:1555
 msgid "New documentation theme ([#551](https://github.com/adap/flower/pull/551))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1534
+#: ../../source/ref-changelog.md:1556
 msgid "New API reference ([#554](https://github.com/adap/flower/pull/554))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1535
+#: ../../source/ref-changelog.md:1557
 msgid ""
 "Updated examples documentation "
 "([#549](https://github.com/adap/flower/pull/549))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1536
+#: ../../source/ref-changelog.md:1558
 msgid ""
 "Removed obsolete documentation "
 "([#548](https://github.com/adap/flower/pull/548))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1538
+#: ../../source/ref-changelog.md:1560
 msgid "Bugfix:"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1540
+#: ../../source/ref-changelog.md:1562
 msgid ""
 "`Server.fit` does not disconnect clients when finished, disconnecting the"
 " clients is now handled in `flwr.server.start_server` "
@@ -21115,28 +21201,28 @@ msgid ""
 "[#540](https://github.com/adap/flower/issues/540))."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1542
+#: ../../source/ref-changelog.md:1564
 msgid "v0.12.0 (2020-12-07)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1544 ../../source/ref-changelog.md:1560
+#: ../../source/ref-changelog.md:1566 ../../source/ref-changelog.md:1582
 msgid "Important changes:"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1546
+#: ../../source/ref-changelog.md:1568
 msgid ""
 "Added an example for embedded devices "
 "([#507](https://github.com/adap/flower/pull/507))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1547
+#: ../../source/ref-changelog.md:1569
 msgid ""
 "Added a new NumPyClient (in addition to the existing KerasClient) "
 "([#504](https://github.com/adap/flower/pull/504) "
 "[#508](https://github.com/adap/flower/pull/508))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1548
+#: ../../source/ref-changelog.md:1570
 msgid ""
 "Deprecated `flwr_example` package and started to migrate examples into "
 "the top-level `examples` directory "
@@ -21144,15 +21230,15 @@ msgid ""
 "[#512](https://github.com/adap/flower/pull/512))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1550
+#: ../../source/ref-changelog.md:1572
 msgid "v0.11.0 (2020-11-30)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1552
+#: ../../source/ref-changelog.md:1574
 msgid "Incompatible changes:"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1554
+#: ../../source/ref-changelog.md:1576
 msgid ""
 "Renamed strategy methods "
 "([#486](https://github.com/adap/flower/pull/486)) to unify the naming of "
@@ -21162,48 +21248,48 @@ msgid ""
 "migrate rename the following `Strategy` methods accordingly:"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1555
+#: ../../source/ref-changelog.md:1577
 msgid "`on_configure_evaluate` => `configure_evaluate`"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1556
+#: ../../source/ref-changelog.md:1578
 msgid "`on_aggregate_evaluate` => `aggregate_evaluate`"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1557
+#: ../../source/ref-changelog.md:1579
 msgid "`on_configure_fit` => `configure_fit`"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1558
+#: ../../source/ref-changelog.md:1580
 msgid "`on_aggregate_fit` => `aggregate_fit`"
 msgstr ""
 
-#: ../../source/ref-changelog.md:1562
+#: ../../source/ref-changelog.md:1584
 msgid ""
 "Deprecated `DefaultStrategy` "
 "([#479](https://github.com/adap/flower/pull/479)). To migrate use "
 "`FedAvg` instead."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1563
+#: ../../source/ref-changelog.md:1585
 msgid ""
 "Simplified examples and baselines "
 "([#484](https://github.com/adap/flower/pull/484))."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1564
+#: ../../source/ref-changelog.md:1586
 msgid ""
 "Removed presently unused `on_conclude_round` from strategy interface "
 "([#483](https://github.com/adap/flower/pull/483))."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1565
+#: ../../source/ref-changelog.md:1587
 msgid ""
 "Set minimal Python version to 3.6.1 instead of 3.6.9 "
 "([#471](https://github.com/adap/flower/pull/471))."
 msgstr ""
 
-#: ../../source/ref-changelog.md:1566
+#: ../../source/ref-changelog.md:1588
 msgid ""
 "Improved `Strategy` docstrings "
 "([#470](https://github.com/adap/flower/pull/470))."
@@ -24570,7 +24656,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:41
-msgid "|cf5fe148406b44b9a8b842fb01b5a7ea|"
+msgid "|f150b8d6e0074250822c9f6f7a8de3e0|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:109
@@ -24585,7 +24671,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:53
-msgid "|ba25c91426d64cc1ae2d3febc5715b35|"
+msgid "|72772d10debc4abd8373c0bc82985422|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:111
@@ -24607,7 +24693,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:67
-msgid "|fca67f83aaab4389aa9ebb4d9c5cd75e|"
+msgid "|5815398552ad41d290a3a2631fe8f6ca|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:113
@@ -24623,7 +24709,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:79
-msgid "|6f2e8f95c95443379b0df00ca9824654|"
+msgid "|e6ac20744bf149378be20ac3dc309356|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:115
@@ -24639,7 +24725,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:91
-msgid "|c0ab3a1a733d4dbc9e1677aa608e8038|"
+msgid "|a4011ef443c14725b15a8cf33b0e3443|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:117
@@ -24654,7 +24740,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:103
-msgid "|8f0491bde07341ab9f2e23d50593c0be|"
+msgid "|a22faa3617404c06803731525e1c609f|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:119
@@ -24674,7 +24760,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:138
-msgid "|762fc099899943688361562252c5e600|"
+msgid "|84a5c9b5041c43c3beab9786197c3e4e|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:173
@@ -24689,7 +24775,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:150
-msgid "|f62d365fd0ae405b975d3ca01e7183fd|"
+msgid "|b5c4be0b52d4493ba8c4af14d7c2db97|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:175
@@ -24829,7 +24915,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:210
-msgid "|2c78fc1816b143289f4d909388f92a80|"
+msgid "|c1c784183d18481186ff65dc261d1335|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:307
@@ -24853,7 +24939,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:225
-msgid "|4230725aeebe497d8ad84a3efc2a912b|"
+msgid "|669fcd1f44ab42f5bbd196c3cf1ecbc2|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:309
@@ -24877,7 +24963,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:240
-msgid "|64b66a88417240eabe52f5cc55d89d0b|"
+msgid "|edfb08758c9441afb6736045a59e154c|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:311
@@ -24900,7 +24986,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:255
-msgid "|726c8eca58bc4f859b06aa24a587b253|"
+msgid "|82338b8bbad24d5ea9df3801aab37852|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:313
@@ -24938,7 +25024,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:273
-msgid "|f9d869e4b33c4093b29cf24ed8dff80a|"
+msgid "|518d994dd2c844898b441da03b858326|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:315
@@ -25032,7 +25118,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:334
-msgid "|4ab50bc01a9f426a91a2c0cbc3ab7a84|"
+msgid "|7bfcfcb57ae5403f8e18486f45ca48b4|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:340
@@ -37274,3 +37360,48 @@ msgstr ""
 #~ msgid "|dd4434075f374e99ac07f509a883778f|"
 #~ msgstr ""
 
+#~ msgid "Other changes"
+#~ msgstr ""
+
+#~ msgid "|cf5fe148406b44b9a8b842fb01b5a7ea|"
+#~ msgstr ""
+
+#~ msgid "|ba25c91426d64cc1ae2d3febc5715b35|"
+#~ msgstr ""
+
+#~ msgid "|fca67f83aaab4389aa9ebb4d9c5cd75e|"
+#~ msgstr ""
+
+#~ msgid "|6f2e8f95c95443379b0df00ca9824654|"
+#~ msgstr ""
+
+#~ msgid "|c0ab3a1a733d4dbc9e1677aa608e8038|"
+#~ msgstr ""
+
+#~ msgid "|8f0491bde07341ab9f2e23d50593c0be|"
+#~ msgstr ""
+
+#~ msgid "|762fc099899943688361562252c5e600|"
+#~ msgstr ""
+
+#~ msgid "|f62d365fd0ae405b975d3ca01e7183fd|"
+#~ msgstr ""
+
+#~ msgid "|2c78fc1816b143289f4d909388f92a80|"
+#~ msgstr ""
+
+#~ msgid "|4230725aeebe497d8ad84a3efc2a912b|"
+#~ msgstr ""
+
+#~ msgid "|64b66a88417240eabe52f5cc55d89d0b|"
+#~ msgstr ""
+
+#~ msgid "|726c8eca58bc4f859b06aa24a587b253|"
+#~ msgstr ""
+
+#~ msgid "|f9d869e4b33c4093b29cf24ed8dff80a|"
+#~ msgstr ""
+
+#~ msgid "|4ab50bc01a9f426a91a2c0cbc3ab7a84|"
+#~ msgstr ""
+
diff --git a/doc/locales/zh_Hans/LC_MESSAGES/framework-docs.po b/doc/locales/zh_Hans/LC_MESSAGES/framework-docs.po
index be5a8c984dbc..41c74779d83b 100644
--- a/doc/locales/zh_Hans/LC_MESSAGES/framework-docs.po
+++ b/doc/locales/zh_Hans/LC_MESSAGES/framework-docs.po
@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Flower main\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-11-22 08:46+0000\n"
+"POT-Creation-Date: 2024-11-28 00:32+0000\n"
 "PO-Revision-Date: 2024-06-12 10:09+0000\n"
 "Last-Translator: Yan Gao <y.gaogy@gmail.com>\n"
 "Language: zh_Hans\n"
@@ -3351,10 +3351,10 @@ msgstr "快速入门 fastai"
 #: ../../source/docker/run-quickstart-examples-docker-compose.rst:119
 #: ../../source/docker/run-quickstart-examples-docker-compose.rst:121
 #: ../../source/docker/run-quickstart-examples-docker-compose.rst:125
-#: ../../source/ref-changelog.md:214 ../../source/ref-changelog.md:580
-#: ../../source/ref-changelog.md:857 ../../source/ref-changelog.md:921
-#: ../../source/ref-changelog.md:979 ../../source/ref-changelog.md:1048
-#: ../../source/ref-changelog.md:1110
+#: ../../source/ref-changelog.md:236 ../../source/ref-changelog.md:602
+#: ../../source/ref-changelog.md:879 ../../source/ref-changelog.md:943
+#: ../../source/ref-changelog.md:1001 ../../source/ref-changelog.md:1070
+#: ../../source/ref-changelog.md:1132
 msgid "None"
 msgstr "无"
 
@@ -15710,7 +15710,7 @@ msgstr ""
 "\\(num\\_available\\_clients\\)"
 
 #: ../../source/ref-api/flwr.server.strategy.FedAdagrad.rst:2
-#: ../../source/ref-changelog.md:1412
+#: ../../source/ref-changelog.md:1434
 msgid "FedAdagrad"
 msgstr "FedAdagrad"
 
@@ -18141,75 +18141,183 @@ msgstr "更新日志"
 
 #: ../../source/ref-changelog.md:3
 #, fuzzy
-msgid "Unreleased"
-msgstr "版本发布"
+msgid "v1.13.1 (2024-11-26)"
+msgstr "v1.4.0 (2023-04-21)"
 
-#: ../../source/ref-changelog.md:5 ../../source/ref-changelog.md:21
-#: ../../source/ref-changelog.md:122 ../../source/ref-changelog.md:224
-#: ../../source/ref-changelog.md:328 ../../source/ref-changelog.md:426
-#: ../../source/ref-changelog.md:526 ../../source/ref-changelog.md:590
-#: ../../source/ref-changelog.md:683 ../../source/ref-changelog.md:783
-#: ../../source/ref-changelog.md:867 ../../source/ref-changelog.md:931
-#: ../../source/ref-changelog.md:989 ../../source/ref-changelog.md:1058
-#: ../../source/ref-changelog.md:1187 ../../source/ref-changelog.md:1229
-#: ../../source/ref-changelog.md:1296 ../../source/ref-changelog.md:1362
-#: ../../source/ref-changelog.md:1407 ../../source/ref-changelog.md:1446
-#: ../../source/ref-changelog.md:1479 ../../source/ref-changelog.md:1529
+#: ../../source/ref-changelog.md:5 ../../source/ref-changelog.md:37
+#: ../../source/ref-changelog.md:138 ../../source/ref-changelog.md:208
+#: ../../source/ref-changelog.md:240 ../../source/ref-changelog.md:344
+#: ../../source/ref-changelog.md:442 ../../source/ref-changelog.md:542
+#: ../../source/ref-changelog.md:606 ../../source/ref-changelog.md:699
+#: ../../source/ref-changelog.md:799 ../../source/ref-changelog.md:883
+#: ../../source/ref-changelog.md:947 ../../source/ref-changelog.md:1005
+#: ../../source/ref-changelog.md:1074 ../../source/ref-changelog.md:1143
+msgid "Thanks to our contributors"
+msgstr "感谢我们的贡献者"
+
+#: ../../source/ref-changelog.md:7 ../../source/ref-changelog.md:39
+#: ../../source/ref-changelog.md:140 ../../source/ref-changelog.md:210
+#: ../../source/ref-changelog.md:242 ../../source/ref-changelog.md:346
+#: ../../source/ref-changelog.md:444 ../../source/ref-changelog.md:544
+#: ../../source/ref-changelog.md:608 ../../source/ref-changelog.md:701
+#: ../../source/ref-changelog.md:801 ../../source/ref-changelog.md:885
+#: ../../source/ref-changelog.md:949 ../../source/ref-changelog.md:1007
+msgid ""
+"We would like to give our special thanks to all the contributors who made"
+" the new version of Flower possible (in `git shortlog` order):"
+msgstr "在此，我们要特别感谢所有为 Flower 的新版本做出贡献的人员（按 `git shortlog` 顺序排列）："
+
+#: ../../source/ref-changelog.md:9
+#, fuzzy
+msgid ""
+"`Adam Narozniak`, `Charles Beauville`, `Heng Pan`, `Javier`, `Robert "
+"Steiner` <!---TOKEN_v1.13.1-->"
+msgstr ""
+"`Adam Narozniak`, `Anass Anhari`, `Charles Beauville`, `Dana-Farber`, "
+"`Daniel J. Beutel`, `Daniel Nata Nugraha`, `Edoardo Gabrielli`, `Gustavo "
+"Bertoli`, `Heng Pan`, `Javier`, `Mahdi`, `Steven Hé (Sīchàng)`, `Taner "
+"Topal`, `achiverram28`, `danielnugraha`, `eunchung`, `ruthgal` <!---"
+"TOKEN_v1.5.0-->"
+
+#: ../../source/ref-changelog.md:11 ../../source/ref-changelog.md:43
+#: ../../source/ref-changelog.md:144 ../../source/ref-changelog.md:246
+#: ../../source/ref-changelog.md:350 ../../source/ref-changelog.md:448
+#: ../../source/ref-changelog.md:548 ../../source/ref-changelog.md:612
+#: ../../source/ref-changelog.md:705 ../../source/ref-changelog.md:805
+#: ../../source/ref-changelog.md:889 ../../source/ref-changelog.md:953
+#: ../../source/ref-changelog.md:1011 ../../source/ref-changelog.md:1080
+#: ../../source/ref-changelog.md:1209 ../../source/ref-changelog.md:1251
+#: ../../source/ref-changelog.md:1318 ../../source/ref-changelog.md:1384
+#: ../../source/ref-changelog.md:1429 ../../source/ref-changelog.md:1468
+#: ../../source/ref-changelog.md:1501 ../../source/ref-changelog.md:1551
 msgid "What's new?"
 msgstr "有什么新内容？"
 
-#: ../../source/ref-changelog.md:7
+#: ../../source/ref-changelog.md:13
 #, fuzzy
-msgid "Other changes"
-msgstr "不兼容的更改"
+msgid ""
+"**Fix `SimulationEngine` Executor for SuperLink** "
+"([#4563](https://github.com/adap/flower/pull/4563), "
+"[#4568](https://github.com/adap/flower/pull/4568), "
+"[#4570](https://github.com/adap/flower/pull/4570))"
+msgstr ""
+"** 统一客户端应用程序接口** ([#2303](https://github.com/adap/flower/pull/2303), "
+"[#2390](https://github.com/adap/flower/pull/2390), "
+"[#2493](https://github.com/adap/flower/pull/2493))"
+
+#: ../../source/ref-changelog.md:15
+msgid ""
+"Resolved an issue that prevented SuperLink from functioning correctly "
+"when using the `SimulationEngine` executor."
+msgstr ""
 
-#: ../../source/ref-changelog.md:9 ../../source/ref-changelog.md:388
+#: ../../source/ref-changelog.md:17
 #, fuzzy
-msgid "Documentation improvements"
-msgstr "可选的改进措施"
+msgid ""
+"**Improve FAB build and install** "
+"([#4571](https://github.com/adap/flower/pull/4571))"
+msgstr "**新的联邦医疗策略** ([#1461](https://github.com/adap/flower/pull/1461))"
 
-#: ../../source/ref-changelog.md:11 ../../source/ref-changelog.md:88
-#: ../../source/ref-changelog.md:178 ../../source/ref-changelog.md:212
-#: ../../source/ref-changelog.md:292 ../../source/ref-changelog.md:408
-#: ../../source/ref-changelog.md:504 ../../source/ref-changelog.md:578
-#: ../../source/ref-changelog.md:653 ../../source/ref-changelog.md:765
-#: ../../source/ref-changelog.md:855 ../../source/ref-changelog.md:919
-#: ../../source/ref-changelog.md:977 ../../source/ref-changelog.md:1046
-#: ../../source/ref-changelog.md:1108 ../../source/ref-changelog.md:1127
-#: ../../source/ref-changelog.md:1283 ../../source/ref-changelog.md:1354
-#: ../../source/ref-changelog.md:1391 ../../source/ref-changelog.md:1434
-msgid "Incompatible changes"
-msgstr "不兼容的更改"
+#: ../../source/ref-changelog.md:19
+msgid ""
+"An updated FAB build and install process produces smaller FAB files and "
+"doesn't rely on `pip install` any more. It also resolves an issue where "
+"all files were unnecessarily included in the FAB file. The `flwr` CLI "
+"commands now correctly pack only the necessary files, such as `.md`, "
+"`.toml` and `.py`, ensuring more efficient and accurate packaging."
+msgstr ""
 
-#: ../../source/ref-changelog.md:13
+#: ../../source/ref-changelog.md:21
 #, fuzzy
-msgid "v1.13.0 (2024-11-20)"
-msgstr "v1.4.0 (2023-04-21)"
+msgid ""
+"**Update** `embedded-devices` **example** "
+"([#4381](https://github.com/adap/flower/pull/4381))"
+msgstr "**引入 start_driver**（[#1697](https://github.com/adap/flower/pull/1697)）"
 
-#: ../../source/ref-changelog.md:15 ../../source/ref-changelog.md:116
-#: ../../source/ref-changelog.md:186 ../../source/ref-changelog.md:218
-#: ../../source/ref-changelog.md:322 ../../source/ref-changelog.md:420
-#: ../../source/ref-changelog.md:520 ../../source/ref-changelog.md:584
-#: ../../source/ref-changelog.md:677 ../../source/ref-changelog.md:777
-#: ../../source/ref-changelog.md:861 ../../source/ref-changelog.md:925
-#: ../../source/ref-changelog.md:983 ../../source/ref-changelog.md:1052
-#: ../../source/ref-changelog.md:1121
-msgid "Thanks to our contributors"
-msgstr "感谢我们的贡献者"
+#: ../../source/ref-changelog.md:23
+msgid "The example now uses the `flwr run` command and the Deployment Engine."
+msgstr ""
 
-#: ../../source/ref-changelog.md:17 ../../source/ref-changelog.md:118
-#: ../../source/ref-changelog.md:188 ../../source/ref-changelog.md:220
-#: ../../source/ref-changelog.md:324 ../../source/ref-changelog.md:422
-#: ../../source/ref-changelog.md:522 ../../source/ref-changelog.md:586
-#: ../../source/ref-changelog.md:679 ../../source/ref-changelog.md:779
-#: ../../source/ref-changelog.md:863 ../../source/ref-changelog.md:927
-#: ../../source/ref-changelog.md:985
+#: ../../source/ref-changelog.md:25
+#, fuzzy
 msgid ""
-"We would like to give our special thanks to all the contributors who made"
-" the new version of Flower possible (in `git shortlog` order):"
-msgstr "在此，我们要特别感谢所有为 Flower 的新版本做出贡献的人员（按 `git shortlog` 顺序排列）："
+"**Update Documentation** "
+"([#4566](https://github.com/adap/flower/pull/4566), "
+"[#4569](https://github.com/adap/flower/pull/4569), "
+"[#4560](https://github.com/adap/flower/pull/4560), "
+"[#4556](https://github.com/adap/flower/pull/4556), "
+"[#4581](https://github.com/adap/flower/pull/4581), "
+"[#4537](https://github.com/adap/flower/pull/4537), "
+"[#4562](https://github.com/adap/flower/pull/4562), "
+"[#4582](https://github.com/adap/flower/pull/4582))"
+msgstr ""
+"**改进教程** ([#1468](https://github.com/adap/flower/pull/1468), "
+"[#1470](https://github.com/adap/flower/pull/1470), "
+"[#1472](https://github.com/adap/flower/pull/1472), "
+"[#1473](https://github.com/adap/flower/pull/1473), "
+"[#1474](https://github.com/adap/flower/pull/1474), "
+"[#1475](https://github.com/adap/flower/pull/1475)))"
 
-#: ../../source/ref-changelog.md:19
+#: ../../source/ref-changelog.md:27
+msgid ""
+"Enhanced documentation across various aspects, including updates to "
+"translation workflows, Docker-related READMEs, and recommended datasets. "
+"Improvements also include formatting fixes for dataset partitioning docs "
+"and better references to resources in the datasets documentation index."
+msgstr ""
+
+#: ../../source/ref-changelog.md:29
+#, fuzzy
+msgid ""
+"**Update Infrastructure and CI/CD** "
+"([#4577](https://github.com/adap/flower/pull/4577), "
+"[#4578](https://github.com/adap/flower/pull/4578), "
+"[#4558](https://github.com/adap/flower/pull/4558), "
+"[#4551](https://github.com/adap/flower/pull/4551), "
+"[#3356](https://github.com/adap/flower/pull/3356), "
+"[#4559](https://github.com/adap/flower/pull/4559), "
+"[#4575](https://github.com/adap/flower/pull/4575))"
+msgstr ""
+"**改进教程** ([#1468](https://github.com/adap/flower/pull/1468), "
+"[#1470](https://github.com/adap/flower/pull/1470), "
+"[#1472](https://github.com/adap/flower/pull/1472), "
+"[#1473](https://github.com/adap/flower/pull/1473), "
+"[#1474](https://github.com/adap/flower/pull/1474), "
+"[#1475](https://github.com/adap/flower/pull/1475)))"
+
+#: ../../source/ref-changelog.md:31
+#, fuzzy
+msgid ""
+"**General improvements** "
+"([#4557](https://github.com/adap/flower/pull/4557), "
+"[#4564](https://github.com/adap/flower/pull/4564), "
+"[#4573](https://github.com/adap/flower/pull/4573), "
+"[#4561](https://github.com/adap/flower/pull/4561), "
+"[#4579](https://github.com/adap/flower/pull/4579), "
+"[#4572](https://github.com/adap/flower/pull/4572))"
+msgstr ""
+"** 更新文档** ([#1629](https://github.com/adap/flower/pull/1629), "
+"[#1628](https://github.com/adap/flower/pull/1628), "
+"[#1620](https://github.com/adap/flower/pull/1620), "
+"[#1618](https://github.com/adap/flower/pull/1618), "
+"[#1617](https://github.com/adap/flower/pull/1617), "
+"[#1613](https://github.com/adap/flower/pull/1613), "
+"[#1614](https://github.com/adap/flower/pull/1614)))"
+
+#: ../../source/ref-changelog.md:33 ../../source/ref-changelog.md:102
+#: ../../source/ref-changelog.md:198 ../../source/ref-changelog.md:301
+#: ../../source/ref-changelog.md:408
+msgid ""
+"As always, many parts of the Flower framework and quality infrastructure "
+"were improved and updated."
+msgstr ""
+
+#: ../../source/ref-changelog.md:35
+#, fuzzy
+msgid "v1.13.0 (2024-11-20)"
+msgstr "v1.4.0 (2023-04-21)"
+
+#: ../../source/ref-changelog.md:41
 #, fuzzy
 msgid ""
 "`Adam Narozniak`, `Charles Beauville`, `Chong Shen Ng`, `Daniel J. "
@@ -18223,7 +18331,7 @@ msgstr ""
 "Topal`, `achiverram28`, `danielnugraha`, `eunchung`, `ruthgal` <!---"
 "TOKEN_v1.5.0-->"
 
-#: ../../source/ref-changelog.md:23
+#: ../../source/ref-changelog.md:45
 #, fuzzy
 msgid ""
 "**Introduce `flwr ls` command** "
@@ -18235,30 +18343,30 @@ msgstr ""
 "[#2221](https://github.com/adap/flower/pull/2221), "
 "[#2248](https://github.com/adap/flower/pull/2248))"
 
-#: ../../source/ref-changelog.md:25
+#: ../../source/ref-changelog.md:47
 msgid ""
 "The `flwr ls` command is now available to display details about all runs "
 "(or one specific run). It supports the following usage options:"
 msgstr ""
 
-#: ../../source/ref-changelog.md:27
+#: ../../source/ref-changelog.md:49
 msgid "`flwr ls --runs [<app>] [<federation>]`: Lists all runs."
 msgstr ""
 
-#: ../../source/ref-changelog.md:28
+#: ../../source/ref-changelog.md:50
 msgid ""
 "`flwr ls --run-id <run-id> [<app>] [<federation>]`: Displays details for "
 "a specific run."
 msgstr ""
 
-#: ../../source/ref-changelog.md:30
+#: ../../source/ref-changelog.md:52
 msgid ""
 "This command provides information including the run ID, FAB ID and "
 "version, run status, elapsed time, and timestamps for when the run was "
 "created, started running, and finished."
 msgstr ""
 
-#: ../../source/ref-changelog.md:32
+#: ../../source/ref-changelog.md:54
 #, fuzzy
 msgid ""
 "**Fuse SuperLink and SuperExec** "
@@ -18280,7 +18388,7 @@ msgstr ""
 "[#2355](https://github.com/adap/flower/pull/2355), "
 "[#2356](https://github.com/adap/flower/pull/2356))"
 
-#: ../../source/ref-changelog.md:34
+#: ../../source/ref-changelog.md:56
 msgid ""
 "SuperExec has been integrated into SuperLink, enabling SuperLink to "
 "directly manage ServerApp processes (`flwr-serverapp`). The `flwr` CLI "
@@ -18290,7 +18398,7 @@ msgid ""
 "{subprocess,process}` flag."
 msgstr ""
 
-#: ../../source/ref-changelog.md:36
+#: ../../source/ref-changelog.md:58
 #, fuzzy
 msgid ""
 "**Introduce `flwr-serverapp` command** "
@@ -18312,7 +18420,7 @@ msgstr ""
 "[#1474](https://github.com/adap/flower/pull/1474), "
 "[#1475](https://github.com/adap/flower/pull/1475)))"
 
-#: ../../source/ref-changelog.md:38
+#: ../../source/ref-changelog.md:60
 msgid ""
 "The `flwr-serverapp` command has been introduced as a CLI entry point "
 "that runs a `ServerApp` process. This process communicates with SuperLink"
@@ -18320,7 +18428,7 @@ msgid ""
 "and more flexible deployment."
 msgstr ""
 
-#: ../../source/ref-changelog.md:40
+#: ../../source/ref-changelog.md:62
 #, fuzzy
 msgid ""
 "**Improve simulation engine and introduce `flwr-simulation` command** "
@@ -18341,7 +18449,7 @@ msgstr ""
 "[#2355](https://github.com/adap/flower/pull/2355), "
 "[#2356](https://github.com/adap/flower/pull/2356))"
 
-#: ../../source/ref-changelog.md:42
+#: ../../source/ref-changelog.md:64
 msgid ""
 "The simulation engine has been significantly improved, resulting in "
 "dramatically faster simulations. Additionally, the `flwr-simulation` "
@@ -18349,7 +18457,7 @@ msgid ""
 "dedicated entry point for running simulations."
 msgstr ""
 
-#: ../../source/ref-changelog.md:44
+#: ../../source/ref-changelog.md:66
 #, fuzzy
 msgid ""
 "**Improve SuperLink message management** "
@@ -18359,7 +18467,7 @@ msgstr ""
 "** 更新代码示例** ([#1344](https://github.com/adap/flower/pull/1344), "
 "[#1347](https://github.com/adap/flower/pull/1347))"
 
-#: ../../source/ref-changelog.md:46
+#: ../../source/ref-changelog.md:68
 msgid ""
 "SuperLink now validates the destination node ID of instruction messages "
 "and checks the TTL (time-to-live) for reply messages. When pulling reply "
@@ -18368,14 +18476,14 @@ msgid ""
 "reply message exists but has expired."
 msgstr ""
 
-#: ../../source/ref-changelog.md:48
+#: ../../source/ref-changelog.md:70
 #, fuzzy
 msgid ""
 "**Introduce FedDebug baseline** "
 "([#3783](https://github.com/adap/flower/pull/3783))"
 msgstr "**引入 start_driver**（[#1697](https://github.com/adap/flower/pull/1697)）"
 
-#: ../../source/ref-changelog.md:50
+#: ../../source/ref-changelog.md:72
 msgid ""
 "FedDebug is a framework that enhances debugging in Federated Learning by "
 "enabling interactive inspection of the training process and automatically"
@@ -18385,7 +18493,7 @@ msgid ""
 "documentation](https://flower.ai/docs/baselines/feddebug.html)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:52
+#: ../../source/ref-changelog.md:74
 msgid ""
 "**Update documentation** "
 "([#4511](https://github.com/adap/flower/pull/4511), "
@@ -18430,7 +18538,7 @@ msgid ""
 "[#4533](https://github.com/adap/flower/pull/4533))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:54
+#: ../../source/ref-changelog.md:76
 msgid ""
 "Many documentation pages and tutorials have been updated to improve "
 "clarity, fix typos, incorporate user feedback, and stay aligned with the "
@@ -18444,7 +18552,7 @@ msgid ""
 "aggregation-protocols.html) page has also been updated."
 msgstr ""
 
-#: ../../source/ref-changelog.md:56
+#: ../../source/ref-changelog.md:78
 #, fuzzy
 msgid ""
 "**Update examples and templates** "
@@ -18466,7 +18574,7 @@ msgstr ""
 "[#1770](https://github.com/adap/flower/pull/1770), "
 "[#1733](https://github.com/adap/flower/pull/1733))"
 
-#: ../../source/ref-changelog.md:58
+#: ../../source/ref-changelog.md:80
 msgid ""
 "Multiple examples and templates have been updated to enhance usability "
 "and correctness. The updates include the `30-minute-tutorial`, "
@@ -18474,7 +18582,7 @@ msgid ""
 "and the FlowerTune template."
 msgstr ""
 
-#: ../../source/ref-changelog.md:60
+#: ../../source/ref-changelog.md:82
 #, fuzzy
 msgid ""
 "**Improve Docker support** "
@@ -18497,7 +18605,7 @@ msgstr ""
 "[#1477](https://github.com/adap/flower/pull/1477), "
 "[#2171](https://github.com/adap/flower/pull/2171))"
 
-#: ../../source/ref-changelog.md:62
+#: ../../source/ref-changelog.md:84
 msgid ""
 "Docker images and configurations have been updated, including updating "
 "Docker Compose files to version 1.13.0, refactoring the Docker build "
@@ -18505,7 +18613,7 @@ msgid ""
 " 6.9.0, and improving Docker documentation."
 msgstr ""
 
-#: ../../source/ref-changelog.md:64
+#: ../../source/ref-changelog.md:86
 #, fuzzy
 msgid ""
 "**Allow app installation without internet access** "
@@ -18515,14 +18623,14 @@ msgstr ""
 "** 更新代码示例** ([#1344](https://github.com/adap/flower/pull/1344), "
 "[#1347](https://github.com/adap/flower/pull/1347))"
 
-#: ../../source/ref-changelog.md:66
+#: ../../source/ref-changelog.md:88
 msgid ""
 "The `flwr build` command now includes a wheel file in the FAB, enabling "
 "Flower app installation in environments without internet access via `flwr"
 " install`."
 msgstr ""
 
-#: ../../source/ref-changelog.md:68
+#: ../../source/ref-changelog.md:90
 #, fuzzy
 msgid ""
 "**Improve `flwr log` command** "
@@ -18536,7 +18644,7 @@ msgstr ""
 "[#1301](https://github.com/adap/flower/pull/1301), "
 "[#1310](https://github.com/adap/flower/pull/1310)"
 
-#: ../../source/ref-changelog.md:70
+#: ../../source/ref-changelog.md:92
 #, fuzzy
 msgid ""
 "**Refactor SuperNode for better maintainability and efficiency** "
@@ -18550,14 +18658,14 @@ msgstr ""
 "[#1301](https://github.com/adap/flower/pull/1301), "
 "[#1310](https://github.com/adap/flower/pull/1310)"
 
-#: ../../source/ref-changelog.md:72
+#: ../../source/ref-changelog.md:94
 #, fuzzy
 msgid ""
 "**Support NumPy `2.0`** "
 "([#4440](https://github.com/adap/flower/pull/4440))"
 msgstr "** 支持 Python 3.10** ([#1320](https://github.com/adap/flower/pull/1320))"
 
-#: ../../source/ref-changelog.md:74
+#: ../../source/ref-changelog.md:96
 #, fuzzy
 msgid ""
 "**Update infrastructure and CI/CD** "
@@ -18576,7 +18684,7 @@ msgstr ""
 "[#1477](https://github.com/adap/flower/pull/1477), "
 "[#2171](https://github.com/adap/flower/pull/2171))"
 
-#: ../../source/ref-changelog.md:76
+#: ../../source/ref-changelog.md:98
 #, fuzzy
 msgid ""
 "**Bugfixes** ([#4404](https://github.com/adap/flower/pull/4404), "
@@ -18598,7 +18706,7 @@ msgstr ""
 "[#1613](https://github.com/adap/flower/pull/1613), "
 "[#1614](https://github.com/adap/flower/pull/1614)))"
 
-#: ../../source/ref-changelog.md:78
+#: ../../source/ref-changelog.md:100
 msgid ""
 "**General improvements** "
 "([#4454](https://github.com/adap/flower/pull/4454), "
@@ -18654,25 +18762,18 @@ msgid ""
 "[#4481](https://github.com/adap/flower/pull/4481))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:80 ../../source/ref-changelog.md:176
-#: ../../source/ref-changelog.md:279 ../../source/ref-changelog.md:386
-msgid ""
-"As always, many parts of the Flower framework and quality infrastructure "
-"were improved and updated."
-msgstr ""
-
-#: ../../source/ref-changelog.md:82 ../../source/ref-changelog.md:281
-#: ../../source/ref-changelog.md:398 ../../source/ref-changelog.md:490
-#: ../../source/ref-changelog.md:1473
+#: ../../source/ref-changelog.md:104 ../../source/ref-changelog.md:303
+#: ../../source/ref-changelog.md:420 ../../source/ref-changelog.md:512
+#: ../../source/ref-changelog.md:1495
 msgid "Deprecations"
 msgstr "停用"
 
-#: ../../source/ref-changelog.md:84
+#: ../../source/ref-changelog.md:106
 #, fuzzy
 msgid "**Deprecate Python 3.9**"
 msgstr "** 过时的 Python 3.7**"
 
-#: ../../source/ref-changelog.md:86
+#: ../../source/ref-changelog.md:108
 msgid ""
 "Flower is deprecating support for Python 3.9 as several of its "
 "dependencies are phasing out compatibility with this version. While no "
@@ -18680,14 +18781,27 @@ msgid ""
 "upgrading to a supported Python version."
 msgstr ""
 
-#: ../../source/ref-changelog.md:90
+#: ../../source/ref-changelog.md:110 ../../source/ref-changelog.md:200
+#: ../../source/ref-changelog.md:234 ../../source/ref-changelog.md:314
+#: ../../source/ref-changelog.md:430 ../../source/ref-changelog.md:526
+#: ../../source/ref-changelog.md:600 ../../source/ref-changelog.md:675
+#: ../../source/ref-changelog.md:787 ../../source/ref-changelog.md:877
+#: ../../source/ref-changelog.md:941 ../../source/ref-changelog.md:999
+#: ../../source/ref-changelog.md:1068 ../../source/ref-changelog.md:1130
+#: ../../source/ref-changelog.md:1149 ../../source/ref-changelog.md:1305
+#: ../../source/ref-changelog.md:1376 ../../source/ref-changelog.md:1413
+#: ../../source/ref-changelog.md:1456
+msgid "Incompatible changes"
+msgstr "不兼容的更改"
+
+#: ../../source/ref-changelog.md:112
 #, fuzzy
 msgid ""
 "**Remove `flower-superexec` command** "
 "([#4351](https://github.com/adap/flower/pull/4351))"
 msgstr "**移除过时的 KerasClient**（[#857](https://github.com/adap/flower/pull/857)）"
 
-#: ../../source/ref-changelog.md:92
+#: ../../source/ref-changelog.md:114
 msgid ""
 "The `flower-superexec` command, previously used to launch SuperExec, is "
 "no longer functional as SuperExec has been merged into SuperLink. "
@@ -18695,68 +18809,68 @@ msgid ""
 " initiated."
 msgstr ""
 
-#: ../../source/ref-changelog.md:94
+#: ../../source/ref-changelog.md:116
 #, fuzzy
 msgid ""
 "**Remove `flower-server-app` command** "
 "([#4490](https://github.com/adap/flower/pull/4490))"
 msgstr "**移除过时的 KerasClient**（[#857](https://github.com/adap/flower/pull/857)）"
 
-#: ../../source/ref-changelog.md:96
+#: ../../source/ref-changelog.md:118
 msgid ""
 "The `flower-server-app` command has been removed. To start a Flower app, "
 "please use the `flwr run` command instead."
 msgstr ""
 
-#: ../../source/ref-changelog.md:98
+#: ../../source/ref-changelog.md:120
 #, fuzzy
 msgid ""
 "**Remove `app` argument from `flower-supernode` command** "
 "([#4497](https://github.com/adap/flower/pull/4497))"
 msgstr "**移除过时的 KerasClient**（[#857](https://github.com/adap/flower/pull/857)）"
 
-#: ../../source/ref-changelog.md:100
+#: ../../source/ref-changelog.md:122
 msgid ""
 "The usage of `flower-supernode <app-dir>` has been removed. SuperNode "
 "will now load the FAB delivered by SuperLink, and it is no longer "
 "possible to directly specify an app directory."
 msgstr ""
 
-#: ../../source/ref-changelog.md:102
+#: ../../source/ref-changelog.md:124
 #, fuzzy
 msgid ""
 "**Remove support for non-app simulations** "
 "([#4431](https://github.com/adap/flower/pull/4431))"
 msgstr "**改进模拟中的 GPU 支持**（[#1555](https://github.com/adap/flower/pull/1555)）"
 
-#: ../../source/ref-changelog.md:104
+#: ../../source/ref-changelog.md:126
 msgid ""
 "The simulation engine (via `flower-simulation`) now exclusively supports "
 "passing an app."
 msgstr ""
 
-#: ../../source/ref-changelog.md:106
+#: ../../source/ref-changelog.md:128
 #, fuzzy
 msgid ""
 "**Rename CLI arguments for `flower-superlink` command** "
 "([#4412](https://github.com/adap/flower/pull/4412))"
 msgstr "**移除过时的 KerasClient**（[#857](https://github.com/adap/flower/pull/857)）"
 
-#: ../../source/ref-changelog.md:108
+#: ../../source/ref-changelog.md:130
 msgid ""
 "The `--driver-api-address` argument has been renamed to `--serverappio-"
 "api-address` in the `flower-superlink` command to reflect the renaming of"
 " the `Driver` service to the `ServerAppIo` service."
 msgstr ""
 
-#: ../../source/ref-changelog.md:110
+#: ../../source/ref-changelog.md:132
 #, fuzzy
 msgid ""
 "**Rename CLI arguments for `flwr-serverapp` and `flwr-clientapp` "
 "commands** ([#4495](https://github.com/adap/flower/pull/4495))"
 msgstr "**移除过时的 KerasClient**（[#857](https://github.com/adap/flower/pull/857)）"
 
-#: ../../source/ref-changelog.md:112
+#: ../../source/ref-changelog.md:134
 msgid ""
 "The CLI arguments have been renamed for clarity and consistency. "
 "Specifically, `--superlink` for `flwr-serverapp` is now `--serverappio-"
@@ -18764,12 +18878,12 @@ msgid ""
 "`--clientappio-api-address`."
 msgstr ""
 
-#: ../../source/ref-changelog.md:114
+#: ../../source/ref-changelog.md:136
 #, fuzzy
 msgid "v1.12.0 (2024-10-14)"
 msgstr "v1.1.0 (2022-10-31)"
 
-#: ../../source/ref-changelog.md:120
+#: ../../source/ref-changelog.md:142
 #, fuzzy
 msgid ""
 "`Adam Narozniak`, `Audris`, `Charles Beauville`, `Chong Shen Ng`, `Daniel"
@@ -18783,7 +18897,7 @@ msgstr ""
 "Topal`, `achiverram28`, `danielnugraha`, `eunchung`, `ruthgal` <!---"
 "TOKEN_v1.5.0-->"
 
-#: ../../source/ref-changelog.md:124
+#: ../../source/ref-changelog.md:146
 #, fuzzy
 msgid ""
 "**Introduce SuperExec log streaming** "
@@ -18801,7 +18915,7 @@ msgstr ""
 "[#2355](https://github.com/adap/flower/pull/2355), "
 "[#2356](https://github.com/adap/flower/pull/2356))"
 
-#: ../../source/ref-changelog.md:126
+#: ../../source/ref-changelog.md:148
 msgid ""
 "Flower now supports log streaming from a remote SuperExec using the `flwr"
 " log` command. This new feature allows you to monitor logs from SuperExec"
@@ -18809,7 +18923,7 @@ msgid ""
 "<federation>`)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:128
+#: ../../source/ref-changelog.md:150
 #, fuzzy
 msgid ""
 "**Improve `flwr new` templates** "
@@ -18826,14 +18940,14 @@ msgstr ""
 "[#1474](https://github.com/adap/flower/pull/1474), "
 "[#1475](https://github.com/adap/flower/pull/1475)))"
 
-#: ../../source/ref-changelog.md:130
+#: ../../source/ref-changelog.md:152
 msgid ""
 "The `flwr new` command templates for MLX, NumPy, sklearn, JAX, and "
 "PyTorch have been updated to improve usability and consistency across "
 "frameworks."
 msgstr ""
 
-#: ../../source/ref-changelog.md:132
+#: ../../source/ref-changelog.md:154
 #, fuzzy
 msgid ""
 "**Migrate ID handling to use unsigned 64-bit integers** "
@@ -18845,7 +18959,7 @@ msgstr ""
 "[#1286](https://github.com/adap/flower/pull/1286), "
 "[#1282](https://github.com/adap/flower/pull/1282))"
 
-#: ../../source/ref-changelog.md:134
+#: ../../source/ref-changelog.md:156
 msgid ""
 "Node IDs, run IDs, and related fields have been migrated from signed "
 "64-bit integers (`sint64`) to unsigned 64-bit integers (`uint64`). To "
@@ -18856,14 +18970,14 @@ msgid ""
 "`uint64`."
 msgstr ""
 
-#: ../../source/ref-changelog.md:136
+#: ../../source/ref-changelog.md:158
 #, fuzzy
 msgid ""
 "**Add Flower architecture explanation** "
 "([#3270](https://github.com/adap/flower/pull/3270))"
 msgstr "**重构文档**（[#1387](https://github.com/adap/flower/pull/1387)）"
 
-#: ../../source/ref-changelog.md:138
+#: ../../source/ref-changelog.md:160
 msgid ""
 "A new [Flower architecture explainer](https://flower.ai/docs/framework"
 "/explanation-flower-architecture.html) page introduces Flower components "
@@ -18871,14 +18985,14 @@ msgid ""
 "documentation if you're interested."
 msgstr ""
 
-#: ../../source/ref-changelog.md:140
+#: ../../source/ref-changelog.md:162
 #, fuzzy
 msgid ""
 "**Introduce FedRep baseline** "
 "([#3790](https://github.com/adap/flower/pull/3790))"
 msgstr "**引入 start_driver**（[#1697](https://github.com/adap/flower/pull/1697)）"
 
-#: ../../source/ref-changelog.md:142
+#: ../../source/ref-changelog.md:164
 msgid ""
 "FedRep is a federated learning algorithm that learns shared data "
 "representations across clients while allowing each to maintain "
@@ -18888,7 +19002,7 @@ msgid ""
 "([arxiv](https://arxiv.org/abs/2102.07078))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:144
+#: ../../source/ref-changelog.md:166
 #, fuzzy
 msgid ""
 "**Improve FlowerTune template and LLM evaluation pipelines** "
@@ -18920,7 +19034,7 @@ msgstr ""
 "[#1305](https://github.com/adap/flower/pull/1305), "
 "[#1307](https://github.com/adap/flower/pull/1307))"
 
-#: ../../source/ref-changelog.md:146
+#: ../../source/ref-changelog.md:168
 msgid ""
 "Refined evaluation pipelines, metrics, and documentation for the upcoming"
 " FlowerTune LLM Leaderboard across multiple domains including Finance, "
@@ -18929,7 +19043,7 @@ msgid ""
 "exciting challenge!"
 msgstr ""
 
-#: ../../source/ref-changelog.md:148
+#: ../../source/ref-changelog.md:170
 #, fuzzy
 msgid ""
 "**Enhance Docker Support and Documentation** "
@@ -18955,7 +19069,7 @@ msgstr ""
 "[#1474](https://github.com/adap/flower/pull/1474), "
 "[#1475](https://github.com/adap/flower/pull/1475)))"
 
-#: ../../source/ref-changelog.md:150
+#: ../../source/ref-changelog.md:172
 msgid ""
 "Upgraded Ubuntu base image to 24.04, added SBOM and gcc to Docker images,"
 " and comprehensively updated [Docker "
@@ -18963,7 +19077,7 @@ msgid ""
 "including quickstart guides and distributed Docker Compose instructions."
 msgstr ""
 
-#: ../../source/ref-changelog.md:152
+#: ../../source/ref-changelog.md:174
 #, fuzzy
 msgid ""
 "**Introduce Flower glossary** "
@@ -18974,7 +19088,7 @@ msgstr ""
 "([#1858](https://github.com/adap/flower/pull/1858), "
 "[#1897](https://github.com/adap/flower/pull/1897))"
 
-#: ../../source/ref-changelog.md:154
+#: ../../source/ref-changelog.md:176
 msgid ""
 "Added the [Federated Learning glossary](https://flower.ai/glossary/) to "
 "the Flower repository, located under the `flower/glossary/` directory. "
@@ -18984,7 +19098,7 @@ msgid ""
 "become a Flower contributor!"
 msgstr ""
 
-#: ../../source/ref-changelog.md:156
+#: ../../source/ref-changelog.md:178
 #, fuzzy
 msgid ""
 "**Implement Message Time-to-Live (TTL)** "
@@ -19002,7 +19116,7 @@ msgstr ""
 "[#1613](https://github.com/adap/flower/pull/1613), "
 "[#1614](https://github.com/adap/flower/pull/1614)))"
 
-#: ../../source/ref-changelog.md:158
+#: ../../source/ref-changelog.md:180
 msgid ""
 "Added comprehensive TTL support for messages in Flower's SuperLink. "
 "Messages are now automatically expired and cleaned up based on "
@@ -19010,7 +19124,7 @@ msgid ""
 " default in the high-level API)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:160
+#: ../../source/ref-changelog.md:182
 #, fuzzy
 msgid ""
 "**Improve FAB handling** "
@@ -19024,14 +19138,14 @@ msgstr ""
 "[#1301](https://github.com/adap/flower/pull/1301), "
 "[#1310](https://github.com/adap/flower/pull/1310)"
 
-#: ../../source/ref-changelog.md:162
+#: ../../source/ref-changelog.md:184
 msgid ""
 "An 8-character hash is now appended to the FAB file name. The `flwr "
 "install` command installs FABs with a more flattened folder structure, "
 "reducing it from 3 levels to 1."
 msgstr ""
 
-#: ../../source/ref-changelog.md:164
+#: ../../source/ref-changelog.md:186
 #, fuzzy
 msgid ""
 "**Update documentation** "
@@ -19050,7 +19164,7 @@ msgstr ""
 "[#2355](https://github.com/adap/flower/pull/2355), "
 "[#2356](https://github.com/adap/flower/pull/2356))"
 
-#: ../../source/ref-changelog.md:166
+#: ../../source/ref-changelog.md:188
 msgid ""
 "Updated quickstart tutorials (PyTorch Lightning, TensorFlow, Hugging "
 "Face, Fastai) to use the new `flwr run` command and removed default title"
@@ -19058,7 +19172,7 @@ msgid ""
 "added to FAQ."
 msgstr ""
 
-#: ../../source/ref-changelog.md:168
+#: ../../source/ref-changelog.md:190
 #, fuzzy
 msgid ""
 "**Update example projects** "
@@ -19078,7 +19192,7 @@ msgstr ""
 "[#1477](https://github.com/adap/flower/pull/1477), "
 "[#2171](https://github.com/adap/flower/pull/2171))"
 
-#: ../../source/ref-changelog.md:170
+#: ../../source/ref-changelog.md:192
 msgid ""
 "Refreshed multiple example projects including vertical FL, PyTorch "
 "(advanced), Pandas, Secure Aggregation, and XGBoost examples. Optimized "
@@ -19086,7 +19200,7 @@ msgid ""
 "simulation examples."
 msgstr ""
 
-#: ../../source/ref-changelog.md:172
+#: ../../source/ref-changelog.md:194
 #, fuzzy
 msgid ""
 "**Update translations** "
@@ -19106,7 +19220,7 @@ msgstr ""
 "[#1613](https://github.com/adap/flower/pull/1613), "
 "[#1614](https://github.com/adap/flower/pull/1614)))"
 
-#: ../../source/ref-changelog.md:174
+#: ../../source/ref-changelog.md:196
 msgid ""
 "**General improvements** "
 "([#4239](https://github.com/adap/flower/pull/4239), "
@@ -19153,7 +19267,7 @@ msgid ""
 "[#4333](https://github.com/adap/flower/pull/4333))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:180
+#: ../../source/ref-changelog.md:202
 #, fuzzy
 msgid ""
 "**Drop Python 3.8 support and update minimum version to 3.9** "
@@ -19174,7 +19288,7 @@ msgstr ""
 "[#1613](https://github.com/adap/flower/pull/1613), "
 "[#1614](https://github.com/adap/flower/pull/1614)))"
 
-#: ../../source/ref-changelog.md:182
+#: ../../source/ref-changelog.md:204
 msgid ""
 "Python 3.8 support was deprecated in Flower 1.9, and this release removes"
 " support. Flower now requires Python 3.9 or later (Python 3.11 is "
@@ -19182,12 +19296,12 @@ msgid ""
 "minimum supported version. Flower now supports Python 3.9 to 3.12."
 msgstr ""
 
-#: ../../source/ref-changelog.md:184
+#: ../../source/ref-changelog.md:206
 #, fuzzy
 msgid "v1.11.1 (2024-09-11)"
 msgstr "v1.3.0 (2023-02-06)"
 
-#: ../../source/ref-changelog.md:190
+#: ../../source/ref-changelog.md:212
 #, fuzzy
 msgid ""
 "`Charles Beauville`, `Chong Shen Ng`, `Daniel J. Beutel`, `Heng Pan`, "
@@ -19199,12 +19313,12 @@ msgstr ""
 "Topal`, `achiverram28`, `danielnugraha`, `eunchung`, `ruthgal` <!---"
 "TOKEN_v1.5.0-->"
 
-#: ../../source/ref-changelog.md:192
+#: ../../source/ref-changelog.md:214
 #, fuzzy
 msgid "Improvements"
 msgstr "可选的改进措施"
 
-#: ../../source/ref-changelog.md:194
+#: ../../source/ref-changelog.md:216
 #, fuzzy
 msgid ""
 "**Implement** `keys/values/items` **methods for** `TypedDict` "
@@ -19213,21 +19327,21 @@ msgstr ""
 "**使** `get_parameters` **可配置** "
 "([#1242](https://github.com/adap/flower/pull/1242))"
 
-#: ../../source/ref-changelog.md:196
+#: ../../source/ref-changelog.md:218
 #, fuzzy
 msgid ""
 "**Fix parsing of** `--executor-config` **if present** "
 "([#4125](https://github.com/adap/flower/pull/4125))"
 msgstr "**引入 start_driver**（[#1697](https://github.com/adap/flower/pull/1697)）"
 
-#: ../../source/ref-changelog.md:198
+#: ../../source/ref-changelog.md:220
 #, fuzzy
 msgid ""
 "**Adjust framework name in templates docstrings** "
 "([#4127](https://github.com/adap/flower/pull/4127))"
 msgstr "**新的 scikit-learn 代码示例** ([#748](https://github.com/adap/flower/pull/748))"
 
-#: ../../source/ref-changelog.md:200
+#: ../../source/ref-changelog.md:222
 #, fuzzy
 msgid ""
 "**Update** `flwr new` **Hugging Face template** "
@@ -19236,14 +19350,14 @@ msgstr ""
 "**新的Hugging Face Transformers代码示例** "
 "([#863](https://github.com/adap/flower/pull/863))"
 
-#: ../../source/ref-changelog.md:202
+#: ../../source/ref-changelog.md:224
 #, fuzzy
 msgid ""
 "**Fix** `flwr new` **FlowerTune template** "
 "([#4123](https://github.com/adap/flower/pull/4123))"
 msgstr "**新的 iOS CoreML 代码示例**（[#1289](https://github.com/adap/flower/pull/1289)）"
 
-#: ../../source/ref-changelog.md:204
+#: ../../source/ref-changelog.md:226
 #, fuzzy
 msgid ""
 "**Add buffer time after** `ServerApp` **thread initialization** "
@@ -19252,14 +19366,14 @@ msgstr ""
 "**在模拟过程中为***`历史`***对象添加训练指标*** "
 "([#1696](https://github.com/adap/flower/pull/1696))"
 
-#: ../../source/ref-changelog.md:206
+#: ../../source/ref-changelog.md:228
 #, fuzzy
 msgid ""
 "**Handle unsuitable resources for simulation** "
 "([#4143](https://github.com/adap/flower/pull/4143))"
 msgstr "** 添加新的模拟监控指南** ([#1649](https://github.com/adap/flower/pull/1649))"
 
-#: ../../source/ref-changelog.md:208
+#: ../../source/ref-changelog.md:230
 #, fuzzy
 msgid ""
 "**Update example READMEs** "
@@ -19268,19 +19382,19 @@ msgstr ""
 "**介绍Flower Android SDK** "
 "([#2131](https://github.com/adap/flower/pull/2131))"
 
-#: ../../source/ref-changelog.md:210
+#: ../../source/ref-changelog.md:232
 #, fuzzy
 msgid ""
 "**Update SuperNode authentication docs** "
 "([#4160](https://github.com/adap/flower/pull/4160))"
 msgstr "** 添加一个新的 gRPC 选项**（[#2197](https://github.com/adap/flower/pull/2197)）"
 
-#: ../../source/ref-changelog.md:216
+#: ../../source/ref-changelog.md:238
 #, fuzzy
 msgid "v1.11.0 (2024-08-30)"
 msgstr "v1.3.0 (2023-02-06)"
 
-#: ../../source/ref-changelog.md:222
+#: ../../source/ref-changelog.md:244
 #, fuzzy
 msgid ""
 "`Adam Narozniak`, `Charles Beauville`, `Chong Shen Ng`, `Daniel J. "
@@ -19295,7 +19409,7 @@ msgstr ""
 "Topal`, `achiverram28`, `danielnugraha`, `eunchung`, `ruthgal` <!---"
 "TOKEN_v1.5.0-->"
 
-#: ../../source/ref-changelog.md:226
+#: ../../source/ref-changelog.md:248
 msgid ""
 "**Deliver Flower App Bundle (FAB) to SuperLink and SuperNodes** "
 "([#4006](https://github.com/adap/flower/pull/4006), "
@@ -19322,14 +19436,14 @@ msgid ""
 "[#3619](https://github.com/adap/flower/pull/3619))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:228
+#: ../../source/ref-changelog.md:250
 msgid ""
 "Dynamic code updates are here! `flwr run` can now ship and install the "
 "latest version of your `ServerApp` and `ClientApp` to an already-running "
 "federation (SuperLink and SuperNodes)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:230
+#: ../../source/ref-changelog.md:252
 msgid ""
 "How does it work? `flwr run` bundles your Flower app into a single FAB "
 "(Flower App Bundle) file. It then ships this FAB file, via the SuperExec,"
@@ -19339,11 +19453,11 @@ msgid ""
 "projects!) dynamically."
 msgstr ""
 
-#: ../../source/ref-changelog.md:232
+#: ../../source/ref-changelog.md:254
 msgid "`flwr run` is all you need."
 msgstr ""
 
-#: ../../source/ref-changelog.md:234
+#: ../../source/ref-changelog.md:256
 #, fuzzy
 msgid ""
 "**Introduce isolated** `ClientApp` **execution** "
@@ -19377,30 +19491,30 @@ msgstr ""
 "[#1564](https://github.com/adap/flower/pull/1564), "
 "[#1566](https://github.com/adap/flower/pull/1566))"
 
-#: ../../source/ref-changelog.md:236
+#: ../../source/ref-changelog.md:258
 msgid ""
 "The SuperNode can now run your `ClientApp` in a fully isolated way. In an"
 " enterprise deployment, this allows you to set strict limits on what the "
 "`ClientApp` can and cannot do."
 msgstr ""
 
-#: ../../source/ref-changelog.md:238
+#: ../../source/ref-changelog.md:260
 msgid "`flower-supernode` supports three `--isolation` modes:"
 msgstr ""
 
-#: ../../source/ref-changelog.md:240
+#: ../../source/ref-changelog.md:262
 msgid ""
 "Unset: The SuperNode runs the `ClientApp` in the same process (as in "
 "previous versions of Flower). This is the default mode."
 msgstr ""
 
-#: ../../source/ref-changelog.md:241
+#: ../../source/ref-changelog.md:263
 msgid ""
 "`--isolation=subprocess`: The SuperNode starts a subprocess to run the "
 "`ClientApp`."
 msgstr ""
 
-#: ../../source/ref-changelog.md:242
+#: ../../source/ref-changelog.md:264
 msgid ""
 "`--isolation=process`: The SuperNode expects an externally-managed "
 "process to run the `ClientApp`. This external process is not managed by "
@@ -19409,7 +19523,7 @@ msgid ""
 "`flwr/clientapp` Docker image."
 msgstr ""
 
-#: ../../source/ref-changelog.md:244
+#: ../../source/ref-changelog.md:266
 #, fuzzy
 msgid ""
 "**Improve Docker support for enterprise deployments** "
@@ -19428,17 +19542,17 @@ msgstr ""
 "[#2355](https://github.com/adap/flower/pull/2355), "
 "[#2356](https://github.com/adap/flower/pull/2356))"
 
-#: ../../source/ref-changelog.md:246
+#: ../../source/ref-changelog.md:268
 msgid ""
 "Flower 1.11 ships many Docker improvements that are especially useful for"
 " enterprise deployments:"
 msgstr ""
 
-#: ../../source/ref-changelog.md:248
+#: ../../source/ref-changelog.md:270
 msgid "`flwr/supernode` comes with a new Alpine Docker image."
 msgstr ""
 
-#: ../../source/ref-changelog.md:249
+#: ../../source/ref-changelog.md:271
 msgid ""
 "`flwr/clientapp` is a new image to be used with the `--isolation=process`"
 " option. In this mode, SuperNode and `ClientApp` run in two different "
@@ -19448,19 +19562,19 @@ msgid ""
 "enterprise settings."
 msgstr ""
 
-#: ../../source/ref-changelog.md:250
+#: ../../source/ref-changelog.md:272
 msgid ""
 "New all-in-one Docker Compose enables you to easily start a full Flower "
 "Deployment Engine on a single machine."
 msgstr ""
 
-#: ../../source/ref-changelog.md:251
+#: ../../source/ref-changelog.md:273
 msgid ""
 "Completely new Docker documentation: "
 "https://flower.ai/docs/framework/docker/index.html"
 msgstr ""
 
-#: ../../source/ref-changelog.md:253
+#: ../../source/ref-changelog.md:275
 #, fuzzy
 msgid ""
 "**Improve SuperNode authentication** "
@@ -19472,13 +19586,13 @@ msgstr ""
 "[#2390](https://github.com/adap/flower/pull/2390), "
 "[#2493](https://github.com/adap/flower/pull/2493))"
 
-#: ../../source/ref-changelog.md:255
+#: ../../source/ref-changelog.md:277
 msgid ""
 "SuperNode auth has been improved in several ways, including improved "
 "logging, improved testing, and improved error handling."
 msgstr ""
 
-#: ../../source/ref-changelog.md:257
+#: ../../source/ref-changelog.md:279
 #, fuzzy
 msgid ""
 "**Update** `flwr new` **templates** "
@@ -19499,13 +19613,13 @@ msgstr ""
 "[#1477](https://github.com/adap/flower/pull/1477), "
 "[#2171](https://github.com/adap/flower/pull/2171))"
 
-#: ../../source/ref-changelog.md:259
+#: ../../source/ref-changelog.md:281
 msgid ""
 "All `flwr new` templates have been updated to show the latest recommended"
 " use of Flower APIs."
 msgstr ""
 
-#: ../../source/ref-changelog.md:261
+#: ../../source/ref-changelog.md:283
 #, fuzzy
 msgid ""
 "**Improve Simulation Engine** "
@@ -19525,14 +19639,14 @@ msgstr ""
 "[#2355](https://github.com/adap/flower/pull/2355), "
 "[#2356](https://github.com/adap/flower/pull/2356))"
 
-#: ../../source/ref-changelog.md:263
+#: ../../source/ref-changelog.md:285
 msgid ""
 "The Flower Simulation Engine comes with several updates, including "
 "improved run config support, verbose logging, simulation backend "
 "configuration via `flwr run`, and more."
 msgstr ""
 
-#: ../../source/ref-changelog.md:265
+#: ../../source/ref-changelog.md:287
 #, fuzzy
 msgid ""
 "**Improve** `RecordSet` "
@@ -19544,7 +19658,7 @@ msgstr ""
 "[#2390](https://github.com/adap/flower/pull/2390), "
 "[#2493](https://github.com/adap/flower/pull/2493))"
 
-#: ../../source/ref-changelog.md:267
+#: ../../source/ref-changelog.md:289
 msgid ""
 "`RecordSet` is the core object to exchange model parameters, "
 "configuration values and metrics between `ClientApp` and `ServerApp`. "
@@ -19552,7 +19666,7 @@ msgid ""
 "related `*Record` types."
 msgstr ""
 
-#: ../../source/ref-changelog.md:269
+#: ../../source/ref-changelog.md:291
 #, fuzzy
 msgid ""
 "**Update documentation** "
@@ -19583,14 +19697,14 @@ msgstr ""
 "[#2225](https://github.com/adap/flower/pull/2225), "
 "[#2183](https://github.com/adap/flower/pull/2183))"
 
-#: ../../source/ref-changelog.md:271
+#: ../../source/ref-changelog.md:293
 msgid ""
 "Many parts of the documentation, including the main tutorial, have been "
 "migrated to show new Flower APIs and other new Flower features like the "
 "improved Docker support."
 msgstr ""
 
-#: ../../source/ref-changelog.md:273
+#: ../../source/ref-changelog.md:295
 msgid ""
 "**Migrate code example to use new Flower APIs** "
 "([#3758](https://github.com/adap/flower/pull/3758), "
@@ -19616,11 +19730,11 @@ msgid ""
 "[#3313](https://github.com/adap/flower/pull/3313))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:275
+#: ../../source/ref-changelog.md:297
 msgid "Many code examples have been migrated to use new Flower APIs."
 msgstr ""
 
-#: ../../source/ref-changelog.md:277
+#: ../../source/ref-changelog.md:299
 msgid ""
 "**Update Flower framework, framework internals and quality "
 "infrastructure** ([#4018](https://github.com/adap/flower/pull/4018), "
@@ -19662,14 +19776,14 @@ msgid ""
 "[#4038](https://github.com/adap/flower/pull/4038))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:283
+#: ../../source/ref-changelog.md:305
 #, fuzzy
 msgid ""
 "**Deprecate accessing `Context` via `Client.context`** "
 "([#3797](https://github.com/adap/flower/pull/3797))"
 msgstr "**移除过时的不操作额外安装** ([#973](https://github.com/adap/flower/pull/973))"
 
-#: ../../source/ref-changelog.md:285
+#: ../../source/ref-changelog.md:307
 msgid ""
 "Now that both `client_fn` and `server_fn` receive a `Context` object, "
 "accessing `Context` via `Client.context` is deprecated. `Client.context` "
@@ -19678,7 +19792,7 @@ msgid ""
 " instance in `client_fn`:"
 msgstr ""
 
-#: ../../source/ref-changelog.md:294
+#: ../../source/ref-changelog.md:316
 #, fuzzy
 msgid ""
 "**Update CLIs to accept an app directory instead of** `ClientApp` **and**"
@@ -19690,7 +19804,7 @@ msgstr ""
 "[#2221](https://github.com/adap/flower/pull/2221), "
 "[#2248](https://github.com/adap/flower/pull/2248))"
 
-#: ../../source/ref-changelog.md:296
+#: ../../source/ref-changelog.md:318
 msgid ""
 "The CLI commands `flower-supernode` and `flower-server-app` now accept an"
 " app directory as argument (instead of references to a `ClientApp` or "
@@ -19700,7 +19814,7 @@ msgid ""
 "`flwr new`."
 msgstr ""
 
-#: ../../source/ref-changelog.md:298
+#: ../../source/ref-changelog.md:320
 #, fuzzy
 msgid ""
 "**Disable** `flower-client-app` **CLI command** "
@@ -19709,46 +19823,46 @@ msgstr ""
 "**介绍Flower Android SDK** "
 "([#2131](https://github.com/adap/flower/pull/2131))"
 
-#: ../../source/ref-changelog.md:300
+#: ../../source/ref-changelog.md:322
 msgid "`flower-client-app` has been disabled. Use `flower-supernode` instead."
 msgstr ""
 
-#: ../../source/ref-changelog.md:302
+#: ../../source/ref-changelog.md:324
 #, fuzzy
 msgid ""
 "**Use spaces instead of commas for separating config args** "
 "([#4000](https://github.com/adap/flower/pull/4000))"
 msgstr "**服务器和策略的自定义指标** ([#717](https://github.com/adap/flower/pull/717))"
 
-#: ../../source/ref-changelog.md:304
+#: ../../source/ref-changelog.md:326
 msgid ""
 "When passing configs (run config, node config) to Flower, you now need to"
 " separate key-value pairs using spaces instead of commas. For example:"
 msgstr ""
 
-#: ../../source/ref-changelog.md:310
+#: ../../source/ref-changelog.md:332
 msgid "Previously, you could pass configs using commas, like this:"
 msgstr ""
 
-#: ../../source/ref-changelog.md:316
+#: ../../source/ref-changelog.md:338
 #, fuzzy
 msgid ""
 "**Remove** `flwr example` **CLI command** "
 "([#4084](https://github.com/adap/flower/pull/4084))"
 msgstr "**移除过时的 KerasClient**（[#857](https://github.com/adap/flower/pull/857)）"
 
-#: ../../source/ref-changelog.md:318
+#: ../../source/ref-changelog.md:340
 msgid ""
 "The experimental `flwr example` CLI command has been removed. Use `flwr "
 "new` to generate a project and then run it using `flwr run`."
 msgstr ""
 
-#: ../../source/ref-changelog.md:320
+#: ../../source/ref-changelog.md:342
 #, fuzzy
 msgid "v1.10.0 (2024-07-24)"
 msgstr "v1.0.0 (2022-07-28)"
 
-#: ../../source/ref-changelog.md:326
+#: ../../source/ref-changelog.md:348
 #, fuzzy
 msgid ""
 "`Adam Narozniak`, `Charles Beauville`, `Chong Shen Ng`, `Daniel J. "
@@ -19763,7 +19877,7 @@ msgstr ""
 "Topal`, `achiverram28`, `danielnugraha`, `eunchung`, `ruthgal` <!---"
 "TOKEN_v1.5.0-->"
 
-#: ../../source/ref-changelog.md:330
+#: ../../source/ref-changelog.md:352
 #, fuzzy
 msgid ""
 "**Introduce** `flwr run` **(beta)** "
@@ -19784,7 +19898,7 @@ msgstr ""
 "[#1474](https://github.com/adap/flower/pull/1474), "
 "[#1475](https://github.com/adap/flower/pull/1475)))"
 
-#: ../../source/ref-changelog.md:332
+#: ../../source/ref-changelog.md:354
 msgid ""
 "Flower 1.10 ships the first beta release of the new `flwr run` command. "
 "`flwr run` can run different projects using `flwr run path/to/project`, "
@@ -19797,7 +19911,7 @@ msgid ""
 "`flwr new` to generate a project and then run it using `flwr run`."
 msgstr ""
 
-#: ../../source/ref-changelog.md:334
+#: ../../source/ref-changelog.md:356
 #, fuzzy
 msgid ""
 "**Introduce run config** "
@@ -19825,7 +19939,7 @@ msgstr ""
 "[#1770](https://github.com/adap/flower/pull/1770), "
 "[#1733](https://github.com/adap/flower/pull/1733))"
 
-#: ../../source/ref-changelog.md:336
+#: ../../source/ref-changelog.md:358
 msgid ""
 "The new run config feature allows you to run your Flower project in "
 "different configurations without having to change a single line of code. "
@@ -19838,7 +19952,7 @@ msgid ""
 "new project using `flwr new` to see run config in action."
 msgstr ""
 
-#: ../../source/ref-changelog.md:338
+#: ../../source/ref-changelog.md:360
 #, fuzzy
 msgid ""
 "**Generalize** `client_fn` **signature to** `client_fn(context: Context) "
@@ -19852,7 +19966,7 @@ msgstr ""
 "[#2523](https://github.com/adap/flower/pull/2523), "
 "[#2522](https://github.com/adap/flower/pull/2522))"
 
-#: ../../source/ref-changelog.md:340
+#: ../../source/ref-changelog.md:362
 msgid ""
 "The `client_fn` signature has been generalized to `client_fn(context: "
 "Context) -> Client`. It now receives a `Context` object instead of the "
@@ -19862,14 +19976,14 @@ msgid ""
 "system."
 msgstr ""
 
-#: ../../source/ref-changelog.md:342
+#: ../../source/ref-changelog.md:364
 msgid ""
 "The previous signature `client_fn(cid: str)` is now deprecated and "
 "support for it will be removed in a future release. Use "
 "`client_fn(context: Context) -> Client` everywhere."
 msgstr ""
 
-#: ../../source/ref-changelog.md:344
+#: ../../source/ref-changelog.md:366
 #, fuzzy
 msgid ""
 "**Introduce new** `server_fn(context)` "
@@ -19881,7 +19995,7 @@ msgstr ""
 "[#1544](https://github.com/adap/flower/pull/1544), "
 "[#1584](https://github.com/adap/flower/pull/1584)"
 
-#: ../../source/ref-changelog.md:346
+#: ../../source/ref-changelog.md:368
 msgid ""
 "In addition to the new `client_fn(context:Context)`, a new "
 "`server_fn(context: Context) -> ServerAppComponents` can now be passed to"
@@ -19890,7 +20004,7 @@ msgid ""
 "build a configurable `ServerApp`."
 msgstr ""
 
-#: ../../source/ref-changelog.md:348
+#: ../../source/ref-changelog.md:370
 #, fuzzy
 msgid ""
 "**Relaunch all** `flwr new` **templates** "
@@ -19910,7 +20024,7 @@ msgstr ""
 "[#1613](https://github.com/adap/flower/pull/1613), "
 "[#1614](https://github.com/adap/flower/pull/1614)))"
 
-#: ../../source/ref-changelog.md:350
+#: ../../source/ref-changelog.md:372
 msgid ""
 "All `flwr new` templates have been significantly updated to showcase new "
 "Flower features and best practices. This includes using `flwr run` and "
@@ -19919,7 +20033,7 @@ msgid ""
 "run` it."
 msgstr ""
 
-#: ../../source/ref-changelog.md:352
+#: ../../source/ref-changelog.md:374
 #, fuzzy
 msgid ""
 "**Introduce** `flower-supernode` **(preview)** "
@@ -19928,7 +20042,7 @@ msgstr ""
 "**介绍Flower Android SDK** "
 "([#2131](https://github.com/adap/flower/pull/2131))"
 
-#: ../../source/ref-changelog.md:354
+#: ../../source/ref-changelog.md:376
 msgid ""
 "The new `flower-supernode` CLI is here to replace `flower-client-app`. "
 "`flower-supernode` brings full multi-app support to the Flower client-"
@@ -19937,7 +20051,7 @@ msgid ""
 "`client_fn(context: Context)` signature)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:356
+#: ../../source/ref-changelog.md:378
 #, fuzzy
 msgid ""
 "**Introduce node config** "
@@ -19952,7 +20066,7 @@ msgstr ""
 "[#1681](https://github.com/adap/flower/pull/1681), "
 "[#1679](https://github.com/adap/flower/pull/1679)"
 
-#: ../../source/ref-changelog.md:358
+#: ../../source/ref-changelog.md:380
 msgid ""
 "A new node config feature allows you to pass a static configuration to "
 "the SuperNode. This configuration is read-only and available to every "
@@ -19960,7 +20074,7 @@ msgid ""
 "config via `Context` (`context.node_config`)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:360
+#: ../../source/ref-changelog.md:382
 msgid ""
 "**Introduce SuperExec (experimental)** "
 "([#3605](https://github.com/adap/flower/pull/3605), "
@@ -19981,14 +20095,14 @@ msgid ""
 "[#3629](https://github.com/adap/flower/pull/3629))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:362
+#: ../../source/ref-changelog.md:384
 msgid ""
 "This is the first experimental release of Flower SuperExec, a new service"
 " that executes your runs. It's not ready for production deployment just "
 "yet, but don't hesitate to give it a try if you're interested."
 msgstr ""
 
-#: ../../source/ref-changelog.md:364
+#: ../../source/ref-changelog.md:386
 #, fuzzy
 msgid ""
 "**Add new federated learning with tabular data example** "
@@ -19997,13 +20111,13 @@ msgstr ""
 "** 添加使用 fastai 和 Flower 进行联邦学习的新示例** "
 "([#1598](https://github.com/adap/flower/pull/1598))"
 
-#: ../../source/ref-changelog.md:366
+#: ../../source/ref-changelog.md:388
 msgid ""
 "A new code example exemplifies a federated learning setup using the "
 "Flower framework on the Adult Census Income tabular dataset."
 msgstr ""
 
-#: ../../source/ref-changelog.md:368
+#: ../../source/ref-changelog.md:390
 #, fuzzy
 msgid ""
 "**Create generic adapter layer (preview)** "
@@ -20015,7 +20129,7 @@ msgstr ""
 "[#2390](https://github.com/adap/flower/pull/2390), "
 "[#2493](https://github.com/adap/flower/pull/2493))"
 
-#: ../../source/ref-changelog.md:370
+#: ../../source/ref-changelog.md:392
 msgid ""
 "A new generic gRPC adapter layer allows 3rd-party frameworks to integrate"
 " with Flower in a transparent way. This makes Flower more modular and "
@@ -20023,7 +20137,7 @@ msgid ""
 "platforms."
 msgstr ""
 
-#: ../../source/ref-changelog.md:372
+#: ../../source/ref-changelog.md:394
 #, fuzzy
 msgid ""
 "**Refactor Flower Simulation Engine** "
@@ -20046,7 +20160,7 @@ msgstr ""
 "[#1474](https://github.com/adap/flower/pull/1474), "
 "[#1475](https://github.com/adap/flower/pull/1475)))"
 
-#: ../../source/ref-changelog.md:374
+#: ../../source/ref-changelog.md:396
 msgid ""
 "The Simulation Engine was significantly refactored. This results in "
 "faster and more stable simulations. It is also the foundation for "
@@ -20054,20 +20168,20 @@ msgid ""
 "configurability in federated learning simulations."
 msgstr ""
 
-#: ../../source/ref-changelog.md:376
+#: ../../source/ref-changelog.md:398
 #, fuzzy
 msgid ""
 "**Optimize Docker containers** "
 "([#3591](https://github.com/adap/flower/pull/3591))"
 msgstr "新文档主题 ([#551](https://github.com/adap/flower/pull/551))"
 
-#: ../../source/ref-changelog.md:378
+#: ../../source/ref-changelog.md:400
 msgid ""
 "Flower Docker containers were optimized and updated to use that latest "
 "Flower framework features."
 msgstr ""
 
-#: ../../source/ref-changelog.md:380
+#: ../../source/ref-changelog.md:402
 #, fuzzy
 msgid ""
 "**Improve logging** ([#3776](https://github.com/adap/flower/pull/3776), "
@@ -20076,13 +20190,13 @@ msgstr ""
 "** 更新代码示例** ([#1344](https://github.com/adap/flower/pull/1344), "
 "[#1347](https://github.com/adap/flower/pull/1347))"
 
-#: ../../source/ref-changelog.md:382
+#: ../../source/ref-changelog.md:404
 msgid ""
 "Improved logging aims to be more concise and helpful to show you the "
 "details you actually care about."
 msgstr ""
 
-#: ../../source/ref-changelog.md:384
+#: ../../source/ref-changelog.md:406
 #, fuzzy
 msgid ""
 "**Refactor framework internals** "
@@ -20103,14 +20217,19 @@ msgstr ""
 "[#1474](https://github.com/adap/flower/pull/1474), "
 "[#1475](https://github.com/adap/flower/pull/1475)))"
 
-#: ../../source/ref-changelog.md:390
+#: ../../source/ref-changelog.md:410
+#, fuzzy
+msgid "Documentation improvements"
+msgstr "可选的改进措施"
+
+#: ../../source/ref-changelog.md:412
 #, fuzzy
 msgid ""
 "**Add 🇰🇷 Korean translations** "
 "([#3680](https://github.com/adap/flower/pull/3680))"
 msgstr "**在 Colab 中打开按钮** ([#1389](https://github.com/adap/flower/pull/1389))"
 
-#: ../../source/ref-changelog.md:392
+#: ../../source/ref-changelog.md:414
 #, fuzzy
 msgid ""
 "**Update translations** "
@@ -20131,7 +20250,7 @@ msgstr ""
 "[#1474](https://github.com/adap/flower/pull/1474), "
 "[#1475](https://github.com/adap/flower/pull/1475)))"
 
-#: ../../source/ref-changelog.md:394
+#: ../../source/ref-changelog.md:416
 #, fuzzy
 msgid ""
 "**Update documentation** "
@@ -20152,18 +20271,18 @@ msgstr ""
 "[#1477](https://github.com/adap/flower/pull/1477), "
 "[#2171](https://github.com/adap/flower/pull/2171))"
 
-#: ../../source/ref-changelog.md:396
+#: ../../source/ref-changelog.md:418
 msgid ""
 "Updated documentation includes new install instructions for different "
 "shells, a new Flower Code Examples documentation landing page, new `flwr`"
 " CLI docs and an updated federated XGBoost code example."
 msgstr ""
 
-#: ../../source/ref-changelog.md:400
+#: ../../source/ref-changelog.md:422
 msgid "**Deprecate** `client_fn(cid: str)`"
 msgstr ""
 
-#: ../../source/ref-changelog.md:402
+#: ../../source/ref-changelog.md:424
 msgid ""
 "`client_fn` used to have a signature `client_fn(cid: str) -> Client`. "
 "This signature is now deprecated. Use the new signature "
@@ -20176,13 +20295,13 @@ msgid ""
 " the dataset on each simulated or deployed SuperNode."
 msgstr ""
 
-#: ../../source/ref-changelog.md:404
+#: ../../source/ref-changelog.md:426
 msgid ""
 "**Deprecate passing** `Server/ServerConfig/Strategy/ClientManager` **to**"
 " `ServerApp` **directly**"
 msgstr ""
 
-#: ../../source/ref-changelog.md:406
+#: ../../source/ref-changelog.md:428
 msgid ""
 "Creating `ServerApp` using `ServerApp(config=config, strategy=strategy)` "
 "is now deprecated. Instead of passing "
@@ -20195,14 +20314,14 @@ msgid ""
 " the `run_config`)."
 msgstr ""
 
-#: ../../source/ref-changelog.md:410
+#: ../../source/ref-changelog.md:432
 #, fuzzy
 msgid ""
 "**Remove support for `client_ids` in `start_simulation`** "
 "([#3699](https://github.com/adap/flower/pull/3699))"
 msgstr "**改进模拟中的 GPU 支持**（[#1555](https://github.com/adap/flower/pull/1555)）"
 
-#: ../../source/ref-changelog.md:412
+#: ../../source/ref-changelog.md:434
 msgid ""
 "The (rarely used) feature that allowed passing custom `client_ids` to the"
 " `start_simulation` function was removed. This removal is part of a "
@@ -20210,26 +20329,26 @@ msgid ""
 "internals work in simulation and deployment."
 msgstr ""
 
-#: ../../source/ref-changelog.md:414
+#: ../../source/ref-changelog.md:436
 #, fuzzy
 msgid ""
 "**Remove `flower-driver-api` and `flower-fleet-api`** "
 "([#3418](https://github.com/adap/flower/pull/3418))"
 msgstr "**移除过时的 KerasClient**（[#857](https://github.com/adap/flower/pull/857)）"
 
-#: ../../source/ref-changelog.md:416
+#: ../../source/ref-changelog.md:438
 msgid ""
 "The two deprecated CLI commands `flower-driver-api` and `flower-fleet-"
 "api` were removed in an effort to streamline the SuperLink developer "
 "experience. Use `flower-superlink` instead."
 msgstr ""
 
-#: ../../source/ref-changelog.md:418
+#: ../../source/ref-changelog.md:440
 #, fuzzy
 msgid "v1.9.0 (2024-06-10)"
 msgstr "v1.3.0 (2023-02-06)"
 
-#: ../../source/ref-changelog.md:424
+#: ../../source/ref-changelog.md:446
 #, fuzzy
 msgid ""
 "`Adam Narozniak`, `Charles Beauville`, `Chong Shen Ng`, `Daniel J. "
@@ -20243,7 +20362,7 @@ msgstr ""
 "Topal`, `achiverram28`, `danielnugraha`, `eunchung`, `ruthgal` <!---"
 "TOKEN_v1.5.0-->"
 
-#: ../../source/ref-changelog.md:428
+#: ../../source/ref-changelog.md:450
 #, fuzzy
 msgid ""
 "**Introduce built-in authentication (preview)** "
@@ -20272,7 +20391,7 @@ msgstr ""
 "[#1519](https://github.com/adap/flower/pull/1519), "
 "[#1515](https://github.com/adap/flower/pull/1515))"
 
-#: ../../source/ref-changelog.md:430
+#: ../../source/ref-changelog.md:452
 msgid ""
 "Flower 1.9 introduces the first build-in version of client node "
 "authentication. In previous releases, users often wrote glue code to "
@@ -20284,14 +20403,14 @@ msgid ""
 "authentication) help you to get started."
 msgstr ""
 
-#: ../../source/ref-changelog.md:432
+#: ../../source/ref-changelog.md:454
 msgid ""
 "This is the first preview release of the Flower-native authentication "
 "system. Many additional features are on the roadmap for upcoming Flower "
 "releases - stay tuned."
 msgstr ""
 
-#: ../../source/ref-changelog.md:434
+#: ../../source/ref-changelog.md:456
 #, fuzzy
 msgid ""
 "**Introduce end-to-end Docker support** "
@@ -20316,7 +20435,7 @@ msgstr ""
 "[#1770](https://github.com/adap/flower/pull/1770), "
 "[#1733](https://github.com/adap/flower/pull/1733))"
 
-#: ../../source/ref-changelog.md:436
+#: ../../source/ref-changelog.md:458
 msgid ""
 "Full Flower Next Docker support is here! With the release of Flower 1.9, "
 "Flower provides stable Docker images for the Flower SuperLink, the Flower"
@@ -20326,7 +20445,7 @@ msgid ""
 "docker.html) to get stated."
 msgstr ""
 
-#: ../../source/ref-changelog.md:438
+#: ../../source/ref-changelog.md:460
 #, fuzzy
 msgid ""
 "**Re-architect Flower Next simulation engine** "
@@ -20347,7 +20466,7 @@ msgstr ""
 "[#1613](https://github.com/adap/flower/pull/1613), "
 "[#1614](https://github.com/adap/flower/pull/1614)))"
 
-#: ../../source/ref-changelog.md:440
+#: ../../source/ref-changelog.md:462
 msgid ""
 "Flower Next simulations now use a new in-memory `Driver` that improves "
 "the reliability of simulations, especially in notebook environments. This"
@@ -20355,7 +20474,7 @@ msgid ""
 "simulation architecture."
 msgstr ""
 
-#: ../../source/ref-changelog.md:442
+#: ../../source/ref-changelog.md:464
 #, fuzzy
 msgid ""
 "**Upgrade simulation engine** "
@@ -20375,21 +20494,21 @@ msgstr ""
 "[#1613](https://github.com/adap/flower/pull/1613), "
 "[#1614](https://github.com/adap/flower/pull/1614)))"
 
-#: ../../source/ref-changelog.md:444
+#: ../../source/ref-changelog.md:466
 msgid ""
 "The Flower Next simulation engine comes with improved and configurable "
 "logging. The Ray-based simulation backend in Flower 1.9 was updated to "
 "use Ray 2.10."
 msgstr ""
 
-#: ../../source/ref-changelog.md:446
+#: ../../source/ref-changelog.md:468
 #, fuzzy
 msgid ""
 "**Introduce FedPFT baseline** "
 "([#3268](https://github.com/adap/flower/pull/3268))"
 msgstr "**引入 start_driver**（[#1697](https://github.com/adap/flower/pull/1697)）"
 
-#: ../../source/ref-changelog.md:448
+#: ../../source/ref-changelog.md:470
 msgid ""
 "FedPFT allows you to perform one-shot Federated Learning by leveraging "
 "widely available foundational models, dramatically reducing communication"
@@ -20400,7 +20519,7 @@ msgid ""
 "([arxiv](https://arxiv.org/abs/2402.01862))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:450
+#: ../../source/ref-changelog.md:472
 #, fuzzy
 msgid ""
 "**Launch additional** `flwr new` **templates for Apple MLX, Hugging Face "
@@ -20420,7 +20539,7 @@ msgstr ""
 "[#2355](https://github.com/adap/flower/pull/2355), "
 "[#2356](https://github.com/adap/flower/pull/2356))"
 
-#: ../../source/ref-changelog.md:452
+#: ../../source/ref-changelog.md:474
 msgid ""
 "The `flwr` CLI's `flwr new` command is starting to become everone's "
 "favorite way of creating new Flower projects. This release introduces "
@@ -20429,7 +20548,7 @@ msgid ""
 "also received updates."
 msgstr ""
 
-#: ../../source/ref-changelog.md:454
+#: ../../source/ref-changelog.md:476
 #, fuzzy
 msgid ""
 "**Refine** `RecordSet` **API** "
@@ -20447,14 +20566,14 @@ msgstr ""
 "[#1477](https://github.com/adap/flower/pull/1477), "
 "[#2171](https://github.com/adap/flower/pull/2171))"
 
-#: ../../source/ref-changelog.md:456
+#: ../../source/ref-changelog.md:478
 msgid ""
 "`RecordSet` is part of the Flower Next low-level API preview release. In "
 "Flower 1.9, `RecordSet` received a number of usability improvements that "
 "make it easier to build `RecordSet`-based `ServerApp`s and `ClientApp`s."
 msgstr ""
 
-#: ../../source/ref-changelog.md:458
+#: ../../source/ref-changelog.md:480
 #, fuzzy
 msgid ""
 "**Beautify logging** ([#3379](https://github.com/adap/flower/pull/3379), "
@@ -20468,13 +20587,13 @@ msgstr ""
 "[#2523](https://github.com/adap/flower/pull/2523), "
 "[#2522](https://github.com/adap/flower/pull/2522))"
 
-#: ../../source/ref-changelog.md:460
+#: ../../source/ref-changelog.md:482
 msgid ""
 "Logs received a substantial update. Not only are logs now much nicer to "
 "look at, but they are also more configurable."
 msgstr ""
 
-#: ../../source/ref-changelog.md:462
+#: ../../source/ref-changelog.md:484
 #, fuzzy
 msgid ""
 "**Improve reliability** "
@@ -20494,13 +20613,13 @@ msgstr ""
 "[#1474](https://github.com/adap/flower/pull/1474), "
 "[#1475](https://github.com/adap/flower/pull/1475)))"
 
-#: ../../source/ref-changelog.md:464
+#: ../../source/ref-changelog.md:486
 msgid ""
 "Flower 1.9 includes reliability improvements across many parts of the "
 "system. One example is a much improved SuperNode shutdown procedure."
 msgstr ""
 
-#: ../../source/ref-changelog.md:466
+#: ../../source/ref-changelog.md:488
 #, fuzzy
 msgid ""
 "**Update Swift and C++ SDKs** "
@@ -20510,14 +20629,14 @@ msgstr ""
 "** 更新代码示例** ([#1344](https://github.com/adap/flower/pull/1344), "
 "[#1347](https://github.com/adap/flower/pull/1347))"
 
-#: ../../source/ref-changelog.md:468
+#: ../../source/ref-changelog.md:490
 msgid ""
 "In the C++ SDK, communication-related code is now separate from main "
 "client logic. A new abstract class `Communicator` has been introduced "
 "alongside a gRPC implementation of it."
 msgstr ""
 
-#: ../../source/ref-changelog.md:470
+#: ../../source/ref-changelog.md:492
 msgid ""
 "**Improve testing, tooling and CI/CD infrastructure** "
 "([#3294](https://github.com/adap/flower/pull/3294), "
@@ -20551,13 +20670,13 @@ msgid ""
 "[#3271](https://github.com/adap/flower/pull/3271))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:472
+#: ../../source/ref-changelog.md:494
 msgid ""
 "As always, the Flower tooling, testing, and CI/CD infrastructure has "
 "received many updates."
 msgstr ""
 
-#: ../../source/ref-changelog.md:474
+#: ../../source/ref-changelog.md:496
 msgid ""
 "**Improve documentation** "
 "([#3530](https://github.com/adap/flower/pull/3530), "
@@ -20582,20 +20701,20 @@ msgid ""
 "[#3274](https://github.com/adap/flower/pull/3274))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:476
+#: ../../source/ref-changelog.md:498
 msgid ""
 "As always, the Flower documentation has received many updates. Notable "
 "new pages include:"
 msgstr ""
 
-#: ../../source/ref-changelog.md:478
+#: ../../source/ref-changelog.md:500
 msgid ""
 "[How-to upgrate to Flower Next (Flower Next migration "
 "guide)](https://flower.ai/docs/framework/how-to-upgrade-to-flower-"
 "next.html)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:480
+#: ../../source/ref-changelog.md:502
 #, fuzzy
 msgid ""
 "[How-to run Flower using Docker](https://flower.ai/docs/framework/how-to-"
@@ -20604,13 +20723,13 @@ msgstr ""
 "`TensorFlow快速入门 (教程) <https://flower.ai/docs/framework/tutorial-"
 "quickstart-tensorflow.html>`_"
 
-#: ../../source/ref-changelog.md:482
+#: ../../source/ref-changelog.md:504
 msgid ""
 "[Flower Mods reference](https://flower.ai/docs/framework/ref-"
 "api/flwr.client.mod.html#module-flwr.client.mod)"
 msgstr ""
 
-#: ../../source/ref-changelog.md:484
+#: ../../source/ref-changelog.md:506
 #, fuzzy
 msgid ""
 "**General updates to Flower Examples** "
@@ -20644,12 +20763,12 @@ msgstr ""
 "[#1305](https://github.com/adap/flower/pull/1305), "
 "[#1307](https://github.com/adap/flower/pull/1307))"
 
-#: ../../source/ref-changelog.md:486
+#: ../../source/ref-changelog.md:508
 #, fuzzy
 msgid "As always, Flower code examples have received many updates."
 msgstr "许多 \"Flower \"代码示例得到了大幅更新。"
 
-#: ../../source/ref-changelog.md:488
+#: ../../source/ref-changelog.md:510
 msgid ""
 "**General improvements** "
 "([#3532](https://github.com/adap/flower/pull/3532), "
@@ -20688,12 +20807,12 @@ msgid ""
 "[#3261](https://github.com/adap/flower/pull/3261))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:492
+#: ../../source/ref-changelog.md:514
 #, fuzzy
 msgid "**Deprecate Python 3.8 support**"
 msgstr "** 过时的 Python 3.8**"
 
-#: ../../source/ref-changelog.md:494
+#: ../../source/ref-changelog.md:516
 #, fuzzy
 msgid ""
 "Python 3.8 will stop receiving security fixes in [October "
@@ -20701,7 +20820,7 @@ msgid ""
 "now deprecated and will be removed in an upcoming release."
 msgstr "由于 Python 3.8 已于 2024-10-01 弃用 (EOL)，对 Python 3.7 的支持现已废弃，并将在即将发布的版本中移除。"
 
-#: ../../source/ref-changelog.md:496
+#: ../../source/ref-changelog.md:518
 #, fuzzy
 msgid ""
 "**Deprecate (experimental)** `flower-driver-api` **and** `flower-fleet-"
@@ -20711,14 +20830,14 @@ msgstr ""
 "FedBN ([#2608](https://github.com/adap/flower/pull/2608), "
 "[#2615](https://github.com/adap/flower/pull/2615))"
 
-#: ../../source/ref-changelog.md:498
+#: ../../source/ref-changelog.md:520
 msgid ""
 "Flower 1.9 deprecates the two (experimental) commands `flower-driver-api`"
 " and `flower-fleet-api`. Both commands will be removed in an upcoming "
 "release. Use `flower-superlink` instead."
 msgstr ""
 
-#: ../../source/ref-changelog.md:500
+#: ../../source/ref-changelog.md:522
 #, fuzzy
 msgid ""
 "**Deprecate** `--server` **in favor of** `--superlink` "
@@ -20727,14 +20846,14 @@ msgstr ""
 "**启用向** `start_simulation` 传递** `Server` 实例 "
 "([#1281](https://github.com/adap/flower/pull/1281))"
 
-#: ../../source/ref-changelog.md:502
+#: ../../source/ref-changelog.md:524
 msgid ""
 "The commands `flower-server-app` and `flower-client-app` should use "
 "`--superlink` instead of the now deprecated `--server`. Support for "
 "`--server` will be removed in a future release."
 msgstr ""
 
-#: ../../source/ref-changelog.md:506
+#: ../../source/ref-changelog.md:528
 msgid ""
 "**Replace** `flower-superlink` **CLI option** `--certificates` **with** "
 "`--ssl-ca-certfile` **,** `--ssl-certfile` **and** `--ssl-keyfile` "
@@ -20742,7 +20861,7 @@ msgid ""
 "[#3408](https://github.com/adap/flower/pull/3408))"
 msgstr ""
 
-#: ../../source/ref-changelog.md:508
+#: ../../source/ref-changelog.md:530
 msgid ""
 "SSL-related `flower-superlink` CLI arguments were restructured in an "
 "incompatible way. Instead of passing a single `--certificates` flag with "
@@ -20752,21 +20871,21 @@ msgid ""
 "connections.html) documentation page for details."
 msgstr ""
 
-#: ../../source/ref-changelog.md:510
+#: ../../source/ref-changelog.md:532
 #, fuzzy
 msgid ""
 "**Remove SuperLink** `--vce` **option** "
 "([#3513](https://github.com/adap/flower/pull/3513))"
 msgstr "**重构文档**（[#1387](https://github.com/adap/flower/pull/1387)）"
 
-#: ../../source/ref-changelog.md:512
+#: ../../source/ref-changelog.md:534
 msgid ""
 "Instead of separately starting a SuperLink and a `ServerApp` for "
 "simulation, simulations must now be started using the single `flower-"
 "simulation` command."
 msgstr ""
 
-#: ../../source/ref-changelog.md:514
+#: ../../source/ref-changelog.md:536
 #, fuzzy
 msgid ""
 "**Merge** `--grpc-rere` **and** `--rest` **SuperLink options** "
@@ -20775,7 +20894,7 @@ msgstr ""
 "**重新命名** `rnd` ** to** `server_round` "
 "([#1321](https://github.com/adap/flower/pull/1321))"
 
-#: ../../source/ref-changelog.md:516
+#: ../../source/ref-changelog.md:538
 msgid ""
 "To simplify the usage of `flower-superlink`, previously separate sets of "
 "CLI options for gRPC and REST were merged into one unified set of "
@@ -20784,12 +20903,12 @@ msgid ""
 "details."
 msgstr ""
 
-#: ../../source/ref-changelog.md:518
+#: ../../source/ref-changelog.md:540
 #, fuzzy
 msgid "v1.8.0 (2024-04-03)"
 msgstr "v1.3.0 (2023-02-06)"
 
-#: ../../source/ref-changelog.md:524
+#: ../../source/ref-changelog.md:546
 #, fuzzy
 msgid ""
 "`Adam Narozniak`, `Charles Beauville`, `Daniel J. Beutel`, `Daniel Nata "
@@ -20804,7 +20923,7 @@ msgstr ""
 "Topal`, `achiverram28`, `danielnugraha`, `eunchung`, `ruthgal` <!---"
 "TOKEN_v1.5.0-->"
 
-#: ../../source/ref-changelog.md:528
+#: ../../source/ref-changelog.md:550
 #, fuzzy
 msgid ""
 "**Introduce Flower Next high-level API (stable)** "
@@ -20861,7 +20980,7 @@ msgstr ""
 "[#3195](https://github.com/adap/flower/pull/3195), "
 "[#3197](https://github.com/adap/flower/pull/3197))"
 
-#: ../../source/ref-changelog.md:530
+#: ../../source/ref-changelog.md:552
 #, fuzzy
 msgid ""
 "The Flower Next high-level API is stable! Flower Next is the future of "
@@ -20881,7 +21000,7 @@ msgstr ""
 "Next 允许您同时运行多个项目（我们称之为多重运行），并在模拟环境或部署环境中执行同一项目，而无需更改任何代码。最棒的是什么？它与使用 "
 "`Strategy`、`NumPyClient` 等的现有 Flower 项目完全兼容。"
 
-#: ../../source/ref-changelog.md:532
+#: ../../source/ref-changelog.md:554
 #, fuzzy
 msgid ""
 "**Introduce Flower Next low-level API (preview)** "
@@ -20893,7 +21012,7 @@ msgstr ""
 "[#2390](https://github.com/adap/flower/pull/2390), "
 "[#2493](https://github.com/adap/flower/pull/2493))"
 
-#: ../../source/ref-changelog.md:534
+#: ../../source/ref-changelog.md:556
 #, fuzzy
 msgid ""
 "In addition to the Flower Next *high-level* API that uses `Strategy`, "
@@ -20918,7 +21037,7 @@ msgstr ""
 "\"接收到的原始信息。新的抽象（如 \"RecordSet\"、\"Message \"和 "
 "\"Context\"）进一步支持发送多个模型、多套配置值和指标、客户端节点上的有状态计算以及自定义 SMPC 协议的实现等。"
 
-#: ../../source/ref-changelog.md:536
+#: ../../source/ref-changelog.md:558
 #, fuzzy
 msgid ""
 "**Introduce Flower Mods (preview)** "
@@ -20930,7 +21049,7 @@ msgstr ""
 "[#2221](https://github.com/adap/flower/pull/2221), "
 "[#2248](https://github.com/adap/flower/pull/2248))"
 
-#: ../../source/ref-changelog.md:538
+#: ../../source/ref-changelog.md:560
 #, fuzzy
 msgid ""
 "Flower Modifiers (we call them Mods) can intercept messages and analyze, "
@@ -20947,7 +21066,7 @@ msgstr ""
 "已经包含了记录信息大小、通过网络发送的参数数量、固定剪切和自适应剪切的差分隐私、本地差分隐私以及安全聚合协议 SecAgg 和 SecAgg+ 的"
 " Mods。Flower Mods API 作为预览版发布，但研究人员已经可以用它来试验任意的 SMPC 协议。"
 
-#: ../../source/ref-changelog.md:540
+#: ../../source/ref-changelog.md:562
 #, fuzzy
 msgid ""
 "**Fine-tune LLMs with LLM FlowerTune** "
@@ -20966,7 +21085,7 @@ msgstr ""
 "[#1474](https://github.com/adap/flower/pull/1474), "
 "[#1475](https://github.com/adap/flower/pull/1475)))"
 
-#: ../../source/ref-changelog.md:542
+#: ../../source/ref-changelog.md:564
 #, fuzzy
 msgid ""
 "We are introducing LLM FlowerTune, an introductory example that "
@@ -20981,7 +21100,7 @@ msgstr ""
 "Fine-tuning with Flower](https://flower.ai/blog/2024-03-14-llm-"
 "flowertune-federated-llm-finetuning-with-flower/) 了解更多详情。"
 
-#: ../../source/ref-changelog.md:544
+#: ../../source/ref-changelog.md:566
 #, fuzzy
 msgid ""
 "**Introduce built-in Differential Privacy (preview)** "
@@ -21002,7 +21121,7 @@ msgstr ""
 "[#993](https://github.com/adap/flower/pull/993), "
 "[#994](https://github.com/adap/flower/pull/994))"
 
-#: ../../source/ref-changelog.md:546
+#: ../../source/ref-changelog.md:568
 #, fuzzy
 msgid ""
 "Built-in Differential Privacy is here! Flower supports both central and "
@@ -21021,7 +21140,7 @@ msgstr ""
 "和新的操作指南[如何使用新的差分隐私组件](https://flower.ai/docs/framework/how-to-use-"
 "differential-privacy.html) 介绍了 Flower 的使用方法。"
 
-#: ../../source/ref-changelog.md:548
+#: ../../source/ref-changelog.md:570
 #, fuzzy
 msgid ""
 "**Introduce built-in Secure Aggregation (preview)** "
@@ -21033,7 +21152,7 @@ msgstr ""
 "[#2221](https://github.com/adap/flower/pull/2221), "
 "[#2248](https://github.com/adap/flower/pull/2248))"
 
-#: ../../source/ref-changelog.md:550
+#: ../../source/ref-changelog.md:572
 #, fuzzy
 msgid ""
 "Built-in Secure Aggregation is here! Flower now supports different secure"
@@ -21051,7 +21170,7 @@ msgstr ""
 "的支持，但更多协议将很快实现。我们还将添加详细的文档，解释安全聚合以及如何在 Flower 中使用它。您可以查看新的代码示例，了解如何使用 "
 "Flower 在同一项目中轻松结合联合学习、差分隐私和安全聚合。"
 
-#: ../../source/ref-changelog.md:552
+#: ../../source/ref-changelog.md:574
 #, fuzzy
 msgid ""
 "**Introduce** `flwr` **CLI (preview)** "
@@ -21072,14 +21191,14 @@ msgstr ""
 "[#1477](https://github.com/adap/flower/pull/1477), "
 "[#2171](https://github.com/adap/flower/pull/2171))"
 
-#: ../../source/ref-changelog.md:554
+#: ../../source/ref-changelog.md:576
 #, fuzzy
 msgid ""
 "A new `flwr` CLI command allows creating new Flower projects (`flwr new`)"
 " and then running them using the Simulation Engine (`flwr run`)."
 msgstr "新的 `flwr` CLI 命令允许创建新的 Flower 项目（`flwr new`），然后使用仿真引擎运行它们（`flwr run`）。"
 
-#: ../../source/ref-changelog.md:556
+#: ../../source/ref-changelog.md:578
 #, fuzzy
 msgid ""
 "**Introduce Flower Next Simulation Engine** "
@@ -21102,7 +21221,7 @@ msgstr ""
 "[#1770](https://github.com/adap/flower/pull/1770), "
 "[#1733](https://github.com/adap/flower/pull/1733))"
 
-#: ../../source/ref-changelog.md:558
+#: ../../source/ref-changelog.md:580
 #, fuzzy
 msgid ""
 "The Flower Simulation Engine can now run Flower Next projects. For "
@@ -21112,14 +21231,14 @@ msgstr ""
 "Flower 模拟引擎现在可以运行 Flower Next 项目。对于笔记本环境，还有一个新的 `run_simulation` 函数，可以运行 "
 "`ServerApp` 和 `ClientApp`。"
 
-#: ../../source/ref-changelog.md:560
+#: ../../source/ref-changelog.md:582
 #, fuzzy
 msgid ""
 "**Handle SuperNode connection errors** "
 "([#2969](https://github.com/adap/flower/pull/2969))"
 msgstr "** 添加一个新的 gRPC 选项**（[#2197](https://github.com/adap/flower/pull/2197)）"
 
-#: ../../source/ref-changelog.md:562
+#: ../../source/ref-changelog.md:584
 #, fuzzy
 msgid ""
 "A SuperNode will now try to reconnect indefinitely to the SuperLink in "
@@ -21134,7 +21253,7 @@ msgstr ""
 "retries` 和 `-max-wait-time`。最大重试次数 \"将定义客户端在放弃重新连接超级链接之前的重试次数，而 \"最大等待时间 "
 "\"则定义超级节点放弃重新连接超级链接之前的等待时间。"
 
-#: ../../source/ref-changelog.md:564
+#: ../../source/ref-changelog.md:586
 #, fuzzy
 msgid ""
 "**General updates to Flower Baselines** "
@@ -21149,7 +21268,7 @@ msgstr ""
 "[#1681](https://github.com/adap/flower/pull/1681), "
 "[#1679](https://github.com/adap/flower/pull/1679)"
 
-#: ../../source/ref-changelog.md:566
+#: ../../source/ref-changelog.md:588
 #, fuzzy
 msgid ""
 "There's a new [FedStar](https://flower.ai/docs/baselines/fedstar.html) "
@@ -21158,7 +21277,7 @@ msgstr ""
 "有一条新的 [FedStar](https://flower.ai/docs/baselines/fedstar.html) "
 "基准线。其他几条基准线也已更新。"
 
-#: ../../source/ref-changelog.md:568
+#: ../../source/ref-changelog.md:590
 #, fuzzy
 msgid ""
 "**Improve documentation and translations** "
@@ -21196,7 +21315,7 @@ msgstr ""
 "[#2990](https://github.com/adap/flower/pull/2990), "
 "[#2989](https://github.com/adap/flower/pull/2989))"
 
-#: ../../source/ref-changelog.md:570
+#: ../../source/ref-changelog.md:592
 #, fuzzy
 msgid ""
 "As usual, we merged many smaller and larger improvements to the "
@@ -21206,7 +21325,7 @@ msgstr ""
 "像往常一样，我们合并了许多对文档的较大和较小的改进。特别要感谢 [Sebastian van der "
 "Voort](https://github.com/svdvoort)，他为我们带来了一份重要的文档 PR！"
 
-#: ../../source/ref-changelog.md:572
+#: ../../source/ref-changelog.md:594
 #, fuzzy
 msgid ""
 "**General updates to Flower Examples** "
@@ -21232,7 +21351,7 @@ msgstr ""
 "[#1519](https://github.com/adap/flower/pull/1519), "
 "[#1515](https://github.com/adap/flower/pull/1515))"
 
-#: ../../source/ref-changelog.md:574
+#: ../../source/ref-changelog.md:596
 #, fuzzy
 msgid ""
 "Two new examples show federated training of a Vision Transformer (ViT) "
@@ -21245,7 +21364,7 @@ msgstr ""
 "\"和 \"quickstart-tensorflow \"展示了新的 Flower Next \"ServerApp \"和 "
 "\"ClientApp\"。许多其他示例也得到了大量更新。"
 
-#: ../../source/ref-changelog.md:576
+#: ../../source/ref-changelog.md:598
 #, fuzzy
 msgid ""
 "**General improvements** "
@@ -21397,12 +21516,12 @@ msgstr ""
 "[#2955](https://github.com/adap/flower/pull/2955), "
 "[#2954](https://github.com/adap/flower/pull/2954))"
 
-#: ../../source/ref-changelog.md:582
+#: ../../source/ref-changelog.md:604
 #, fuzzy
 msgid "v1.7.0 (2024-02-05)"
 msgstr "v1.3.0 (2023-02-06)"
 
-#: ../../source/ref-changelog.md:588
+#: ../../source/ref-changelog.md:610
 #, fuzzy
 msgid ""
 "`Aasheesh Singh`, `Adam Narozniak`, `Aml Hassan Esmil`, `Charles "
@@ -21418,7 +21537,7 @@ msgstr ""
 "Topal`, `achiverram28`, `danielnugraha`, `eunchung`, `ruthgal` <!---"
 "TOKEN_v1.5.0-->"
 
-#: ../../source/ref-changelog.md:592
+#: ../../source/ref-changelog.md:614
 #, fuzzy
 msgid ""
 "**Introduce stateful clients (experimental)** "
@@ -21434,7 +21553,7 @@ msgstr ""
 "[#2327](https://github.com/adap/flower/pull/2327), "
 "[#2435](https://github.com/adap/flower/pull/2435))"
 
-#: ../../source/ref-changelog.md:594
+#: ../../source/ref-changelog.md:616
 #, fuzzy
 msgid ""
 "Subclasses of `Client` and `NumPyClient` can now store local state that "
@@ -21453,14 +21572,14 @@ msgstr ""
 "RecordSet = self.context.state`。对该 `RecordSet` "
 "的更改会在不同轮执行中保留，以便在模拟和部署中以统一的方式进行有状态计算。"
 
-#: ../../source/ref-changelog.md:596
+#: ../../source/ref-changelog.md:618
 #, fuzzy
 msgid ""
 "**Improve performance** "
 "([#2293](https://github.com/adap/flower/pull/2293))"
 msgstr "**改进示例笔记** ([#2005](https://github.com/adap/flower/pull/2005))"
 
-#: ../../source/ref-changelog.md:598
+#: ../../source/ref-changelog.md:620
 #, fuzzy
 msgid ""
 "Flower is faster than ever. All `FedAvg`-derived strategies now use in-"
@@ -21472,7 +21591,7 @@ msgstr ""
 "Flower 的速度比以往更快。所有源于 `FedAvg` 的策略现在都使用就地聚合，以减少内存消耗。Flower "
 "客户端序列化/解序列化已从头开始重写，从而显著提高了速度，尤其是在客户端训练时间较短的情况下。"
 
-#: ../../source/ref-changelog.md:600
+#: ../../source/ref-changelog.md:622
 #, fuzzy
 msgid ""
 "**Support Federated Learning with Apple MLX and Flower** "
@@ -21481,7 +21600,7 @@ msgstr ""
 "** 添加使用 fastai 和 Flower 进行联邦学习的新示例** "
 "([#1598](https://github.com/adap/flower/pull/1598))"
 
-#: ../../source/ref-changelog.md:602
+#: ../../source/ref-changelog.md:624
 #, fuzzy
 msgid ""
 "Flower has official support for federated learning using [Apple "
@@ -21491,7 +21610,7 @@ msgstr ""
 "通过新的 `quickstart-mlx` 代码示例，Flower 正式支持使用 [Apple MLX](https://ml-"
 "explore.github.io/mlx)的联合学习。"
 
-#: ../../source/ref-changelog.md:604
+#: ../../source/ref-changelog.md:626
 #, fuzzy
 msgid ""
 "**Introduce new XGBoost cyclic strategy** "
@@ -21501,7 +21620,7 @@ msgstr ""
 "**介绍 iOS SDK（预览版）** ([#1621](https://github.com/adap/flower/pull/1621), "
 "[#1764](https://github.com/adap/flower/pull/1764))"
 
-#: ../../source/ref-changelog.md:606
+#: ../../source/ref-changelog.md:628
 #, fuzzy
 msgid ""
 "A new strategy called `FedXgbCyclic` supports a client-by-client style of"
@@ -21514,21 +21633,21 @@ msgstr ""
 "\"代码示例展示了如何在一个完整的项目中使用它。除此之外，`xgboost-comprehensive` 现在还支持模拟模式。由此，Flower "
 "提供了同类最佳的 XGBoost 支持。"
 
-#: ../../source/ref-changelog.md:608
+#: ../../source/ref-changelog.md:630
 #, fuzzy
 msgid ""
 "**Support Python 3.11** "
 "([#2394](https://github.com/adap/flower/pull/2394))"
 msgstr "** 支持 Python 3.10** ([#1320](https://github.com/adap/flower/pull/1320))"
 
-#: ../../source/ref-changelog.md:610
+#: ../../source/ref-changelog.md:632
 #, fuzzy
 msgid ""
 "Framework tests now run on Python 3.8, 3.9, 3.10, and 3.11. This will "
 "ensure better support for users using more recent Python versions."
 msgstr "框架测试现在可在 Python 3.8、3.9、3.10 和 3.11 上运行。这将确保为使用最新 Python 版本的用户提供更好的支持。"
 
-#: ../../source/ref-changelog.md:612
+#: ../../source/ref-changelog.md:634
 #, fuzzy
 msgid ""
 "**Update gRPC and ProtoBuf dependencies** "
@@ -21537,14 +21656,14 @@ msgstr ""
 "**更新 REST API 以支持创建和删除节点** "
 "([#2283](https://github.com/adap/flower/pull/2283))"
 
-#: ../../source/ref-changelog.md:614
+#: ../../source/ref-changelog.md:636
 #, fuzzy
 msgid ""
 "The `grpcio` and `protobuf` dependencies were updated to their latest "
 "versions for improved security and performance."
 msgstr "为提高安全性和性能，\"grpcio \"和 \"protobuf \"依赖项已更新至最新版本。"
 
-#: ../../source/ref-changelog.md:616
+#: ../../source/ref-changelog.md:638
 #, fuzzy
 msgid ""
 "**Introduce Docker image for Flower server** "
@@ -21565,7 +21684,7 @@ msgstr ""
 "[#993](https://github.com/adap/flower/pull/993), "
 "[#994](https://github.com/adap/flower/pull/994))"
 
-#: ../../source/ref-changelog.md:618
+#: ../../source/ref-changelog.md:640
 #, fuzzy
 msgid ""
 "The Flower server can now be run using an official Docker image. A new "
@@ -21577,7 +21696,7 @@ msgstr ""
 "Flower](https://flower.ai/docs/framework/how-to-run-flower-using-"
 "docker.html)。Flower 客户端 Docker 官方镜像将随后发布。"
 
-#: ../../source/ref-changelog.md:620
+#: ../../source/ref-changelog.md:642
 #, fuzzy
 msgid ""
 "**Introduce** `flower-via-docker-compose` **example** "
@@ -21586,21 +21705,21 @@ msgstr ""
 "**介绍Flower Android SDK** "
 "([#2131](https://github.com/adap/flower/pull/2131))"
 
-#: ../../source/ref-changelog.md:622
+#: ../../source/ref-changelog.md:644
 #, fuzzy
 msgid ""
 "**Introduce** `quickstart-sklearn-tabular` **example** "
 "([#2719](https://github.com/adap/flower/pull/2719))"
 msgstr "**引入 start_driver**（[#1697](https://github.com/adap/flower/pull/1697)）"
 
-#: ../../source/ref-changelog.md:624
+#: ../../source/ref-changelog.md:646
 #, fuzzy
 msgid ""
 "**Introduce** `custom-metrics` **example** "
 "([#1958](https://github.com/adap/flower/pull/1958))"
 msgstr "**引入 start_driver**（[#1697](https://github.com/adap/flower/pull/1697)）"
 
-#: ../../source/ref-changelog.md:626
+#: ../../source/ref-changelog.md:648
 #, fuzzy
 msgid ""
 "**Update code examples to use Flower Datasets** "
@@ -21614,14 +21733,14 @@ msgstr ""
 "[#1301](https://github.com/adap/flower/pull/1301), "
 "[#1310](https://github.com/adap/flower/pull/1310)"
 
-#: ../../source/ref-changelog.md:628
+#: ../../source/ref-changelog.md:650
 #, fuzzy
 msgid ""
 "Several code examples were updated to use [Flower "
 "Datasets](https://flower.ai/docs/datasets/)."
 msgstr "更新了多个代码示例，以使用 [Flower Datasets](https://flower.ai/docs/datasets/) 。"
 
-#: ../../source/ref-changelog.md:630
+#: ../../source/ref-changelog.md:652
 #, fuzzy
 msgid ""
 "**General updates to Flower Examples** "
@@ -21646,16 +21765,16 @@ msgstr ""
 "[#1662](https://github.com/adap/flower/pull/1662), "
 "[#1794](https://github.com/adap/flower/pull/1794))"
 
-#: ../../source/ref-changelog.md:632
+#: ../../source/ref-changelog.md:654
 #, fuzzy
 msgid "Many Flower code examples received substantial updates."
 msgstr "许多 \"Flower \"代码示例得到了大幅更新。"
 
-#: ../../source/ref-changelog.md:634 ../../source/ref-changelog.md:727
+#: ../../source/ref-changelog.md:656 ../../source/ref-changelog.md:749
 msgid "**Update Flower Baselines**"
 msgstr "**更新 Flower Baselines**"
 
-#: ../../source/ref-changelog.md:636
+#: ../../source/ref-changelog.md:658
 #, fuzzy
 msgid ""
 "HFedXGBoost ([#2226](https://github.com/adap/flower/pull/2226), "
@@ -21664,32 +21783,32 @@ msgstr ""
 "FedBN ([#2608](https://github.com/adap/flower/pull/2608), "
 "[#2615](https://github.com/adap/flower/pull/2615))"
 
-#: ../../source/ref-changelog.md:637
+#: ../../source/ref-changelog.md:659
 #, fuzzy
 msgid "FedVSSL ([#2412](https://github.com/adap/flower/pull/2412))"
 msgstr "FjORD [#2431](https://github.com/adap/flower/pull/2431)"
 
-#: ../../source/ref-changelog.md:638
+#: ../../source/ref-changelog.md:660
 #, fuzzy
 msgid "FedNova ([#2179](https://github.com/adap/flower/pull/2179))"
 msgstr "FjORD [#2431](https://github.com/adap/flower/pull/2431)"
 
-#: ../../source/ref-changelog.md:639
+#: ../../source/ref-changelog.md:661
 #, fuzzy
 msgid "HeteroFL ([#2439](https://github.com/adap/flower/pull/2439))"
 msgstr "FedMeta [#2438](https://github.com/adap/flower/pull/2438)"
 
-#: ../../source/ref-changelog.md:640
+#: ../../source/ref-changelog.md:662
 #, fuzzy
 msgid "FedAvgM ([#2246](https://github.com/adap/flower/pull/2246))"
 msgstr "FedPer [#2266](https://github.com/adap/flower/pull/2266)"
 
-#: ../../source/ref-changelog.md:641
+#: ../../source/ref-changelog.md:663
 #, fuzzy
 msgid "FedPara ([#2722](https://github.com/adap/flower/pull/2722))"
 msgstr "FedPer [#2266](https://github.com/adap/flower/pull/2266)"
 
-#: ../../source/ref-changelog.md:643
+#: ../../source/ref-changelog.md:665
 #, fuzzy
 msgid ""
 "**Improve documentation** "
@@ -21708,7 +21827,7 @@ msgstr ""
 "[#1613](https://github.com/adap/flower/pull/1613), "
 "[#1614](https://github.com/adap/flower/pull/1614)))"
 
-#: ../../source/ref-changelog.md:645
+#: ../../source/ref-changelog.md:667
 #, fuzzy
 msgid ""
 "**Improved testing and development infrastructure** "
@@ -21772,14 +21891,14 @@ msgstr ""
 "[#2661](https://github.com/adap/flower/pull/2661), "
 "[#2398](https://github.com/adap/flower/pull/2398))"
 
-#: ../../source/ref-changelog.md:647
+#: ../../source/ref-changelog.md:669
 #, fuzzy
 msgid ""
 "The Flower testing and development infrastructure has received "
 "substantial updates. This makes Flower 1.7 the most tested release ever."
 msgstr "Flower 测试和开发基础架构已得到大幅更新。这使得 Flower 1.7 成为有史以来经过最多测试的版本。"
 
-#: ../../source/ref-changelog.md:649
+#: ../../source/ref-changelog.md:671
 #, fuzzy
 msgid ""
 "**Update dependencies** "
@@ -21815,7 +21934,7 @@ msgstr ""
 "[#2225](https://github.com/adap/flower/pull/2225), "
 "[#2183](https://github.com/adap/flower/pull/2183))"
 
-#: ../../source/ref-changelog.md:651
+#: ../../source/ref-changelog.md:673
 #, fuzzy
 msgid ""
 "**General improvements** "
@@ -21893,7 +22012,7 @@ msgstr ""
 "[#2672](https://github.com/adap/flower/pull/2672), "
 "[#2759](https://github.com/adap/flower/pull/2759))"
 
-#: ../../source/ref-changelog.md:655
+#: ../../source/ref-changelog.md:677
 #, fuzzy
 msgid ""
 "**Deprecate** `start_numpy_client` "
@@ -21903,7 +22022,7 @@ msgstr ""
 "TAMUNA ([#2254](https://github.com/adap/flower/pull/2254), "
 "[#2508](https://github.com/adap/flower/pull/2508))"
 
-#: ../../source/ref-changelog.md:657
+#: ../../source/ref-changelog.md:679
 #, fuzzy
 msgid ""
 "Until now, clients of type `NumPyClient` needed to be started via "
@@ -21919,14 +22038,14 @@ msgstr ""
 "客户端，只需首先调用 `.to_client()` 方法，然后将返回的 `Client` 对象传递给 "
 "`start_client`。示例和文档已相应更新。"
 
-#: ../../source/ref-changelog.md:659
+#: ../../source/ref-changelog.md:681
 #, fuzzy
 msgid ""
 "**Deprecate legacy DP wrappers** "
 "([#2749](https://github.com/adap/flower/pull/2749))"
 msgstr "**移除过时的 KerasClient**（[#857](https://github.com/adap/flower/pull/857)）"
 
-#: ../../source/ref-changelog.md:661
+#: ../../source/ref-changelog.md:683
 #, fuzzy
 msgid ""
 "Legacy DP wrapper classes are deprecated, but still functional. This is "
@@ -21934,7 +22053,7 @@ msgid ""
 "support in Flower."
 msgstr "传统的 DP 封装类已废弃，但仍可正常使用。这是为 Flower 中的全新可插拔差分隐私支持版本做准备。"
 
-#: ../../source/ref-changelog.md:663
+#: ../../source/ref-changelog.md:685
 #, fuzzy
 msgid ""
 "**Make optional arg** `--callable` **in** `flower-client` **a required "
@@ -21943,7 +22062,7 @@ msgstr ""
 "**从** `start_client` 中移除** `rest` **实验参数 "
 "([#2324](https://github.com/adap/flower/pull/2324))"
 
-#: ../../source/ref-changelog.md:665
+#: ../../source/ref-changelog.md:687
 #, fuzzy
 msgid ""
 "**Rename** `certificates` **to** `root_certificates` **in** `Driver` "
@@ -21952,7 +22071,7 @@ msgstr ""
 "**重新命名** `rnd` ** to** `server_round` "
 "([#1321](https://github.com/adap/flower/pull/1321))"
 
-#: ../../source/ref-changelog.md:667
+#: ../../source/ref-changelog.md:689
 #, fuzzy
 msgid ""
 "**Drop experimental** `Task` **fields** "
@@ -21962,7 +22081,7 @@ msgstr ""
 "FedBN ([#2608](https://github.com/adap/flower/pull/2608), "
 "[#2615](https://github.com/adap/flower/pull/2615))"
 
-#: ../../source/ref-changelog.md:669
+#: ../../source/ref-changelog.md:691
 #, fuzzy
 msgid ""
 "Experimental fields `sa`, `legacy_server_message` and "
@@ -21972,14 +22091,14 @@ msgstr ""
 "从 `Task` 消息中删除了试验性字段 `sa`、 `legacy_server_message` 和 "
 "`legacy_client_message`。删除的字段已被新的 `RecordSet` 抽象所取代。"
 
-#: ../../source/ref-changelog.md:671
+#: ../../source/ref-changelog.md:693
 #, fuzzy
 msgid ""
 "**Retire MXNet examples** "
 "([#2724](https://github.com/adap/flower/pull/2724))"
 msgstr "**新的 scikit-learn 代码示例** ([#748](https://github.com/adap/flower/pull/748))"
 
-#: ../../source/ref-changelog.md:673
+#: ../../source/ref-changelog.md:695
 #, fuzzy
 msgid ""
 "The development of the MXNet fremework has ended and the project is now "
@@ -21989,12 +22108,12 @@ msgstr ""
 "MXNet fremework 的开发工作已经结束，该项目现已[归档于 "
 "GitHub](https://github.com/apache/mxnet)。现有的 MXNet 示例不会收到更新。"
 
-#: ../../source/ref-changelog.md:675
+#: ../../source/ref-changelog.md:697
 #, fuzzy
 msgid "v1.6.0 (2023-11-28)"
 msgstr "v1.4.0 (2023-04-21)"
 
-#: ../../source/ref-changelog.md:681
+#: ../../source/ref-changelog.md:703
 #, fuzzy
 msgid ""
 "`Aashish Kolluri`, `Adam Narozniak`, `Alessio Mora`, `Barathwaja S`, "
@@ -22011,7 +22130,7 @@ msgstr ""
 "`Steve Laskaridis`, `Taner Topal`, `William Lindskog`, `Yan Gao`, "
 "`cnxdeveloper`, `k3nfalt` <!---TOKEN_v1.6.0-->"
 
-#: ../../source/ref-changelog.md:685
+#: ../../source/ref-changelog.md:707
 msgid ""
 "**Add experimental support for Python 3.12** "
 "([#2565](https://github.com/adap/flower/pull/2565))"
@@ -22019,7 +22138,7 @@ msgstr ""
 "** 增加对 Python 3.12 的实验支持** "
 "([#2565](https://github.com/adap/flower/pull/2565))"
 
-#: ../../source/ref-changelog.md:687
+#: ../../source/ref-changelog.md:709
 #, fuzzy
 msgid ""
 "**Add new XGBoost examples** "
@@ -22038,7 +22157,7 @@ msgstr ""
 "[#1551](https://github.com/adap/flower/pull/1551), "
 "[#1567](https://github.com/adap/flower/pull/1567))"
 
-#: ../../source/ref-changelog.md:689
+#: ../../source/ref-changelog.md:711
 #, fuzzy
 msgid ""
 "We have added a new `xgboost-quickstart` example alongside a new "
@@ -22047,14 +22166,14 @@ msgstr ""
 "我们添加了一个新的 \"xgboost-quickstart \"示例和一个新的 \"xgboost-comprehensive "
 "\"示例，后者更加深入。"
 
-#: ../../source/ref-changelog.md:691
+#: ../../source/ref-changelog.md:713
 #, fuzzy
 msgid ""
 "**Add Vertical FL example** "
 "([#2598](https://github.com/adap/flower/pull/2598))"
 msgstr "**新的 iOS CoreML 代码示例**（[#1289](https://github.com/adap/flower/pull/1289)）"
 
-#: ../../source/ref-changelog.md:693
+#: ../../source/ref-changelog.md:715
 #, fuzzy
 msgid ""
 "We had many questions about Vertical Federated Learning using Flower, so "
@@ -22066,13 +22185,13 @@ msgstr ""
 "数据集](https://www.kaggle.com/competitions/titanic/data) 上添加一个简单的示例，并附上教程（在"
 " README 中）。"
 
-#: ../../source/ref-changelog.md:695
+#: ../../source/ref-changelog.md:717
 msgid ""
 "**Support custom** `ClientManager` **in** `start_driver()` "
 "([#2292](https://github.com/adap/flower/pull/2292))"
 msgstr "**在***`start_driver()`中支持自定义***`ClientManager([#2292](https://github.com/adap/flower/pull/2292))"
 
-#: ../../source/ref-changelog.md:697
+#: ../../source/ref-changelog.md:719
 msgid ""
 "**Update REST API to support create and delete nodes** "
 "([#2283](https://github.com/adap/flower/pull/2283))"
@@ -22080,7 +22199,7 @@ msgstr ""
 "**更新 REST API 以支持创建和删除节点** "
 "([#2283](https://github.com/adap/flower/pull/2283))"
 
-#: ../../source/ref-changelog.md:699
+#: ../../source/ref-changelog.md:721
 #, fuzzy
 msgid ""
 "**Update the Android SDK** "
@@ -22089,12 +22208,12 @@ msgstr ""
 "**介绍Flower Android SDK** "
 "([#2131](https://github.com/adap/flower/pull/2131))"
 
-#: ../../source/ref-changelog.md:701
+#: ../../source/ref-changelog.md:723
 #, fuzzy
 msgid "Add gRPC request-response capability to the Android SDK."
 msgstr "为 C++ SDK 添加 gRPC 请求-响应功能。"
 
-#: ../../source/ref-changelog.md:703
+#: ../../source/ref-changelog.md:725
 #, fuzzy
 msgid ""
 "**Update the C++ SDK** "
@@ -22108,11 +22227,11 @@ msgstr ""
 "[#2523](https://github.com/adap/flower/pull/2523), "
 "[#2522](https://github.com/adap/flower/pull/2522))"
 
-#: ../../source/ref-changelog.md:705
+#: ../../source/ref-changelog.md:727
 msgid "Add gRPC request-response capability to the C++ SDK."
 msgstr "为 C++ SDK 添加 gRPC 请求-响应功能。"
 
-#: ../../source/ref-changelog.md:707
+#: ../../source/ref-changelog.md:729
 #, fuzzy
 msgid ""
 "**Make HTTPS the new default** "
@@ -22122,7 +22241,7 @@ msgstr ""
 "Baselines文档（[#2290](https://github.com/adap/flower/pull/2290), "
 "[#2400](https://github.com/adap/flower/pull/2400)"
 
-#: ../../source/ref-changelog.md:709
+#: ../../source/ref-changelog.md:731
 #, fuzzy
 msgid ""
 "Flower is moving to HTTPS by default. The new `flower-server` requires "
@@ -22136,7 +22255,7 @@ msgstr ""
 "HTTP 进行原型开发。这同样适用于 `flower-client`，它可以使用用户提供的凭证或 gRPC 绑定证书连接到支持 HTTPS "
 "的服务器，也可以通过传递 `--insecure`来启用不安全的 HTTP 连接。"
 
-#: ../../source/ref-changelog.md:711
+#: ../../source/ref-changelog.md:733
 #, fuzzy
 msgid ""
 "For backward compatibility, `start_client()` and `start_numpy_client()` "
@@ -22146,7 +22265,7 @@ msgstr ""
 "为了向后兼容，`start_client()` 和 `start_numpy_client()` "
 "默认仍以不安全模式启动。在未来的版本中，不安全连接将需要用户通过传递 `insecure=True` 进行选择。"
 
-#: ../../source/ref-changelog.md:713
+#: ../../source/ref-changelog.md:735
 msgid ""
 "**Unify client API** ([#2303](https://github.com/adap/flower/pull/2303), "
 "[#2390](https://github.com/adap/flower/pull/2390), "
@@ -22156,7 +22275,7 @@ msgstr ""
 "[#2390](https://github.com/adap/flower/pull/2390), "
 "[#2493](https://github.com/adap/flower/pull/2493))"
 
-#: ../../source/ref-changelog.md:715
+#: ../../source/ref-changelog.md:737
 #, fuzzy
 msgid ""
 "Using the `client_fn`, Flower clients can interchangeably run as "
@@ -22168,7 +22287,7 @@ msgstr ""
 "使用 `client_fn`，Flower 客户端可以作为独立进程（即通过 `start_client`）或在模拟中（即通过 "
 "`start_simulation`）交替运行，而无需更改客户端类的定义和实例化方式。调用 `start_numpy_client` 现已过时。"
 
-#: ../../source/ref-changelog.md:717
+#: ../../source/ref-changelog.md:739
 msgid ""
 "**Add new** `Bulyan` **strategy** "
 "([#1817](https://github.com/adap/flower/pull/1817), "
@@ -22178,20 +22297,20 @@ msgstr ""
 "\"**策略**（[#1817](https://github.com/adap/flower/pull/1817), "
 "[#1891](https://github.com/adap/flower/pull/1891)"
 
-#: ../../source/ref-changelog.md:719
+#: ../../source/ref-changelog.md:741
 msgid ""
 "The new `Bulyan` strategy implements Bulyan by [El Mhamdi et al., "
 "2018](https://arxiv.org/abs/1802.07927)"
 msgstr "新的 \"Bulyan\"策略通过[El Mhamdi 等人，2018]（https://arxiv.org/abs/1802.07927）实现"
 
-#: ../../source/ref-changelog.md:721
+#: ../../source/ref-changelog.md:743
 #, fuzzy
 msgid ""
 "**Add new** `XGB Bagging` **strategy** "
 "([#2611](https://github.com/adap/flower/pull/2611))"
 msgstr "**添加新的`FedProx`策略** （[#1619](https://github.com/adap/flower/pull/1619)）"
 
-#: ../../source/ref-changelog.md:723 ../../source/ref-changelog.md:725
+#: ../../source/ref-changelog.md:745 ../../source/ref-changelog.md:747
 #, fuzzy
 msgid ""
 "**Introduce `WorkloadState`** "
@@ -22201,7 +22320,7 @@ msgstr ""
 "**新的内置策略**（[#828](https://github.com/adap/flower/pull/828) "
 "[#822](https://github.com/adap/flower/pull/822)"
 
-#: ../../source/ref-changelog.md:729
+#: ../../source/ref-changelog.md:751
 msgid ""
 "FedProx ([#2210](https://github.com/adap/flower/pull/2210), "
 "[#2286](https://github.com/adap/flower/pull/2286), "
@@ -22211,7 +22330,7 @@ msgstr ""
 "[#2286](https://github.com/adap/flower/pull/2286), "
 "[#2509](https://github.com/adap/flower/pull/2509))"
 
-#: ../../source/ref-changelog.md:731
+#: ../../source/ref-changelog.md:753
 msgid ""
 "Baselines Docs ([#2290](https://github.com/adap/flower/pull/2290), "
 "[#2400](https://github.com/adap/flower/pull/2400))"
@@ -22219,7 +22338,7 @@ msgstr ""
 "Baselines文档（[#2290](https://github.com/adap/flower/pull/2290), "
 "[#2400](https://github.com/adap/flower/pull/2400)"
 
-#: ../../source/ref-changelog.md:733
+#: ../../source/ref-changelog.md:755
 msgid ""
 "FedMLB ([#2340](https://github.com/adap/flower/pull/2340), "
 "[#2507](https://github.com/adap/flower/pull/2507))"
@@ -22227,7 +22346,7 @@ msgstr ""
 "FedMLB ([#2340](https://github.com/adap/flower/pull/2340), "
 "[#2507](https://github.com/adap/flower/pull/2507))"
 
-#: ../../source/ref-changelog.md:735
+#: ../../source/ref-changelog.md:757
 msgid ""
 "TAMUNA ([#2254](https://github.com/adap/flower/pull/2254), "
 "[#2508](https://github.com/adap/flower/pull/2508))"
@@ -22235,35 +22354,35 @@ msgstr ""
 "TAMUNA ([#2254](https://github.com/adap/flower/pull/2254), "
 "[#2508](https://github.com/adap/flower/pull/2508))"
 
-#: ../../source/ref-changelog.md:737
+#: ../../source/ref-changelog.md:759
 msgid "FedMeta [#2438](https://github.com/adap/flower/pull/2438)"
 msgstr "FedMeta [#2438](https://github.com/adap/flower/pull/2438)"
 
-#: ../../source/ref-changelog.md:739
+#: ../../source/ref-changelog.md:761
 msgid "FjORD [#2431](https://github.com/adap/flower/pull/2431)"
 msgstr "FjORD [#2431](https://github.com/adap/flower/pull/2431)"
 
-#: ../../source/ref-changelog.md:741
+#: ../../source/ref-changelog.md:763
 msgid "MOON [#2421](https://github.com/adap/flower/pull/2421)"
 msgstr "MOON [#2421](https://github.com/adap/flower/pull/2421)"
 
-#: ../../source/ref-changelog.md:743
+#: ../../source/ref-changelog.md:765
 msgid "DepthFL [#2295](https://github.com/adap/flower/pull/2295)"
 msgstr "DepthFL [#2295](https://github.com/adap/flower/pull/2295)"
 
-#: ../../source/ref-changelog.md:745
+#: ../../source/ref-changelog.md:767
 msgid "FedPer [#2266](https://github.com/adap/flower/pull/2266)"
 msgstr "FedPer [#2266](https://github.com/adap/flower/pull/2266)"
 
-#: ../../source/ref-changelog.md:747
+#: ../../source/ref-changelog.md:769
 msgid "FedWav2vec [#2551](https://github.com/adap/flower/pull/2551)"
 msgstr "FedWav2vec [#2551](https://github.com/adap/flower/pull/2551)"
 
-#: ../../source/ref-changelog.md:749
+#: ../../source/ref-changelog.md:771
 msgid "niid-Bench [#2428](https://github.com/adap/flower/pull/2428)"
 msgstr "niid-Bench [#2428](https://github.com/adap/flower/pull/2428)"
 
-#: ../../source/ref-changelog.md:751
+#: ../../source/ref-changelog.md:773
 msgid ""
 "FedBN ([#2608](https://github.com/adap/flower/pull/2608), "
 "[#2615](https://github.com/adap/flower/pull/2615))"
@@ -22271,7 +22390,7 @@ msgstr ""
 "FedBN ([#2608](https://github.com/adap/flower/pull/2608), "
 "[#2615](https://github.com/adap/flower/pull/2615))"
 
-#: ../../source/ref-changelog.md:753
+#: ../../source/ref-changelog.md:775
 #, fuzzy
 msgid ""
 "**General updates to Flower Examples** "
@@ -22286,7 +22405,7 @@ msgstr ""
 "[#2523](https://github.com/adap/flower/pull/2523), "
 "[#2522](https://github.com/adap/flower/pull/2522))"
 
-#: ../../source/ref-changelog.md:755
+#: ../../source/ref-changelog.md:777
 #, fuzzy
 msgid ""
 "**General updates to Flower Baselines** "
@@ -22314,7 +22433,7 @@ msgstr ""
 "[#2446](https://github.com/adap/flower/pull/2446) "
 "[#2561](https://github.com/adap/flower/pull/2561))"
 
-#: ../../source/ref-changelog.md:757
+#: ../../source/ref-changelog.md:779
 #, fuzzy
 msgid ""
 "**General updates to the simulation engine** "
@@ -22327,7 +22446,7 @@ msgstr ""
 "[#2447](https://github.com/adap/flower/pull/2447), "
 "[#2448](https://github.com/adap/flower/pull/2448))"
 
-#: ../../source/ref-changelog.md:759
+#: ../../source/ref-changelog.md:781
 #, fuzzy
 msgid ""
 "**General updates to Flower SDKs** "
@@ -22346,7 +22465,7 @@ msgstr ""
 "[#1474](https://github.com/adap/flower/pull/1474), "
 "[#1475](https://github.com/adap/flower/pull/1475)))"
 
-#: ../../source/ref-changelog.md:761
+#: ../../source/ref-changelog.md:783
 #, fuzzy
 msgid ""
 "**General improvements** "
@@ -22406,13 +22525,13 @@ msgstr ""
 "[#2553](https://github.com/adap/flower/pull/2553), "
 "[#2596](https://github.com/adap/flower/pull/2596))"
 
-#: ../../source/ref-changelog.md:763 ../../source/ref-changelog.md:853
-#: ../../source/ref-changelog.md:917 ../../source/ref-changelog.md:971
-#: ../../source/ref-changelog.md:1038
+#: ../../source/ref-changelog.md:785 ../../source/ref-changelog.md:875
+#: ../../source/ref-changelog.md:939 ../../source/ref-changelog.md:993
+#: ../../source/ref-changelog.md:1060
 msgid "Flower received many improvements under the hood, too many to list here."
 msgstr "Flower 进行了许多改进，这里就不一一列举了。"
 
-#: ../../source/ref-changelog.md:767
+#: ../../source/ref-changelog.md:789
 msgid ""
 "**Remove support for Python 3.7** "
 "([#2280](https://github.com/adap/flower/pull/2280), "
@@ -22430,13 +22549,13 @@ msgstr ""
 "[#2355](https://github.com/adap/flower/pull/2355), "
 "[#2356](https://github.com/adap/flower/pull/2356))"
 
-#: ../../source/ref-changelog.md:769
+#: ../../source/ref-changelog.md:791
 msgid ""
 "Python 3.7 support was deprecated in Flower 1.5, and this release removes"
 " support. Flower now requires Python 3.8."
 msgstr "在 Flower 1.5 中，Python 3.7 支持已被弃用，本版本将删除该支持。Flower 现在需要 Python 3.8。"
 
-#: ../../source/ref-changelog.md:771
+#: ../../source/ref-changelog.md:793
 msgid ""
 "**Remove experimental argument** `rest` **from** `start_client` "
 "([#2324](https://github.com/adap/flower/pull/2324))"
@@ -22444,7 +22563,7 @@ msgstr ""
 "**从** `start_client` 中移除** `rest` **实验参数 "
 "([#2324](https://github.com/adap/flower/pull/2324))"
 
-#: ../../source/ref-changelog.md:773
+#: ../../source/ref-changelog.md:795
 msgid ""
 "The (still experimental) argument `rest` was removed from `start_client` "
 "and `start_numpy_client`. Use `transport=\"rest\"` to opt into the "
@@ -22453,11 +22572,11 @@ msgstr ""
 "删除了 `start_client` 和 `start_numpy_client` 中的参数 `rest`（仍属试验性质）。请使用 "
 "`transport=\"rest\"` 来选择使用试验性 REST API。"
 
-#: ../../source/ref-changelog.md:775
+#: ../../source/ref-changelog.md:797
 msgid "v1.5.0 (2023-08-31)"
 msgstr "v1.5.0 (2023-08-31)"
 
-#: ../../source/ref-changelog.md:781
+#: ../../source/ref-changelog.md:803
 msgid ""
 "`Adam Narozniak`, `Anass Anhari`, `Charles Beauville`, `Dana-Farber`, "
 "`Daniel J. Beutel`, `Daniel Nata Nugraha`, `Edoardo Gabrielli`, `Gustavo "
@@ -22471,7 +22590,7 @@ msgstr ""
 "Topal`, `achiverram28`, `danielnugraha`, `eunchung`, `ruthgal` <!---"
 "TOKEN_v1.5.0-->"
 
-#: ../../source/ref-changelog.md:785
+#: ../../source/ref-changelog.md:807
 msgid ""
 "**Introduce new simulation engine** "
 "([#1969](https://github.com/adap/flower/pull/1969), "
@@ -22482,7 +22601,7 @@ msgstr ""
 "[#2221](https://github.com/adap/flower/pull/2221), "
 "[#2248](https://github.com/adap/flower/pull/2248))"
 
-#: ../../source/ref-changelog.md:787
+#: ../../source/ref-changelog.md:809
 msgid ""
 "The new simulation engine has been rewritten from the ground up, yet it "
 "remains fully backwards compatible. It offers much improved stability and"
@@ -22493,7 +22612,7 @@ msgstr ""
 "新的模拟引擎从头开始重新编写，但仍完全向后兼容。它的稳定性和内存处理能力大大提高，尤其是在使用 GPU 时。仿真可透明地适应不同的设置，以在仅 "
 "CPU、CPU+GPU、多 GPU 或多节点多 GPU 环境中扩展模拟。"
 
-#: ../../source/ref-changelog.md:789
+#: ../../source/ref-changelog.md:811
 msgid ""
 "Comprehensive documentation includes a new [how-to run "
 "simulations](https://flower.ai/docs/framework/how-to-run-"
@@ -22510,7 +22629,7 @@ msgstr ""
 "tensorflow.html) notebooks, and a new [YouTube tutorial "
 "series](https://www.youtube.com/watch?v=cRebUIGB5RU&list=PLNG4feLHqCWlnj8a_E1A_n5zr2-8pafTB)。"
 
-#: ../../source/ref-changelog.md:791
+#: ../../source/ref-changelog.md:813
 msgid ""
 "**Restructure Flower Docs** "
 "([#1824](https://github.com/adap/flower/pull/1824), "
@@ -22569,7 +22688,7 @@ msgstr ""
 "[#2243](https://github.com/adap/flower/pull/2243), "
 "[#2227](https://github.com/adap/flower/pull/2227))"
 
-#: ../../source/ref-changelog.md:793
+#: ../../source/ref-changelog.md:815
 #, fuzzy
 msgid ""
 "Much effort went into a completely restructured Flower docs experience. "
@@ -22580,7 +22699,7 @@ msgstr ""
 "Flower 文档体验的全面重构耗费了大量精力。现在，[flower.ai/docs](flower.ai/docs)上的文档分为 Flower "
 "Framework、Flower Baselines、Flower Android SDK、Flower iOS SDK 和代码示例项目。"
 
-#: ../../source/ref-changelog.md:795
+#: ../../source/ref-changelog.md:817
 msgid ""
 "**Introduce Flower Swift SDK** "
 "([#1858](https://github.com/adap/flower/pull/1858), "
@@ -22590,7 +22709,7 @@ msgstr ""
 "([#1858](https://github.com/adap/flower/pull/1858), "
 "[#1897](https://github.com/adap/flower/pull/1897))"
 
-#: ../../source/ref-changelog.md:797
+#: ../../source/ref-changelog.md:819
 msgid ""
 "This is the first preview release of the Flower Swift SDK. Flower support"
 " on iOS is improving, and alongside the Swift SDK and code example, there"
@@ -22599,7 +22718,7 @@ msgstr ""
 "这是 Flower Swift SDK 的首个预览版。Flower 对 iOS 的支持正在不断改进，除了 Swift SDK "
 "和代码示例外，现在还有 iOS 快速入门教程。"
 
-#: ../../source/ref-changelog.md:799
+#: ../../source/ref-changelog.md:821
 msgid ""
 "**Introduce Flower Android SDK** "
 "([#2131](https://github.com/adap/flower/pull/2131))"
@@ -22607,7 +22726,7 @@ msgstr ""
 "**介绍Flower Android SDK** "
 "([#2131](https://github.com/adap/flower/pull/2131))"
 
-#: ../../source/ref-changelog.md:801
+#: ../../source/ref-changelog.md:823
 msgid ""
 "This is the first preview release of the Flower Kotlin SDK. Flower "
 "support on Android is improving, and alongside the Kotlin SDK and code "
@@ -22616,7 +22735,7 @@ msgstr ""
 "这是 Flower Kotlin SDK 的首个预览版。Flower 对 Android 的支持正在不断改进，除了 Kotlin SDK "
 "和代码示例，现在还有 Android 快速入门教程。"
 
-#: ../../source/ref-changelog.md:803
+#: ../../source/ref-changelog.md:825
 msgid ""
 "**Introduce new end-to-end testing infrastructure** "
 "([#1842](https://github.com/adap/flower/pull/1842), "
@@ -22655,23 +22774,23 @@ msgstr ""
 "[#2137](https://github.com/adap/flower/pull/2137), "
 "[#2165](https://github.com/adap/flower/pull/2165))"
 
-#: ../../source/ref-changelog.md:805
+#: ../../source/ref-changelog.md:827
 msgid ""
 "A new testing infrastructure ensures that new changes stay compatible "
 "with existing framework integrations or strategies."
 msgstr "新的测试设施可确保新的变更与现有的框架集成或策略保持兼容。"
 
-#: ../../source/ref-changelog.md:807
+#: ../../source/ref-changelog.md:829
 msgid "**Deprecate Python 3.7**"
 msgstr "** 过时的 Python 3.7**"
 
-#: ../../source/ref-changelog.md:809
+#: ../../source/ref-changelog.md:831
 msgid ""
 "Since Python 3.7 reached its end of life (EOL) on 2023-06-27, support for"
 " Python 3.7 is now deprecated and will be removed in an upcoming release."
 msgstr "由于 Python 3.7 已于 2023-06-27 弃用 (EOL)，对 Python 3.7 的支持现已废弃，并将在即将发布的版本中移除。"
 
-#: ../../source/ref-changelog.md:811
+#: ../../source/ref-changelog.md:833
 msgid ""
 "**Add new** `FedTrimmedAvg` **strategy** "
 "([#1769](https://github.com/adap/flower/pull/1769), "
@@ -22680,7 +22799,7 @@ msgstr ""
 "**添加新的**`FedTrimmedAvg`**策略**（[#1769](https://github.com/adap/flower/pull/1769),"
 " [#1853](https://github.com/adap/flower/pull/1853)"
 
-#: ../../source/ref-changelog.md:813
+#: ../../source/ref-changelog.md:835
 msgid ""
 "The new `FedTrimmedAvg` strategy implements Trimmed Mean by [Dong Yin, "
 "2018](https://arxiv.org/abs/1803.01498)."
@@ -22688,13 +22807,13 @@ msgstr ""
 "新的 \"FedTrimmedAvg \"策略实现了[Dong Yin, "
 "2018]（https://arxiv.org/abs/1803.01498）的 \"Trimmed Mean\"。"
 
-#: ../../source/ref-changelog.md:815
+#: ../../source/ref-changelog.md:837
 msgid ""
 "**Introduce start_driver** "
 "([#1697](https://github.com/adap/flower/pull/1697))"
 msgstr "**引入 start_driver**（[#1697](https://github.com/adap/flower/pull/1697)）"
 
-#: ../../source/ref-changelog.md:817
+#: ../../source/ref-changelog.md:839
 msgid ""
 "In addition to `start_server` and using the raw Driver API, there is a "
 "new `start_driver` function that allows for running `start_server` "
@@ -22706,7 +22825,7 @@ msgstr ""
 "`start_server` 脚本作为 Flower 驱动程序运行。请查看 `mt-pytorch` 代码示例，了解使用 "
 "`start_driver` 的工作示例。"
 
-#: ../../source/ref-changelog.md:819
+#: ../../source/ref-changelog.md:841
 msgid ""
 "**Add parameter aggregation to** `mt-pytorch` **code example** "
 "([#1785](https://github.com/adap/flower/pull/1785))"
@@ -22714,7 +22833,7 @@ msgstr ""
 "为 `mt-pytorch` **代码示例**添加参数聚合 "
 "([#1785](https://github.com/adap/flower/pull/1785))"
 
-#: ../../source/ref-changelog.md:821
+#: ../../source/ref-changelog.md:843
 msgid ""
 "The `mt-pytorch` example shows how to aggregate parameters when writing a"
 " driver script. The included `driver.py` and `server.py` have been "
@@ -22724,7 +22843,7 @@ msgstr ""
 "`mt-pytorch`示例展示了如何在编写驱动程序脚本时聚合参数。附带的 `driver.py` 和 `server.py` "
 "已经进行了调整，以演示构建服务器端逻辑的低级方法和高级方法。"
 
-#: ../../source/ref-changelog.md:823
+#: ../../source/ref-changelog.md:845
 msgid ""
 "**Migrate experimental REST API to Starlette** "
 "([2171](https://github.com/adap/flower/pull/2171))"
@@ -22732,7 +22851,7 @@ msgstr ""
 "**将实验性 REST API 移植到 Starlette** "
 "([2171](https://github.com/adap/flower/pull/2171))"
 
-#: ../../source/ref-changelog.md:825
+#: ../../source/ref-changelog.md:847
 msgid ""
 "The (experimental) REST API used to be implemented in "
 "[FastAPI](https://fastapi.tiangolo.com/), but it has now been migrated to"
@@ -22741,13 +22860,13 @@ msgstr ""
 "REST API（试验性）曾在 [FastAPI](https://fastapi.tiangolo.com/) 中实现，但现在已迁移到直接使用 "
 "[Starlette](https://www.starlette.io/) 。"
 
-#: ../../source/ref-changelog.md:827
+#: ../../source/ref-changelog.md:849
 msgid ""
 "Please note: The REST request-response API is still experimental and will"
 " likely change significantly over time."
 msgstr "请注意：REST 请求-响应 API 仍处于试验阶段，随着时间的推移可能会发生重大变化。"
 
-#: ../../source/ref-changelog.md:829
+#: ../../source/ref-changelog.md:851
 msgid ""
 "**Introduce experimental gRPC request-response API** "
 "([#1867](https://github.com/adap/flower/pull/1867), "
@@ -22757,7 +22876,7 @@ msgstr ""
 "（[#1867](https://github.com/adap/flower/pull/1867), "
 "[#1901](https://github.com/adap/flower/pull/1901)"
 
-#: ../../source/ref-changelog.md:831
+#: ../../source/ref-changelog.md:853
 msgid ""
 "In addition to the existing gRPC API (based on bidirectional streaming) "
 "and the experimental REST API, there is now a new gRPC API that uses a "
@@ -22766,13 +22885,13 @@ msgstr ""
 "除了现有的 gRPC 应用程序接口（基于双向流）和试验性 REST 应用程序接口外，现在还有一个新的 gRPC "
 "应用程序接口，它使用请求-响应模型与客户端节点通信。"
 
-#: ../../source/ref-changelog.md:833
+#: ../../source/ref-changelog.md:855
 msgid ""
 "Please note: The gRPC request-response API is still experimental and will"
 " likely change significantly over time."
 msgstr "请注意：gRPC 请求-响应 API 仍处于试验阶段，随着时间的推移可能会发生重大变化。"
 
-#: ../../source/ref-changelog.md:835
+#: ../../source/ref-changelog.md:857
 msgid ""
 "**Replace the experimental** `start_client(rest=True)` **with the new** "
 "`start_client(transport=\"rest\")` "
@@ -22782,7 +22901,7 @@ msgstr ""
 "`start_client(rest=True)` "
 "([#1880](https://github.com/adap/flower/pull/1880))"
 
-#: ../../source/ref-changelog.md:837
+#: ../../source/ref-changelog.md:859
 msgid ""
 "The (experimental) `start_client` argument `rest` was deprecated in "
 "favour of a new argument `transport`. `start_client(transport=\"rest\")` "
@@ -22793,13 +22912,13 @@ msgstr ""
 "已废弃（试验性的）`start_client`参数`rest`，改用新参数`transport`。`start_client(transport=\"rest\")`将产生与以前的`start_client(rest=True)`相同的行为。所有代码都应迁移到新参数"
 " `transport`。过时的参数 `rest` 将在今后的版本中删除。"
 
-#: ../../source/ref-changelog.md:839
+#: ../../source/ref-changelog.md:861
 msgid ""
 "**Add a new gRPC option** "
 "([#2197](https://github.com/adap/flower/pull/2197))"
 msgstr "** 添加一个新的 gRPC 选项**（[#2197](https://github.com/adap/flower/pull/2197)）"
 
-#: ../../source/ref-changelog.md:841
+#: ../../source/ref-changelog.md:863
 msgid ""
 "We now start a gRPC server with the `grpc.keepalive_permit_without_calls`"
 " option set to 0 by default. This prevents the clients from sending "
@@ -22808,17 +22927,17 @@ msgstr ""
 "现在我们启动一个 gRPC 服务器，并将 `grpc.keepalive_permit_without_calls` 选项默认设置为 "
 "0。这将防止客户端在没有未处理数据流时发送 keepalive pings。"
 
-#: ../../source/ref-changelog.md:843
+#: ../../source/ref-changelog.md:865
 msgid ""
 "**Improve example notebooks** "
 "([#2005](https://github.com/adap/flower/pull/2005))"
 msgstr "**改进示例笔记** ([#2005](https://github.com/adap/flower/pull/2005))"
 
-#: ../../source/ref-changelog.md:845
+#: ../../source/ref-changelog.md:867
 msgid "There's a new 30min Federated Learning PyTorch tutorial!"
 msgstr "有一个新的 30 分钟的联邦学习 PyTorch 教程！"
 
-#: ../../source/ref-changelog.md:847
+#: ../../source/ref-changelog.md:869
 msgid ""
 "**Example updates** ([#1772](https://github.com/adap/flower/pull/1772), "
 "[#1873](https://github.com/adap/flower/pull/1873), "
@@ -22844,7 +22963,7 @@ msgstr ""
 "[#2225](https://github.com/adap/flower/pull/2225), "
 "[#2183](https://github.com/adap/flower/pull/2183))"
 
-#: ../../source/ref-changelog.md:849
+#: ../../source/ref-changelog.md:871
 msgid ""
 "Many examples have received significant updates, including simplified "
 "advanced-tensorflow and advanced-pytorch examples, improved macOS "
@@ -22856,7 +22975,7 @@ msgstr ""
 "TensorFlow 示例的 macOS 兼容性，以及模拟代码示例。一项重大升级是所有代码示例现在都有了 "
 "\"requirements.txt\"（除 \"pyproject.toml \"外）。"
 
-#: ../../source/ref-changelog.md:851
+#: ../../source/ref-changelog.md:873
 msgid ""
 "**General improvements** "
 "([#1872](https://github.com/adap/flower/pull/1872), "
@@ -22873,11 +22992,11 @@ msgstr ""
 "[#1477](https://github.com/adap/flower/pull/1477), "
 "[#2171](https://github.com/adap/flower/pull/2171))"
 
-#: ../../source/ref-changelog.md:859
+#: ../../source/ref-changelog.md:881
 msgid "v1.4.0 (2023-04-21)"
 msgstr "v1.4.0 (2023-04-21)"
 
-#: ../../source/ref-changelog.md:865
+#: ../../source/ref-changelog.md:887
 msgid ""
 "`Adam Narozniak`, `Alexander Viala Bellander`, `Charles Beauville`, "
 "`Chenyang Ma (Danny)`, `Daniel J. Beutel`, `Edoardo`, `Gautam Jajoo`, "
@@ -22893,7 +23012,7 @@ msgstr ""
 "Lane`, `Nikolaos Episkopos`, `Ragy`, `Saurav Maheshkar`, `Semo Yang`, "
 "`Steve Laskaridis`, `Steven Hé (Sīchàng)`, `Taner Topal`"
 
-#: ../../source/ref-changelog.md:869
+#: ../../source/ref-changelog.md:891
 msgid ""
 "**Introduce support for XGBoost (**`FedXgbNnAvg` **strategy and "
 "example)** ([#1694](https://github.com/adap/flower/pull/1694), "
@@ -22911,7 +23030,7 @@ msgstr ""
 "[#1763](https://github.com/adap/flower/pull/1763), "
 "[#1795](https://github.com/adap/flower/pull/1795))"
 
-#: ../../source/ref-changelog.md:871
+#: ../../source/ref-changelog.md:893
 msgid ""
 "XGBoost is a tree-based ensemble machine learning algorithm that uses "
 "gradient boosting to improve model accuracy. We added a new `FedXgbNnAvg`"
@@ -22925,7 +23044,7 @@ msgstr ""
 "\"FedXgbNnAvg\"[策略](https://github.com/adap/flower/tree/main/src/py/flwr/server/strategy/fedxgb_nn_avg.py)和一个[代码示例](https://github.com/adap/flower/tree/main/examples"
 "/xgboost-quickstart)，演示如何在 XGBoost 项目中使用这个新策略。"
 
-#: ../../source/ref-changelog.md:873
+#: ../../source/ref-changelog.md:895
 msgid ""
 "**Introduce iOS SDK (preview)** "
 "([#1621](https://github.com/adap/flower/pull/1621), "
@@ -22934,7 +23053,7 @@ msgstr ""
 "**介绍 iOS SDK（预览版）** ([#1621](https://github.com/adap/flower/pull/1621), "
 "[#1764](https://github.com/adap/flower/pull/1764))"
 
-#: ../../source/ref-changelog.md:875
+#: ../../source/ref-changelog.md:897
 msgid ""
 "This is a major update for anyone wanting to implement Federated Learning"
 " on iOS mobile devices. We now have a swift iOS SDK present under "
@@ -22949,7 +23068,7 @@ msgstr ""
 " 下提供了一个迅捷的 iOS SDK，这将大大方便应用程序的创建过程。为了展示其使用情况，我们还更新了 [iOS "
 "示例](https://github.com/adap/flower/tree/main/examples/ios)！"
 
-#: ../../source/ref-changelog.md:877
+#: ../../source/ref-changelog.md:899
 msgid ""
 "**Introduce new \"What is Federated Learning?\" tutorial** "
 "([#1657](https://github.com/adap/flower/pull/1657), "
@@ -22959,7 +23078,7 @@ msgstr ""
 "\"什么是联邦学习？\"教程**（[#1657](https://github.com/adap/flower/pull/1657), "
 "[#1721](https://github.com/adap/flower/pull/1721)"
 
-#: ../../source/ref-changelog.md:879
+#: ../../source/ref-changelog.md:901
 msgid ""
 "A new [entry-level tutorial](https://flower.ai/docs/framework/tutorial-"
 "what-is-federated-learning.html) in our documentation explains the basics"
@@ -22971,7 +23090,7 @@ msgstr ""
 "federated-learning.html)，解释了联邦学习的基础知识。它让任何不熟悉联邦学习的人都能开始 Flower "
 "之旅。请转发给对联邦学习感兴趣的人！"
 
-#: ../../source/ref-changelog.md:881
+#: ../../source/ref-changelog.md:903
 msgid ""
 "**Introduce new Flower Baseline: FedProx MNIST** "
 "([#1513](https://github.com/adap/flower/pull/1513), "
@@ -22985,7 +23104,7 @@ msgstr ""
 "[#1681](https://github.com/adap/flower/pull/1681), "
 "[#1679](https://github.com/adap/flower/pull/1679)"
 
-#: ../../source/ref-changelog.md:883
+#: ../../source/ref-changelog.md:905
 msgid ""
 "This new baseline replicates the MNIST+CNN task from the paper [Federated"
 " Optimization in Heterogeneous Networks (Li et al., "
@@ -22996,7 +23115,7 @@ msgstr ""
 "al., 2018)](https://arxiv.org/abs/1812.06127)中的 MNIST+CNN 任务。它使用 "
 "\"FedProx \"策略，旨在使收敛在异构环境中更加稳健。"
 
-#: ../../source/ref-changelog.md:885
+#: ../../source/ref-changelog.md:907
 msgid ""
 "**Introduce new Flower Baseline: FedAvg FEMNIST** "
 "([#1655](https://github.com/adap/flower/pull/1655))"
@@ -23004,7 +23123,7 @@ msgstr ""
 "**引入新的 Flower Baseline： FedAvg FEMNIST** "
 "([#1655](https://github.com/adap/flower/pull/1655))"
 
-#: ../../source/ref-changelog.md:887
+#: ../../source/ref-changelog.md:909
 msgid ""
 "This new baseline replicates an experiment evaluating the performance of "
 "the FedAvg algorithm on the FEMNIST dataset from the paper [LEAF: A "
@@ -23014,7 +23133,7 @@ msgstr ""
 "这一新Baseline复现了论文[LEAF: A Benchmark for Federated Settings（Caldas 等人，2018 "
 "年）](https://arxiv.org/abs/1812.01097)中评估 FedAvg 算法在 FEMNIST 数据集上性能的实验。"
 
-#: ../../source/ref-changelog.md:889
+#: ../../source/ref-changelog.md:911
 msgid ""
 "**Introduce (experimental) REST API** "
 "([#1594](https://github.com/adap/flower/pull/1594), "
@@ -23033,20 +23152,20 @@ msgstr ""
 "[#1770](https://github.com/adap/flower/pull/1770), "
 "[#1733](https://github.com/adap/flower/pull/1733))"
 
-#: ../../source/ref-changelog.md:891
+#: ../../source/ref-changelog.md:913
 msgid ""
 "A new REST API has been introduced as an alternative to the gRPC-based "
 "communication stack. In this initial version, the REST API only supports "
 "anonymous clients."
 msgstr "作为基于 gRPC 的通信栈的替代方案，我们引入了新的 REST API。在初始版本中，REST API 仅支持匿名客户端。"
 
-#: ../../source/ref-changelog.md:893
+#: ../../source/ref-changelog.md:915
 msgid ""
 "Please note: The REST API is still experimental and will likely change "
 "significantly over time."
 msgstr "请注意：REST API 仍处于试验阶段，随着时间的推移可能会发生重大变化。"
 
-#: ../../source/ref-changelog.md:895
+#: ../../source/ref-changelog.md:917
 msgid ""
 "**Improve the (experimental) Driver API** "
 "([#1663](https://github.com/adap/flower/pull/1663), "
@@ -23069,7 +23188,7 @@ msgstr ""
 "[#1662](https://github.com/adap/flower/pull/1662), "
 "[#1794](https://github.com/adap/flower/pull/1794))"
 
-#: ../../source/ref-changelog.md:897
+#: ../../source/ref-changelog.md:919
 msgid ""
 "The Driver API is still an experimental feature, but this release "
 "introduces some major upgrades. One of the main improvements is the "
@@ -23082,20 +23201,20 @@ msgstr ""
 "数据库，将服务器状态存储在磁盘上（而不是内存中）。另一项改进是，已交付的任务（指令或结果）现在将被删除。这大大提高了长期运行的 Flower "
 "服务器的内存效率。"
 
-#: ../../source/ref-changelog.md:899
+#: ../../source/ref-changelog.md:921
 msgid ""
 "**Fix spilling issues related to Ray during simulations** "
 "([#1698](https://github.com/adap/flower/pull/1698))"
 msgstr "**修复模拟过程中与Ray有关的溢出问题** ([#1698](https://github.com/adap/flower/pull/1698))"
 
-#: ../../source/ref-changelog.md:901
+#: ../../source/ref-changelog.md:923
 msgid ""
 "While running long simulations, `ray` was sometimes spilling huge amounts"
 " of data that would make the training unable to continue. This is now "
 "fixed! 🎉"
 msgstr "在运行长时间模拟时，`ray` 有时会溢出大量数据，导致训练无法继续。现在这个问题已经解决！🎉"
 
-#: ../../source/ref-changelog.md:903
+#: ../../source/ref-changelog.md:925
 msgid ""
 "**Add new example using** `TabNet` **and Flower** "
 "([#1725](https://github.com/adap/flower/pull/1725))"
@@ -23103,7 +23222,7 @@ msgstr ""
 "** 添加使用** `TabNet` ** 的新示例** "
 "([#1725](https://github.com/adap/flower/pull/1725))"
 
-#: ../../source/ref-changelog.md:905
+#: ../../source/ref-changelog.md:927
 msgid ""
 "TabNet is a powerful and flexible framework for training machine learning"
 " models on tabular data. We now have a federated example using Flower: "
@@ -23114,19 +23233,19 @@ msgstr ""
 "tabnet](https://github.com/adap/flower/tree/main/examples/quickstart-"
 "tabnet)。"
 
-#: ../../source/ref-changelog.md:907
+#: ../../source/ref-changelog.md:929
 msgid ""
 "**Add new how-to guide for monitoring simulations** "
 "([#1649](https://github.com/adap/flower/pull/1649))"
 msgstr "** 添加新的模拟监控指南** ([#1649](https://github.com/adap/flower/pull/1649))"
 
-#: ../../source/ref-changelog.md:909
+#: ../../source/ref-changelog.md:931
 msgid ""
 "We now have a documentation guide to help users monitor their performance"
 " during simulations."
 msgstr "我们现在有一份文档指南，可帮助用户在模拟过程中监控其性能。"
 
-#: ../../source/ref-changelog.md:911
+#: ../../source/ref-changelog.md:933
 msgid ""
 "**Add training metrics to** `History` **object during simulations** "
 "([#1696](https://github.com/adap/flower/pull/1696))"
@@ -23134,7 +23253,7 @@ msgstr ""
 "**在模拟过程中为***`历史`***对象添加训练指标*** "
 "([#1696](https://github.com/adap/flower/pull/1696))"
 
-#: ../../source/ref-changelog.md:913
+#: ../../source/ref-changelog.md:935
 msgid ""
 "The `fit_metrics_aggregation_fn` can be used to aggregate training "
 "metrics, but previous releases did not save the results in the `History` "
@@ -23143,7 +23262,7 @@ msgstr ""
 "`fit_metrics_aggregation_fn`可用于汇总训练指标，但以前的版本不会将结果保存在 \"History "
 "\"对象中。现在可以了！"
 
-#: ../../source/ref-changelog.md:915
+#: ../../source/ref-changelog.md:937
 msgid ""
 "**General improvements** "
 "([#1659](https://github.com/adap/flower/pull/1659), "
@@ -23246,11 +23365,11 @@ msgstr ""
 "[#1804](https://github.com/adap/flower/pull/1804), "
 "[#1805](https://github.com/adap/flower/pull/1805))"
 
-#: ../../source/ref-changelog.md:923
+#: ../../source/ref-changelog.md:945
 msgid "v1.3.0 (2023-02-06)"
 msgstr "v1.3.0 (2023-02-06)"
 
-#: ../../source/ref-changelog.md:929
+#: ../../source/ref-changelog.md:951
 msgid ""
 "`Adam Narozniak`, `Alexander Viala Bellander`, `Charles Beauville`, "
 "`Daniel J. Beutel`, `JDRanpariya`, `Lennart Behme`, `Taner Topal`"
@@ -23258,7 +23377,7 @@ msgstr ""
 "`Adam Narozniak`, `Alexander Viala Bellander`, `Charles Beauville`, "
 "`Daniel J. Beutel`, `JDRanpariya`, `Lennart Behme`, `Taner Topal`"
 
-#: ../../source/ref-changelog.md:933
+#: ../../source/ref-changelog.md:955
 msgid ""
 "**Add support for** `workload_id` **and** `group_id` **in Driver API** "
 "([#1595](https://github.com/adap/flower/pull/1595))"
@@ -23266,7 +23385,7 @@ msgstr ""
 "**在驱动程序应用程序接口中添加对** `workload_id` **和** `group_id` **的支持** "
 "([#1595](https://github.com/adap/flower/pull/1595))"
 
-#: ../../source/ref-changelog.md:935
+#: ../../source/ref-changelog.md:957
 msgid ""
 "The (experimental) Driver API now supports a `workload_id` that can be "
 "used to identify which workload a task belongs to. It also supports a new"
@@ -23278,7 +23397,7 @@ msgstr ""
 "`group_id`，例如，可用于指示当前的训练轮次。通过 `workload_id` 和 `group_id` "
 "客户端节点可以决定是否要处理某个任务。"
 
-#: ../../source/ref-changelog.md:937
+#: ../../source/ref-changelog.md:959
 msgid ""
 "**Make Driver API and Fleet API address configurable** "
 "([#1637](https://github.com/adap/flower/pull/1637))"
@@ -23286,7 +23405,7 @@ msgstr ""
 "**使Driver API 和Fleet "
 "API地址可配置**（[#1637](https://github.com/adap/flower/pull/1637)）"
 
-#: ../../source/ref-changelog.md:939
+#: ../../source/ref-changelog.md:961
 msgid ""
 "The (experimental) long-running Flower server (Driver API and Fleet API) "
 "can now configure the server address of both Driver API (via `--driver-"
@@ -23295,7 +23414,7 @@ msgstr ""
 "长期运行的 Flower 服务器（Driver API 和 Fleet API）现在可以在启动时配置 Driver API（通过 "
 "`--driver-api-address`）和 Fleet API（通过 `-fleet-api-address`）的服务器地址："
 
-#: ../../source/ref-changelog.md:941
+#: ../../source/ref-changelog.md:963
 #, fuzzy
 msgid ""
 "`flower-server --driver-api-address \"0.0.0.0:8081\" --fleet-api-address "
@@ -23304,11 +23423,11 @@ msgstr ""
 "`flower-server --driver-api-address \"0.0.0.0:8081\" --fleet-api-address "
 "\"0.0.0.0:8086\"`"
 
-#: ../../source/ref-changelog.md:943
+#: ../../source/ref-changelog.md:965
 msgid "Both IPv4 and IPv6 addresses are supported."
 msgstr "支持 IPv4 和 IPv6 地址。"
 
-#: ../../source/ref-changelog.md:945
+#: ../../source/ref-changelog.md:967
 msgid ""
 "**Add new example of Federated Learning using fastai and Flower** "
 "([#1598](https://github.com/adap/flower/pull/1598))"
@@ -23316,7 +23435,7 @@ msgstr ""
 "** 添加使用 fastai 和 Flower 进行联邦学习的新示例** "
 "([#1598](https://github.com/adap/flower/pull/1598))"
 
-#: ../../source/ref-changelog.md:947
+#: ../../source/ref-changelog.md:969
 msgid ""
 "A new code example (`quickstart-fastai`) demonstrates federated learning "
 "with [fastai](https://www.fast.ai/) and Flower. You can find it here: "
@@ -23328,7 +23447,7 @@ msgstr ""
 "fastai](https://github.com/adap/flower/tree/main/examples/quickstart-"
 "fastai)。"
 
-#: ../../source/ref-changelog.md:949
+#: ../../source/ref-changelog.md:971
 msgid ""
 "**Make Android example compatible with** `flwr >= 1.0.0` **and the latest"
 " versions of Android** "
@@ -23337,7 +23456,7 @@ msgstr ""
 "**使安卓示例兼容** `flwr >= 1.0.0` **和最新版本的安卓** "
 "([#1603](https://github.com/adap/flower/pull/1603))"
 
-#: ../../source/ref-changelog.md:951
+#: ../../source/ref-changelog.md:973
 msgid ""
 "The Android code example has received a substantial update: the project "
 "is compatible with Flower 1.0 (and later), the UI received a full "
@@ -23347,13 +23466,13 @@ msgstr ""
 "Android 代码示例已进行了大幅更新：项目兼容 Flower 1.0（及更高版本），用户界面已全面刷新，项目已更新为兼容较新的 Android"
 " 工具。"
 
-#: ../../source/ref-changelog.md:953
+#: ../../source/ref-changelog.md:975
 msgid ""
 "**Add new `FedProx` strategy** "
 "([#1619](https://github.com/adap/flower/pull/1619))"
 msgstr "**添加新的`FedProx`策略** （[#1619](https://github.com/adap/flower/pull/1619)）"
 
-#: ../../source/ref-changelog.md:955
+#: ../../source/ref-changelog.md:977
 msgid ""
 "This "
 "[strategy](https://github.com/adap/flower/blob/main/src/py/flwr/server/strategy/fedprox.py)"
@@ -23367,25 +23486,25 @@ msgstr ""
 "该[策略](https://github.com/adap/flower/blob/main/src/py/flwr/server/strategy/fedprox.py)与[`FedAvg`](https://github.com/adap/flower/blob/main/src/py/flwr/server/strategy/fedavg.py)几乎相同，但可以帮助用户复现本[论文](https://arxiv.org/abs/1812.06127)中的描述。它的本质是添加一个名为"
 " `proximal_mu`的参数，使局部模型与全局模型正则化。"
 
-#: ../../source/ref-changelog.md:957
+#: ../../source/ref-changelog.md:979
 msgid ""
 "**Add new metrics to telemetry events** "
 "([#1640](https://github.com/adap/flower/pull/1640))"
 msgstr "**为遥测事件添加新指标**（[#1640](https://github.com/adap/flower/pull/1640)）"
 
-#: ../../source/ref-changelog.md:959
+#: ../../source/ref-changelog.md:981
 msgid ""
 "An updated event structure allows, for example, the clustering of events "
 "within the same workload."
 msgstr "例如，更新后的事件结构可以将同一工作负载中的事件集中在一起。"
 
-#: ../../source/ref-changelog.md:961
+#: ../../source/ref-changelog.md:983
 msgid ""
 "**Add new custom strategy tutorial section** "
 "[#1623](https://github.com/adap/flower/pull/1623)"
 msgstr "**添加新的自定义策略教程部分** [#1623](https://github.com/adap/flower/pull/1623)"
 
-#: ../../source/ref-changelog.md:963
+#: ../../source/ref-changelog.md:985
 msgid ""
 "The Flower tutorial now has a new section that covers implementing a "
 "custom strategy from scratch: [Open in "
@@ -23396,13 +23515,13 @@ msgstr ""
 "中打开](https://colab.research.google.com/github/adap/flower/blob/main/doc/source"
 "/tutorial-build-a-strategy-from-scratch-pytorch.ipynb)"
 
-#: ../../source/ref-changelog.md:965
+#: ../../source/ref-changelog.md:987
 msgid ""
 "**Add new custom serialization tutorial section** "
 "([#1622](https://github.com/adap/flower/pull/1622))"
 msgstr "** 添加新的自定义序列化教程部分** ([#1622](https://github.com/adap/flower/pull/1622))"
 
-#: ../../source/ref-changelog.md:967
+#: ../../source/ref-changelog.md:989
 msgid ""
 "The Flower tutorial now has a new section that covers custom "
 "serialization: [Open in "
@@ -23413,7 +23532,7 @@ msgstr ""
 "中打开](https://colab.research.google.com/github/adap/flower/blob/main/doc/source"
 "/tutorial-customize-the-client-pytorch.ipynb)"
 
-#: ../../source/ref-changelog.md:969
+#: ../../source/ref-changelog.md:991
 msgid ""
 "**General improvements** "
 "([#1638](https://github.com/adap/flower/pull/1638), "
@@ -23484,7 +23603,7 @@ msgstr ""
 "[#1572](https://github.com/adap/flower/pull/1572), "
 "[#1586](https://github.com/adap/flower/pull/1586))"
 
-#: ../../source/ref-changelog.md:973
+#: ../../source/ref-changelog.md:995
 msgid ""
 "**Updated documentation** "
 "([#1629](https://github.com/adap/flower/pull/1629), "
@@ -23503,18 +23622,18 @@ msgstr ""
 "[#1613](https://github.com/adap/flower/pull/1613), "
 "[#1614](https://github.com/adap/flower/pull/1614)))"
 
-#: ../../source/ref-changelog.md:975 ../../source/ref-changelog.md:1042
+#: ../../source/ref-changelog.md:997 ../../source/ref-changelog.md:1064
 msgid ""
 "As usual, the documentation has improved quite a bit. It is another step "
 "in our effort to make the Flower documentation the best documentation of "
 "any project. Stay tuned and as always, feel free to provide feedback!"
 msgstr "和往常一样，我们的文档有了很大的改进。这是我们努力使 Flower 文档成为所有项目中最好文档的又一步骤。请继续关注，并随时提供反馈意见！"
 
-#: ../../source/ref-changelog.md:981
+#: ../../source/ref-changelog.md:1003
 msgid "v1.2.0 (2023-01-13)"
 msgstr "v1.2.0 (2023-01-13)"
 
-#: ../../source/ref-changelog.md:987
+#: ../../source/ref-changelog.md:1009
 msgid ""
 "`Adam Narozniak`, `Charles Beauville`, `Daniel J. Beutel`, `Edoardo`, `L."
 " Jiang`, `Ragy`, `Taner Topal`, `dannymcy`"
@@ -23522,7 +23641,7 @@ msgstr ""
 "`Adam Narozniak`, `Charles Beauville`, `Daniel J. Beutel`, `Edoardo`, `L."
 " Jiang`, `Ragy`, `Taner Topal`, `dannymcy`"
 
-#: ../../source/ref-changelog.md:991
+#: ../../source/ref-changelog.md:1013
 msgid ""
 "**Introduce new Flower Baseline: FedAvg MNIST** "
 "([#1497](https://github.com/adap/flower/pull/1497), "
@@ -23532,7 +23651,7 @@ msgstr ""
 "([#1497](https://github.com/adap/flower/pull/1497), "
 "[#1552](https://github.com/adap/flower/pull/1552))"
 
-#: ../../source/ref-changelog.md:993
+#: ../../source/ref-changelog.md:1015
 msgid ""
 "Over the coming weeks, we will be releasing a number of new reference "
 "implementations useful especially to FL newcomers. They will typically "
@@ -23547,13 +23666,13 @@ msgstr ""
 "的总体了解。今天发布的是该系列中的第一篇。[阅读全文](https://flower.ai/blog/2023-01-12-fl-starter-"
 "pack-fedavg-mnist-cnn/)"
 
-#: ../../source/ref-changelog.md:995
+#: ../../source/ref-changelog.md:1017
 msgid ""
 "**Improve GPU support in simulations** "
 "([#1555](https://github.com/adap/flower/pull/1555))"
 msgstr "**改进模拟中的 GPU 支持**（[#1555](https://github.com/adap/flower/pull/1555)）"
 
-#: ../../source/ref-changelog.md:997
+#: ../../source/ref-changelog.md:1019
 msgid ""
 "The Ray-based Virtual Client Engine (`start_simulation`) has been updated"
 " to improve GPU support. The update includes some of the hard-earned "
@@ -23563,7 +23682,7 @@ msgstr ""
 "基于 Ray 的虚拟客户端引擎 (`start_simulation`)已更新，以改进对 GPU 的支持。此次更新包含了在 GPU "
 "集群环境中扩展模拟的一些经验教训。新的默认设置使基于 GPU 的模拟运行更加稳健。"
 
-#: ../../source/ref-changelog.md:999
+#: ../../source/ref-changelog.md:1021
 msgid ""
 "**Improve GPU support in Jupyter Notebook tutorials** "
 "([#1527](https://github.com/adap/flower/pull/1527), "
@@ -23573,7 +23692,7 @@ msgstr ""
 "([#1527](https://github.com/adap/flower/pull/1527), "
 "[#1558](https://github.com/adap/flower/pull/1558))"
 
-#: ../../source/ref-changelog.md:1001
+#: ../../source/ref-changelog.md:1023
 msgid ""
 "Some users reported that Jupyter Notebooks have not always been easy to "
 "use on GPU instances. We listened and made improvements to all of our "
@@ -23582,7 +23701,7 @@ msgstr ""
 "一些用户报告说，在 GPU 实例上使用 Jupyter 笔记本并不是很方便。我们听取了他们的意见，并对所有 Jupyter "
 "笔记本进行了改进！点击这里查看更新后的笔记本："
 
-#: ../../source/ref-changelog.md:1003
+#: ../../source/ref-changelog.md:1025
 msgid ""
 "[An Introduction to Federated Learning](https://flower.ai/docs/framework"
 "/tutorial-get-started-with-flower-pytorch.html)"
@@ -23590,7 +23709,7 @@ msgstr ""
 "[联邦学习简介](https://flower.ai/docs/framework/tutorial-get-started-with-"
 "flower-pytorch.html)"
 
-#: ../../source/ref-changelog.md:1004
+#: ../../source/ref-changelog.md:1026
 msgid ""
 "[Strategies in Federated Learning](https://flower.ai/docs/framework"
 "/tutorial-use-a-federated-learning-strategy-pytorch.html)"
@@ -23598,7 +23717,7 @@ msgstr ""
 "[联邦学习策略](https://flower.ai/docs/framework/tutorial-use-a-federated-"
 "learning-strategy-pytorch.html)"
 
-#: ../../source/ref-changelog.md:1005
+#: ../../source/ref-changelog.md:1027
 msgid ""
 "[Building a Strategy](https://flower.ai/docs/framework/tutorial-build-a"
 "-strategy-from-scratch-pytorch.html)"
@@ -23606,7 +23725,7 @@ msgstr ""
 "[制定策略](https://flower.ai/docs/framework/tutorial-build-a-strategy-from-"
 "scratch-pytorch.html)"
 
-#: ../../source/ref-changelog.md:1006
+#: ../../source/ref-changelog.md:1028
 msgid ""
 "[Client and NumPyClient](https://flower.ai/docs/framework/tutorial-"
 "customize-the-client-pytorch.html)"
@@ -23614,7 +23733,7 @@ msgstr ""
 "[客户端和 NumPyClient](https://flower.ai/docs/framework/tutorial-customize-"
 "the-client-pytorch.html)"
 
-#: ../../source/ref-changelog.md:1008
+#: ../../source/ref-changelog.md:1030
 msgid ""
 "**Introduce optional telemetry** "
 "([#1533](https://github.com/adap/flower/pull/1533), "
@@ -23625,7 +23744,7 @@ msgstr ""
 "[#1544](https://github.com/adap/flower/pull/1544), "
 "[#1584](https://github.com/adap/flower/pull/1584)"
 
-#: ../../source/ref-changelog.md:1010
+#: ../../source/ref-changelog.md:1032
 msgid ""
 "After a [request for "
 "feedback](https://github.com/adap/flower/issues/1534) from the community,"
@@ -23638,7 +23757,7 @@ msgstr ""
 "开放源码项目引入了可选的*匿名*使用指标收集，以便在充分知情的情况下做出改进 Flower 的决定。这样做能让 Flower 团队了解 "
 "Flower 的使用情况以及用户可能面临的挑战。"
 
-#: ../../source/ref-changelog.md:1012
+#: ../../source/ref-changelog.md:1034
 msgid ""
 "**Flower is a friendly framework for collaborative AI and data science.**"
 " Staying true to this statement, Flower makes it easy to disable "
@@ -23648,7 +23767,7 @@ msgstr ""
 "**Flower 是一个用于协作式人工智能和数据科学的友好框架。** Flower "
 "遵循这一声明，让不想分享匿名使用指标的用户可以轻松禁用遥测技术。[阅读全文](https://flower.ai/docs/telemetry.html)。"
 
-#: ../../source/ref-changelog.md:1014
+#: ../../source/ref-changelog.md:1036
 msgid ""
 "**Introduce (experimental) Driver API** "
 "([#1520](https://github.com/adap/flower/pull/1520), "
@@ -23667,7 +23786,7 @@ msgstr ""
 "[#1551](https://github.com/adap/flower/pull/1551), "
 "[#1567](https://github.com/adap/flower/pull/1567))"
 
-#: ../../source/ref-changelog.md:1016
+#: ../../source/ref-changelog.md:1038
 msgid ""
 "Flower now has a new (experimental) Driver API which will enable fully "
 "programmable, async, and multi-tenant Federated Learning and Federated "
@@ -23679,7 +23798,7 @@ msgstr ""
 "API），它将支持完全可编程、异步和多租户的联邦学习（Federated Learning）和联邦分析（Federated "
 "Analytics）应用程序。展望未来，Driver API 将成为许多即将推出的功能的抽象基础，您现在就可以开始构建这些功能。"
 
-#: ../../source/ref-changelog.md:1018
+#: ../../source/ref-changelog.md:1040
 msgid ""
 "The Driver API also enables a new execution mode in which the server runs"
 " indefinitely. Multiple individual workloads can run concurrently and "
@@ -23689,19 +23808,19 @@ msgstr ""
 "驱动程序应用程序接口还支持一种新的执行模式，在这种模式下，服务器可无限期运行。多个单独的工作负载可以同时运行，并独立于服务器启动和停止执行。这对于希望在生产中部署"
 " Flower 的用户来说尤其有用。"
 
-#: ../../source/ref-changelog.md:1020
+#: ../../source/ref-changelog.md:1042
 msgid ""
 "To learn more, check out the `mt-pytorch` code example. We look forward "
 "to you feedback!"
 msgstr "要了解更多信息，请查看 `mt-pytorch` 代码示例。我们期待您的反馈！"
 
-#: ../../source/ref-changelog.md:1022
+#: ../../source/ref-changelog.md:1044
 msgid ""
 "Please note: *The Driver API is still experimental and will likely change"
 " significantly over time.*"
 msgstr "请注意：Driver API仍处于试验阶段，随着时间的推移可能会发生重大变化。*"
 
-#: ../../source/ref-changelog.md:1024
+#: ../../source/ref-changelog.md:1046
 msgid ""
 "**Add new Federated Analytics with Pandas example** "
 "([#1469](https://github.com/adap/flower/pull/1469), "
@@ -23711,7 +23830,7 @@ msgstr ""
 "的联邦分析示例**（[#1469](https://github.com/adap/flower/pull/1469), "
 "[#1535](https://github.com/adap/flower/pull/1535)"
 
-#: ../../source/ref-changelog.md:1026
+#: ../../source/ref-changelog.md:1048
 msgid ""
 "A new code example (`quickstart-pandas`) demonstrates federated analytics"
 " with Pandas and Flower. You can find it here: [quickstart-"
@@ -23722,7 +23841,7 @@ msgstr ""
 "[quickstart-pandas](https://github.com/adap/flower/tree/main/examples"
 "/quickstart-pandas)。"
 
-#: ../../source/ref-changelog.md:1028
+#: ../../source/ref-changelog.md:1050
 msgid ""
 "**Add new strategies: Krum and MultiKrum** "
 "([#1481](https://github.com/adap/flower/pull/1481))"
@@ -23730,7 +23849,7 @@ msgstr ""
 "**添加新策略： Krum 和 MultiKrum** "
 "([#1481](https://github.com/adap/flower/pull/1481))"
 
-#: ../../source/ref-changelog.md:1030
+#: ../../source/ref-changelog.md:1052
 msgid ""
 "Edoardo, a computer science student at the Sapienza University of Rome, "
 "contributed a new `Krum` strategy that enables users to easily use Krum "
@@ -23739,7 +23858,7 @@ msgstr ""
 "罗马萨皮恩扎大学（Sapienza University）计算机科学专业的学生埃多尔多（Edoardo）提出了一种新的 \"Krum "
 "\"策略，使用户能够在其工作负载中轻松使用 Krum 和 MultiKrum。"
 
-#: ../../source/ref-changelog.md:1032
+#: ../../source/ref-changelog.md:1054
 msgid ""
 "**Update C++ example to be compatible with Flower v1.2.0** "
 "([#1495](https://github.com/adap/flower/pull/1495))"
@@ -23747,13 +23866,13 @@ msgstr ""
 "** 更新 C++ 示例，与 Flower v1.2.0 兼容** "
 "([#1495](https://github.com/adap/flower/pull/1495))"
 
-#: ../../source/ref-changelog.md:1034
+#: ../../source/ref-changelog.md:1056
 msgid ""
 "The C++ code example has received a substantial update to make it "
 "compatible with the latest version of Flower."
 msgstr "为了与最新版本的 Flower 兼容，C++ 示例代码进行了大幅更新。"
 
-#: ../../source/ref-changelog.md:1036
+#: ../../source/ref-changelog.md:1058
 msgid ""
 "**General improvements** "
 "([#1491](https://github.com/adap/flower/pull/1491), "
@@ -23784,7 +23903,7 @@ msgstr ""
 "[#1564](https://github.com/adap/flower/pull/1564), "
 "[#1566](https://github.com/adap/flower/pull/1566))"
 
-#: ../../source/ref-changelog.md:1040
+#: ../../source/ref-changelog.md:1062
 msgid ""
 "**Updated documentation** "
 "([#1494](https://github.com/adap/flower/pull/1494), "
@@ -23807,7 +23926,7 @@ msgstr ""
 "[#1519](https://github.com/adap/flower/pull/1519), "
 "[#1515](https://github.com/adap/flower/pull/1515))"
 
-#: ../../source/ref-changelog.md:1044
+#: ../../source/ref-changelog.md:1066
 msgid ""
 "One highlight is the new [first time contributor "
 "guide](https://flower.ai/docs/first-time-contributors.html): if you've "
@@ -23816,17 +23935,17 @@ msgstr ""
 "其中一个亮点是新的[首次贡献者指南](https://flower.ai/docs/first-time-"
 "contributors.html)：如果你以前从未在 GitHub 上做过贡献，这将是一个完美的开始！"
 
-#: ../../source/ref-changelog.md:1050
+#: ../../source/ref-changelog.md:1072
 msgid "v1.1.0 (2022-10-31)"
 msgstr "v1.1.0 (2022-10-31)"
 
-#: ../../source/ref-changelog.md:1054
+#: ../../source/ref-changelog.md:1076
 msgid ""
 "We would like to give our **special thanks** to all the contributors who "
 "made the new version of Flower possible (in `git shortlog` order):"
 msgstr "在此，我们向所有促成 Flower 新版本的贡献者致以**特别的谢意（按 \"git shortlog \"顺序排列）："
 
-#: ../../source/ref-changelog.md:1056
+#: ../../source/ref-changelog.md:1078
 msgid ""
 "`Akis Linardos`, `Christopher S`, `Daniel J. Beutel`, `George`, `Jan "
 "Schlicht`, `Mohammad Fares`, `Pedro Porto Buarque de Gusmão`, `Philipp "
@@ -23838,7 +23957,7 @@ msgstr ""
 "Wiesner`, `Rob Luke`, `Taner Topal`, `VasundharaAgarwal`, "
 "`danielnugraha`, `edogab33`"
 
-#: ../../source/ref-changelog.md:1060
+#: ../../source/ref-changelog.md:1082
 msgid ""
 "**Introduce Differential Privacy wrappers (preview)** "
 "([#1357](https://github.com/adap/flower/pull/1357), "
@@ -23847,7 +23966,7 @@ msgstr ""
 "**引入差分隐私包装器（预览）** ([#1357](https://github.com/adap/flower/pull/1357), "
 "[#1460](https://github.com/adap/flower/pull/1460))"
 
-#: ../../source/ref-changelog.md:1062
+#: ../../source/ref-changelog.md:1084
 msgid ""
 "The first (experimental) preview of pluggable Differential Privacy "
 "wrappers enables easy configuration and usage of differential privacy "
@@ -23858,13 +23977,13 @@ msgstr ""
 "可插拔差分隐私封装器的首个（实验性）预览版可轻松配置和使用差分隐私（DP）。可插拔的差分隐私封装器可实现客户端差分隐私和服务器端差分隐私的框架无关**以及**策略无关的使用。请访问"
 " Flower 文档，新的解释器会提供更多细节。"
 
-#: ../../source/ref-changelog.md:1064
+#: ../../source/ref-changelog.md:1086
 msgid ""
 "**New iOS CoreML code example** "
 "([#1289](https://github.com/adap/flower/pull/1289))"
 msgstr "**新的 iOS CoreML 代码示例**（[#1289](https://github.com/adap/flower/pull/1289)）"
 
-#: ../../source/ref-changelog.md:1066
+#: ../../source/ref-changelog.md:1088
 msgid ""
 "Flower goes iOS! A massive new code example shows how Flower clients can "
 "be built for iOS. The code example contains both Flower iOS SDK "
@@ -23874,13 +23993,13 @@ msgstr ""
 "Flower 进入 iOS！大量新代码示例展示了如何为 iOS 构建 Flower 客户端。该代码示例包含可用于多种任务的 Flower iOS "
 "SDK 组件，以及在 CoreML 上运行的一个任务示例。"
 
-#: ../../source/ref-changelog.md:1068
+#: ../../source/ref-changelog.md:1090
 msgid ""
 "**New FedMedian strategy** "
 "([#1461](https://github.com/adap/flower/pull/1461))"
 msgstr "**新的联邦医疗策略** ([#1461](https://github.com/adap/flower/pull/1461))"
 
-#: ../../source/ref-changelog.md:1070
+#: ../../source/ref-changelog.md:1092
 msgid ""
 "The new `FedMedian` strategy implements Federated Median (FedMedian) by "
 "[Yin et al., 2018](https://arxiv.org/pdf/1803.01498v1.pdf)."
@@ -23888,27 +24007,27 @@ msgstr ""
 "新的 \"FedMedian \"战略实现了[Yin "
 "等人，2018]的联邦中值（FedMedian）(https://arxiv.org/pdf/1803.01498v1.pdf)。"
 
-#: ../../source/ref-changelog.md:1072
+#: ../../source/ref-changelog.md:1094
 msgid ""
 "**Log** `Client` **exceptions in Virtual Client Engine** "
 "([#1493](https://github.com/adap/flower/pull/1493))"
 msgstr "**虚拟客户端引擎中的**日志**`客户端`**异常（[#1493](https://github.com/adap/flower/pull/1493)）"
 
-#: ../../source/ref-changelog.md:1074
+#: ../../source/ref-changelog.md:1096
 msgid ""
 "All `Client` exceptions happening in the VCE are now logged by default "
 "and not just exposed to the configured `Strategy` (via the `failures` "
 "argument)."
 msgstr "VCE 中发生的所有 \"客户端 \"异常现在都会被默认记录下来，而不只是暴露给配置的 `Strategy`（通过 `failures`参数）。"
 
-#: ../../source/ref-changelog.md:1076
+#: ../../source/ref-changelog.md:1098
 msgid ""
 "**Improve Virtual Client Engine internals** "
 "([#1401](https://github.com/adap/flower/pull/1401), "
 "[#1453](https://github.com/adap/flower/pull/1453))"
 msgstr "**改进虚拟客户端引擎内部**（[#1401](https://github.com/adap/flower/pull/1401)、[#1453](https://github.com/adap/flower/pull/1453)）"
 
-#: ../../source/ref-changelog.md:1078
+#: ../../source/ref-changelog.md:1100
 msgid ""
 "Some internals of the Virtual Client Engine have been revamped. The VCE "
 "now uses Ray 2.0 under the hood, the value type of the `client_resources`"
@@ -23918,19 +24037,19 @@ msgstr ""
 "虚拟客户端引擎的部分内部结构已进行了修改。VCE 现在使用 Ray 2.0，\"client_resources \"字典的值类型改为 "
 "\"float\"，以允许分配分数资源。"
 
-#: ../../source/ref-changelog.md:1080
+#: ../../source/ref-changelog.md:1102
 msgid ""
 "**Support optional** `Client`**/**`NumPyClient` **methods in Virtual "
 "Client Engine**"
 msgstr "**支持虚拟客户端引擎中的可选** `Client`**/**`NumPyClient` **方法**"
 
-#: ../../source/ref-changelog.md:1082
+#: ../../source/ref-changelog.md:1104
 msgid ""
 "The Virtual Client Engine now has full support for optional `Client` (and"
 " `NumPyClient`) methods."
 msgstr "虚拟客户端引擎现在完全支持可选的 `Client`（和 `NumPyClient`）方法。"
 
-#: ../../source/ref-changelog.md:1084
+#: ../../source/ref-changelog.md:1106
 msgid ""
 "**Provide type information to packages using** `flwr` "
 "([#1377](https://github.com/adap/flower/pull/1377))"
@@ -23938,7 +24057,7 @@ msgstr ""
 "**使用** `flwr`向软件包提供类型信息 "
 "([#1377](https://github.com/adap/flower/pull/1377))"
 
-#: ../../source/ref-changelog.md:1086
+#: ../../source/ref-changelog.md:1108
 msgid ""
 "The package `flwr` is now bundled with a `py.typed` file indicating that "
 "the package is typed. This enables typing support for projects or "
@@ -23948,7 +24067,7 @@ msgstr ""
 "软件包 `flwr` 现在捆绑了一个 `py.typed` 文件，表明该软件包是类型化的。这样，使用 `flwr` 的项目或软件包就可以使用 "
 "`mypy` 等静态类型检查器改进代码，从而获得类型支持。"
 
-#: ../../source/ref-changelog.md:1088
+#: ../../source/ref-changelog.md:1110
 msgid ""
 "**Updated code example** "
 "([#1344](https://github.com/adap/flower/pull/1344), "
@@ -23957,13 +24076,13 @@ msgstr ""
 "** 更新代码示例** ([#1344](https://github.com/adap/flower/pull/1344), "
 "[#1347](https://github.com/adap/flower/pull/1347))"
 
-#: ../../source/ref-changelog.md:1090
+#: ../../source/ref-changelog.md:1112
 msgid ""
 "The code examples covering scikit-learn and PyTorch Lightning have been "
 "updated to work with the latest version of Flower."
 msgstr "涵盖 scikit-learn 和 PyTorch Lightning 的代码示例已更新，以便与最新版本的 Flower 配合使用。"
 
-#: ../../source/ref-changelog.md:1092
+#: ../../source/ref-changelog.md:1114
 msgid ""
 "**Updated documentation** "
 "([#1355](https://github.com/adap/flower/pull/1355), "
@@ -24002,32 +24121,32 @@ msgstr ""
 "[#1465](https://github.com/adap/flower/pull/1465), "
 "[#1467](https://github.com/adap/flower/pull/1467))"
 
-#: ../../source/ref-changelog.md:1094
+#: ../../source/ref-changelog.md:1116
 msgid ""
 "There have been so many documentation updates that it doesn't even make "
 "sense to list them individually."
 msgstr "文档更新的数量之多，甚至没有必要逐一列出。"
 
-#: ../../source/ref-changelog.md:1096
+#: ../../source/ref-changelog.md:1118
 msgid ""
 "**Restructured documentation** "
 "([#1387](https://github.com/adap/flower/pull/1387))"
 msgstr "**重构文档**（[#1387](https://github.com/adap/flower/pull/1387)）"
 
-#: ../../source/ref-changelog.md:1098
+#: ../../source/ref-changelog.md:1120
 msgid ""
 "The documentation has been restructured to make it easier to navigate. "
 "This is just the first step in a larger effort to make the Flower "
 "documentation the best documentation of any project ever. Stay tuned!"
 msgstr "我们对文档进行了重组，使其更易于浏览。这只是让 Flower 文档成为所有项目中最好文档的第一步。敬请期待！"
 
-#: ../../source/ref-changelog.md:1100
+#: ../../source/ref-changelog.md:1122
 msgid ""
 "**Open in Colab button** "
 "([#1389](https://github.com/adap/flower/pull/1389))"
 msgstr "**在 Colab 中打开按钮** ([#1389](https://github.com/adap/flower/pull/1389))"
 
-#: ../../source/ref-changelog.md:1102
+#: ../../source/ref-changelog.md:1124
 msgid ""
 "The four parts of the Flower Federated Learning Tutorial now come with a "
 "new `Open in Colab` button. No need to install anything on your local "
@@ -24037,7 +24156,7 @@ msgstr ""
 "Flower 联邦学习教程的四个部分现在都带有一个新的 \"在 Colab 中打开 "
 "\"按钮。现在，您无需在本地计算机上安装任何软件，只需点击一下，就可以在浏览器中使用和学习 Flower。"
 
-#: ../../source/ref-changelog.md:1104
+#: ../../source/ref-changelog.md:1126
 msgid ""
 "**Improved tutorial** ([#1468](https://github.com/adap/flower/pull/1468),"
 " [#1470](https://github.com/adap/flower/pull/1470), "
@@ -24053,7 +24172,7 @@ msgstr ""
 "[#1474](https://github.com/adap/flower/pull/1474), "
 "[#1475](https://github.com/adap/flower/pull/1475)))"
 
-#: ../../source/ref-changelog.md:1106
+#: ../../source/ref-changelog.md:1128
 msgid ""
 "The Flower Federated Learning Tutorial has two brand-new parts covering "
 "custom strategies (still WIP) and the distinction between `Client` and "
@@ -24063,33 +24182,33 @@ msgstr ""
 "Flower 联邦学习教程有两个全新的部分，涉及自定义策略（仍处于 WIP 阶段）和 `Client` 与 `NumPyClient` "
 "之间的区别。现有的第一和第二部分也得到了改进（许多小改动和修正）。"
 
-#: ../../source/ref-changelog.md:1112
+#: ../../source/ref-changelog.md:1134
 msgid "v1.0.0 (2022-07-28)"
 msgstr "v1.0.0 (2022-07-28)"
 
-#: ../../source/ref-changelog.md:1114
+#: ../../source/ref-changelog.md:1136
 msgid "Highlights"
 msgstr "亮点"
 
-#: ../../source/ref-changelog.md:1116
+#: ../../source/ref-changelog.md:1138
 msgid "Stable **Virtual Client Engine** (accessible via `start_simulation`)"
 msgstr "稳定的**虚拟客户端引擎**（可通过`start_simulation`访问）"
 
-#: ../../source/ref-changelog.md:1117
+#: ../../source/ref-changelog.md:1139
 msgid "All `Client`/`NumPyClient` methods are now optional"
 msgstr "所有 `Client`/`NumPyClient` 方法现在都是可选的了"
 
-#: ../../source/ref-changelog.md:1118
+#: ../../source/ref-changelog.md:1140
 msgid "Configurable `get_parameters`"
 msgstr "可配置的`get_parameters`"
 
-#: ../../source/ref-changelog.md:1119
+#: ../../source/ref-changelog.md:1141
 msgid ""
 "Tons of small API cleanups resulting in a more coherent developer "
 "experience"
 msgstr "对大量小型应用程序接口进行了清理，使开发人员的体验更加一致"
 
-#: ../../source/ref-changelog.md:1123
+#: ../../source/ref-changelog.md:1145
 msgid ""
 "We would like to give our **special thanks** to all the contributors who "
 "made Flower 1.0 possible (in reverse [GitHub "
@@ -24098,7 +24217,7 @@ msgstr ""
 "在此，我们谨向所有促成 Flower 1.0 的贡献者致以**特别的谢意（按[GitHub "
 "贡献者](https://github.com/adap/flower/graphs/contributors) 倒序排列）："
 
-#: ../../source/ref-changelog.md:1125
+#: ../../source/ref-changelog.md:1147
 msgid ""
 "[@rtaiello](https://github.com/rtaiello), "
 "[@g-pichler](https://github.com/g-pichler), [@rob-"
@@ -24174,13 +24293,13 @@ msgstr ""
 "[@tanertopal](https://github.com/tanertopal), "
 "[@danieljanes](https://github.com/danieljanes)."
 
-#: ../../source/ref-changelog.md:1129
+#: ../../source/ref-changelog.md:1151
 msgid ""
 "**All arguments must be passed as keyword arguments** "
 "([#1338](https://github.com/adap/flower/pull/1338))"
 msgstr "** 所有参数必须作为关键字参数传递** ([#1338](https://github.com/adap/flower/pull/1338))"
 
-#: ../../source/ref-changelog.md:1131
+#: ../../source/ref-changelog.md:1153
 msgid ""
 "Pass all arguments as keyword arguments, positional arguments are not "
 "longer supported. Code that uses positional arguments (e.g., "
@@ -24193,7 +24312,7 @@ msgstr ""
 "FlowerClient())`）必须为每个位置参数添加关键字（例如，`start_client(server_address=\"127.0.0.1:8080\","
 " client=FlowerClient())`）。"
 
-#: ../../source/ref-changelog.md:1133
+#: ../../source/ref-changelog.md:1155
 msgid ""
 "**Introduce configuration object** `ServerConfig` **in** `start_server` "
 "**and** `start_simulation` "
@@ -24202,7 +24321,7 @@ msgstr ""
 "**在*** `start_server` ***和*** `start_simulation` 中引入配置对象*** "
 "`ServerConfig` ([#1317](https://github.com/adap/flower/pull/1317))"
 
-#: ../../source/ref-changelog.md:1135
+#: ../../source/ref-changelog.md:1157
 msgid ""
 "Instead of a config dictionary `{\"num_rounds\": 3, \"round_timeout\": "
 "600.0}`, `start_server` and `start_simulation` now expect a configuration"
@@ -24215,37 +24334,37 @@ msgstr ""
 "`flwr.server.ServerConfig`的配置对象。`ServerConfig`接收的参数与之前的 config dict "
 "相同，但它使编写类型安全代码变得更容易，默认参数值也更加透明。"
 
-#: ../../source/ref-changelog.md:1137
+#: ../../source/ref-changelog.md:1159
 msgid ""
 "**Rename built-in strategy parameters for clarity** "
 "([#1334](https://github.com/adap/flower/pull/1334))"
 msgstr "**重新命名内置策略参数，使其更加清晰** ([#1334](https://github.com/adap/flower/pull/1334))"
 
-#: ../../source/ref-changelog.md:1139
+#: ../../source/ref-changelog.md:1161
 msgid ""
 "The following built-in strategy parameters were renamed to improve "
 "readability and consistency with other API's:"
 msgstr "以下内置策略参数已重新命名，以提高可读性并与其他 API 保持一致："
 
-#: ../../source/ref-changelog.md:1141
+#: ../../source/ref-changelog.md:1163
 msgid "`fraction_eval` --> `fraction_evaluate`"
 msgstr "`fraction_eval` --> `fraction_evaluate`"
 
-#: ../../source/ref-changelog.md:1142
+#: ../../source/ref-changelog.md:1164
 msgid "`min_eval_clients` --> `min_evaluate_clients`"
 msgstr "`min_eval_clients` --> `min_evaluate_clients`"
 
-#: ../../source/ref-changelog.md:1143
+#: ../../source/ref-changelog.md:1165
 msgid "`eval_fn` --> `evaluate_fn`"
 msgstr "`eval_fn` --> `evaluate_fn`"
 
-#: ../../source/ref-changelog.md:1145
+#: ../../source/ref-changelog.md:1167
 msgid ""
 "**Update default arguments of built-in strategies** "
 "([#1278](https://github.com/adap/flower/pull/1278))"
 msgstr "**更新内置策略的默认参数** ([#1278](https://github.com/adap/flower/pull/1278))"
 
-#: ../../source/ref-changelog.md:1147
+#: ../../source/ref-changelog.md:1169
 msgid ""
 "All built-in strategies now use `fraction_fit=1.0` and "
 "`fraction_evaluate=1.0`, which means they select *all* currently "
@@ -24256,11 +24375,11 @@ msgstr ""
 "所有内置策略现在都使用 \"fraction_fit=1.0 \"和 "
 "\"fraction_evaluate=1.0\"，这意味着它们会选择*所有*当前可用的客户端进行训练和评估。依赖以前默认值的项目可以通过以下方式初始化策略，获得以前的行为："
 
-#: ../../source/ref-changelog.md:1149
+#: ../../source/ref-changelog.md:1171
 msgid "`strategy = FedAvg(fraction_fit=0.1, fraction_evaluate=0.1)`"
 msgstr "`strategy = FedAvg(fraction_fit=0.1, fraction_evaluate=0.1)`"
 
-#: ../../source/ref-changelog.md:1151
+#: ../../source/ref-changelog.md:1173
 msgid ""
 "**Add** `server_round` **to** `Strategy.evaluate` "
 "([#1334](https://github.com/adap/flower/pull/1334))"
@@ -24268,13 +24387,13 @@ msgstr ""
 "**添加*** `server_round` ***到*** `Strategy.evaluate` "
 "([#1334](https://github.com/adap/flower/pull/1334))"
 
-#: ../../source/ref-changelog.md:1153
+#: ../../source/ref-changelog.md:1175
 msgid ""
 "The `Strategy` method `evaluate` now receives the current round of "
 "federated learning/evaluation as the first parameter."
 msgstr "`Strategy`的`evaluate` 方法现在会接收当前一轮联邦学习/评估作为第一个参数。"
 
-#: ../../source/ref-changelog.md:1155
+#: ../../source/ref-changelog.md:1177
 msgid ""
 "**Add** `server_round` **and** `config` **parameters to** `evaluate_fn` "
 "([#1334](https://github.com/adap/flower/pull/1334))"
@@ -24282,7 +24401,7 @@ msgstr ""
 "**将*** `server_round` **和*** `config` **参数添加到*** `evaluate_fn` "
 "([#1334](https://github.com/adap/flower/pull/1334))"
 
-#: ../../source/ref-changelog.md:1157
+#: ../../source/ref-changelog.md:1179
 msgid ""
 "The `evaluate_fn` passed to built-in strategies like `FedAvg` now takes "
 "three parameters: (1) The current round of federated learning/evaluation "
@@ -24292,7 +24411,7 @@ msgstr ""
 "传递给内置策略（如 `FedAvg`）的 `evaluate_fn` 现在需要三个参数：(1) 当前一轮联邦学习/评估 "
 "(`server_round`)，(2) 要评估的模型参数 (`parameters`)，(3) 配置字典 (`config`)。"
 
-#: ../../source/ref-changelog.md:1159
+#: ../../source/ref-changelog.md:1181
 msgid ""
 "**Rename** `rnd` **to** `server_round` "
 "([#1321](https://github.com/adap/flower/pull/1321))"
@@ -24300,7 +24419,7 @@ msgstr ""
 "**重新命名** `rnd` ** to** `server_round` "
 "([#1321](https://github.com/adap/flower/pull/1321))"
 
-#: ../../source/ref-changelog.md:1161
+#: ../../source/ref-changelog.md:1183
 msgid ""
 "Several Flower methods and functions (`evaluate_fn`, `configure_fit`, "
 "`aggregate_fit`, `configure_evaluate`, `aggregate_evaluate`) receive the "
@@ -24312,7 +24431,7 @@ msgstr ""
 "方法和函数（`evaluate_fn`、`configure_fit`、`aggregate_fit`、`configure_evaluate`、`aggregate_evaluate`）的第一个参数是当前一轮的联邦学习/评估。为提高可重复性并避免与"
 " *random* 混淆，该参数已从 `rnd` 更名为 `server_round`。"
 
-#: ../../source/ref-changelog.md:1163
+#: ../../source/ref-changelog.md:1185
 msgid ""
 "**Move** `flwr.dataset` **to** `flwr_baselines` "
 "([#1273](https://github.com/adap/flower/pull/1273))"
@@ -24320,23 +24439,23 @@ msgstr ""
 "**移动*** `flwr.dataset` **到*** `flwr_baselines` "
 "([#1273](https://github.com/adap/flower/pull/1273))"
 
-#: ../../source/ref-changelog.md:1165
+#: ../../source/ref-changelog.md:1187
 msgid "The experimental package `flwr.dataset` was migrated to Flower Baselines."
 msgstr "实验软件包 `flwr.dataset` 已迁移至 Flower Baselines。"
 
-#: ../../source/ref-changelog.md:1167
+#: ../../source/ref-changelog.md:1189
 msgid ""
 "**Remove experimental strategies** "
 "([#1280](https://github.com/adap/flower/pull/1280))"
 msgstr "**删除实验策略** ([#1280](https://github.com/adap/flower/pull/1280))"
 
-#: ../../source/ref-changelog.md:1169
+#: ../../source/ref-changelog.md:1191
 msgid ""
 "Remove unmaintained experimental strategies (`FastAndSlow`, `FedFSv0`, "
 "`FedFSv1`)."
 msgstr "移除未维护的试验性策略（`FastAndSlow`、`FedFSv0`、`FedFSv1`）。"
 
-#: ../../source/ref-changelog.md:1171
+#: ../../source/ref-changelog.md:1193
 msgid ""
 "**Rename** `Weights` **to** `NDArrays` "
 "([#1258](https://github.com/adap/flower/pull/1258), "
@@ -24346,13 +24465,13 @@ msgstr ""
 "([#1258](https://github.com/adap/flower/pull/1258), "
 "[#1259](https://github.com/adap/flower/pull/1259))"
 
-#: ../../source/ref-changelog.md:1173
+#: ../../source/ref-changelog.md:1195
 msgid ""
 "`flwr.common.Weights` was renamed to `flwr.common.NDArrays` to better "
 "capture what this type is all about."
 msgstr "flwr.common.Weights \"更名为 \"flwr.common.NDArrays\"，以更好地反映该类型的含义。"
 
-#: ../../source/ref-changelog.md:1175
+#: ../../source/ref-changelog.md:1197
 msgid ""
 "**Remove antiquated** `force_final_distributed_eval` **from** "
 "`start_server` ([#1258](https://github.com/adap/flower/pull/1258), "
@@ -24362,7 +24481,7 @@ msgstr ""
 "([#1258](https://github.com/adap/flower/pull/1258), "
 "[#1259](https://github.com/adap/flower/pull/1259))"
 
-#: ../../source/ref-changelog.md:1177
+#: ../../source/ref-changelog.md:1199
 msgid ""
 "The `start_server` parameter `force_final_distributed_eval` has long been"
 " a historic artefact, in this release it is finally gone for good."
@@ -24370,7 +24489,7 @@ msgstr ""
 "start_server \"参数 \"force_final_distributed_eval "
 "\"长期以来一直是个历史遗留问题，在此版本中终于永远消失了。"
 
-#: ../../source/ref-changelog.md:1179
+#: ../../source/ref-changelog.md:1201
 msgid ""
 "**Make** `get_parameters` **configurable** "
 "([#1242](https://github.com/adap/flower/pull/1242))"
@@ -24378,7 +24497,7 @@ msgstr ""
 "**使** `get_parameters` **可配置** "
 "([#1242](https://github.com/adap/flower/pull/1242))"
 
-#: ../../source/ref-changelog.md:1181
+#: ../../source/ref-changelog.md:1203
 msgid ""
 "The `get_parameters` method now accepts a configuration dictionary, just "
 "like `get_properties`, `fit`, and `evaluate`."
@@ -24386,7 +24505,7 @@ msgstr ""
 "现在，\"get_parameters \"方法与 \"get_properties\"、\"fit \"和 \"evaluate "
 "\"一样，都接受配置字典。"
 
-#: ../../source/ref-changelog.md:1183
+#: ../../source/ref-changelog.md:1205
 msgid ""
 "**Replace** `num_rounds` **in** `start_simulation` **with new** `config` "
 "**parameter** ([#1281](https://github.com/adap/flower/pull/1281))"
@@ -24394,7 +24513,7 @@ msgstr ""
 "**用新的** `config` 参数** 替换** `num_rounds` ** in** `start_simulation` ** "
 "([#1281](https://github.com/adap/flower/pull/1281))"
 
-#: ../../source/ref-changelog.md:1185
+#: ../../source/ref-changelog.md:1207
 msgid ""
 "The `start_simulation` function now accepts a configuration dictionary "
 "`config` instead of the `num_rounds` integer. This improves the "
@@ -24404,19 +24523,19 @@ msgstr ""
 "现在，`start_simulation`（开始模拟）` 函数接受配置字典 `config` 而不是 `num_rounds` 整数。这改进了 "
 "`start_simulation` 和 `start_server` 之间的一致性，并使两者之间的转换更容易。"
 
-#: ../../source/ref-changelog.md:1189
+#: ../../source/ref-changelog.md:1211
 msgid ""
 "**Support Python 3.10** "
 "([#1320](https://github.com/adap/flower/pull/1320))"
 msgstr "** 支持 Python 3.10** ([#1320](https://github.com/adap/flower/pull/1320))"
 
-#: ../../source/ref-changelog.md:1191
+#: ../../source/ref-changelog.md:1213
 msgid ""
 "The previous Flower release introduced experimental support for Python "
 "3.10, this release declares Python 3.10 support as stable."
 msgstr "上一个 Flower 版本引入了对 Python 3.10 的实验支持，而本版本则宣布对 Python 3.10 的支持为稳定支持。"
 
-#: ../../source/ref-changelog.md:1193
+#: ../../source/ref-changelog.md:1215
 msgid ""
 "**Make all** `Client` **and** `NumPyClient` **methods optional** "
 "([#1260](https://github.com/adap/flower/pull/1260), "
@@ -24426,7 +24545,7 @@ msgstr ""
 "([#1260](https://github.com/adap/flower/pull/1260), "
 "[#1277](https://github.com/adap/flower/pull/1277))"
 
-#: ../../source/ref-changelog.md:1195
+#: ../../source/ref-changelog.md:1217
 msgid ""
 "The `Client`/`NumPyClient` methods `get_properties`, `get_parameters`, "
 "`fit`, and `evaluate` are all optional. This enables writing clients that"
@@ -24437,7 +24556,7 @@ msgstr ""
 "\"evaluate \"方法都是可选的。这样就可以编写只实现 `fit` 而不实现其他方法的客户端。使用集中评估时，无需实现 "
 "`evaluate`！"
 
-#: ../../source/ref-changelog.md:1197
+#: ../../source/ref-changelog.md:1219
 msgid ""
 "**Enable passing a** `Server` **instance to** `start_simulation` "
 "([#1281](https://github.com/adap/flower/pull/1281))"
@@ -24445,7 +24564,7 @@ msgstr ""
 "**启用向** `start_simulation` 传递** `Server` 实例 "
 "([#1281](https://github.com/adap/flower/pull/1281))"
 
-#: ../../source/ref-changelog.md:1199
+#: ../../source/ref-changelog.md:1221
 msgid ""
 "Similar to `start_server`, `start_simulation` now accepts a full `Server`"
 " instance. This enables users to heavily customize the execution of "
@@ -24455,7 +24574,7 @@ msgstr ""
 "与 `start_server` 类似，`start_simulation` 现在也接受一个完整的 `Server` "
 "实例。这使得用户可以对实验的执行进行大量自定义，并为使用虚拟客户端引擎运行异步 FL 等打开了大门。"
 
-#: ../../source/ref-changelog.md:1201
+#: ../../source/ref-changelog.md:1223
 msgid ""
 "**Update code examples** "
 "([#1291](https://github.com/adap/flower/pull/1291), "
@@ -24466,43 +24585,43 @@ msgstr ""
 "[#1286](https://github.com/adap/flower/pull/1286), "
 "[#1282](https://github.com/adap/flower/pull/1282))"
 
-#: ../../source/ref-changelog.md:1203
+#: ../../source/ref-changelog.md:1225
 msgid ""
 "Many code examples received small or even large maintenance updates, "
 "among them are"
 msgstr "许多代码示例都进行了小规模甚至大规模的维护更新，其中包括"
 
-#: ../../source/ref-changelog.md:1205
+#: ../../source/ref-changelog.md:1227
 msgid "`scikit-learn`"
 msgstr "`scikit-learn`"
 
-#: ../../source/ref-changelog.md:1206
+#: ../../source/ref-changelog.md:1228
 msgid "`simulation_pytorch`"
 msgstr "`simulation_pytorch`"
 
-#: ../../source/ref-changelog.md:1207
+#: ../../source/ref-changelog.md:1229
 msgid "`quickstart_pytorch`"
 msgstr "`quickstart_pytorch`"
 
-#: ../../source/ref-changelog.md:1208
+#: ../../source/ref-changelog.md:1230
 msgid "`quickstart_simulation`"
 msgstr "`quickstart_simulation`"
 
-#: ../../source/ref-changelog.md:1209
+#: ../../source/ref-changelog.md:1231
 msgid "`quickstart_tensorflow`"
 msgstr "`quickstart_tensorflow`"
 
-#: ../../source/ref-changelog.md:1210
+#: ../../source/ref-changelog.md:1232
 msgid "`advanced_tensorflow`"
 msgstr "`advanced_tensorflow`"
 
-#: ../../source/ref-changelog.md:1212
+#: ../../source/ref-changelog.md:1234
 msgid ""
 "**Remove the obsolete simulation example** "
 "([#1328](https://github.com/adap/flower/pull/1328))"
 msgstr "**删除过时的模拟示例** ([#1328](https://github.com/adap/flower/pull/1328))"
 
-#: ../../source/ref-changelog.md:1214
+#: ../../source/ref-changelog.md:1236
 msgid ""
 "Removes the obsolete `simulation` example and renames "
 "`quickstart_simulation` to `simulation_tensorflow` so it fits withs the "
@@ -24511,7 +24630,7 @@ msgstr ""
 "删除过时的 \"simulation \"示例，并将 \"quickstart_simulation \"重命名为 "
 "\"simulation_tensorflow\"，使其与 \"simulation_pytorch \"的命名一致"
 
-#: ../../source/ref-changelog.md:1216
+#: ../../source/ref-changelog.md:1238
 msgid ""
 "**Update documentation** "
 "([#1223](https://github.com/adap/flower/pull/1223), "
@@ -24536,7 +24655,7 @@ msgstr ""
 "[#1305](https://github.com/adap/flower/pull/1305), "
 "[#1307](https://github.com/adap/flower/pull/1307))"
 
-#: ../../source/ref-changelog.md:1218
+#: ../../source/ref-changelog.md:1240
 msgid ""
 "One substantial documentation update fixes multiple smaller rendering "
 "issues, makes titles more succinct to improve navigation, removes a "
@@ -24549,18 +24668,18 @@ msgstr ""
 "`flwr.common` 模块，包含了对基于 markdown 的文档的支持，将更新日志从 `.rst` 移植到了 "
 "`.md`，并修复了一些较小的细节！"
 
-#: ../../source/ref-changelog.md:1220 ../../source/ref-changelog.md:1275
-#: ../../source/ref-changelog.md:1344 ../../source/ref-changelog.md:1383
+#: ../../source/ref-changelog.md:1242 ../../source/ref-changelog.md:1297
+#: ../../source/ref-changelog.md:1366 ../../source/ref-changelog.md:1405
 msgid "**Minor updates**"
 msgstr "**小规模更新**"
 
-#: ../../source/ref-changelog.md:1222
+#: ../../source/ref-changelog.md:1244
 msgid ""
 "Add round number to fit and evaluate log messages "
 "([#1266](https://github.com/adap/flower/pull/1266))"
 msgstr "添加四舍五入数字，以适应和评估日志信息（[#1266](https://github.com/adap/flower/pull/1266)）"
 
-#: ../../source/ref-changelog.md:1223
+#: ../../source/ref-changelog.md:1245
 msgid ""
 "Add secure gRPC connection to the `advanced_tensorflow` code example "
 "([#847](https://github.com/adap/flower/pull/847))"
@@ -24568,7 +24687,7 @@ msgstr ""
 "为 `advanced_tensorflow` 代码示例添加安全 gRPC 连接 "
 "([#847](https://github.com/adap/flower/pull/847))"
 
-#: ../../source/ref-changelog.md:1224
+#: ../../source/ref-changelog.md:1246
 msgid ""
 "Update developer tooling "
 "([#1231](https://github.com/adap/flower/pull/1231), "
@@ -24581,7 +24700,7 @@ msgstr ""
 "[#1301](https://github.com/adap/flower/pull/1301), "
 "[#1310](https://github.com/adap/flower/pull/1310)"
 
-#: ../../source/ref-changelog.md:1225
+#: ../../source/ref-changelog.md:1247
 msgid ""
 "Rename ProtoBuf messages to improve consistency "
 "([#1214](https://github.com/adap/flower/pull/1214), "
@@ -24592,11 +24711,11 @@ msgstr ""
 "[#1258](https://github.com/adap/flower/pull/1258), "
 "[#1259](https://github.com/adap/flower/pull/1259)"
 
-#: ../../source/ref-changelog.md:1227
+#: ../../source/ref-changelog.md:1249
 msgid "v0.19.0 (2022-05-18)"
 msgstr "v0.19.0 (2022-05-18)"
 
-#: ../../source/ref-changelog.md:1231
+#: ../../source/ref-changelog.md:1253
 msgid ""
 "**Flower Baselines (preview): FedOpt, FedBN, FedAvgM** "
 "([#919](https://github.com/adap/flower/pull/919), "
@@ -24608,7 +24727,7 @@ msgstr ""
 "[#1127](https://github.com/adap/flower/pull/1127), "
 "[#914](https://github.com/adap/flower/pull/914))"
 
-#: ../../source/ref-changelog.md:1233
+#: ../../source/ref-changelog.md:1255
 #, fuzzy
 msgid ""
 "The first preview release of Flower Baselines has arrived! We're "
@@ -24625,13 +24744,13 @@ msgstr ""
 "baselines.html)。在首次发布预览版时，我们还邀请社区成员[贡献自己的Baselines](https://flower.ai/docs"
 "/contributing-baselines.html)。"
 
-#: ../../source/ref-changelog.md:1235
+#: ../../source/ref-changelog.md:1257
 msgid ""
 "**C++ client SDK (preview) and code example** "
 "([#1111](https://github.com/adap/flower/pull/1111))"
 msgstr "**C++客户端SDK（预览版）和代码示例**（[#1111](https://github.com/adap/flower/pull/1111)）"
 
-#: ../../source/ref-changelog.md:1237
+#: ../../source/ref-changelog.md:1259
 msgid ""
 "Preview support for Flower clients written in C++. The C++ preview "
 "includes a Flower client SDK and a quickstart code example that "
@@ -24640,7 +24759,7 @@ msgstr ""
 "预览版支持用 C++ 编写的 Flower 客户端。C++ 预览版包括一个 Flower 客户端 SDK 和一个快速入门代码示例，使用 SDK "
 "演示了一个简单的 C++ 客户端。"
 
-#: ../../source/ref-changelog.md:1239
+#: ../../source/ref-changelog.md:1261
 msgid ""
 "**Add experimental support for Python 3.10 and Python 3.11** "
 "([#1135](https://github.com/adap/flower/pull/1135))"
@@ -24648,7 +24767,7 @@ msgstr ""
 "** 增加对 Python 3.10 和 Python 3.11 的实验支持** "
 "([#1135](https://github.com/adap/flower/pull/1135))"
 
-#: ../../source/ref-changelog.md:1241
+#: ../../source/ref-changelog.md:1263
 msgid ""
 "Python 3.10 is the latest stable release of Python and Python 3.11 is due"
 " to be released in October. This Flower release adds experimental support"
@@ -24657,13 +24776,13 @@ msgstr ""
 "Python 3.10 是 Python 的最新稳定版本，Python 3.11 将于 10 月份发布。Flower 版本增加了对这两个 "
 "Python 版本的实验支持。"
 
-#: ../../source/ref-changelog.md:1243
+#: ../../source/ref-changelog.md:1265
 msgid ""
 "**Aggregate custom metrics through user-provided functions** "
 "([#1144](https://github.com/adap/flower/pull/1144))"
 msgstr "**通过用户提供的函数聚合自定义指标**（[#1144](https://github.com/adap/flower/pull/1144)）"
 
-#: ../../source/ref-changelog.md:1245
+#: ../../source/ref-changelog.md:1267
 msgid ""
 "Custom metrics (e.g., `accuracy`) can now be aggregated without having to"
 " customize the strategy. Built-in strategies support two new arguments, "
@@ -24673,13 +24792,13 @@ msgstr ""
 "现在无需定制策略即可聚合自定义度量（如`准确度`）。内置策略支持两个新参数：`fit_metrics_aggregation_fn` "
 "和`evaluate_metrics_aggregation_fn`，允许传递自定义度量聚合函数。"
 
-#: ../../source/ref-changelog.md:1247
+#: ../../source/ref-changelog.md:1269
 msgid ""
 "**User-configurable round timeout** "
 "([#1162](https://github.com/adap/flower/pull/1162))"
 msgstr "**用户可配置的回合超时**（[#1162](https://github.com/adap/flower/pull/1162)）"
 
-#: ../../source/ref-changelog.md:1249
+#: ../../source/ref-changelog.md:1271
 msgid ""
 "A new configuration value allows the round timeout to be set for "
 "`start_server` and `start_simulation`. If the `config` dictionary "
@@ -24690,7 +24809,7 @@ msgstr ""
 "新的配置值允许为 `start_server` 和 `start_simulation` 设置回合超时。如果 `config` 字典中包含一个 "
 "`round_timeout` 键（以秒为单位的 `float`值），服务器将至少等待 ** `round_timeout` 秒后才关闭连接。"
 
-#: ../../source/ref-changelog.md:1251
+#: ../../source/ref-changelog.md:1273
 msgid ""
 "**Enable both federated evaluation and centralized evaluation to be used "
 "at the same time in all built-in strategies** "
@@ -24699,7 +24818,7 @@ msgstr ""
 "**允许在所有内置策略中同时使用联邦评价和集中评估** "
 "([#1091](https://github.com/adap/flower/pull/1091))"
 
-#: ../../source/ref-changelog.md:1253
+#: ../../source/ref-changelog.md:1275
 msgid ""
 "Built-in strategies can now perform both federated evaluation (i.e., "
 "client-side) and centralized evaluation (i.e., server-side) in the same "
@@ -24709,7 +24828,7 @@ msgstr ""
 "内置策略现在可以在同一轮中同时执行联邦评估（即客户端）和集中评估（即服务器端）。可以通过将 `fraction_eval` 设置为 "
 "`0.0`来禁用联邦评估。"
 
-#: ../../source/ref-changelog.md:1255
+#: ../../source/ref-changelog.md:1277
 msgid ""
 "**Two new Jupyter Notebook tutorials** "
 "([#1141](https://github.com/adap/flower/pull/1141))"
@@ -24717,13 +24836,13 @@ msgstr ""
 "**两本新的 Jupyter Notebook 教程** "
 "([#1141](https://github.com/adap/flower/pull/1141))"
 
-#: ../../source/ref-changelog.md:1257
+#: ../../source/ref-changelog.md:1279
 msgid ""
 "Two Jupyter Notebook tutorials (compatible with Google Colab) explain "
 "basic and intermediate Flower features:"
 msgstr "两本 Jupyter Notebook 教程（与 Google Colab 兼容）介绍了 Flower 的基本和中级功能："
 
-#: ../../source/ref-changelog.md:1259
+#: ../../source/ref-changelog.md:1281
 msgid ""
 "*An Introduction to Federated Learning*: [Open in "
 "Colab](https://colab.research.google.com/github/adap/flower/blob/main/tutorials/Flower-1"
@@ -24733,7 +24852,7 @@ msgstr ""
 "中打开](https://colab.research.google.com/github/adap/flower/blob/main/tutorials/Flower-1"
 "-Intro-to-FL-PyTorch.ipynb)"
 
-#: ../../source/ref-changelog.md:1261
+#: ../../source/ref-changelog.md:1283
 msgid ""
 "*Using Strategies in Federated Learning*: [Open in "
 "Colab](https://colab.research.google.com/github/adap/flower/blob/main/tutorials/Flower-2"
@@ -24743,7 +24862,7 @@ msgstr ""
 "中打开](https://colab.research.google.com/github/adap/flower/blob/main/tutorials/Flower-2"
 "-Strategies-in-FL-PyTorch.ipynb)"
 
-#: ../../source/ref-changelog.md:1263
+#: ../../source/ref-changelog.md:1285
 msgid ""
 "**New FedAvgM strategy (Federated Averaging with Server Momentum)** "
 "([#1076](https://github.com/adap/flower/pull/1076))"
@@ -24751,25 +24870,25 @@ msgstr ""
 "**新的 FedAvgM 策略（带服务器动量的联邦平均）** "
 "([#1076](https://github.com/adap/flower/pull/1076))"
 
-#: ../../source/ref-changelog.md:1265
+#: ../../source/ref-changelog.md:1287
 msgid ""
 "The new `FedAvgM` strategy implements Federated Averaging with Server "
 "Momentum \\[Hsu et al., 2019\\]."
 msgstr "新的 \"FedAvgM \"策略实现了带服务器动量的联邦平均[Hsu et al., 2019\\]."
 
-#: ../../source/ref-changelog.md:1267
+#: ../../source/ref-changelog.md:1289
 msgid ""
 "**New advanced PyTorch code example** "
 "([#1007](https://github.com/adap/flower/pull/1007))"
 msgstr "**新的 PyTorch 高级代码示例** ([#1007](https://github.com/adap/flower/pull/1007))"
 
-#: ../../source/ref-changelog.md:1269
+#: ../../source/ref-changelog.md:1291
 msgid ""
 "A new code example (`advanced_pytorch`) demonstrates advanced Flower "
 "concepts with PyTorch."
 msgstr "新代码示例 (`advanced_pytorch`) 演示了 PyTorch 的高级 Flower 概念。"
 
-#: ../../source/ref-changelog.md:1271
+#: ../../source/ref-changelog.md:1293
 msgid ""
 "**New JAX code example** "
 "([#906](https://github.com/adap/flower/pull/906), "
@@ -24778,13 +24897,13 @@ msgstr ""
 "**新的 JAX 代码示例**（[#906](https://github.com/adap/flower/pull/906), "
 "[#1143](https://github.com/adap/flower/pull/1143)"
 
-#: ../../source/ref-changelog.md:1273
+#: ../../source/ref-changelog.md:1295
 msgid ""
 "A new code example (`jax_from_centralized_to_federated`) shows federated "
 "learning with JAX and Flower."
 msgstr "新代码示例（`jax_from_centralized_to_federated`）展示了使用 JAX 和 Flower 的联邦学习。"
 
-#: ../../source/ref-changelog.md:1277
+#: ../../source/ref-changelog.md:1299
 msgid ""
 "New option to keep Ray running if Ray was already initialized in "
 "`start_simulation` ([#1177](https://github.com/adap/flower/pull/1177))"
@@ -24792,7 +24911,7 @@ msgstr ""
 "新增选项，用于在 \"start_simulation\"（开始模拟）中已初始化 Ray 的情况下保持 Ray "
 "运行（[#1177](https://github.com/adap/flower/pull/1177)）"
 
-#: ../../source/ref-changelog.md:1278
+#: ../../source/ref-changelog.md:1300
 msgid ""
 "Add support for custom `ClientManager` as a `start_simulation` parameter "
 "([#1171](https://github.com/adap/flower/pull/1171))"
@@ -24800,7 +24919,7 @@ msgstr ""
 "添加对自定义 \"客户端管理器 \"作为 \"start_simulation "
 "\"参数的支持（[#1171](https://github.com/adap/flower/pull/1171)）"
 
-#: ../../source/ref-changelog.md:1279
+#: ../../source/ref-changelog.md:1301
 msgid ""
 "New documentation for [implementing "
 "strategies](https://flower.ai/docs/framework/how-to-implement-"
@@ -24811,13 +24930,13 @@ msgstr ""
 " 的新文件（[#1097](https://github.com/adap/flower/pull/1097), "
 "[#1175](https://github.com/adap/flower/pull/1175)"
 
-#: ../../source/ref-changelog.md:1280
+#: ../../source/ref-changelog.md:1302
 msgid ""
 "New mobile-friendly documentation theme "
 "([#1174](https://github.com/adap/flower/pull/1174))"
 msgstr "新的移动友好型文档主题 ([#1174](https://github.com/adap/flower/pull/1174))"
 
-#: ../../source/ref-changelog.md:1281
+#: ../../source/ref-changelog.md:1303
 msgid ""
 "Limit version range for (optional) `ray` dependency to include only "
 "compatible releases (`>=1.9.2,<1.12.0`) "
@@ -24826,25 +24945,25 @@ msgstr ""
 "限制（可选）`ray`依赖的版本范围，使其仅包含兼容版本（`>=1.9.2,<1.12.0`） "
 "([#1205](https://github.com/adap/flower/pull/1205))"
 
-#: ../../source/ref-changelog.md:1285
+#: ../../source/ref-changelog.md:1307
 msgid ""
 "**Remove deprecated support for Python 3.6** "
 "([#871](https://github.com/adap/flower/pull/871))"
 msgstr "**删除对 Python 3.6 的过时支持** ([#871](https://github.com/adap/flower/pull/871))"
 
-#: ../../source/ref-changelog.md:1286
+#: ../../source/ref-changelog.md:1308
 msgid ""
 "**Remove deprecated KerasClient** "
 "([#857](https://github.com/adap/flower/pull/857))"
 msgstr "**移除过时的 KerasClient**（[#857](https://github.com/adap/flower/pull/857)）"
 
-#: ../../source/ref-changelog.md:1287
+#: ../../source/ref-changelog.md:1309
 msgid ""
 "**Remove deprecated no-op extra installs** "
 "([#973](https://github.com/adap/flower/pull/973))"
 msgstr "**移除过时的不操作额外安装** ([#973](https://github.com/adap/flower/pull/973))"
 
-#: ../../source/ref-changelog.md:1288
+#: ../../source/ref-changelog.md:1310
 msgid ""
 "**Remove deprecated proto fields from** `FitRes` **and** `EvaluateRes` "
 "([#869](https://github.com/adap/flower/pull/869))"
@@ -24852,7 +24971,7 @@ msgstr ""
 "**从** `FitRes` **和** `EvaluateRes` 中移除已废弃的 proto 字段 "
 "([#869](https://github.com/adap/flower/pull/869))"
 
-#: ../../source/ref-changelog.md:1289
+#: ../../source/ref-changelog.md:1311
 msgid ""
 "**Remove deprecated QffedAvg strategy (replaced by QFedAvg)** "
 "([#1107](https://github.com/adap/flower/pull/1107))"
@@ -24860,7 +24979,7 @@ msgstr ""
 "**移除过时的 QffedAvg 策略（由 QFedAvg 取代）** "
 "([#1107](https://github.com/adap/flower/pull/1107))"
 
-#: ../../source/ref-changelog.md:1290
+#: ../../source/ref-changelog.md:1312
 msgid ""
 "**Remove deprecated DefaultStrategy strategy** "
 "([#1142](https://github.com/adap/flower/pull/1142))"
@@ -24868,7 +24987,7 @@ msgstr ""
 "**删除过时的 DefaultStrategy 策略** "
 "([#1142](https://github.com/adap/flower/pull/1142))"
 
-#: ../../source/ref-changelog.md:1291
+#: ../../source/ref-changelog.md:1313
 msgid ""
 "**Remove deprecated support for eval_fn accuracy return value** "
 "([#1142](https://github.com/adap/flower/pull/1142))"
@@ -24876,7 +24995,7 @@ msgstr ""
 "**删除已过时的对 eval_fn 返回值准确性的支持** "
 "([#1142](https://github.com/adap/flower/pull/1142))"
 
-#: ../../source/ref-changelog.md:1292
+#: ../../source/ref-changelog.md:1314
 msgid ""
 "**Remove deprecated support for passing initial parameters as NumPy "
 "ndarrays** ([#1142](https://github.com/adap/flower/pull/1142))"
@@ -24884,11 +25003,11 @@ msgstr ""
 "**移除对以 NumPy ndarrays 传递初始参数的过时支持** "
 "([#1142](https://github.com/adap/flower/pull/1142))"
 
-#: ../../source/ref-changelog.md:1294
+#: ../../source/ref-changelog.md:1316
 msgid "v0.18.0 (2022-02-28)"
 msgstr "v0.18.0 (2022-02-28)"
 
-#: ../../source/ref-changelog.md:1298
+#: ../../source/ref-changelog.md:1320
 msgid ""
 "**Improved Virtual Client Engine compatibility with Jupyter Notebook / "
 "Google Colab** ([#866](https://github.com/adap/flower/pull/866), "
@@ -24902,7 +25021,7 @@ msgstr ""
 "[#833](https://github.com/adap/flower/pull/833), "
 "[#1036](https://github.com/adap/flower/pull/1036))"
 
-#: ../../source/ref-changelog.md:1300
+#: ../../source/ref-changelog.md:1322
 msgid ""
 "Simulations (using the Virtual Client Engine through `start_simulation`) "
 "now work more smoothly on Jupyter Notebooks (incl. Google Colab) after "
@@ -24913,7 +25032,7 @@ msgstr ""
 "`simulation` (`pip install 'flwr[simulation]'`)后，模拟（通过 `start_simulation`"
 " 使用虚拟客户端引擎）现在可以更流畅地运行。"
 
-#: ../../source/ref-changelog.md:1302
+#: ../../source/ref-changelog.md:1324
 msgid ""
 "**New Jupyter Notebook code example** "
 "([#833](https://github.com/adap/flower/pull/833))"
@@ -24921,7 +25040,7 @@ msgstr ""
 "**新的 Jupyter Notebook 代码示例** "
 "([#833](https://github.com/adap/flower/pull/833))"
 
-#: ../../source/ref-changelog.md:1304
+#: ../../source/ref-changelog.md:1326
 msgid ""
 "A new code example (`quickstart_simulation`) demonstrates Flower "
 "simulations using the Virtual Client Engine through Jupyter Notebook "
@@ -24930,25 +25049,25 @@ msgstr ""
 "新代码示例（`quickstart_simulation`）通过 Jupyter Notebook（包括 Google "
 "Colab）演示了使用虚拟客户端引擎进行 Flower 模拟。"
 
-#: ../../source/ref-changelog.md:1306
+#: ../../source/ref-changelog.md:1328
 msgid ""
 "**Client properties (feature preview)** "
 "([#795](https://github.com/adap/flower/pull/795))"
 msgstr "**客户端属性（功能预览）** ([#795](https://github.com/adap/flower/pull/795))"
 
-#: ../../source/ref-changelog.md:1308
+#: ../../source/ref-changelog.md:1330
 msgid ""
 "Clients can implement a new method `get_properties` to enable server-side"
 " strategies to query client properties."
 msgstr "客户端可以实现一个新方法 `get_properties`，以启用服务器端策略来查询客户端属性。"
 
-#: ../../source/ref-changelog.md:1310
+#: ../../source/ref-changelog.md:1332
 msgid ""
 "**Experimental Android support with TFLite** "
 "([#865](https://github.com/adap/flower/pull/865))"
 msgstr "** 使用 TFLite 实验性支持安卓系统** ([#865](https://github.com/adap/flower/pull/865))"
 
-#: ../../source/ref-changelog.md:1312
+#: ../../source/ref-changelog.md:1334
 msgid ""
 "Android support has finally arrived in `main`! Flower is both client-"
 "agnostic and framework-agnostic by design. One can integrate arbitrary "
@@ -24958,7 +25077,7 @@ msgstr ""
 "`main`终于支持 Android 了！Flower 的设计与客户端和框架无关。我们可以集成任意客户端平台，有了这个版本，在安卓系统上使用 "
 "Flower 就变得更容易了。"
 
-#: ../../source/ref-changelog.md:1314
+#: ../../source/ref-changelog.md:1336
 msgid ""
 "The example uses TFLite on the client side, along with a new "
 "`FedAvgAndroid` strategy. The Android client and `FedAvgAndroid` are "
@@ -24970,7 +25089,7 @@ msgstr ""
 "`FedAvgAndroid`仍处于试验阶段，但这是向成熟的 Android SDK 和集成了 `FedAvgAndroid`新功能的统一 "
 "`FedAvg`实现迈出的第一步。"
 
-#: ../../source/ref-changelog.md:1316
+#: ../../source/ref-changelog.md:1338
 msgid ""
 "**Make gRPC keepalive time user-configurable and decrease default "
 "keepalive time** ([#1069](https://github.com/adap/flower/pull/1069))"
@@ -24978,7 +25097,7 @@ msgstr ""
 "**使 gRPC 保持连接时间可由用户配置，并缩短默认保持连接时间** "
 "([#1069](https://github.com/adap/flower/pull/1069))"
 
-#: ../../source/ref-changelog.md:1318
+#: ../../source/ref-changelog.md:1340
 msgid ""
 "The default gRPC keepalive time has been reduced to increase the "
 "compatibility of Flower with more cloud environments (for example, "
@@ -24988,7 +25107,7 @@ msgstr ""
 "为提高 Flower 与更多云环境（如 Microsoft Azure）的兼容性，缩短了默认 gRPC 保持时间。用户可以根据具体要求配置 "
 "keepalive 时间，自定义 gRPC 堆栈。"
 
-#: ../../source/ref-changelog.md:1320
+#: ../../source/ref-changelog.md:1342
 msgid ""
 "**New differential privacy example using Opacus and PyTorch** "
 "([#805](https://github.com/adap/flower/pull/805))"
@@ -24996,13 +25115,13 @@ msgstr ""
 "**使用 Opacus 和 PyTorch 的新差分隐私示例** "
 "([#805](https://github.com/adap/flower/pull/805))"
 
-#: ../../source/ref-changelog.md:1322
+#: ../../source/ref-changelog.md:1344
 msgid ""
 "A new code example (`opacus`) demonstrates differentially-private "
 "federated learning with Opacus, PyTorch, and Flower."
 msgstr "一个新的代码示例（\"opacus\"）演示了使用 Opacus、PyTorch 和 Flower 进行差分隐私的联邦学习。"
 
-#: ../../source/ref-changelog.md:1324
+#: ../../source/ref-changelog.md:1346
 msgid ""
 "**New Hugging Face Transformers code example** "
 "([#863](https://github.com/adap/flower/pull/863))"
@@ -25010,13 +25129,13 @@ msgstr ""
 "**新的Hugging Face Transformers代码示例** "
 "([#863](https://github.com/adap/flower/pull/863))"
 
-#: ../../source/ref-changelog.md:1326
+#: ../../source/ref-changelog.md:1348
 msgid ""
 "A new code example (`quickstart_huggingface`) demonstrates usage of "
 "Hugging Face Transformers with Flower."
 msgstr "新的代码示例(`quickstart_huggingface`)证明了结合Flower和Hugging Face Transformers的实用性。"
 
-#: ../../source/ref-changelog.md:1328
+#: ../../source/ref-changelog.md:1350
 msgid ""
 "**New MLCube code example** "
 "([#779](https://github.com/adap/flower/pull/779), "
@@ -25029,13 +25148,13 @@ msgstr ""
 "[#1065](https://github.com/adap/flower/pull/1065), "
 "[#1090](https://github.com/adap/flower/pull/1090))"
 
-#: ../../source/ref-changelog.md:1330
+#: ../../source/ref-changelog.md:1352
 msgid ""
 "A new code example (`quickstart_mlcube`) demonstrates usage of MLCube "
 "with Flower."
 msgstr "新代码示例（\"quickstart_mlcube\"）演示了 MLCube 与 Flower 的用法。"
 
-#: ../../source/ref-changelog.md:1332
+#: ../../source/ref-changelog.md:1354
 msgid ""
 "**SSL-enabled server and client** "
 "([#842](https://github.com/adap/flower/pull/842),  "
@@ -25052,14 +25171,14 @@ msgstr ""
 "[#993](https://github.com/adap/flower/pull/993), "
 "[#994](https://github.com/adap/flower/pull/994))"
 
-#: ../../source/ref-changelog.md:1334
+#: ../../source/ref-changelog.md:1356
 msgid ""
 "SSL enables secure encrypted connections between clients and servers. "
 "This release open-sources the Flower secure gRPC implementation to make "
 "encrypted communication channels accessible to all Flower users."
 msgstr "SSL 可实现客户端与服务器之间的安全加密连接。该版本开源了 Flower 安全 gRPC 实现，使所有 Flower 用户都能访问加密通信通道。"
 
-#: ../../source/ref-changelog.md:1336
+#: ../../source/ref-changelog.md:1358
 msgid ""
 "**Updated** `FedAdam` **and** `FedYogi` **strategies** "
 "([#885](https://github.com/adap/flower/pull/885), "
@@ -25069,13 +25188,13 @@ msgstr ""
 "([#885](https://github.com/adap/flower/pull/885), "
 "[#895](https://github.com/adap/flower/pull/895))"
 
-#: ../../source/ref-changelog.md:1338
+#: ../../source/ref-changelog.md:1360
 msgid ""
 "`FedAdam` and `FedAdam` match the latest version of the Adaptive "
 "Federated Optimization paper."
 msgstr "FedAdam \"和 \"FedAdam \"与最新版本的 \"自适应联邦优化 \"论文相匹配。"
 
-#: ../../source/ref-changelog.md:1340
+#: ../../source/ref-changelog.md:1362
 msgid ""
 "**Initialize** `start_simulation` **with a list of client IDs** "
 "([#860](https://github.com/adap/flower/pull/860))"
@@ -25083,7 +25202,7 @@ msgstr ""
 "**初始化** `start_simulation` **使用客户端 ID 列表** "
 "([#860](https://github.com/adap/flower/pull/860))"
 
-#: ../../source/ref-changelog.md:1342
+#: ../../source/ref-changelog.md:1364
 msgid ""
 "`start_simulation` can now be called with a list of client IDs "
 "(`clients_ids`, type: `List[str]`). Those IDs will be passed to the "
@@ -25095,7 +25214,7 @@ msgstr ""
 "`start_simulation`。每当需要初始化客户端时，这些 ID 就会被传递到 `client_fn` 中，这样就能更轻松地加载无法通过 "
 "`int` 标识符访问的数据分区。"
 
-#: ../../source/ref-changelog.md:1346
+#: ../../source/ref-changelog.md:1368
 msgid ""
 "Update `num_examples` calculation in PyTorch code examples in "
 "([#909](https://github.com/adap/flower/pull/909))"
@@ -25103,7 +25222,7 @@ msgstr ""
 "更新 PyTorch 代码示例中的 \"num_examples \"计算 "
 "([#909](https://github.com/adap/flower/pull/909))"
 
-#: ../../source/ref-changelog.md:1347
+#: ../../source/ref-changelog.md:1369
 msgid ""
 "Expose Flower version through `flwr.__version__` "
 "([#952](https://github.com/adap/flower/pull/952))"
@@ -25111,7 +25230,7 @@ msgstr ""
 "通过 `flwr.__version__` 公开 Flower 版本 "
 "([#952](https://github.com/adap/flower/pull/952))"
 
-#: ../../source/ref-changelog.md:1348
+#: ../../source/ref-changelog.md:1370
 msgid ""
 "`start_server` in `app.py` now returns a `History` object containing "
 "metrics from training ([#974](https://github.com/adap/flower/pull/974))"
@@ -25119,7 +25238,7 @@ msgstr ""
 "`app.py`中的 `start_server`现在会返回一个 `History` "
 "对象，其中包含训练中的指标（[#974](https://github.com/adap/flower/pull/974)）"
 
-#: ../../source/ref-changelog.md:1349
+#: ../../source/ref-changelog.md:1371
 msgid ""
 "Make `max_workers` (used by `ThreadPoolExecutor`) configurable "
 "([#978](https://github.com/adap/flower/pull/978))"
@@ -25127,25 +25246,25 @@ msgstr ""
 "使 `max_workers`（由 "
 "`ThreadPoolExecutor`使用）可配置（[#978](https://github.com/adap/flower/pull/978)）"
 
-#: ../../source/ref-changelog.md:1350
+#: ../../source/ref-changelog.md:1372
 msgid ""
 "Increase sleep time after server start to three seconds in all code "
 "examples ([#1086](https://github.com/adap/flower/pull/1086))"
 msgstr "在所有代码示例中，将服务器启动后的休眠时间延长至三秒（[#1086](https://github.com/adap/flower/pull/1086)）"
 
-#: ../../source/ref-changelog.md:1351
+#: ../../source/ref-changelog.md:1373
 msgid ""
 "Added a new FAQ section to the documentation "
 "([#948](https://github.com/adap/flower/pull/948))"
 msgstr "在文档中添加了新的常见问题部分 ([#948](https://github.com/adap/flower/pull/948))"
 
-#: ../../source/ref-changelog.md:1352
+#: ../../source/ref-changelog.md:1374
 msgid ""
 "And many more under-the-hood changes, library updates, documentation "
 "changes, and tooling improvements!"
 msgstr "还有更多底层更改、库更新、文档更改和工具改进！"
 
-#: ../../source/ref-changelog.md:1356
+#: ../../source/ref-changelog.md:1378
 msgid ""
 "**Removed** `flwr_example` **and** `flwr_experimental` **from release "
 "build** ([#869](https://github.com/adap/flower/pull/869))"
@@ -25153,7 +25272,7 @@ msgstr ""
 "**从发布版中删除**`flwr_example`**和**`flwr_experimental`** "
 "([#869](https://github.com/adap/flower/pull/869))"
 
-#: ../../source/ref-changelog.md:1358
+#: ../../source/ref-changelog.md:1380
 msgid ""
 "The packages `flwr_example` and `flwr_experimental` have been deprecated "
 "since Flower 0.12.0 and they are not longer included in Flower release "
@@ -25165,11 +25284,11 @@ msgstr ""
 "Flower 的发布版本中。相关的额外包（`baseline`, `examples-pytorch`, `examples-"
 "tensorflow`, `http-logger`, `ops`）现在已不再使用，并将在即将发布的版本中移除。"
 
-#: ../../source/ref-changelog.md:1360
+#: ../../source/ref-changelog.md:1382
 msgid "v0.17.0 (2021-09-24)"
 msgstr "v0.17.0 (2021-09-24)"
 
-#: ../../source/ref-changelog.md:1364
+#: ../../source/ref-changelog.md:1386
 msgid ""
 "**Experimental virtual client engine** "
 "([#781](https://github.com/adap/flower/pull/781) "
@@ -25180,7 +25299,7 @@ msgstr ""
 "[#790](https://github.com/adap/flower/pull/790) "
 "[#791](https://github.com/adap/flower/pull/791))"
 
-#: ../../source/ref-changelog.md:1366
+#: ../../source/ref-changelog.md:1388
 msgid ""
 "One of Flower's goals is to enable research at scale. This release "
 "enables a first (experimental) peek at a major new feature, codenamed the"
@@ -25193,7 +25312,7 @@ msgstr ""
 "\"的重要新功能。虚拟客户端可以在单台机器或计算集群上对大量客户端进行模拟。测试新功能的最简单方法是查看名为 "
 "\"quickstart_simulation \"和 \"simulation_pytorch \"的两个新代码示例。"
 
-#: ../../source/ref-changelog.md:1368
+#: ../../source/ref-changelog.md:1390
 msgid ""
 "The feature is still experimental, so there's no stability guarantee for "
 "the API. It's also not quite ready for prime time and comes with a few "
@@ -25203,7 +25322,7 @@ msgstr ""
 "该功能仍处于试验阶段，因此无法保证 API "
 "的稳定性。此外，它还没有完全准备好进入黄金时间，并有一些已知的注意事项。不过，我们鼓励好奇的用户尝试使用并分享他们的想法。"
 
-#: ../../source/ref-changelog.md:1370
+#: ../../source/ref-changelog.md:1392
 msgid ""
 "**New built-in strategies** "
 "([#828](https://github.com/adap/flower/pull/828) "
@@ -25212,19 +25331,19 @@ msgstr ""
 "**新的内置策略**（[#828](https://github.com/adap/flower/pull/828) "
 "[#822](https://github.com/adap/flower/pull/822)"
 
-#: ../../source/ref-changelog.md:1372
+#: ../../source/ref-changelog.md:1394
 msgid ""
 "FedYogi - Federated learning strategy using Yogi on server-side. "
 "Implementation based on https://arxiv.org/abs/2003.00295"
 msgstr "FedYogi - 在服务器端使用 Yogi 的联邦学习策略。基于 https://arxiv.org/abs/2003.00295 实现"
 
-#: ../../source/ref-changelog.md:1373
+#: ../../source/ref-changelog.md:1395
 msgid ""
 "FedAdam - Federated learning strategy using Adam on server-side. "
 "Implementation based on https://arxiv.org/abs/2003.00295"
 msgstr "FedAdam - 在服务器端使用 Adam 的联邦学习策略。基于 https://arxiv.org/abs/2003.00295 实现"
 
-#: ../../source/ref-changelog.md:1375
+#: ../../source/ref-changelog.md:1397
 msgid ""
 "**New PyTorch Lightning code example** "
 "([#617](https://github.com/adap/flower/pull/617))"
@@ -25232,31 +25351,31 @@ msgstr ""
 "**新的 PyTorch Lightning 代码示例** "
 "([#617](https://github.com/adap/flower/pull/617))"
 
-#: ../../source/ref-changelog.md:1377
+#: ../../source/ref-changelog.md:1399
 msgid ""
 "**New Variational Auto-Encoder code example** "
 "([#752](https://github.com/adap/flower/pull/752))"
 msgstr "**新的变分自动编码器代码示例** ([#752](https://github.com/adap/flower/pull/752))"
 
-#: ../../source/ref-changelog.md:1379
+#: ../../source/ref-changelog.md:1401
 msgid ""
 "**New scikit-learn code example** "
 "([#748](https://github.com/adap/flower/pull/748))"
 msgstr "**新的 scikit-learn 代码示例** ([#748](https://github.com/adap/flower/pull/748))"
 
-#: ../../source/ref-changelog.md:1381
+#: ../../source/ref-changelog.md:1403
 msgid ""
 "**New experimental TensorBoard strategy** "
 "([#789](https://github.com/adap/flower/pull/789))"
 msgstr "**新的实验性 TensorBoard 策略**（[#789](https://github.com/adap/flower/pull/789)）"
 
-#: ../../source/ref-changelog.md:1385
+#: ../../source/ref-changelog.md:1407
 msgid ""
 "Improved advanced TensorFlow code example "
 "([#769](https://github.com/adap/flower/pull/769))"
 msgstr "改进的高级 TensorFlow 代码示例（[#769](https://github.com/adap/flower/pull/769)"
 
-#: ../../source/ref-changelog.md:1386
+#: ../../source/ref-changelog.md:1408
 msgid ""
 "Warning when `min_available_clients` is misconfigured "
 "([#830](https://github.com/adap/flower/pull/830))"
@@ -25264,31 +25383,31 @@ msgstr ""
 "当 `min_available_clients` 配置错误时发出警告 "
 "([#830](https://github.com/adap/flower/pull/830))"
 
-#: ../../source/ref-changelog.md:1387
+#: ../../source/ref-changelog.md:1409
 msgid ""
 "Improved gRPC server docs "
 "([#841](https://github.com/adap/flower/pull/841))"
 msgstr "改进了 gRPC 服务器文档（[#841](https://github.com/adap/flower/pull/841)）"
 
-#: ../../source/ref-changelog.md:1388
+#: ../../source/ref-changelog.md:1410
 msgid ""
 "Improved error message in `NumPyClient` "
 "([#851](https://github.com/adap/flower/pull/851))"
 msgstr "改进了 `NumPyClient` 中的错误信息 ([#851](https://github.com/adap/flower/pull/851))"
 
-#: ../../source/ref-changelog.md:1389
+#: ../../source/ref-changelog.md:1411
 msgid ""
 "Improved PyTorch quickstart code example "
 "([#852](https://github.com/adap/flower/pull/852))"
 msgstr "改进的 PyTorch 快速启动代码示例 ([#852](https://github.com/adap/flower/pull/852))"
 
-#: ../../source/ref-changelog.md:1393
+#: ../../source/ref-changelog.md:1415
 msgid ""
 "**Disabled final distributed evaluation** "
 "([#800](https://github.com/adap/flower/pull/800))"
 msgstr "**禁用最终分布式评价** ([#800](https://github.com/adap/flower/pull/800))"
 
-#: ../../source/ref-changelog.md:1395
+#: ../../source/ref-changelog.md:1417
 msgid ""
 "Prior behaviour was to perform a final round of distributed evaluation on"
 " all connected clients, which is often not required (e.g., when using "
@@ -25298,13 +25417,13 @@ msgstr ""
 "之前的行为是在所有连接的客户端上执行最后一轮分布式评估，而这通常是不需要的（例如，在使用服务器端评估时）。可以通过向 `start_server`"
 " 传递 `force_final_distributed_eval=True` 来启用之前的行为。"
 
-#: ../../source/ref-changelog.md:1397
+#: ../../source/ref-changelog.md:1419
 msgid ""
 "**Renamed q-FedAvg strategy** "
 "([#802](https://github.com/adap/flower/pull/802))"
 msgstr "**更名为 q-FedAvg 策略** ([#802](https://github.com/adap/flower/pull/802))"
 
-#: ../../source/ref-changelog.md:1399
+#: ../../source/ref-changelog.md:1421
 msgid ""
 "The strategy named `QffedAvg` was renamed to `QFedAvg` to better reflect "
 "the notation given in the original paper (q-FFL is the optimization "
@@ -25315,7 +25434,7 @@ msgstr ""
 "名为 `QffedAvg` 的策略已更名为 `QFedAvg`，以更好地反映原始论文中给出的符号（q-FFL 是优化目标，q-FedAvg "
 "是建议的求解器）。请注意，出于兼容性原因，原始（现已废弃）的 `QffedAvg` 类仍然可用（它将在未来的版本中移除）。"
 
-#: ../../source/ref-changelog.md:1401
+#: ../../source/ref-changelog.md:1423
 msgid ""
 "**Deprecated and renamed code example** `simulation_pytorch` **to** "
 "`simulation_pytorch_legacy` "
@@ -25324,7 +25443,7 @@ msgstr ""
 "**删除并重命名代码示例**`simulation_pytorch`**为**`simulation_pytorch_legacy` "
 "([#791](https://github.com/adap/flower/pull/791))"
 
-#: ../../source/ref-changelog.md:1403
+#: ../../source/ref-changelog.md:1425
 msgid ""
 "This example has been replaced by a new example. The new example is based"
 " on the experimental virtual client engine, which will become the new "
@@ -25335,27 +25454,27 @@ msgstr ""
 "该示例已被新示例取代。新示例基于试验性虚拟客户端引擎，它将成为在 Flower "
 "中进行大多数类型大规模模拟的新的默认方式。现有示例将作为参考保留，但将来可能会删除。"
 
-#: ../../source/ref-changelog.md:1405
+#: ../../source/ref-changelog.md:1427
 msgid "v0.16.0 (2021-05-11)"
 msgstr "v0.16.0 (2021-05-11)"
 
-#: ../../source/ref-changelog.md:1409
+#: ../../source/ref-changelog.md:1431
 msgid ""
 "**New built-in strategies** "
 "([#549](https://github.com/adap/flower/pull/549))"
 msgstr "**新的内置策略** ([#549](https://github.com/adap/flower/pull/549))"
 
-#: ../../source/ref-changelog.md:1411
+#: ../../source/ref-changelog.md:1433
 msgid "(abstract) FedOpt"
 msgstr "（摘要） FedOpt"
 
-#: ../../source/ref-changelog.md:1414
+#: ../../source/ref-changelog.md:1436
 msgid ""
 "**Custom metrics for server and strategies** "
 "([#717](https://github.com/adap/flower/pull/717))"
 msgstr "**服务器和策略的自定义指标** ([#717](https://github.com/adap/flower/pull/717))"
 
-#: ../../source/ref-changelog.md:1416
+#: ../../source/ref-changelog.md:1438
 msgid ""
 "The Flower server is now fully task-agnostic, all remaining instances of "
 "task-specific metrics (such as `accuracy`) have been replaced by custom "
@@ -25366,7 +25485,7 @@ msgstr ""
 "Flower 服务器现在完全与任务无关，所有剩余的任务特定度量（如 \"准确度\"）都已被自定义度量字典取代。Flower 0.15 "
 "引入了从客户端向服务器传递包含自定义指标的字典的功能。从本版本开始，自定义指标将取代服务器上的特定任务指标。"
 
-#: ../../source/ref-changelog.md:1418
+#: ../../source/ref-changelog.md:1440
 msgid ""
 "Custom metric dictionaries are now used in two user-facing APIs: they are"
 " returned from Strategy methods `aggregate_fit`/`aggregate_evaluate` and "
@@ -25379,7 +25498,7 @@ msgstr ""
 "返回，还可使传递给内置策略（通过 `eval_fn`）的评估函数返回两个以上的评估度量。策略甚至可以返回 *aggregated* "
 "指标字典，以便服务器跟踪。"
 
-#: ../../source/ref-changelog.md:1420
+#: ../../source/ref-changelog.md:1442
 msgid ""
 "Strategy implementations should migrate their `aggregate_fit` and "
 "`aggregate_evaluate` methods to the new return type (e.g., by simply "
@@ -25390,19 +25509,19 @@ msgstr ""
 "方法迁移到新的返回类型（例如，只需返回空的 `{}`），服务器端评估函数应从 `return loss, accuracy` 迁移到 "
 "`return loss, {\"accuracy\": accuracy}`。"
 
-#: ../../source/ref-changelog.md:1422
+#: ../../source/ref-changelog.md:1444
 msgid ""
 "Flower 0.15-style return types are deprecated (but still supported), "
 "compatibility will be removed in a future release."
 msgstr "Flower 0.15 风格的返回类型已被弃用（但仍受支持），兼容性将在未来的版本中移除。"
 
-#: ../../source/ref-changelog.md:1424
+#: ../../source/ref-changelog.md:1446
 msgid ""
 "**Migration warnings for deprecated functionality** "
 "([#690](https://github.com/adap/flower/pull/690))"
 msgstr "** 过时功能的迁移警告** ([#690](https://github.com/adap/flower/pull/690))"
 
-#: ../../source/ref-changelog.md:1426
+#: ../../source/ref-changelog.md:1448
 msgid ""
 "Earlier versions of Flower were often migrated to new APIs, while "
 "maintaining compatibility with legacy APIs. This release introduces "
@@ -25413,7 +25532,7 @@ msgstr ""
 "Flower 早期版本通常会迁移到新的应用程序接口，同时保持与旧版应用程序接口的兼容。如果检测到使用了过时的 "
 "API，本版本将引入详细的警告信息。新的警告信息通常会详细说明如何迁移到更新的 API，从而简化从一个版本到另一个版本的过渡。"
 
-#: ../../source/ref-changelog.md:1428
+#: ../../source/ref-changelog.md:1450
 msgid ""
 "Improved docs and docstrings "
 "([#691](https://github.com/adap/flower/pull/691) "
@@ -25424,11 +25543,11 @@ msgstr ""
 "[#692](https://github.com/adap/flower/pull/692) "
 "[#713](https://github.com/adap/flower/pull/713))"
 
-#: ../../source/ref-changelog.md:1430
+#: ../../source/ref-changelog.md:1452
 msgid "MXNet example and documentation"
 msgstr "MXNet 示例和文档"
 
-#: ../../source/ref-changelog.md:1432
+#: ../../source/ref-changelog.md:1454
 msgid ""
 "FedBN implementation in example PyTorch: From Centralized To Federated "
 "([#696](https://github.com/adap/flower/pull/696) "
@@ -25440,13 +25559,13 @@ msgstr ""
 "[#702](https://github.com/adap/flower/pull/702) "
 "[#705](https://github.com/adap/flower/pull/705))"
 
-#: ../../source/ref-changelog.md:1436
+#: ../../source/ref-changelog.md:1458
 msgid ""
 "**Serialization-agnostic server** "
 "([#721](https://github.com/adap/flower/pull/721))"
 msgstr "**序列化无关服务器** ([#721](https://github.com/adap/flower/pull/721))"
 
-#: ../../source/ref-changelog.md:1438
+#: ../../source/ref-changelog.md:1460
 msgid ""
 "The Flower server is now fully serialization-agnostic. Prior usage of "
 "class `Weights` (which represents parameters as deserialized NumPy "
@@ -25460,7 +25579,7 @@ msgstr ""
 "`Parameters` 类取代（例如在 `Strategy`中）。参数 "
 "\"对象与序列化完全无关，它以字节数组的形式表示参数，\"tensor_type \"属性表示如何解释这些字节数组（例如，用于序列化/反序列化）。"
 
-#: ../../source/ref-changelog.md:1440
+#: ../../source/ref-changelog.md:1462
 msgid ""
 "Built-in strategies implement this approach by handling serialization and"
 " deserialization to/from `Weights` internally. Custom/3rd-party Strategy "
@@ -25472,7 +25591,7 @@ msgstr ""
 "内置策略通过在内部处理序列化和反序列化到/从`Weights`来实现这种方法。自定义/第三方策略实现应更新为稍有改动的策略方法定义。策略作者可查阅"
 " PR [#721](https://github.com/adap/flower/pull/721) 以了解如何将策略轻松迁移到新格式。"
 
-#: ../../source/ref-changelog.md:1442
+#: ../../source/ref-changelog.md:1464
 msgid ""
 "Deprecated `flwr.server.Server.evaluate`, use "
 "`flwr.server.Server.evaluate_round` instead "
@@ -25481,17 +25600,17 @@ msgstr ""
 "已弃用 `flwr.server.Server.evaluate`，改用 "
 "`flwr.server.Server.evaluate_round`（[#717](https://github.com/adap/flower/pull/717)"
 
-#: ../../source/ref-changelog.md:1444
+#: ../../source/ref-changelog.md:1466
 msgid "v0.15.0 (2021-03-12)"
 msgstr "v0.15.0 (2021-03-12)"
 
-#: ../../source/ref-changelog.md:1448
+#: ../../source/ref-changelog.md:1470
 msgid ""
 "**Server-side parameter initialization** "
 "([#658](https://github.com/adap/flower/pull/658))"
 msgstr "**服务器端参数初始化** ([#658](https://github.com/adap/flower/pull/658))"
 
-#: ../../source/ref-changelog.md:1450
+#: ../../source/ref-changelog.md:1472
 msgid ""
 "Model parameters can now be initialized on the server-side. Server-side "
 "parameter initialization works via a new `Strategy` method called "
@@ -25500,7 +25619,7 @@ msgstr ""
 "现在可以在服务器端初始化模型参数。服务器端参数初始化通过名为 \"initialize_parameters \"的新 \"Strategy "
 "\"方法进行。"
 
-#: ../../source/ref-changelog.md:1452
+#: ../../source/ref-changelog.md:1474
 msgid ""
 "Built-in strategies support a new constructor argument called "
 "`initial_parameters` to set the initial parameters. Built-in strategies "
@@ -25510,7 +25629,7 @@ msgstr ""
 "内置策略支持名为 \"initial_parameters "
 "\"的新构造函数参数，用于设置初始参数。内置策略会在启动时向服务器提供这些初始参数，然后删除它们以释放内存。"
 
-#: ../../source/ref-changelog.md:1471
+#: ../../source/ref-changelog.md:1493
 msgid ""
 "If no initial parameters are provided to the strategy, the server will "
 "continue to use the current behaviour (namely, it will ask one of the "
@@ -25518,7 +25637,7 @@ msgid ""
 "parameters)."
 msgstr "如果没有向策略提供初始参数，服务器将继续使用当前行为（即向其中一个已连接的客户端询问参数，并将这些参数用作初始全局参数）。"
 
-#: ../../source/ref-changelog.md:1475
+#: ../../source/ref-changelog.md:1497
 msgid ""
 "Deprecate `flwr.server.strategy.DefaultStrategy` (migrate to "
 "`flwr.server.strategy.FedAvg`, which is equivalent)"
@@ -25526,11 +25645,11 @@ msgstr ""
 "停用 `flwr.server.strategy.DefaultStrategy`（迁移到等价的 "
 "`flwr.server.strategy.FedAvg`）"
 
-#: ../../source/ref-changelog.md:1477
+#: ../../source/ref-changelog.md:1499
 msgid "v0.14.0 (2021-02-18)"
 msgstr "v0.14.0 (2021-02-18)"
 
-#: ../../source/ref-changelog.md:1481
+#: ../../source/ref-changelog.md:1503
 msgid ""
 "**Generalized** `Client.fit` **and** `Client.evaluate` **return values** "
 "([#610](https://github.com/adap/flower/pull/610) "
@@ -25542,7 +25661,7 @@ msgstr ""
 "[#572](https://github.com/adap/flower/pull/572) "
 "[#633](https://github.com/adap/flower/pull/633))"
 
-#: ../../source/ref-changelog.md:1483
+#: ../../source/ref-changelog.md:1505
 msgid ""
 "Clients can now return an additional dictionary mapping `str` keys to "
 "values of the following types: `bool`, `bytes`, `float`, `int`, `str`. "
@@ -25553,7 +25672,7 @@ msgstr ""
 "bool`、`bytes`、`float`、`int`、`str`。这意味着我们可以从 `fit`/`evaluate` "
 "返回几乎任意的值，并在服务器端使用它们！"
 
-#: ../../source/ref-changelog.md:1485
+#: ../../source/ref-changelog.md:1507
 msgid ""
 "This improvement also allowed for more consistent return types between "
 "`fit` and `evaluate`: `evaluate` should now return a tuple `(float, int, "
@@ -25563,7 +25682,7 @@ msgstr ""
 "这一改进还使 `fit` 和 `evaluate` 之间的返回类型更加一致：`evaluate` 现在应返回一个元组`(float, int, "
 "dict)`，代表损失、示例数和一个包含特定问题任意值（如准确度）的字典。"
 
-#: ../../source/ref-changelog.md:1487
+#: ../../source/ref-changelog.md:1509
 msgid ""
 "In case you wondered: this feature is compatible with existing projects, "
 "the additional dictionary return value is optional. New code should "
@@ -25576,13 +25695,13 @@ msgstr ""
 "版本兼容（`fit`: `List[np.ndarray], int, Dict[str, Scalar]`，`evaluate`: "
 "`float, int, Dict[str, Scalar]`）。详见下面的示例。"
 
-#: ../../source/ref-changelog.md:1489
+#: ../../source/ref-changelog.md:1511
 msgid ""
 "*Code example:* note the additional dictionary return values in both "
 "`FlwrClient.fit` and `FlwrClient.evaluate`:"
 msgstr "*代码示例：* 注意 `FlwrClient.fit` 和 `FlwrClient.evaluate` 中的附加字典返回值："
 
-#: ../../source/ref-changelog.md:1504
+#: ../../source/ref-changelog.md:1526
 msgid ""
 "**Generalized** `config` **argument in** `Client.fit` **and** "
 "`Client.evaluate` ([#595](https://github.com/adap/flower/pull/595))"
@@ -25590,7 +25709,7 @@ msgstr ""
 "**在**`Client.fit` "
 "**和**`Client.evaluate`中泛化**`config`参数（[#595](https://github.com/adap/flower/pull/595)）"
 
-#: ../../source/ref-changelog.md:1506
+#: ../../source/ref-changelog.md:1528
 msgid ""
 "The `config` argument used to be of type `Dict[str, str]`, which means "
 "that dictionary values were expected to be strings. The new release "
@@ -25600,7 +25719,7 @@ msgstr ""
 "`config`参数曾是 \"字典[str, str]\"类型，这意味着字典值应是字符串。新版本将其扩展为以下类型的值： "
 "bool`、`bytes`、`float`、`int`、`str`。"
 
-#: ../../source/ref-changelog.md:1508
+#: ../../source/ref-changelog.md:1530
 msgid ""
 "This means one can now pass almost arbitrary values to `fit`/`evaluate` "
 "using the `config` dictionary. Yay, no more `str(epochs)` on the server-"
@@ -25609,51 +25728,51 @@ msgstr ""
 "这意味着现在可以使用 `config` 字典向 `fit`/`evaluate` 传递几乎任意的值。耶，服务器端不再需要 "
 "`str(epochs)`，客户端不再需要 `int(config[\"epochs\"])`！"
 
-#: ../../source/ref-changelog.md:1510
+#: ../../source/ref-changelog.md:1532
 msgid ""
 "*Code example:* note that the `config` dictionary now contains non-`str` "
 "values in both `Client.fit` and `Client.evaluate`:"
 msgstr "*代码示例：* 注意 `config` 字典现在在 `Client.fit` 和 `Client.evaluate` 中都包含非 `str` 值："
 
-#: ../../source/ref-changelog.md:1527
+#: ../../source/ref-changelog.md:1549
 msgid "v0.13.0 (2021-01-08)"
 msgstr "v0.13.0 (2021-01-08)"
 
-#: ../../source/ref-changelog.md:1531
+#: ../../source/ref-changelog.md:1553
 msgid ""
 "New example: PyTorch From Centralized To Federated "
 "([#549](https://github.com/adap/flower/pull/549))"
 msgstr "新示例： PyTorch 从集中到联邦 ([#549](https://github.com/adap/flower/pull/549))"
 
-#: ../../source/ref-changelog.md:1532
+#: ../../source/ref-changelog.md:1554
 msgid "Improved documentation"
 msgstr "改进文档"
 
-#: ../../source/ref-changelog.md:1533
+#: ../../source/ref-changelog.md:1555
 msgid "New documentation theme ([#551](https://github.com/adap/flower/pull/551))"
 msgstr "新文档主题 ([#551](https://github.com/adap/flower/pull/551))"
 
-#: ../../source/ref-changelog.md:1534
+#: ../../source/ref-changelog.md:1556
 msgid "New API reference ([#554](https://github.com/adap/flower/pull/554))"
 msgstr "新的 API 参考 ([#554](https://github.com/adap/flower/pull/554))"
 
-#: ../../source/ref-changelog.md:1535
+#: ../../source/ref-changelog.md:1557
 msgid ""
 "Updated examples documentation "
 "([#549](https://github.com/adap/flower/pull/549))"
 msgstr "更新了示例文档 ([#549](https://github.com/adap/flower/pull/549))"
 
-#: ../../source/ref-changelog.md:1536
+#: ../../source/ref-changelog.md:1558
 msgid ""
 "Removed obsolete documentation "
 "([#548](https://github.com/adap/flower/pull/548))"
 msgstr "删除了过时的文档 ([#548](https://github.com/adap/flower/pull/548))"
 
-#: ../../source/ref-changelog.md:1538
+#: ../../source/ref-changelog.md:1560
 msgid "Bugfix:"
 msgstr "错误修正："
 
-#: ../../source/ref-changelog.md:1540
+#: ../../source/ref-changelog.md:1562
 msgid ""
 "`Server.fit` does not disconnect clients when finished, disconnecting the"
 " clients is now handled in `flwr.server.start_server` "
@@ -25664,21 +25783,21 @@ msgstr ""
 "\"中处理的（[#553](https://github.com/adap/flower/pull/553) "
 "[#540](https://github.com/adap/flower/issues/540)）。"
 
-#: ../../source/ref-changelog.md:1542
+#: ../../source/ref-changelog.md:1564
 msgid "v0.12.0 (2020-12-07)"
 msgstr "v0.12.0 (2020-12-07)"
 
-#: ../../source/ref-changelog.md:1544 ../../source/ref-changelog.md:1560
+#: ../../source/ref-changelog.md:1566 ../../source/ref-changelog.md:1582
 msgid "Important changes:"
 msgstr "重要变更："
 
-#: ../../source/ref-changelog.md:1546
+#: ../../source/ref-changelog.md:1568
 msgid ""
 "Added an example for embedded devices "
 "([#507](https://github.com/adap/flower/pull/507))"
 msgstr "添加了嵌入式设备示例 ([#507](https://github.com/adap/flower/pull/507))"
 
-#: ../../source/ref-changelog.md:1547
+#: ../../source/ref-changelog.md:1569
 msgid ""
 "Added a new NumPyClient (in addition to the existing KerasClient) "
 "([#504](https://github.com/adap/flower/pull/504) "
@@ -25688,7 +25807,7 @@ msgstr ""
 "之外）（[#504](https://github.com/adap/flower/pull/504) "
 "[#508](https://github.com/adap/flower/pull/508)"
 
-#: ../../source/ref-changelog.md:1548
+#: ../../source/ref-changelog.md:1570
 msgid ""
 "Deprecated `flwr_example` package and started to migrate examples into "
 "the top-level `examples` directory "
@@ -25699,15 +25818,15 @@ msgstr ""
 "([#494](https://github.com/adap/flower/pull/494) "
 "[#512](https://github.com/adap/flower/pull/512))"
 
-#: ../../source/ref-changelog.md:1550
+#: ../../source/ref-changelog.md:1572
 msgid "v0.11.0 (2020-11-30)"
 msgstr "v0.11.0 (2020-11-30)"
 
-#: ../../source/ref-changelog.md:1552
+#: ../../source/ref-changelog.md:1574
 msgid "Incompatible changes:"
 msgstr "不兼容的更改："
 
-#: ../../source/ref-changelog.md:1554
+#: ../../source/ref-changelog.md:1576
 msgid ""
 "Renamed strategy methods "
 "([#486](https://github.com/adap/flower/pull/486)) to unify the naming of "
@@ -25720,23 +25839,23 @@ msgstr ""
 "API 的命名。其他公共方法/函数（例如 `Client` 中的每个方法，以及 `Strategy.evaluate`）不使用 `on_` "
 "前缀，这就是我们从 Strategy 中的四个方法中移除它的原因。迁移时，请相应地重命名以下 `Strategy` 方法："
 
-#: ../../source/ref-changelog.md:1555
+#: ../../source/ref-changelog.md:1577
 msgid "`on_configure_evaluate` => `configure_evaluate`"
 msgstr "`on_configure_evaluate` => `configure_evaluate`"
 
-#: ../../source/ref-changelog.md:1556
+#: ../../source/ref-changelog.md:1578
 msgid "`on_aggregate_evaluate` => `aggregate_evaluate`"
 msgstr "`on_aggregate_evaluate` => `aggregate_evaluate`"
 
-#: ../../source/ref-changelog.md:1557
+#: ../../source/ref-changelog.md:1579
 msgid "`on_configure_fit` => `configure_fit`"
 msgstr "`on_configure_fit` => `configure_fit`"
 
-#: ../../source/ref-changelog.md:1558
+#: ../../source/ref-changelog.md:1580
 msgid "`on_aggregate_fit` => `aggregate_fit`"
 msgstr "`on_aggregate_fit` => `aggregate_fit`"
 
-#: ../../source/ref-changelog.md:1562
+#: ../../source/ref-changelog.md:1584
 msgid ""
 "Deprecated `DefaultStrategy` "
 "([#479](https://github.com/adap/flower/pull/479)). To migrate use "
@@ -25745,13 +25864,13 @@ msgstr ""
 "已废弃的 `DefaultStrategy` ([#479](https://github.com/adap/flower/pull/479)) "
 "。迁移时请使用 `FedAvg`。"
 
-#: ../../source/ref-changelog.md:1563
+#: ../../source/ref-changelog.md:1585
 msgid ""
 "Simplified examples and baselines "
 "([#484](https://github.com/adap/flower/pull/484))."
 msgstr "简化示例和baselines（[#484](https://github.com/adap/flower/pull/484)）。"
 
-#: ../../source/ref-changelog.md:1564
+#: ../../source/ref-changelog.md:1586
 msgid ""
 "Removed presently unused `on_conclude_round` from strategy interface "
 "([#483](https://github.com/adap/flower/pull/483))."
@@ -25759,7 +25878,7 @@ msgstr ""
 "删除了策略界面中目前未使用的 "
 "\"on_conclude_round\"（[#483](https://github.com/adap/flower/pull/483)）。"
 
-#: ../../source/ref-changelog.md:1565
+#: ../../source/ref-changelog.md:1587
 msgid ""
 "Set minimal Python version to 3.6.1 instead of 3.6.9 "
 "([#471](https://github.com/adap/flower/pull/471))."
@@ -25767,7 +25886,7 @@ msgstr ""
 "将最小 Python 版本设为 3.6.1，而不是 3.6.9 "
 "([#471](https://github.com/adap/flower/pull/471))."
 
-#: ../../source/ref-changelog.md:1566
+#: ../../source/ref-changelog.md:1588
 msgid ""
 "Improved `Strategy` docstrings "
 "([#470](https://github.com/adap/flower/pull/470))."
@@ -29685,7 +29804,7 @@ msgid ""
 msgstr "在机器学习中，我们有一个模型和数据。模型可以是一个神经网络（如图所示），也可以是其他东西，比如经典的线性回归。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:41
-msgid "|cf5fe148406b44b9a8b842fb01b5a7ea|"
+msgid "|f150b8d6e0074250822c9f6f7a8de3e0|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:109
@@ -29700,7 +29819,7 @@ msgid ""
 msgstr "我们使用数据来训练模型，以完成一项有用的任务。任务可以是检测图像中的物体、转录音频或玩围棋等游戏。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:53
-msgid "|ba25c91426d64cc1ae2d3febc5715b35|"
+msgid "|72772d10debc4abd8373c0bc82985422|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:111
@@ -29724,7 +29843,7 @@ msgid ""
 msgstr "它源于智能手机上用户与应用程序的交互、汽车上传感器数据的收集、笔记本电脑上键盘输入的接收，或者智能扬声器上某人试着唱的歌。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:67
-msgid "|fca67f83aaab4389aa9ebb4d9c5cd75e|"
+msgid "|5815398552ad41d290a3a2631fe8f6ca|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:113
@@ -29742,7 +29861,7 @@ msgstr ""
 "\"通常不只是一个地方，而是很多地方。它可能是多个运行同一应用程序的设备。但也可能是多个组织，都在为同一任务生成数据。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:79
-msgid "|6f2e8f95c95443379b0df00ca9824654|"
+msgid "|e6ac20744bf149378be20ac3dc309356|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:115
@@ -29759,7 +29878,7 @@ msgid ""
 msgstr "因此，要使用机器学习或任何类型的数据分析，过去使用的方法是在中央服务器上收集所有数据。这个服务器可以在数据中心的某个地方，也可以在云端的某个地方。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:91
-msgid "|c0ab3a1a733d4dbc9e1677aa608e8038|"
+msgid "|a4011ef443c14725b15a8cf33b0e3443|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:117
@@ -29774,7 +29893,7 @@ msgid ""
 msgstr "一旦所有数据都收集到一处，我们最终就可以使用机器学习算法在数据上训练我们的模型。这就是我们基本上一直依赖的机器学习方法。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:103
-msgid "|8f0491bde07341ab9f2e23d50593c0be|"
+msgid "|a22faa3617404c06803731525e1c609f|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:119
@@ -29795,7 +29914,7 @@ msgid ""
 msgstr "我们刚刚看到的经典机器学习方法可以在某些情况下使用。很好的例子包括对假日照片进行分类或分析网络流量。在这些案例中，所有数据自然都可以在中央服务器上获得。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:138
-msgid "|762fc099899943688361562252c5e600|"
+msgid "|84a5c9b5041c43c3beab9786197c3e4e|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:173
@@ -29810,7 +29929,7 @@ msgid ""
 msgstr "但这种方法并不适用于许多其他情况。例如，集中服务器上没有数据，或者一台服务器上的数据不足以训练出一个好的模型。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:150
-msgid "|f62d365fd0ae405b975d3ca01e7183fd|"
+msgid "|b5c4be0b52d4493ba8c4af14d7c2db97|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:175
@@ -29970,7 +30089,7 @@ msgid ""
 msgstr "我们首先在服务器上初始化模型。这与经典的集中式学习完全相同：我们随机或从先前保存的检查点初始化模型参数。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:210
-msgid "|2c78fc1816b143289f4d909388f92a80|"
+msgid "|c1c784183d18481186ff65dc261d1335|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:307
@@ -29995,7 +30114,7 @@ msgid ""
 msgstr "接下来，我们会将全局模型的参数发送到连接的客户端节点（如智能手机等边缘设备或企业的服务器）。这是为了确保每个参与节点都使用相同的模型参数开始本地训练。我们通常只使用几个连接节点，而不是所有节点。这样做的原因是，选择越来越多的客户端节点会导致收益递减。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:225
-msgid "|4230725aeebe497d8ad84a3efc2a912b|"
+msgid "|669fcd1f44ab42f5bbd196c3cf1ecbc2|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:309
@@ -30021,7 +30140,7 @@ msgstr ""
 "（mini-batches）。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:240
-msgid "|64b66a88417240eabe52f5cc55d89d0b|"
+msgid "|edfb08758c9441afb6736045a59e154c|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:311
@@ -30044,7 +30163,7 @@ msgid ""
 msgstr "经过本地训练后，每个客户节点最初收到的模型参数都会略有不同。参数之所以不同，是因为每个客户端节点的本地数据集中都有不同的数据。然后，客户端节点将这些模型更新发回服务器。它们发送的模型更新既可以是完整的模型参数，也可以只是本地训练过程中积累的梯度。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:255
-msgid "|726c8eca58bc4f859b06aa24a587b253|"
+msgid "|82338b8bbad24d5ea9df3801aab37852|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:313
@@ -30091,7 +30210,7 @@ msgstr ""
 " 100 个示例的 10 倍。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:273
-msgid "|f9d869e4b33c4093b29cf24ed8dff80a|"
+msgid "|518d994dd2c844898b441da03b858326|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:315
@@ -30199,7 +30318,7 @@ msgstr ""
 "为联邦学习、分析和评估提供了一种统一的方法。它允许用户联邦化任何工作负载、任何 ML 框架和任何编程语言。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:334
-msgid "|4ab50bc01a9f426a91a2c0cbc3ab7a84|"
+msgid "|7bfcfcb57ae5403f8e18486f45ca48b4|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:340
@@ -32512,7 +32631,7 @@ msgstr ""
 #~ msgstr "Flower 服务器。"
 
 #~ msgid "Unreleased"
-#~ msgstr "尚未发布"
+#~ msgstr "版本发布"
 
 #~ msgid "|d8bf04f23d9b46d8a23cc6f4887d7873|"
 #~ msgstr "|d8bf04f23d9b46d8a23cc6f4887d7873|"
@@ -37605,3 +37724,48 @@ msgstr ""
 #~ msgid "|dd4434075f374e99ac07f509a883778f|"
 #~ msgstr ""
 
+#~ msgid "Other changes"
+#~ msgstr "不兼容的更改"
+
+#~ msgid "|cf5fe148406b44b9a8b842fb01b5a7ea|"
+#~ msgstr ""
+
+#~ msgid "|ba25c91426d64cc1ae2d3febc5715b35|"
+#~ msgstr ""
+
+#~ msgid "|fca67f83aaab4389aa9ebb4d9c5cd75e|"
+#~ msgstr ""
+
+#~ msgid "|6f2e8f95c95443379b0df00ca9824654|"
+#~ msgstr ""
+
+#~ msgid "|c0ab3a1a733d4dbc9e1677aa608e8038|"
+#~ msgstr ""
+
+#~ msgid "|8f0491bde07341ab9f2e23d50593c0be|"
+#~ msgstr ""
+
+#~ msgid "|762fc099899943688361562252c5e600|"
+#~ msgstr ""
+
+#~ msgid "|f62d365fd0ae405b975d3ca01e7183fd|"
+#~ msgstr ""
+
+#~ msgid "|2c78fc1816b143289f4d909388f92a80|"
+#~ msgstr ""
+
+#~ msgid "|4230725aeebe497d8ad84a3efc2a912b|"
+#~ msgstr ""
+
+#~ msgid "|64b66a88417240eabe52f5cc55d89d0b|"
+#~ msgstr ""
+
+#~ msgid "|726c8eca58bc4f859b06aa24a587b253|"
+#~ msgstr ""
+
+#~ msgid "|f9d869e4b33c4093b29cf24ed8dff80a|"
+#~ msgstr ""
+
+#~ msgid "|4ab50bc01a9f426a91a2c0cbc3ab7a84|"
+#~ msgstr ""
+

From 9d6e656001db14634f4791a10d7a93020098ea86 Mon Sep 17 00:00:00 2001
From: Yan Gao <y.gaogy@gmail.com>
Date: Thu, 28 Nov 2024 20:44:55 +0800
Subject: [PATCH 003/104] fix(benchmarks) Update llm leaderboard readme (#4597)

---
 benchmarks/flowertune-llm/README.md | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/benchmarks/flowertune-llm/README.md b/benchmarks/flowertune-llm/README.md
index 662134a0e44d..c3e1b2b7dd53 100644
--- a/benchmarks/flowertune-llm/README.md
+++ b/benchmarks/flowertune-llm/README.md
@@ -16,8 +16,7 @@ Then, create a new Python environment and install Flower.
 > We recommend using `pyenv` with the `virtualenv` plugin to create your environment with Python >= 3.10.0. Other managers, such as Conda, will likely work as well. Check the [documentation](https://flower.ai/docs/framework/how-to-install-flower.html) for alternative ways to install Flower.
 
 ```shell
-# We use this dev version until flwr 1.13.0 is out
-pip install git+https://github.com/adap/flower.git@d92453d
+pip install flwr
 ```
 
 In the new environment, create a new Flower project using the `FlowerTune` template. You will be prompted for a name to give to your app/project, your username, and for your choice of LLM challenge:

From 79c9f47e4693d9b8f83e753bf13021c27acc7040 Mon Sep 17 00:00:00 2001
From: Charles Beauville <charlesbeauville@gmail.com>
Date: Thu, 28 Nov 2024 13:54:33 +0100
Subject: [PATCH 004/104] refactor(*:skip) Ignore Pyright config file (#4599)

---
 .gitignore | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/.gitignore b/.gitignore
index b0962c2783f0..4c52fa332037 100644
--- a/.gitignore
+++ b/.gitignore
@@ -183,3 +183,6 @@ app/src/main/assets
 /captures
 .externalNativeBuild
 .cxx
+
+# Pyright
+pyrightconfig.json

From f2d3b1ac2cf34f318e910a61c1d201b97f96cfc2 Mon Sep 17 00:00:00 2001
From: SasiMurakonda <sasi.murakonda@gmail.com>
Date: Thu, 28 Nov 2024 16:14:36 +0000
Subject: [PATCH 005/104] docs(framework) Edit Good First Contributions page
 (#4598)

---
 ...ntributor-ref-good-first-contributions.rst | 39 +++++++++----------
 1 file changed, 18 insertions(+), 21 deletions(-)

diff --git a/doc/source/contributor-ref-good-first-contributions.rst b/doc/source/contributor-ref-good-first-contributions.rst
index a715e006f905..0d07f1f1d7ac 100644
--- a/doc/source/contributor-ref-good-first-contributions.rst
+++ b/doc/source/contributor-ref-good-first-contributions.rst
@@ -8,35 +8,32 @@ your chances of getting your PR accepted into the Flower codebase.
 Where to start
 --------------
 
-Until the Flower core library matures it will be easier to get PR's accepted if they
-only touch non-core areas of the codebase. Good candidates to get started are:
+In general, it is easier to get PR's accepted if they only touch non-core areas of the
+codebase. Good candidates to get started are:
 
 - Documentation: What's missing? What could be expressed more clearly?
+- Open issues: Issues with the tag `good first issue
+  <https://github.com/adap/flower/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+issue%22>`_.
 - Baselines: See below.
 - Examples: See below.
 
-Request for Flower Baselines
-----------------------------
+Flower Baselines
+----------------
 
-If you are not familiar with Flower Baselines, you should probably check-out our
-`contributing guide for baselines
-<https://flower.ai/docs/baselines/how-to-contribute-baselines.html>`_.
+If you are not familiar with Flower Baselines, please check our `contributing guide for
+baselines <https://flower.ai/docs/baselines/how-to-contribute-baselines.html>`_.
 
-You should then check out the open `issues
+Then take a look at the open `issues
 <https://github.com/adap/flower/issues?q=is%3Aopen+is%3Aissue+label%3A%22new+baseline%22>`_
-for baseline requests. If you find a baseline that you'd like to work on and that has no
-assignees, feel free to assign it to yourself and start working on it!
+for baseline requests. If you find a baseline that you'd like to work on, and it has no
+assignees, feel free to assign it to yourself and get started!
 
-Otherwise, if you don't find a baseline you'd like to work on, be sure to open a new
-issue with the baseline request template!
+If you don't find the baseline you'd like to work on, be sure to open a new issue with
+the baseline request template!
 
-Request for examples
---------------------
-
-We wish we had more time to write usage examples because we believe they help users to
-get started with building what they want to build. Here are a few ideas where we'd be
-happy to accept a PR:
+Usage examples
+--------------
 
-- Llama 2 fine-tuning, with Hugging Face Transformers and PyTorch
-- XGBoost
-- Android ONNX on-device training
+We wish we had more time to write usage examples because they help users to get started
+with building what they want. If you notice any missing examples that could help others,
+feel free to contribute!

From 7504d556ccb00d5edc6d2d284a2abfa7c3a8570a Mon Sep 17 00:00:00 2001
From: Adam Narozniak <51029327+adam-narozniak@users.noreply.github.com>
Date: Fri, 29 Nov 2024 15:12:09 +0100
Subject: [PATCH 006/104] docs(datasets) Add dataset contribution guide (#4601)

Co-authored-by: jafermarq <javier@flower.ai>
---
 .../contributor-how-to-contribute-dataset.rst | 56 +++++++++++++++++++
 datasets/doc/source/index.rst                 |  7 +++
 2 files changed, 63 insertions(+)
 create mode 100644 datasets/doc/source/contributor-how-to-contribute-dataset.rst

diff --git a/datasets/doc/source/contributor-how-to-contribute-dataset.rst b/datasets/doc/source/contributor-how-to-contribute-dataset.rst
new file mode 100644
index 000000000000..07a6ba6378f7
--- /dev/null
+++ b/datasets/doc/source/contributor-how-to-contribute-dataset.rst
@@ -0,0 +1,56 @@
+How to contribute a dataset
+===========================
+
+To make a dataset available in Flower Dataset (`flwr-datasets`), you need to add the dataset to `HuggingFace Hub <https://huggingface.co/datasets>`_ .
+
+This guide will explain the best practices we found when adding datasets ourselves and point to the HFs guides. To see the datasets added by Flower, visit https://huggingface.co/flwrlabs.
+
+Dataset contribution process
+----------------------------
+The contribution contains three steps: first, on your development machine transform your dataset into a ``datasets.Dataset`` object, the preferred format for datasets in HF Hub; second, upload the dataset to HuggingFace Hub and detail it its readme how can be used with Flower Dataset; third, share your dataset with us and we will add it to the `recommended FL dataset list <https://flower.ai/docs/datasets/recommended-fl-datasets.html>`_ 
+
+Creating a dataset locally
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+You can create a local dataset directly using the `datasets` library or load it in any custom way and transform it to the `datasets.Dataset` from other Python objects.
+To complete this step, we recommend reading our :doc:`how-to-use-with-local-data` guide or/and the `Create a dataset <https://huggingface.co/docs/datasets/create_dataset>`_ guide from HF.
+
+.. tip::
+    We recommend that you do not upload custom scripts to HuggingFace Hub; instead, create the dataset locally and upload the data, which will speed up the processing time each time the data set is downloaded.
+
+Contribution to the HuggingFace Hub
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+Each dataset in the HF Hub is a Git repository with a specific structure and readme file, and HuggingFace provides an API to push the dataset and, alternatively, a user interface directly in the website to populate the information in the readme file.
+
+Contributions to the HuggingFace Hub come down to:
+
+1. creating an HF repository for the dataset.
+2. uploading the dataset.
+3. filling in the information in the readme file.
+
+To complete this step, follow this HF's guide `Share dataset to the Hub <https://huggingface.co/docs/datasets/upload_dataset>`_.
+
+Note that the push of the dataset is straightforward, and here's what it could look like:
+
+.. code-block:: python
+
+    from datasets import Dataset
+
+    # Example dataset
+    data = {
+        'column1': [1, 2, 3],
+        'column2': ['a', 'b', 'c']
+    }
+
+    # Create a Dataset object
+    dataset = Dataset.from_dict(data)
+
+    # Push the dataset to the HuggingFace Hub
+    dataset.push_to_hub("you-hf-username/your-ds-name")
+
+To make the dataset easily accessible in FL we recommend adding the "Use in FL" section. Here's an example of how it is done in `one of our repos  <https://huggingface.co/datasets/flwrlabs/cinic10#use-in-fl>`_ for the cinic10 dataset.
+
+Increasing visibility of the dataset
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+If you want the dataset listed in our `recommended FL dataset list <https://flower.ai/docs/datasets/recommended-fl-datasets.html>`_  , please send a PR or ping us in `Slack <https://flower.ai/join-slack/>`_ #contributions channel.
+
+That's it! You have successfully contributed a dataset to the HuggingFace Hub and made it available for FL community. Thank you for your contribution!
\ No newline at end of file
diff --git a/datasets/doc/source/index.rst b/datasets/doc/source/index.rst
index 6f7c47bf2416..422d93582a02 100644
--- a/datasets/doc/source/index.rst
+++ b/datasets/doc/source/index.rst
@@ -66,6 +66,13 @@ Information-oriented API reference and other reference material.
    recommended-fl-datasets
    ref-telemetry
 
+.. toctree::
+   :maxdepth: 1
+   :caption: Contributor tutorials
+
+   contributor-how-to-contribute-dataset
+
+
 Main features
 -------------
 Flower Datasets library supports:

From 3fcc89a6c40458d7c0ddd3ceb6a9154deba5f269 Mon Sep 17 00:00:00 2001
From: "github-actions[bot]"
 <41898282+github-actions[bot]@users.noreply.github.com>
Date: Sat, 30 Nov 2024 08:36:42 +0100
Subject: [PATCH 007/104] docs(framework:skip) Update source for translations
 (automated) (#4606)

---
 doc/locales/fr/LC_MESSAGES/framework-docs.po  | 162 +++++++++-----
 doc/locales/ko/LC_MESSAGES/framework-docs.po  | 161 +++++++++-----
 .../pt_BR/LC_MESSAGES/framework-docs.po       | 204 +++++++++++++-----
 .../zh_Hans/LC_MESSAGES/framework-docs.po     | 164 +++++++++-----
 4 files changed, 473 insertions(+), 218 deletions(-)

diff --git a/doc/locales/fr/LC_MESSAGES/framework-docs.po b/doc/locales/fr/LC_MESSAGES/framework-docs.po
index 6b0a297dd720..40aaec1a1087 100644
--- a/doc/locales/fr/LC_MESSAGES/framework-docs.po
+++ b/doc/locales/fr/LC_MESSAGES/framework-docs.po
@@ -3,7 +3,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Flower Docs\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2024-11-28 00:32+0000\n"
+"POT-Creation-Date: 2024-11-30 00:31+0000\n"
 "PO-Revision-Date: 2023-09-05 17:54+0000\n"
 "Last-Translator: Charles Beauville <charles@flower.ai>\n"
 "Language: fr\n"
@@ -1353,10 +1353,10 @@ msgid "Where to start"
 msgstr "Par où commencer"
 
 #: ../../source/contributor-ref-good-first-contributions.rst:11
+#, fuzzy
 msgid ""
-"Until the Flower core library matures it will be easier to get PR's "
-"accepted if they only touch non-core areas of the codebase. Good "
-"candidates to get started are:"
+"In general, it is easier to get PR's accepted if they only touch non-core"
+" areas of the codebase. Good candidates to get started are:"
 msgstr ""
 "Jusqu'à ce que la bibliothèque centrale de Flower arrive à maturité, il "
 "sera plus facile de faire accepter les RP s'ils ne touchent que des zones"
@@ -1370,36 +1370,44 @@ msgstr ""
 "exprimé plus clairement ?"
 
 #: ../../source/contributor-ref-good-first-contributions.rst:15
+#, python-format
+msgid ""
+"Open issues: Issues with the tag `good first issue "
+"<https://github.com/adap/flower/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+issue%22>`_."
+msgstr ""
+
+#: ../../source/contributor-ref-good-first-contributions.rst:17
 msgid "Baselines: See below."
 msgstr "Références : voir ci-dessous."
 
-#: ../../source/contributor-ref-good-first-contributions.rst:16
+#: ../../source/contributor-ref-good-first-contributions.rst:18
 msgid "Examples: See below."
 msgstr "Exemples : voir ci-dessous."
 
-#: ../../source/contributor-ref-good-first-contributions.rst:19
-msgid "Request for Flower Baselines"
+#: ../../source/contributor-ref-good-first-contributions.rst:21
+#, fuzzy
+msgid "Flower Baselines"
 msgstr "Demande pour une nouvelle Flower Baseline"
 
-#: ../../source/contributor-ref-good-first-contributions.rst:21
+#: ../../source/contributor-ref-good-first-contributions.rst:23
 #, fuzzy
 msgid ""
-"If you are not familiar with Flower Baselines, you should probably check-"
-"out our `contributing guide for baselines "
-"<https://flower.ai/docs/baselines/how-to-contribute-baselines.html>`_."
+"If you are not familiar with Flower Baselines, please check our "
+"`contributing guide for baselines <https://flower.ai/docs/baselines/how-"
+"to-contribute-baselines.html>`_."
 msgstr ""
 "Si tu n'es pas familier avec les Flower Baselines, tu devrais "
 "probablement consulter notre `guide de contribution pour les baselines "
 "<https://flower.ai/docs/baselines/how-to-contribute-baselines.html>`_."
 
-#: ../../source/contributor-ref-good-first-contributions.rst:25
+#: ../../source/contributor-ref-good-first-contributions.rst:26
 #, fuzzy
 msgid ""
-"You should then check out the open `issues "
+"Then take a look at the open `issues "
 "<https://github.com/adap/flower/issues?q=is%3Aopen+is%3Aissue+label%3A%22new+baseline%22>`_"
-" for baseline requests. If you find a baseline that you'd like to work on"
-" and that has no assignees, feel free to assign it to yourself and start "
-"working on it!"
+" for baseline requests. If you find a baseline that you'd like to work "
+"on, and it has no assignees, feel free to assign it to yourself and get "
+"started!"
 msgstr ""
 "Tu devrais ensuite consulter les `issues ouvertes "
 "<https://github.com/adap/flower/issues?q=is%3Aopen+is%3Aissue+label%3A%22new+baseline%22>`_"
@@ -1407,43 +1415,33 @@ msgstr ""
 " laquelle tu aimerais travailler et qui n'a pas d'assignés, n'hésite pas "
 "à te l'attribuer et à commencer à travailler dessus !"
 
-#: ../../source/contributor-ref-good-first-contributions.rst:30
+#: ../../source/contributor-ref-good-first-contributions.rst:31
+#, fuzzy
 msgid ""
-"Otherwise, if you don't find a baseline you'd like to work on, be sure to"
-" open a new issue with the baseline request template!"
+"If you don't find the baseline you'd like to work on, be sure to open a "
+"new issue with the baseline request template!"
 msgstr ""
 "Sinon, si tu ne trouves pas de ligne de base sur laquelle tu aimerais "
 "travailler, n'oublie pas d'ouvrir un nouveau problème à l'aide du modèle "
 "de demande de ligne de base !"
 
-#: ../../source/contributor-ref-good-first-contributions.rst:34
-msgid "Request for examples"
-msgstr "Demande pour un nouveau Flower Example"
+#: ../../source/contributor-ref-good-first-contributions.rst:35
+#, fuzzy
+msgid "Usage examples"
+msgstr "Exemples de PyTorch"
 
-#: ../../source/contributor-ref-good-first-contributions.rst:36
+#: ../../source/contributor-ref-good-first-contributions.rst:37
+#, fuzzy
 msgid ""
-"We wish we had more time to write usage examples because we believe they "
-"help users to get started with building what they want to build. Here are"
-" a few ideas where we'd be happy to accept a PR:"
+"We wish we had more time to write usage examples because they help users "
+"to get started with building what they want. If you notice any missing "
+"examples that could help others, feel free to contribute!"
 msgstr ""
 "Nous aimerions avoir plus de temps pour écrire des exemples d'utilisation"
 " car nous pensons qu'ils aident les utilisateurs à commencer à construire"
 " ce qu'ils veulent construire. Voici quelques idées pour lesquelles nous "
 "serions heureux d'accepter un RP :"
 
-#: ../../source/contributor-ref-good-first-contributions.rst:40
-msgid "Llama 2 fine-tuning, with Hugging Face Transformers and PyTorch"
-msgstr "LLaMA 2 fine-tuning avec Hugging Face et PyTorch"
-
-#: ../../source/contributor-ref-good-first-contributions.rst:41
-#: ../../source/tutorial-quickstart-xgboost.rst:7
-msgid "XGBoost"
-msgstr "XGBoost"
-
-#: ../../source/contributor-ref-good-first-contributions.rst:42
-msgid "Android ONNX on-device training"
-msgstr "Training sur téléphone à l'aide d'Android ONNX"
-
 #: ../../source/contributor-ref-secure-aggregation-protocols.rst:2
 msgid "Secure Aggregation Protocols"
 msgstr "Protocoles d'agrégation sécurisés"
@@ -26487,6 +26485,10 @@ msgstr ""
 msgid "Quickstart XGBoost"
 msgstr "Démarrage rapide XGBoost"
 
+#: ../../source/tutorial-quickstart-xgboost.rst:7
+msgid "XGBoost"
+msgstr "XGBoost"
+
 #: ../../source/tutorial-quickstart-xgboost.rst:9
 msgid ""
 "EXtreme Gradient Boosting (**XGBoost**) is a robust and efficient "
@@ -28906,7 +28908,7 @@ msgstr ""
 "chose d'autre, comme la régression linéaire classique."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:41
-msgid "|f150b8d6e0074250822c9f6f7a8de3e0|"
+msgid "|80152fa658904be08c849b4a594b76e1|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:109
@@ -28925,7 +28927,7 @@ msgstr ""
 " Go."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:53
-msgid "|72772d10debc4abd8373c0bc82985422|"
+msgid "|35b60a1068f944ce937ac2988661aad5|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:111
@@ -28957,7 +28959,7 @@ msgstr ""
 "chanson."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:67
-msgid "|5815398552ad41d290a3a2631fe8f6ca|"
+msgid "|efead7f2c2224b60b7b42705004c15e6|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:113
@@ -28978,7 +28980,7 @@ msgstr ""
 " données pour la même tâche."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:79
-msgid "|e6ac20744bf149378be20ac3dc309356|"
+msgid "|5421fee4e7ed450c903cbcd8a9d8a5d4|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:115
@@ -29000,7 +29002,7 @@ msgstr ""
 "cloud."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:91
-msgid "|a4011ef443c14725b15a8cf33b0e3443|"
+msgid "|811fcf35e9214bd5b4e613e41f7c0a27|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:117
@@ -29021,7 +29023,7 @@ msgstr ""
 "appuyés."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:103
-msgid "|a22faa3617404c06803731525e1c609f|"
+msgid "|e61d38b0948f4c07a7257755f3799b54|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:119
@@ -29047,7 +29049,7 @@ msgstr ""
 " sur un serveur centralisé."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:138
-msgid "|84a5c9b5041c43c3beab9786197c3e4e|"
+msgid "|e82c29351e2e480087c61b939eb7c041|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:173
@@ -29066,7 +29068,7 @@ msgstr ""
 "suffisantes pour former un bon modèle."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:150
-msgid "|b5c4be0b52d4493ba8c4af14d7c2db97|"
+msgid "|21ca40f4fb1a405c89098fd1d24880a4|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:175
@@ -29297,7 +29299,7 @@ msgstr ""
 "partir d'un point de contrôle précédemment sauvegardé."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:210
-msgid "|c1c784183d18481186ff65dc261d1335|"
+msgid "|1351a2629c2c46d981b13b19f9fa45f0|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:307
@@ -29332,7 +29334,7 @@ msgstr ""
 "rendements décroissants."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:225
-msgid "|669fcd1f44ab42f5bbd196c3cf1ecbc2|"
+msgid "|124c2c188b994c7ab1c862cfdb326923|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:309
@@ -29365,7 +29367,7 @@ msgstr ""
 "données locales, ou même de quelques étapes (mini-batchs)."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:240
-msgid "|edfb08758c9441afb6736045a59e154c|"
+msgid "|42e1951c36f2406e93c7ae0ec5b299f9|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:311
@@ -29396,7 +29398,7 @@ msgstr ""
 " l'entraînement local."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:255
-msgid "|82338b8bbad24d5ea9df3801aab37852|"
+msgid "|ec637b8a84234d068995ee1ccb2dd3b1|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:313
@@ -29456,7 +29458,7 @@ msgstr ""
 "times as much as each of the 100 examples."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:273
-msgid "|518d994dd2c844898b441da03b858326|"
+msgid "|5bceb9d16b1a4d2db18d8a5b2f0cacb3|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:315
@@ -29600,7 +29602,7 @@ msgstr ""
 "quel cadre de ML et n'importe quel langage de programmation."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:334
-msgid "|7bfcfcb57ae5403f8e18486f45ca48b4|"
+msgid "|502b10044e864ca2b15282a393ab7faf|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:340
@@ -30664,15 +30666,13 @@ msgstr ""
 #~ " doit être installé sur le système."
 
 #~ msgid "Llama 2 fine-tuning, with Hugging Face Transformers and PyTorch"
-#~ msgstr "Un fine-tuning de LLaMA 2 avec Hugging Face et PyTorch"
+#~ msgstr "LLaMA 2 fine-tuning avec Hugging Face et PyTorch"
 
 #~ msgid "XGBoost"
 #~ msgstr "XGBoost"
 
 #~ msgid "Android ONNX on-device training"
-#~ msgstr ""
-#~ "Utiliser Android ONNX pour faire du "
-#~ "training directement sur le téléphone"
+#~ msgstr "Training sur téléphone à l'aide d'Android ONNX"
 
 #~ msgid "Contribute on GitHub"
 #~ msgstr "Contribuer sur GitHub"
@@ -42959,3 +42959,51 @@ msgstr ""
 #~ msgid "|4ab50bc01a9f426a91a2c0cbc3ab7a84|"
 #~ msgstr ""
 
+#~ msgid "Request for Flower Baselines"
+#~ msgstr "Demande pour une nouvelle Flower Baseline"
+
+#~ msgid "Request for examples"
+#~ msgstr "Demande pour un nouveau Flower Example"
+
+#~ msgid "|f150b8d6e0074250822c9f6f7a8de3e0|"
+#~ msgstr ""
+
+#~ msgid "|72772d10debc4abd8373c0bc82985422|"
+#~ msgstr ""
+
+#~ msgid "|5815398552ad41d290a3a2631fe8f6ca|"
+#~ msgstr ""
+
+#~ msgid "|e6ac20744bf149378be20ac3dc309356|"
+#~ msgstr ""
+
+#~ msgid "|a4011ef443c14725b15a8cf33b0e3443|"
+#~ msgstr ""
+
+#~ msgid "|a22faa3617404c06803731525e1c609f|"
+#~ msgstr ""
+
+#~ msgid "|84a5c9b5041c43c3beab9786197c3e4e|"
+#~ msgstr ""
+
+#~ msgid "|b5c4be0b52d4493ba8c4af14d7c2db97|"
+#~ msgstr ""
+
+#~ msgid "|c1c784183d18481186ff65dc261d1335|"
+#~ msgstr ""
+
+#~ msgid "|669fcd1f44ab42f5bbd196c3cf1ecbc2|"
+#~ msgstr ""
+
+#~ msgid "|edfb08758c9441afb6736045a59e154c|"
+#~ msgstr ""
+
+#~ msgid "|82338b8bbad24d5ea9df3801aab37852|"
+#~ msgstr ""
+
+#~ msgid "|518d994dd2c844898b441da03b858326|"
+#~ msgstr ""
+
+#~ msgid "|7bfcfcb57ae5403f8e18486f45ca48b4|"
+#~ msgstr ""
+
diff --git a/doc/locales/ko/LC_MESSAGES/framework-docs.po b/doc/locales/ko/LC_MESSAGES/framework-docs.po
index 8775e9b1ca4d..810bc10e99b3 100644
--- a/doc/locales/ko/LC_MESSAGES/framework-docs.po
+++ b/doc/locales/ko/LC_MESSAGES/framework-docs.po
@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Flower main\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-11-28 00:32+0000\n"
+"POT-Creation-Date: 2024-11-30 00:31+0000\n"
 "PO-Revision-Date: 2024-08-23 13:09+0000\n"
 "Last-Translator: Seulki Yun <icstuckyi@gmail.com>\n"
 "Language: ko\n"
@@ -1326,10 +1326,10 @@ msgid "Where to start"
 msgstr "시작 위치"
 
 #: ../../source/contributor-ref-good-first-contributions.rst:11
+#, fuzzy
 msgid ""
-"Until the Flower core library matures it will be easier to get PR's "
-"accepted if they only touch non-core areas of the codebase. Good "
-"candidates to get started are:"
+"In general, it is easier to get PR's accepted if they only touch non-core"
+" areas of the codebase. Good candidates to get started are:"
 msgstr ""
 "Flower 코어 라이브러리가 완성될 때까지는 코드베이스의 비핵심 영역만 건드리는 것이 PR을 승인받기가 더 쉬울 것입니다. "
 "시작하기에 좋은 후보자는 다음과 같습니다:"
@@ -1339,72 +1339,72 @@ msgid "Documentation: What's missing? What could be expressed more clearly?"
 msgstr "문서: 무엇이 누락되었나요? 무엇을 더 명확하게 표현할 수 있을까요?"
 
 #: ../../source/contributor-ref-good-first-contributions.rst:15
+#, python-format
+msgid ""
+"Open issues: Issues with the tag `good first issue "
+"<https://github.com/adap/flower/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+issue%22>`_."
+msgstr ""
+
+#: ../../source/contributor-ref-good-first-contributions.rst:17
 msgid "Baselines: See below."
 msgstr "Baselines: 아래를 참조하세요."
 
-#: ../../source/contributor-ref-good-first-contributions.rst:16
+#: ../../source/contributor-ref-good-first-contributions.rst:18
 msgid "Examples: See below."
 msgstr "예시: 아래를 참조하세요."
 
-#: ../../source/contributor-ref-good-first-contributions.rst:19
-msgid "Request for Flower Baselines"
+#: ../../source/contributor-ref-good-first-contributions.rst:21
+#, fuzzy
+msgid "Flower Baselines"
 msgstr "Flower Baselines 요청"
 
-#: ../../source/contributor-ref-good-first-contributions.rst:21
+#: ../../source/contributor-ref-good-first-contributions.rst:23
+#, fuzzy
 msgid ""
-"If you are not familiar with Flower Baselines, you should probably check-"
-"out our `contributing guide for baselines "
-"<https://flower.ai/docs/baselines/how-to-contribute-baselines.html>`_."
+"If you are not familiar with Flower Baselines, please check our "
+"`contributing guide for baselines <https://flower.ai/docs/baselines/how-"
+"to-contribute-baselines.html>`_."
 msgstr ""
 "Flower Baseline에 익숙하지 않다면 ' Baseline 기여 가이드 "
 "<https://flower.ai/docs/baselines/how-to-contribute-baselines.html>`_를 "
 "확인해보세요."
 
-#: ../../source/contributor-ref-good-first-contributions.rst:25
+#: ../../source/contributor-ref-good-first-contributions.rst:26
+#, fuzzy
 msgid ""
-"You should then check out the open `issues "
+"Then take a look at the open `issues "
 "<https://github.com/adap/flower/issues?q=is%3Aopen+is%3Aissue+label%3A%22new+baseline%22>`_"
-" for baseline requests. If you find a baseline that you'd like to work on"
-" and that has no assignees, feel free to assign it to yourself and start "
-"working on it!"
+" for baseline requests. If you find a baseline that you'd like to work "
+"on, and it has no assignees, feel free to assign it to yourself and get "
+"started!"
 msgstr ""
 "그런 다음 오픈 된 `issues "
 "<https://github.com/adap/flower/issues?q=is%3Aopen+is%3Aissue+label%3A%22new+baseline%22>`_에서"
 " baseline 요청을 확인해야 합니다. 작업하고 싶은 기준선을 찾았지만 담당자가 없는 경우, 자유롭게 자신에게 할당하고 작업을 "
 "시작하세요!"
 
-#: ../../source/contributor-ref-good-first-contributions.rst:30
+#: ../../source/contributor-ref-good-first-contributions.rst:31
+#, fuzzy
 msgid ""
-"Otherwise, if you don't find a baseline you'd like to work on, be sure to"
-" open a new issue with the baseline request template!"
+"If you don't find the baseline you'd like to work on, be sure to open a "
+"new issue with the baseline request template!"
 msgstr "그렇지 않으면 작업하고 싶은 baseline을 찾지 못하면 baseline 요청 템플릿으로 새 이슈를 열어야 합니다!"
 
-#: ../../source/contributor-ref-good-first-contributions.rst:34
-msgid "Request for examples"
-msgstr "예시 요청"
+#: ../../source/contributor-ref-good-first-contributions.rst:35
+#, fuzzy
+msgid "Usage examples"
+msgstr "예시"
 
-#: ../../source/contributor-ref-good-first-contributions.rst:36
+#: ../../source/contributor-ref-good-first-contributions.rst:37
+#, fuzzy
 msgid ""
-"We wish we had more time to write usage examples because we believe they "
-"help users to get started with building what they want to build. Here are"
-" a few ideas where we'd be happy to accept a PR:"
+"We wish we had more time to write usage examples because they help users "
+"to get started with building what they want. If you notice any missing "
+"examples that could help others, feel free to contribute!"
 msgstr ""
 "사용 예시는 사용자가 원하는 것을 구축하는 데 도움이 된다고 생각하기 때문에 더 많은 시간을 할애하여 작성할 수 있었으면 합니다. "
 "다음은 저희가 기꺼이 PR을 수락할 수 있는 몇 가지 아이디어입니다:"
 
-#: ../../source/contributor-ref-good-first-contributions.rst:40
-msgid "Llama 2 fine-tuning, with Hugging Face Transformers and PyTorch"
-msgstr "Llama 2 미세 조정, Hugging Face Transformer와 파이토치 포함"
-
-#: ../../source/contributor-ref-good-first-contributions.rst:41
-#: ../../source/tutorial-quickstart-xgboost.rst:7
-msgid "XGBoost"
-msgstr "XGBoost"
-
-#: ../../source/contributor-ref-good-first-contributions.rst:42
-msgid "Android ONNX on-device training"
-msgstr "Android ONNX 온디바이스 훈련"
-
 #: ../../source/contributor-ref-secure-aggregation-protocols.rst:2
 msgid "Secure Aggregation Protocols"
 msgstr "Secure Aggregation 프로토콜"
@@ -24222,6 +24222,10 @@ msgstr ""
 msgid "Quickstart XGBoost"
 msgstr ""
 
+#: ../../source/tutorial-quickstart-xgboost.rst:7
+msgid "XGBoost"
+msgstr "XGBoost"
+
 #: ../../source/tutorial-quickstart-xgboost.rst:9
 msgid ""
 "EXtreme Gradient Boosting (**XGBoost**) is a robust and efficient "
@@ -25984,7 +25988,7 @@ msgstr ""
 " 수도 있습니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:41
-msgid "|f150b8d6e0074250822c9f6f7a8de3e0|"
+msgid "|80152fa658904be08c849b4a594b76e1|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:109
@@ -26001,7 +26005,7 @@ msgstr ""
 " 바둑과 같은 게임을 하는 것일 수 있습니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:53
-msgid "|72772d10debc4abd8373c0bc82985422|"
+msgid "|35b60a1068f944ce937ac2988661aad5|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:111
@@ -26027,7 +26031,7 @@ msgstr ""
 "부르리는 것을 듣는 스마트 스피커에서 비롯됩니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:67
-msgid "|5815398552ad41d290a3a2631fe8f6ca|"
+msgid "|efead7f2c2224b60b7b42705004c15e6|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:113
@@ -26045,7 +26049,7 @@ msgstr ""
 "있습니다. 하지만 여러 조직이 모두 같은 작업을 위해 데이터를 생성하는 것일 수도 있습니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:79
-msgid "|e6ac20744bf149378be20ac3dc309356|"
+msgid "|5421fee4e7ed450c903cbcd8a9d8a5d4|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:115
@@ -26064,7 +26068,7 @@ msgstr ""
 "서버는 데이터 센터 어딘가에 있을 수도 있고 클라우드 어딘가에 있을 수도 있습니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:91
-msgid "|a4011ef443c14725b15a8cf33b0e3443|"
+msgid "|811fcf35e9214bd5b4e613e41f7c0a27|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:117
@@ -26081,7 +26085,7 @@ msgstr ""
 " 우리가 기본적으로 사용해 온 머신러닝 방법입니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:103
-msgid "|a22faa3617404c06803731525e1c609f|"
+msgid "|e61d38b0948f4c07a7257755f3799b54|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:119
@@ -26104,7 +26108,7 @@ msgstr ""
 "트래픽을 분석하는 것이 있습니다. 이러한 사례에서 모든 데이터는 자연스럽게 중앙 서버에 존재합니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:138
-msgid "|84a5c9b5041c43c3beab9786197c3e4e|"
+msgid "|e82c29351e2e480087c61b939eb7c041|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:173
@@ -26121,7 +26125,7 @@ msgstr ""
 "좋은 모델을 훈련하기에 충분하지 않을 수 있습니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:150
-msgid "|b5c4be0b52d4493ba8c4af14d7c2db97|"
+msgid "|21ca40f4fb1a405c89098fd1d24880a4|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:175
@@ -26300,7 +26304,7 @@ msgstr ""
 "체크포인트에서 모델 매개변수를 초기화합니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:210
-msgid "|c1c784183d18481186ff65dc261d1335|"
+msgid "|1351a2629c2c46d981b13b19f9fa45f0|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:307
@@ -26328,7 +26332,7 @@ msgstr ""
 "개의 연결 노드만 사용합니다. 그 이유는 점점 더 많은 클라이언트 노드를 선택하면 학습의 효율성이 감소하기 때문입니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:225
-msgid "|669fcd1f44ab42f5bbd196c3cf1ecbc2|"
+msgid "|124c2c188b994c7ab1c862cfdb326923|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:309
@@ -26355,7 +26359,7 @@ msgstr ""
 "데이터에서 한 단계 정도로 짧거나 몇 단계(mini-batches)에 불과할 수 있습니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:240
-msgid "|edfb08758c9441afb6736045a59e154c|"
+msgid "|42e1951c36f2406e93c7ae0ec5b299f9|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:311
@@ -26381,7 +26385,7 @@ msgstr ""
 "보냅니다. 보내는 모델 업데이트는 전체 모델 파라미터거나 로컬 교육 중에 누적된 그레디언트(gradient)일 수 있습니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:255
-msgid "|82338b8bbad24d5ea9df3801aab37852|"
+msgid "|ec637b8a84234d068995ee1ccb2dd3b1|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:313
@@ -26431,7 +26435,7 @@ msgstr ""
 "많은 영향을 미칩니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:273
-msgid "|518d994dd2c844898b441da03b858326|"
+msgid "|5bceb9d16b1a4d2db18d8a5b2f0cacb3|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:315
@@ -26551,7 +26555,7 @@ msgstr ""
 "사용자는 모든 워크로드, 머신러닝 프레임워크 및 모든 프로그래밍 언어를 통합할 수 있습니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:334
-msgid "|7bfcfcb57ae5403f8e18486f45ca48b4|"
+msgid "|502b10044e864ca2b15282a393ab7faf|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:340
@@ -33428,3 +33432,54 @@ msgstr ""
 #~ msgid "|4ab50bc01a9f426a91a2c0cbc3ab7a84|"
 #~ msgstr ""
 
+#~ msgid "Request for examples"
+#~ msgstr "예시 요청"
+
+#~ msgid "Llama 2 fine-tuning, with Hugging Face Transformers and PyTorch"
+#~ msgstr "Llama 2 미세 조정, Hugging Face Transformer와 파이토치 포함"
+
+#~ msgid "Android ONNX on-device training"
+#~ msgstr "Android ONNX 온디바이스 훈련"
+
+#~ msgid "|f150b8d6e0074250822c9f6f7a8de3e0|"
+#~ msgstr ""
+
+#~ msgid "|72772d10debc4abd8373c0bc82985422|"
+#~ msgstr ""
+
+#~ msgid "|5815398552ad41d290a3a2631fe8f6ca|"
+#~ msgstr ""
+
+#~ msgid "|e6ac20744bf149378be20ac3dc309356|"
+#~ msgstr ""
+
+#~ msgid "|a4011ef443c14725b15a8cf33b0e3443|"
+#~ msgstr ""
+
+#~ msgid "|a22faa3617404c06803731525e1c609f|"
+#~ msgstr ""
+
+#~ msgid "|84a5c9b5041c43c3beab9786197c3e4e|"
+#~ msgstr ""
+
+#~ msgid "|b5c4be0b52d4493ba8c4af14d7c2db97|"
+#~ msgstr ""
+
+#~ msgid "|c1c784183d18481186ff65dc261d1335|"
+#~ msgstr ""
+
+#~ msgid "|669fcd1f44ab42f5bbd196c3cf1ecbc2|"
+#~ msgstr ""
+
+#~ msgid "|edfb08758c9441afb6736045a59e154c|"
+#~ msgstr ""
+
+#~ msgid "|82338b8bbad24d5ea9df3801aab37852|"
+#~ msgstr ""
+
+#~ msgid "|518d994dd2c844898b441da03b858326|"
+#~ msgstr ""
+
+#~ msgid "|7bfcfcb57ae5403f8e18486f45ca48b4|"
+#~ msgstr ""
+
diff --git a/doc/locales/pt_BR/LC_MESSAGES/framework-docs.po b/doc/locales/pt_BR/LC_MESSAGES/framework-docs.po
index 017acf217ab0..21eafd64d9a2 100644
--- a/doc/locales/pt_BR/LC_MESSAGES/framework-docs.po
+++ b/doc/locales/pt_BR/LC_MESSAGES/framework-docs.po
@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Flower main\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-11-28 00:32+0000\n"
+"POT-Creation-Date: 2024-11-30 00:31+0000\n"
 "PO-Revision-Date: 2024-05-25 11:09+0000\n"
 "Last-Translator: Gustavo Bertoli <gubertoli@gmail.com>\n"
 "Language: pt_BR\n"
@@ -1274,9 +1274,8 @@ msgstr ""
 
 #: ../../source/contributor-ref-good-first-contributions.rst:11
 msgid ""
-"Until the Flower core library matures it will be easier to get PR's "
-"accepted if they only touch non-core areas of the codebase. Good "
-"candidates to get started are:"
+"In general, it is easier to get PR's accepted if they only touch non-core"
+" areas of the codebase. Good candidates to get started are:"
 msgstr ""
 
 #: ../../source/contributor-ref-good-first-contributions.rst:14
@@ -1284,61 +1283,57 @@ msgid "Documentation: What's missing? What could be expressed more clearly?"
 msgstr ""
 
 #: ../../source/contributor-ref-good-first-contributions.rst:15
-msgid "Baselines: See below."
+#, python-format
+msgid ""
+"Open issues: Issues with the tag `good first issue "
+"<https://github.com/adap/flower/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+issue%22>`_."
 msgstr ""
 
-#: ../../source/contributor-ref-good-first-contributions.rst:16
-msgid "Examples: See below."
+#: ../../source/contributor-ref-good-first-contributions.rst:17
+msgid "Baselines: See below."
 msgstr ""
 
-#: ../../source/contributor-ref-good-first-contributions.rst:19
-msgid "Request for Flower Baselines"
+#: ../../source/contributor-ref-good-first-contributions.rst:18
+msgid "Examples: See below."
 msgstr ""
 
 #: ../../source/contributor-ref-good-first-contributions.rst:21
+#, fuzzy
+msgid "Flower Baselines"
+msgstr "``FLWR_VERSION``"
+
+#: ../../source/contributor-ref-good-first-contributions.rst:23
 msgid ""
-"If you are not familiar with Flower Baselines, you should probably check-"
-"out our `contributing guide for baselines "
-"<https://flower.ai/docs/baselines/how-to-contribute-baselines.html>`_."
+"If you are not familiar with Flower Baselines, please check our "
+"`contributing guide for baselines <https://flower.ai/docs/baselines/how-"
+"to-contribute-baselines.html>`_."
 msgstr ""
 
-#: ../../source/contributor-ref-good-first-contributions.rst:25
+#: ../../source/contributor-ref-good-first-contributions.rst:26
 msgid ""
-"You should then check out the open `issues "
+"Then take a look at the open `issues "
 "<https://github.com/adap/flower/issues?q=is%3Aopen+is%3Aissue+label%3A%22new+baseline%22>`_"
-" for baseline requests. If you find a baseline that you'd like to work on"
-" and that has no assignees, feel free to assign it to yourself and start "
-"working on it!"
+" for baseline requests. If you find a baseline that you'd like to work "
+"on, and it has no assignees, feel free to assign it to yourself and get "
+"started!"
 msgstr ""
 
-#: ../../source/contributor-ref-good-first-contributions.rst:30
+#: ../../source/contributor-ref-good-first-contributions.rst:31
 msgid ""
-"Otherwise, if you don't find a baseline you'd like to work on, be sure to"
-" open a new issue with the baseline request template!"
+"If you don't find the baseline you'd like to work on, be sure to open a "
+"new issue with the baseline request template!"
 msgstr ""
 
-#: ../../source/contributor-ref-good-first-contributions.rst:34
-msgid "Request for examples"
-msgstr ""
+#: ../../source/contributor-ref-good-first-contributions.rst:35
+#, fuzzy
+msgid "Usage examples"
+msgstr "Exemplo"
 
-#: ../../source/contributor-ref-good-first-contributions.rst:36
+#: ../../source/contributor-ref-good-first-contributions.rst:37
 msgid ""
-"We wish we had more time to write usage examples because we believe they "
-"help users to get started with building what they want to build. Here are"
-" a few ideas where we'd be happy to accept a PR:"
-msgstr ""
-
-#: ../../source/contributor-ref-good-first-contributions.rst:40
-msgid "Llama 2 fine-tuning, with Hugging Face Transformers and PyTorch"
-msgstr ""
-
-#: ../../source/contributor-ref-good-first-contributions.rst:41
-#: ../../source/tutorial-quickstart-xgboost.rst:7
-msgid "XGBoost"
-msgstr ""
-
-#: ../../source/contributor-ref-good-first-contributions.rst:42
-msgid "Android ONNX on-device training"
+"We wish we had more time to write usage examples because they help users "
+"to get started with building what they want. If you notice any missing "
+"examples that could help others, feel free to contribute!"
 msgstr ""
 
 #: ../../source/contributor-ref-secure-aggregation-protocols.rst:2
@@ -22924,6 +22919,10 @@ msgstr ""
 msgid "Quickstart XGBoost"
 msgstr ""
 
+#: ../../source/tutorial-quickstart-xgboost.rst:7
+msgid "XGBoost"
+msgstr ""
+
 #: ../../source/tutorial-quickstart-xgboost.rst:9
 msgid ""
 "EXtreme Gradient Boosting (**XGBoost**) is a robust and efficient "
@@ -24656,7 +24655,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:41
-msgid "|f150b8d6e0074250822c9f6f7a8de3e0|"
+msgid "|80152fa658904be08c849b4a594b76e1|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:109
@@ -24671,7 +24670,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:53
-msgid "|72772d10debc4abd8373c0bc82985422|"
+msgid "|35b60a1068f944ce937ac2988661aad5|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:111
@@ -24693,7 +24692,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:67
-msgid "|5815398552ad41d290a3a2631fe8f6ca|"
+msgid "|efead7f2c2224b60b7b42705004c15e6|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:113
@@ -24709,7 +24708,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:79
-msgid "|e6ac20744bf149378be20ac3dc309356|"
+msgid "|5421fee4e7ed450c903cbcd8a9d8a5d4|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:115
@@ -24725,7 +24724,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:91
-msgid "|a4011ef443c14725b15a8cf33b0e3443|"
+msgid "|811fcf35e9214bd5b4e613e41f7c0a27|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:117
@@ -24740,7 +24739,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:103
-msgid "|a22faa3617404c06803731525e1c609f|"
+msgid "|e61d38b0948f4c07a7257755f3799b54|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:119
@@ -24760,7 +24759,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:138
-msgid "|84a5c9b5041c43c3beab9786197c3e4e|"
+msgid "|e82c29351e2e480087c61b939eb7c041|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:173
@@ -24775,7 +24774,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:150
-msgid "|b5c4be0b52d4493ba8c4af14d7c2db97|"
+msgid "|21ca40f4fb1a405c89098fd1d24880a4|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:175
@@ -24915,7 +24914,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:210
-msgid "|c1c784183d18481186ff65dc261d1335|"
+msgid "|1351a2629c2c46d981b13b19f9fa45f0|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:307
@@ -24939,7 +24938,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:225
-msgid "|669fcd1f44ab42f5bbd196c3cf1ecbc2|"
+msgid "|124c2c188b994c7ab1c862cfdb326923|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:309
@@ -24963,7 +24962,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:240
-msgid "|edfb08758c9441afb6736045a59e154c|"
+msgid "|42e1951c36f2406e93c7ae0ec5b299f9|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:311
@@ -24986,7 +24985,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:255
-msgid "|82338b8bbad24d5ea9df3801aab37852|"
+msgid "|ec637b8a84234d068995ee1ccb2dd3b1|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:313
@@ -25024,7 +25023,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:273
-msgid "|518d994dd2c844898b441da03b858326|"
+msgid "|5bceb9d16b1a4d2db18d8a5b2f0cacb3|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:315
@@ -25118,7 +25117,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:334
-msgid "|7bfcfcb57ae5403f8e18486f45ca48b4|"
+msgid "|502b10044e864ca2b15282a393ab7faf|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:340
@@ -37405,3 +37404,100 @@ msgstr ""
 #~ msgid "|4ab50bc01a9f426a91a2c0cbc3ab7a84|"
 #~ msgstr ""
 
+#~ msgid ""
+#~ "Until the Flower core library matures"
+#~ " it will be easier to get PR's"
+#~ " accepted if they only touch non-"
+#~ "core areas of the codebase. Good "
+#~ "candidates to get started are:"
+#~ msgstr ""
+
+#~ msgid "Request for Flower Baselines"
+#~ msgstr ""
+
+#~ msgid ""
+#~ "If you are not familiar with "
+#~ "Flower Baselines, you should probably "
+#~ "check-out our `contributing guide for "
+#~ "baselines <https://flower.ai/docs/baselines/how-to-"
+#~ "contribute-baselines.html>`_."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "You should then check out the open"
+#~ " `issues "
+#~ "<https://github.com/adap/flower/issues?q=is%3Aopen+is%3Aissue+label%3A%22new+baseline%22>`_"
+#~ " for baseline requests. If you find"
+#~ " a baseline that you'd like to "
+#~ "work on and that has no assignees,"
+#~ " feel free to assign it to "
+#~ "yourself and start working on it!"
+#~ msgstr ""
+
+#~ msgid ""
+#~ "Otherwise, if you don't find a "
+#~ "baseline you'd like to work on, be"
+#~ " sure to open a new issue with"
+#~ " the baseline request template!"
+#~ msgstr ""
+
+#~ msgid "Request for examples"
+#~ msgstr ""
+
+#~ msgid ""
+#~ "We wish we had more time to "
+#~ "write usage examples because we believe"
+#~ " they help users to get started "
+#~ "with building what they want to "
+#~ "build. Here are a few ideas where"
+#~ " we'd be happy to accept a PR:"
+#~ msgstr ""
+
+#~ msgid "Llama 2 fine-tuning, with Hugging Face Transformers and PyTorch"
+#~ msgstr ""
+
+#~ msgid "Android ONNX on-device training"
+#~ msgstr ""
+
+#~ msgid "|f150b8d6e0074250822c9f6f7a8de3e0|"
+#~ msgstr ""
+
+#~ msgid "|72772d10debc4abd8373c0bc82985422|"
+#~ msgstr ""
+
+#~ msgid "|5815398552ad41d290a3a2631fe8f6ca|"
+#~ msgstr ""
+
+#~ msgid "|e6ac20744bf149378be20ac3dc309356|"
+#~ msgstr ""
+
+#~ msgid "|a4011ef443c14725b15a8cf33b0e3443|"
+#~ msgstr ""
+
+#~ msgid "|a22faa3617404c06803731525e1c609f|"
+#~ msgstr ""
+
+#~ msgid "|84a5c9b5041c43c3beab9786197c3e4e|"
+#~ msgstr ""
+
+#~ msgid "|b5c4be0b52d4493ba8c4af14d7c2db97|"
+#~ msgstr ""
+
+#~ msgid "|c1c784183d18481186ff65dc261d1335|"
+#~ msgstr ""
+
+#~ msgid "|669fcd1f44ab42f5bbd196c3cf1ecbc2|"
+#~ msgstr ""
+
+#~ msgid "|edfb08758c9441afb6736045a59e154c|"
+#~ msgstr ""
+
+#~ msgid "|82338b8bbad24d5ea9df3801aab37852|"
+#~ msgstr ""
+
+#~ msgid "|518d994dd2c844898b441da03b858326|"
+#~ msgstr ""
+
+#~ msgid "|7bfcfcb57ae5403f8e18486f45ca48b4|"
+#~ msgstr ""
+
diff --git a/doc/locales/zh_Hans/LC_MESSAGES/framework-docs.po b/doc/locales/zh_Hans/LC_MESSAGES/framework-docs.po
index 41c74779d83b..3b56d02c7503 100644
--- a/doc/locales/zh_Hans/LC_MESSAGES/framework-docs.po
+++ b/doc/locales/zh_Hans/LC_MESSAGES/framework-docs.po
@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Flower main\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-11-28 00:32+0000\n"
+"POT-Creation-Date: 2024-11-30 00:31+0000\n"
 "PO-Revision-Date: 2024-06-12 10:09+0000\n"
 "Last-Translator: Yan Gao <y.gaogy@gmail.com>\n"
 "Language: zh_Hans\n"
@@ -1335,10 +1335,10 @@ msgid "Where to start"
 msgstr "从哪里开始"
 
 #: ../../source/contributor-ref-good-first-contributions.rst:11
+#, fuzzy
 msgid ""
-"Until the Flower core library matures it will be easier to get PR's "
-"accepted if they only touch non-core areas of the codebase. Good "
-"candidates to get started are:"
+"In general, it is easier to get PR's accepted if they only touch non-core"
+" areas of the codebase. Good candidates to get started are:"
 msgstr "在 Flower 核心库成熟之前，如果 PR 只涉及代码库中的非核心区域，则会更容易被接受。可以从以下方面入手："
 
 #: ../../source/contributor-ref-good-first-contributions.rst:14
@@ -1346,70 +1346,68 @@ msgid "Documentation: What's missing? What could be expressed more clearly?"
 msgstr "文档： 缺少什么？哪些内容可以表达得更清楚？"
 
 #: ../../source/contributor-ref-good-first-contributions.rst:15
+#, python-format
+msgid ""
+"Open issues: Issues with the tag `good first issue "
+"<https://github.com/adap/flower/issues?q=is%3Aopen+is%3Aissue+label%3A%22good+first+issue%22>`_."
+msgstr ""
+
+#: ../../source/contributor-ref-good-first-contributions.rst:17
 msgid "Baselines: See below."
 msgstr "Baselines： 见下文。"
 
-#: ../../source/contributor-ref-good-first-contributions.rst:16
+#: ../../source/contributor-ref-good-first-contributions.rst:18
 msgid "Examples: See below."
 msgstr "示例： 见下文。"
 
-#: ../../source/contributor-ref-good-first-contributions.rst:19
-msgid "Request for Flower Baselines"
-msgstr "Flower Baselines的申请"
-
 #: ../../source/contributor-ref-good-first-contributions.rst:21
 #, fuzzy
+msgid "Flower Baselines"
+msgstr "**更新 Flower Baselines**"
+
+#: ../../source/contributor-ref-good-first-contributions.rst:23
+#, fuzzy
 msgid ""
-"If you are not familiar with Flower Baselines, you should probably check-"
-"out our `contributing guide for baselines "
-"<https://flower.ai/docs/baselines/how-to-contribute-baselines.html>`_."
+"If you are not familiar with Flower Baselines, please check our "
+"`contributing guide for baselines <https://flower.ai/docs/baselines/how-"
+"to-contribute-baselines.html>`_."
 msgstr ""
 "如果您对 Flower Baselines 还不熟悉，也许可以看看我们的 `Baselines贡献指南 "
 "<https://flower.ai/docs/baselines/how-to-contribute-baselines.html>`_。"
 
-#: ../../source/contributor-ref-good-first-contributions.rst:25
+#: ../../source/contributor-ref-good-first-contributions.rst:26
 #, fuzzy
 msgid ""
-"You should then check out the open `issues "
+"Then take a look at the open `issues "
 "<https://github.com/adap/flower/issues?q=is%3Aopen+is%3Aissue+label%3A%22new+baseline%22>`_"
-" for baseline requests. If you find a baseline that you'd like to work on"
-" and that has no assignees, feel free to assign it to yourself and start "
-"working on it!"
+" for baseline requests. If you find a baseline that you'd like to work "
+"on, and it has no assignees, feel free to assign it to yourself and get "
+"started!"
 msgstr ""
 "然后查看开放的 `issues "
 "<https://github.com/adap/flower/issues?q=is%3Aopen+is%3Aissue+label%3A%22new+baseline%22>`_"
 " baseline请求。如果您发现了自己想做的baseline，而它还没有被分配，请随时把它分配给自己，然后开始工作！"
 
-#: ../../source/contributor-ref-good-first-contributions.rst:30
+#: ../../source/contributor-ref-good-first-contributions.rst:31
+#, fuzzy
 msgid ""
-"Otherwise, if you don't find a baseline you'd like to work on, be sure to"
-" open a new issue with the baseline request template!"
+"If you don't find the baseline you'd like to work on, be sure to open a "
+"new issue with the baseline request template!"
 msgstr "如果您没有找到想要做的baseline，请务必使用baseline请求模板打开一个新问题（GitHub issue）！"
 
-#: ../../source/contributor-ref-good-first-contributions.rst:34
-msgid "Request for examples"
-msgstr "示例请求"
+#: ../../source/contributor-ref-good-first-contributions.rst:35
+#, fuzzy
+msgid "Usage examples"
+msgstr "实例"
 
-#: ../../source/contributor-ref-good-first-contributions.rst:36
+#: ../../source/contributor-ref-good-first-contributions.rst:37
+#, fuzzy
 msgid ""
-"We wish we had more time to write usage examples because we believe they "
-"help users to get started with building what they want to build. Here are"
-" a few ideas where we'd be happy to accept a PR:"
+"We wish we had more time to write usage examples because they help users "
+"to get started with building what they want. If you notice any missing "
+"examples that could help others, feel free to contribute!"
 msgstr "我们希望有更多的时间来撰写使用示例，因为我们相信这些示例可以帮助用户开始构建他们想要的东西。以下是我们乐意接受 PR 的几个想法："
 
-#: ../../source/contributor-ref-good-first-contributions.rst:40
-msgid "Llama 2 fine-tuning, with Hugging Face Transformers and PyTorch"
-msgstr "微调 Llama 2，使用 Hugging Face Transformers 和 PyTorch"
-
-#: ../../source/contributor-ref-good-first-contributions.rst:41
-#: ../../source/tutorial-quickstart-xgboost.rst:7
-msgid "XGBoost"
-msgstr "XGBoost"
-
-#: ../../source/contributor-ref-good-first-contributions.rst:42
-msgid "Android ONNX on-device training"
-msgstr "安卓 ONNX 设备上训练"
-
 #: ../../source/contributor-ref-secure-aggregation-protocols.rst:2
 msgid "Secure Aggregation Protocols"
 msgstr "安全聚合协议"
@@ -27700,6 +27698,10 @@ msgstr "查看此联邦学习 快速入门教程，了解如何使用 Flower 和
 msgid "Quickstart XGBoost"
 msgstr "XGBoost快速入门"
 
+#: ../../source/tutorial-quickstart-xgboost.rst:7
+msgid "XGBoost"
+msgstr "XGBoost"
+
 #: ../../source/tutorial-quickstart-xgboost.rst:9
 msgid ""
 "EXtreme Gradient Boosting (**XGBoost**) is a robust and efficient "
@@ -29804,7 +29806,7 @@ msgid ""
 msgstr "在机器学习中，我们有一个模型和数据。模型可以是一个神经网络（如图所示），也可以是其他东西，比如经典的线性回归。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:41
-msgid "|f150b8d6e0074250822c9f6f7a8de3e0|"
+msgid "|80152fa658904be08c849b4a594b76e1|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:109
@@ -29819,7 +29821,7 @@ msgid ""
 msgstr "我们使用数据来训练模型，以完成一项有用的任务。任务可以是检测图像中的物体、转录音频或玩围棋等游戏。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:53
-msgid "|72772d10debc4abd8373c0bc82985422|"
+msgid "|35b60a1068f944ce937ac2988661aad5|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:111
@@ -29843,7 +29845,7 @@ msgid ""
 msgstr "它源于智能手机上用户与应用程序的交互、汽车上传感器数据的收集、笔记本电脑上键盘输入的接收，或者智能扬声器上某人试着唱的歌。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:67
-msgid "|5815398552ad41d290a3a2631fe8f6ca|"
+msgid "|efead7f2c2224b60b7b42705004c15e6|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:113
@@ -29861,7 +29863,7 @@ msgstr ""
 "\"通常不只是一个地方，而是很多地方。它可能是多个运行同一应用程序的设备。但也可能是多个组织，都在为同一任务生成数据。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:79
-msgid "|e6ac20744bf149378be20ac3dc309356|"
+msgid "|5421fee4e7ed450c903cbcd8a9d8a5d4|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:115
@@ -29878,7 +29880,7 @@ msgid ""
 msgstr "因此，要使用机器学习或任何类型的数据分析，过去使用的方法是在中央服务器上收集所有数据。这个服务器可以在数据中心的某个地方，也可以在云端的某个地方。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:91
-msgid "|a4011ef443c14725b15a8cf33b0e3443|"
+msgid "|811fcf35e9214bd5b4e613e41f7c0a27|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:117
@@ -29893,7 +29895,7 @@ msgid ""
 msgstr "一旦所有数据都收集到一处，我们最终就可以使用机器学习算法在数据上训练我们的模型。这就是我们基本上一直依赖的机器学习方法。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:103
-msgid "|a22faa3617404c06803731525e1c609f|"
+msgid "|e61d38b0948f4c07a7257755f3799b54|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:119
@@ -29914,7 +29916,7 @@ msgid ""
 msgstr "我们刚刚看到的经典机器学习方法可以在某些情况下使用。很好的例子包括对假日照片进行分类或分析网络流量。在这些案例中，所有数据自然都可以在中央服务器上获得。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:138
-msgid "|84a5c9b5041c43c3beab9786197c3e4e|"
+msgid "|e82c29351e2e480087c61b939eb7c041|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:173
@@ -29929,7 +29931,7 @@ msgid ""
 msgstr "但这种方法并不适用于许多其他情况。例如，集中服务器上没有数据，或者一台服务器上的数据不足以训练出一个好的模型。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:150
-msgid "|b5c4be0b52d4493ba8c4af14d7c2db97|"
+msgid "|21ca40f4fb1a405c89098fd1d24880a4|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:175
@@ -30089,7 +30091,7 @@ msgid ""
 msgstr "我们首先在服务器上初始化模型。这与经典的集中式学习完全相同：我们随机或从先前保存的检查点初始化模型参数。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:210
-msgid "|c1c784183d18481186ff65dc261d1335|"
+msgid "|1351a2629c2c46d981b13b19f9fa45f0|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:307
@@ -30114,7 +30116,7 @@ msgid ""
 msgstr "接下来，我们会将全局模型的参数发送到连接的客户端节点（如智能手机等边缘设备或企业的服务器）。这是为了确保每个参与节点都使用相同的模型参数开始本地训练。我们通常只使用几个连接节点，而不是所有节点。这样做的原因是，选择越来越多的客户端节点会导致收益递减。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:225
-msgid "|669fcd1f44ab42f5bbd196c3cf1ecbc2|"
+msgid "|124c2c188b994c7ab1c862cfdb326923|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:309
@@ -30140,7 +30142,7 @@ msgstr ""
 "（mini-batches）。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:240
-msgid "|edfb08758c9441afb6736045a59e154c|"
+msgid "|42e1951c36f2406e93c7ae0ec5b299f9|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:311
@@ -30163,7 +30165,7 @@ msgid ""
 msgstr "经过本地训练后，每个客户节点最初收到的模型参数都会略有不同。参数之所以不同，是因为每个客户端节点的本地数据集中都有不同的数据。然后，客户端节点将这些模型更新发回服务器。它们发送的模型更新既可以是完整的模型参数，也可以只是本地训练过程中积累的梯度。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:255
-msgid "|82338b8bbad24d5ea9df3801aab37852|"
+msgid "|ec637b8a84234d068995ee1ccb2dd3b1|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:313
@@ -30210,7 +30212,7 @@ msgstr ""
 " 100 个示例的 10 倍。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:273
-msgid "|518d994dd2c844898b441da03b858326|"
+msgid "|5bceb9d16b1a4d2db18d8a5b2f0cacb3|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:315
@@ -30318,7 +30320,7 @@ msgstr ""
 "为联邦学习、分析和评估提供了一种统一的方法。它允许用户联邦化任何工作负载、任何 ML 框架和任何编程语言。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:334
-msgid "|7bfcfcb57ae5403f8e18486f45ca48b4|"
+msgid "|502b10044e864ca2b15282a393ab7faf|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:340
@@ -37769,3 +37771,57 @@ msgstr ""
 #~ msgid "|4ab50bc01a9f426a91a2c0cbc3ab7a84|"
 #~ msgstr ""
 
+#~ msgid "Request for Flower Baselines"
+#~ msgstr "Flower Baselines的申请"
+
+#~ msgid "Request for examples"
+#~ msgstr "示例请求"
+
+#~ msgid "Llama 2 fine-tuning, with Hugging Face Transformers and PyTorch"
+#~ msgstr "微调 Llama 2，使用 Hugging Face Transformers 和 PyTorch"
+
+#~ msgid "Android ONNX on-device training"
+#~ msgstr "安卓 ONNX 设备上训练"
+
+#~ msgid "|f150b8d6e0074250822c9f6f7a8de3e0|"
+#~ msgstr ""
+
+#~ msgid "|72772d10debc4abd8373c0bc82985422|"
+#~ msgstr ""
+
+#~ msgid "|5815398552ad41d290a3a2631fe8f6ca|"
+#~ msgstr ""
+
+#~ msgid "|e6ac20744bf149378be20ac3dc309356|"
+#~ msgstr ""
+
+#~ msgid "|a4011ef443c14725b15a8cf33b0e3443|"
+#~ msgstr ""
+
+#~ msgid "|a22faa3617404c06803731525e1c609f|"
+#~ msgstr ""
+
+#~ msgid "|84a5c9b5041c43c3beab9786197c3e4e|"
+#~ msgstr ""
+
+#~ msgid "|b5c4be0b52d4493ba8c4af14d7c2db97|"
+#~ msgstr ""
+
+#~ msgid "|c1c784183d18481186ff65dc261d1335|"
+#~ msgstr ""
+
+#~ msgid "|669fcd1f44ab42f5bbd196c3cf1ecbc2|"
+#~ msgstr ""
+
+#~ msgid "|edfb08758c9441afb6736045a59e154c|"
+#~ msgstr ""
+
+#~ msgid "|82338b8bbad24d5ea9df3801aab37852|"
+#~ msgstr ""
+
+#~ msgid "|518d994dd2c844898b441da03b858326|"
+#~ msgstr ""
+
+#~ msgid "|7bfcfcb57ae5403f8e18486f45ca48b4|"
+#~ msgstr ""
+

From 07c11ecc95c5b5a8ac3a6fd7561a1539fc3d2f2c Mon Sep 17 00:00:00 2001
From: Javier <jafermarq@users.noreply.github.com>
Date: Sat, 30 Nov 2024 14:41:14 +0000
Subject: [PATCH 008/104] fix(framework) Pass state factory instead of state
 object to `AuthenticateServerInterceptor` (#4605)

---
 src/py/flwr/server/app.py                     |  2 +-
 .../fleet/grpc_rere/server_interceptor.py     | 23 ++++++++++---------
 .../grpc_rere/server_interceptor_test.py      |  2 +-
 .../superlink/linkstate/sqlite_linkstate.py   |  3 ---
 4 files changed, 14 insertions(+), 16 deletions(-)

diff --git a/src/py/flwr/server/app.py b/src/py/flwr/server/app.py
index a648d3e41bd6..508f2dfc9685 100644
--- a/src/py/flwr/server/app.py
+++ b/src/py/flwr/server/app.py
@@ -360,7 +360,7 @@ def run_superlink() -> None:
                     "Node authentication enabled with %d known public keys",
                     len(node_public_keys),
                 )
-                interceptors = [AuthenticateServerInterceptor(state)]
+                interceptors = [AuthenticateServerInterceptor(state_factory)]
 
             fleet_server = _run_fleet_api_grpc_rere(
                 address=fleet_address,
diff --git a/src/py/flwr/server/superlink/fleet/grpc_rere/server_interceptor.py b/src/py/flwr/server/superlink/fleet/grpc_rere/server_interceptor.py
index 2e7623c34241..c07ee0788493 100644
--- a/src/py/flwr/server/superlink/fleet/grpc_rere/server_interceptor.py
+++ b/src/py/flwr/server/superlink/fleet/grpc_rere/server_interceptor.py
@@ -45,7 +45,7 @@
 )
 from flwr.proto.node_pb2 import Node  # pylint: disable=E0611
 from flwr.proto.run_pb2 import GetRunRequest, GetRunResponse  # pylint: disable=E0611
-from flwr.server.superlink.linkstate import LinkState
+from flwr.server.superlink.linkstate import LinkStateFactory
 
 _PUBLIC_KEY_HEADER = "public-key"
 _AUTH_TOKEN_HEADER = "auth-token"
@@ -84,15 +84,16 @@ def _get_value_from_tuples(
 class AuthenticateServerInterceptor(grpc.ServerInterceptor):  # type: ignore
     """Server interceptor for node authentication."""
 
-    def __init__(self, state: LinkState):
-        self.state = state
+    def __init__(self, state_factory: LinkStateFactory):
+        self.state_factory = state_factory
+        state = self.state_factory.state()
 
         self.node_public_keys = state.get_node_public_keys()
         if len(self.node_public_keys) == 0:
             log(WARNING, "Authentication enabled, but no known public keys configured")
 
-        private_key = self.state.get_server_private_key()
-        public_key = self.state.get_server_public_key()
+        private_key = state.get_server_private_key()
+        public_key = state.get_server_public_key()
 
         if private_key is None or public_key is None:
             raise ValueError("Error loading authentication keys")
@@ -154,7 +155,7 @@ def _generic_method_handler(
                 context.abort(grpc.StatusCode.UNAUTHENTICATED, "Access denied")
 
             # Verify node_id
-            node_id = self.state.get_node_id(node_public_key_bytes)
+            node_id = self.state_factory.state().get_node_id(node_public_key_bytes)
 
             if not self._verify_node_id(node_id, request):
                 context.abort(grpc.StatusCode.UNAUTHENTICATED, "Access denied")
@@ -186,7 +187,7 @@ def _verify_node_id(
                 return False
             return request.task_res_list[0].task.producer.node_id == node_id
         if isinstance(request, GetRunRequest):
-            return node_id in self.state.get_nodes(request.run_id)
+            return node_id in self.state_factory.state().get_nodes(request.run_id)
         return request.node.node_id == node_id
 
     def _verify_hmac(
@@ -210,17 +211,17 @@ def _create_authenticated_node(
                 ),
             )
         )
-
-        node_id = self.state.get_node_id(public_key_bytes)
+        state = self.state_factory.state()
+        node_id = state.get_node_id(public_key_bytes)
 
         # Handle `CreateNode` here instead of calling the default method handler
         # Return previously assigned `node_id` for the provided `public_key`
         if node_id is not None:
-            self.state.acknowledge_ping(node_id, request.ping_interval)
+            state.acknowledge_ping(node_id, request.ping_interval)
             return CreateNodeResponse(node=Node(node_id=node_id, anonymous=False))
 
         # No `node_id` exists for the provided `public_key`
         # Handle `CreateNode` here instead of calling the default method handler
         # Note: the innermost `CreateNode` method will never be called
-        node_id = self.state.create_node(request.ping_interval, public_key_bytes)
+        node_id = state.create_node(request.ping_interval, public_key_bytes)
         return CreateNodeResponse(node=Node(node_id=node_id, anonymous=False))
diff --git a/src/py/flwr/server/superlink/fleet/grpc_rere/server_interceptor_test.py b/src/py/flwr/server/superlink/fleet/grpc_rere/server_interceptor_test.py
index fe6f0540e280..ce43fc4bae0a 100644
--- a/src/py/flwr/server/superlink/fleet/grpc_rere/server_interceptor_test.py
+++ b/src/py/flwr/server/superlink/fleet/grpc_rere/server_interceptor_test.py
@@ -73,7 +73,7 @@ def setUp(self) -> None:
         )
         self.state.store_node_public_keys({public_key_to_bytes(self._node_public_key)})
 
-        self._server_interceptor = AuthenticateServerInterceptor(self.state)
+        self._server_interceptor = AuthenticateServerInterceptor(state_factory)
         self._server: grpc.Server = _run_fleet_api_grpc_rere(
             FLEET_API_GRPC_RERE_DEFAULT_ADDRESS,
             state_factory,
diff --git a/src/py/flwr/server/superlink/linkstate/sqlite_linkstate.py b/src/py/flwr/server/superlink/linkstate/sqlite_linkstate.py
index cf5f4e8f8f49..54df4685bf9a 100644
--- a/src/py/flwr/server/superlink/linkstate/sqlite_linkstate.py
+++ b/src/py/flwr/server/superlink/linkstate/sqlite_linkstate.py
@@ -19,7 +19,6 @@
 import json
 import re
 import sqlite3
-import threading
 import time
 from collections.abc import Sequence
 from logging import DEBUG, ERROR, WARNING
@@ -183,7 +182,6 @@ def __init__(
         """
         self.database_path = database_path
         self.conn: Optional[sqlite3.Connection] = None
-        self.lock = threading.RLock()
 
     def initialize(self, log_queries: bool = False) -> list[tuple[str]]:
         """Create tables if they don't exist yet.
@@ -216,7 +214,6 @@ def initialize(self, log_queries: bool = False) -> list[tuple[str]]:
         cur.execute(SQL_CREATE_TABLE_PUBLIC_KEY)
         cur.execute(SQL_CREATE_INDEX_ONLINE_UNTIL)
         res = cur.execute("SELECT name FROM sqlite_schema;")
-
         return res.fetchall()
 
     def query(

From ae9ec5b58638f93745e5311a62d766e5f33b9dd7 Mon Sep 17 00:00:00 2001
From: Robert Steiner <robert@flower.dev>
Date: Mon, 2 Dec 2024 09:23:18 +0100
Subject: [PATCH 009/104] docs(framework:skip) Add flwr 1.13.1 to docker
 READMEs (#4603)

Signed-off-by: Robert Steiner <robert@flower.ai>
---
 src/docker/base/README.md      | 10 +++++++++-
 src/docker/clientapp/README.md |  5 ++++-
 src/docker/serverapp/README.md |  5 ++++-
 src/docker/superlink/README.md |  4 +++-
 src/docker/supernode/README.md |  6 +++++-
 5 files changed, 25 insertions(+), 5 deletions(-)

diff --git a/src/docker/base/README.md b/src/docker/base/README.md
index ef290a26fec4..9cf31ec0d048 100644
--- a/src/docker/base/README.md
+++ b/src/docker/base/README.md
@@ -21,8 +21,16 @@
 
 - `unstable`
   - points to the last successful build of the `main` branch
-- `nightly`, `<version>.dev<YYYYMMDD>` e.g. `1.13.0.dev20241014`
+- `nightly`, `<version>.dev<YYYYMMDD>` e.g. `1.14.0.dev20241128`
   - uses Python 3.11 and Ubuntu 24.04
+- `1.13.1-py3.11-alpine3.19`
+- `1.13.1-py3.11-ubuntu24.04`
+- `1.13.1-py3.10-ubuntu24.04`
+- `1.13.1-py3.9-ubuntu24.04`
+- `1.13.0-py3.11-alpine3.19`
+- `1.13.0-py3.11-ubuntu24.04`
+- `1.13.0-py3.10-ubuntu24.04`
+- `1.13.0-py3.9-ubuntu24.04`
 - `1.12.0-py3.11-alpine3.19`
 - `1.12.0-py3.11-ubuntu24.04`
 - `1.12.0-py3.10-ubuntu24.04`
diff --git a/src/docker/clientapp/README.md b/src/docker/clientapp/README.md
index e2f6f35d1769..e41abeb6dde8 100644
--- a/src/docker/clientapp/README.md
+++ b/src/docker/clientapp/README.md
@@ -21,8 +21,11 @@
 
 - `unstable`
   - points to the last successful build of the `main` branch
-- `nightly`, `<version>.dev<YYYYMMDD>` e.g. `1.14.0.dev20241120`
+- `nightly`, `<version>.dev<YYYYMMDD>` e.g. `1.14.0.dev20241128`
   - uses Python 3.11 and Ubuntu 24.04
+- `1.13.1`, `1.13.1-py3.11-ubuntu24.04`
+- `1.13.1-py3.10-ubuntu24.04`
+- `1.13.1-py3.9-ubuntu24.04`
 - `1.13.0`, `1.13.0-py3.11-ubuntu24.04`
 - `1.13.0-py3.10-ubuntu24.04`
 - `1.13.0-py3.9-ubuntu24.04`
diff --git a/src/docker/serverapp/README.md b/src/docker/serverapp/README.md
index bcba0f3ef889..e2dad5ee8c56 100644
--- a/src/docker/serverapp/README.md
+++ b/src/docker/serverapp/README.md
@@ -21,8 +21,11 @@
 
 - `unstable`
   - points to the last successful build of the `main` branch
-- `nightly`, `<version>.dev<YYYYMMDD>` e.g. `1.14.0.dev20241120`
+- `nightly`, `<version>.dev<YYYYMMDD>` e.g. `1.14.0.dev20241128`
   - uses Python 3.11 and Ubuntu 24.04
+- `1.13.1`, `1.13.1-py3.11-ubuntu24.04`
+- `1.13.1-py3.10-ubuntu24.04`
+- `1.13.1-py3.9-ubuntu24.04`
 - `1.13.0`, `1.13.0-py3.11-ubuntu24.04`
 - `1.13.0-py3.10-ubuntu24.04`
 - `1.13.0-py3.9-ubuntu24.04`
diff --git a/src/docker/superlink/README.md b/src/docker/superlink/README.md
index 444003964a6b..47827ba6c0ef 100644
--- a/src/docker/superlink/README.md
+++ b/src/docker/superlink/README.md
@@ -21,8 +21,10 @@
 
 - `unstable`
   - points to the last successful build of the `main` branch
-- `nightly`, `<version>.dev<YYYYMMDD>` e.g. `1.14.0.dev20241120`
+- `nightly`, `<version>.dev<YYYYMMDD>` e.g. `1.14.0.dev20241128`
   - uses Python 3.11 and Ubuntu 24.04
+- `1.13.1`, `1.13.1-py3.11-alpine3.19`
+- `1.13.1-py3.11-ubuntu24.04`
 - `1.13.0`, `1.13.0-py3.11-alpine3.19`
 - `1.13.0-py3.11-ubuntu24.04`
 - `1.12.0`, `1.12.0-py3.11-alpine3.19`
diff --git a/src/docker/supernode/README.md b/src/docker/supernode/README.md
index c6b207ffe7cf..69e5c69e1bec 100644
--- a/src/docker/supernode/README.md
+++ b/src/docker/supernode/README.md
@@ -21,8 +21,12 @@
 
 - `unstable`
   - points to the last successful build of the `main` branch
-- `nightly`, `<version>.dev<YYYYMMDD>` e.g. `1.14.0.dev20241120`
+- `nightly`, `<version>.dev<YYYYMMDD>` e.g. `1.14.0.dev20241128`
   - uses Python 3.11 and Ubuntu 24.04
+- `1.13.1`, `1.13.1-py3.11-alpine3.19`
+- `1.13.1-py3.11-ubuntu24.04`
+- `1.13.1-py3.10-ubuntu24.04`
+- `1.13.1-py3.9-ubuntu24.04`
 - `1.13.0`, `1.13.0-py3.11-alpine3.19`
 - `1.13.0-py3.11-ubuntu24.04`
 - `1.13.0-py3.10-ubuntu24.04`

From b440227f1f922347712974db10936a270422c8c4 Mon Sep 17 00:00:00 2001
From: Taner Topal <taner@flower.ai>
Date: Mon, 2 Dec 2024 14:00:15 +0100
Subject: [PATCH 010/104] (framework:skip) Update .gitignore (#4614)

---
 .gitignore | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/.gitignore b/.gitignore
index 4c52fa332037..96789cbf6e00 100644
--- a/.gitignore
+++ b/.gitignore
@@ -17,6 +17,9 @@ examples/**/dataset/**
 # Flower Baselines
 baselines/datasets/leaf
 
+# Exclude ee package
+src/py/flwr/ee
+
 # macOS
 .DS_Store
 

From 29d0181385abd9a04ae30d1a8ae44a84c44a1f39 Mon Sep 17 00:00:00 2001
From: Yan Gao <y.gaogy@gmail.com>
Date: Tue, 3 Dec 2024 23:42:14 +0800
Subject: [PATCH 011/104] Update eval readmes (#4623)

---
 benchmarks/flowertune-llm/evaluation/finance/README.md     | 1 +
 benchmarks/flowertune-llm/evaluation/general-nlp/README.md | 1 +
 benchmarks/flowertune-llm/evaluation/medical/README.md     | 1 +
 3 files changed, 3 insertions(+)

diff --git a/benchmarks/flowertune-llm/evaluation/finance/README.md b/benchmarks/flowertune-llm/evaluation/finance/README.md
index b5595433a238..15d2410b8ca4 100644
--- a/benchmarks/flowertune-llm/evaluation/finance/README.md
+++ b/benchmarks/flowertune-llm/evaluation/finance/README.md
@@ -27,6 +27,7 @@ huggingface-cli login
 
 ```bash
 python eval.py \
+--base-model-name-path=your-base-model-name \ # e.g., mistralai/Mistral-7B-v0.3
 --peft-path=/path/to/fine-tuned-peft-model-dir/ \ # e.g., ./peft_1
 --run-name=fl  \ # specified name for this run  
 --batch-size=32 \
diff --git a/benchmarks/flowertune-llm/evaluation/general-nlp/README.md b/benchmarks/flowertune-llm/evaluation/general-nlp/README.md
index c3fd71da6ea2..5acd75285dd3 100644
--- a/benchmarks/flowertune-llm/evaluation/general-nlp/README.md
+++ b/benchmarks/flowertune-llm/evaluation/general-nlp/README.md
@@ -27,6 +27,7 @@ huggingface-cli login
 
 ```bash
 python eval.py \
+--base-model-name-path=your-base-model-name \ # e.g., mistralai/Mistral-7B-v0.3
 --peft-path=/path/to/fine-tuned-peft-model-dir/ \ # e.g., ./peft_1
 --run-name=fl  \ # specified name for this run  
 --batch-size=16 \
diff --git a/benchmarks/flowertune-llm/evaluation/medical/README.md b/benchmarks/flowertune-llm/evaluation/medical/README.md
index 628489ce8de6..6a519e8a7c54 100644
--- a/benchmarks/flowertune-llm/evaluation/medical/README.md
+++ b/benchmarks/flowertune-llm/evaluation/medical/README.md
@@ -27,6 +27,7 @@ huggingface-cli login
 
 ```bash
 python eval.py \
+--base-model-name-path=your-base-model-name \ # e.g., mistralai/Mistral-7B-v0.3
 --peft-path=/path/to/fine-tuned-peft-model-dir/ \ # e.g., ./peft_1
 --run-name=fl  \ # specified name for this run  
 --batch-size=16 \

From b57e9e7817edc166a5075cbe689b22f9d4279d72 Mon Sep 17 00:00:00 2001
From: niconepo <nicolas.heinz@gmail.com>
Date: Wed, 4 Dec 2024 09:26:17 +0100
Subject: [PATCH 012/104] fix minor typos (#4624)

---
 datasets/doc/source/index.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/datasets/doc/source/index.rst b/datasets/doc/source/index.rst
index 422d93582a02..55e4ea963453 100644
--- a/datasets/doc/source/index.rst
+++ b/datasets/doc/source/index.rst
@@ -78,13 +78,13 @@ Main features
 Flower Datasets library supports:
 
 - **Downloading datasets** - choose the dataset from Hugging Face's ``dataset`` (`link <https://huggingface.co/datasets>`_)(*)
-- **Partitioning datasets** - choose one of the implemented partitioning scheme or create your own.
+- **Partitioning datasets** - choose one of the implemented partitioning schemes or create your own.
 - **Creating centralized datasets** - leave parts of the dataset unpartitioned (e.g. for centralized evaluation)
 - **Visualization of the partitioned datasets** - visualize the label distribution of the partitioned dataset (and compare the results on different parameters of the same partitioning schemes, different datasets, different partitioning schemes, or any mix of them)
 
 .. note::
 
-  (*) Once the dataset is available on HuggingFace Hub it can be **immediately** used in ``Flower Datasets`` (no approval from the Flower team needed, no custom code needed).
+  (*) Once the dataset is available on HuggingFace Hub, it can be **immediately** used in ``Flower Datasets`` without requiring approval from the Flower team or the need for custom code.
 
 
 .. image:: ./_static/readme/comparison_of_partitioning_schemes.png
@@ -101,7 +101,7 @@ Thanks to using Hugging Face's ``datasets`` used under the hood, Flower Datasets
 - Jax
 - Arrow
 
-Here are a few of the ``Partitioner`` s that are available: (for a full list see `link <ref-api/flwr_datasets.partitioner.html#module-flwr_datasets.partitioner>`_ )
+Here are a few of the ``Partitioners`` that are available: (for a full list see `link <ref-api/flwr_datasets.partitioner.html#module-flwr_datasets.partitioner>`_ )
 
 * Partitioner (the abstract base class) ``Partitioner``
 * IID partitioning ``IidPartitioner(num_partitions)``
@@ -127,7 +127,7 @@ What makes Flower Datasets stand out from other libraries?
 
 * Access to the largest online repository of datasets:
 
-  * The library functionality is independent of the dataset, so you can use any dataset available on `🤗Hugging Face Datasets <https://huggingface.co/datasets>`_, which means that others can immediately benefit from the dataset you added.
+  * The library functionality is independent of the dataset, so you can use any dataset available on `🤗Hugging Face Datasets <https://huggingface.co/datasets>`_. This means that others can immediately benefit from the dataset you added.
 
   * Out-of-the-box reproducibility across different projects.
 

From 93d6ae417a69d4671e0af4194dc6f5ea78ef21a5 Mon Sep 17 00:00:00 2001
From: Adam Narozniak <51029327+adam-narozniak@users.noreply.github.com>
Date: Wed, 4 Dec 2024 09:59:56 +0100
Subject: [PATCH 013/104] feat(datasets) Add a check for same object
 partitioners (#4335)

Co-authored-by: jafermarq <javier@flower.ai>
---
 datasets/flwr_datasets/federated_dataset.py   | 18 +++++++
 .../flwr_datasets/federated_dataset_test.py   | 52 +++++++++++++++++++
 2 files changed, 70 insertions(+)

diff --git a/datasets/flwr_datasets/federated_dataset.py b/datasets/flwr_datasets/federated_dataset.py
index 72ea54773564..8659aa03313b 100644
--- a/datasets/flwr_datasets/federated_dataset.py
+++ b/datasets/flwr_datasets/federated_dataset.py
@@ -128,6 +128,7 @@ def __init__(
         self._partitioners: Dict[str, Partitioner] = _instantiate_partitioners(
             partitioners
         )
+        self._check_partitioners_correctness()
         self._shuffle = shuffle
         self._seed = seed
         #  _dataset is prepared lazily on the first call to `load_partition`
@@ -336,3 +337,20 @@ def _check_if_no_split_keyword_possible(self) -> None:
                 "Please set the `split` argument. You can only omit the split keyword "
                 "if there is exactly one partitioner specified."
             )
+
+    def _check_partitioners_correctness(self) -> None:
+        """Check if the partitioners are correctly specified.
+
+        Check if each partitioner is a different Python object. Using the same
+        partitioner for different splits is not allowed.
+        """
+        partitioners_keys = list(self._partitioners.keys())
+        for i, first_split in enumerate(partitioners_keys):
+            for j in range(i + 1, len(partitioners_keys)):
+                second_split = partitioners_keys[j]
+                if self._partitioners[first_split] is self._partitioners[second_split]:
+                    raise ValueError(
+                        f"The same partitioner object is used for multiple splits: "
+                        f"('{first_split}', '{second_split}'). "
+                        "Each partitioner should be a separate object."
+                    )
diff --git a/datasets/flwr_datasets/federated_dataset_test.py b/datasets/flwr_datasets/federated_dataset_test.py
index bbdfa42292c2..6c12ee0e2e1a 100644
--- a/datasets/flwr_datasets/federated_dataset_test.py
+++ b/datasets/flwr_datasets/federated_dataset_test.py
@@ -32,6 +32,7 @@
     _load_mocked_dataset_dict_by_partial_download,
 )
 from flwr_datasets.partitioner import IidPartitioner, NaturalIdPartitioner, Partitioner
+from flwr_datasets.preprocessor.divider import Divider
 
 mocked_datasets = ["cifar100", "svhn", "sentiment140", "speech_commands"]
 
@@ -568,6 +569,57 @@ def test_use_load_dataset_kwargs(self) -> None:
         with self.assertRaises(ValueError):
             _ = fds.load_partition(0)
 
+    def test_incorrect_two_partitioners(self) -> None:
+        """Test if the method raises ValueError with incorrect partitioners."""
+        partitioner = IidPartitioner(num_partitions=10)
+        partitioners: dict[str, Union[Partitioner, int]] = {
+            "train": partitioner,
+            "test": partitioner,
+        }
+        first_split = "train"
+        second_split = "test"
+        with self.assertRaises(ValueError) as context:
+            FederatedDataset(
+                dataset="mnist",
+                partitioners=partitioners,
+            )
+        self.assertIn(
+            f"The same partitioner object is used for multiple splits: "
+            f"('{first_split}', '{second_split}'). "
+            "Each partitioner should be a separate object.",
+            str(context.exception),
+        )
+
+    def test_incorrect_three_partitioners(self) -> None:
+        """Test if the method raises ValueError with incorrect partitioners."""
+        partitioner = IidPartitioner(num_partitions=10)
+        partitioners: dict[str, Union[int, Partitioner]] = {
+            "train1": partitioner,
+            "train2": 10,
+            "test": partitioner,
+        }
+        divider = Divider(
+            divide_config={
+                "train1": 0.5,
+                "train2": 0.5,
+            },
+            divide_split="train",
+        )
+
+        with self.assertRaises(
+            ValueError,
+        ) as context:
+
+            FederatedDataset(
+                dataset="mnist", partitioners=partitioners, preprocessor=divider
+            )
+
+        self.assertIn(
+            "The same partitioner object is used for multiple splits: "
+            "('train1', 'test'). Each partitioner should be a separate object.",
+            str(context.exception),
+        )
+
 
 def datasets_are_equal(ds1: Dataset, ds2: Dataset) -> bool:
     """Check if two Datasets have the same values."""

From d8b00b36f5723bf50adf9b1ef630cb7974312482 Mon Sep 17 00:00:00 2001
From: Adam Narozniak <51029327+adam-narozniak@users.noreply.github.com>
Date: Wed, 4 Dec 2024 11:51:47 +0100
Subject: [PATCH 014/104] docs(datasets) Add recommended datasets list to index
 (#4627)

Co-authored-by: jafermarq <javier@flower.ai>
---
 datasets/doc/source/index.rst                 |  14 ++
 .../source/recommended-fl-datasets-tables.rst | 153 +++++++++++++++++
 .../doc/source/recommended-fl-datasets.rst    | 155 +-----------------
 3 files changed, 169 insertions(+), 153 deletions(-)
 create mode 100644 datasets/doc/source/recommended-fl-datasets-tables.rst

diff --git a/datasets/doc/source/index.rst b/datasets/doc/source/index.rst
index 55e4ea963453..4137f5f2e148 100644
--- a/datasets/doc/source/index.rst
+++ b/datasets/doc/source/index.rst
@@ -154,6 +154,20 @@ The Flower Community is growing quickly - we're a friendly group of researchers,
 
     Join us on Slack
 
+Recommended FL Datasets
+-----------------------
+
+Below we present a list of recommended datasets for federated learning research, which can be
+used with Flower Datasets ``flwr-datasets``.
+
+.. note::
+
+    All datasets from `HuggingFace Hub <https://huggingface.co/datasets>`_ can be used with our library. This page presents just a set of datasets we collected that you might find useful.
+
+For more information about any dataset, visit its page by clicking the dataset name. 
+
+.. include:: recommended-fl-datasets-tables.rst
+
 .. _demo:
 Demo
 ----
diff --git a/datasets/doc/source/recommended-fl-datasets-tables.rst b/datasets/doc/source/recommended-fl-datasets-tables.rst
new file mode 100644
index 000000000000..f69025426d47
--- /dev/null
+++ b/datasets/doc/source/recommended-fl-datasets-tables.rst
@@ -0,0 +1,153 @@
+Image Datasets
+~~~~~~~~~~~~~~
+
+.. list-table:: Image Datasets
+   :widths: 40 40 20
+   :header-rows: 1
+
+   * - Name
+     - Size
+     - Image Shape
+   * - `ylecun/mnist <https://huggingface.co/datasets/ylecun/mnist>`_
+     - train 60k;  
+       test 10k
+     - 28x28
+   * - `uoft-cs/cifar10 <https://huggingface.co/datasets/uoft-cs/cifar10>`_
+     - train 50k;  
+       test 10k
+     - 32x32x3
+   * - `uoft-cs/cifar100 <https://huggingface.co/datasets/uoft-cs/cifar100>`_
+     - train 50k;  
+       test 10k
+     - 32x32x3
+   * - `zalando-datasets/fashion_mnist <https://huggingface.co/datasets/zalando-datasets/fashion_mnist>`_
+     - train 60k;  
+       test 10k
+     - 28x28
+   * - `flwrlabs/femnist <https://huggingface.co/datasets/flwrlabs/femnist>`_
+     - train 814k
+     - 28x28
+   * - `zh-plus/tiny-imagenet <https://huggingface.co/datasets/zh-plus/tiny-imagenet>`_
+     - train 100k;  
+       valid 10k
+     - 64x64x3
+   * - `flwrlabs/usps <https://huggingface.co/datasets/flwrlabs/usps>`_
+     - train 7.3k;  
+       test 2k
+     - 16x16
+   * - `flwrlabs/pacs <https://huggingface.co/datasets/flwrlabs/pacs>`_
+     - train 10k
+     - 227x227
+   * - `flwrlabs/cinic10 <https://huggingface.co/datasets/flwrlabs/cinic10>`_
+     - train 90k;  
+       valid 90k;  
+       test 90k
+     - 32x32x3
+   * - `flwrlabs/caltech101 <https://huggingface.co/datasets/flwrlabs/caltech101>`_
+     - train 8.7k
+     - varies
+   * - `flwrlabs/office-home <https://huggingface.co/datasets/flwrlabs/office-home>`_
+     - train 15.6k
+     - varies
+   * - `flwrlabs/fed-isic2019 <https://huggingface.co/datasets/flwrlabs/fed-isic2019>`_
+     - train 18.6k;  
+       test 4.7k
+     - varies
+   * - `ufldl-stanford/svhn <https://huggingface.co/datasets/ufldl-stanford/svhn>`_
+     - train 73.3k;  
+       test 26k;  
+       extra 531k
+     - 32x32x3
+   * - `sasha/dog-food <https://huggingface.co/datasets/sasha/dog-food>`_
+     - train 2.1k;  
+       test 0.9k
+     - varies
+   * - `Mike0307/MNIST-M <https://huggingface.co/datasets/Mike0307/MNIST-M>`_
+     - train 59k;  
+       test 9k
+     - 32x32
+
+Audio Datasets
+~~~~~~~~~~~~~~
+
+.. list-table:: Audio Datasets
+   :widths: 35 30 15
+   :header-rows: 1
+
+   * - Name
+     - Size
+     - Subset
+   * - `google/speech_commands <https://huggingface.co/datasets/google/speech_commands>`_
+     - train 64.7k
+     - v0.01
+   * - `google/speech_commands <https://huggingface.co/datasets/google/speech_commands>`_
+     - train 105.8k
+     - v0.02
+   * - `flwrlabs/ambient-acoustic-context <https://huggingface.co/datasets/flwrlabs/ambient-acoustic-context>`_
+     - train 70.3k
+     - 
+   * - `fixie-ai/common_voice_17_0 <https://huggingface.co/datasets/fixie-ai/common_voice_17_0>`_
+     - varies
+     - 14 versions
+   * - `fixie-ai/librispeech_asr <https://huggingface.co/datasets/fixie-ai/librispeech_asr>`_
+     - varies
+     - clean/other
+
+Tabular Datasets
+~~~~~~~~~~~~~~~~
+
+
+.. list-table:: Tabular Datasets
+   :widths: 35 30
+   :header-rows: 1
+
+   * - Name
+     - Size
+   * - `scikit-learn/adult-census-income <https://huggingface.co/datasets/scikit-learn/adult-census-income>`_
+     - train 32.6k
+   * - `jlh/uci-mushrooms <https://huggingface.co/datasets/jlh/uci-mushrooms>`_
+     - train 8.1k
+   * - `scikit-learn/iris <https://huggingface.co/datasets/scikit-learn/iris>`_
+     - train 150
+
+Text Datasets
+~~~~~~~~~~~~~
+
+.. list-table:: Text Datasets
+   :widths: 40 30 30
+   :header-rows: 1
+
+   * - Name
+     - Size
+     - Category
+   * - `sentiment140 <https://huggingface.co/datasets/sentiment140>`_
+     - train 1.6M;  
+       test 0.5k
+     - Sentiment
+   * - `google-research-datasets/mbpp <https://huggingface.co/datasets/google-research-datasets/mbpp>`_
+     - full 974; sanitized 427
+     - General
+   * - `openai/openai_humaneval <https://huggingface.co/datasets/openai/openai_humaneval>`_
+     - test 164
+     - General
+   * - `lukaemon/mmlu <https://huggingface.co/datasets/lukaemon/mmlu>`_
+     - varies
+     - General
+   * - `takala/financial_phrasebank <https://huggingface.co/datasets/takala/financial_phrasebank>`_
+     - train 4.8k
+     - Financial
+   * - `pauri32/fiqa-2018 <https://huggingface.co/datasets/pauri32/fiqa-2018>`_
+     - train 0.9k; validation 0.1k; test 0.2k
+     - Financial
+   * - `zeroshot/twitter-financial-news-sentiment <https://huggingface.co/datasets/zeroshot/twitter-financial-news-sentiment>`_
+     - train 9.5k; validation 2.4k
+     - Financial
+   * - `bigbio/pubmed_qa <https://huggingface.co/datasets/bigbio/pubmed_qa>`_
+     - train 2M; validation 11k
+     - Medical
+   * - `openlifescienceai/medmcqa <https://huggingface.co/datasets/openlifescienceai/medmcqa>`_
+     - train 183k; validation 4.3k; test 6.2k
+     - Medical
+   * - `bigbio/med_qa <https://huggingface.co/datasets/bigbio/med_qa>`_
+     - train 10.1k; test 1.3k; validation 1.3k
+     - Medical
diff --git a/datasets/doc/source/recommended-fl-datasets.rst b/datasets/doc/source/recommended-fl-datasets.rst
index 92479bd0542a..21b47d0d257f 100644
--- a/datasets/doc/source/recommended-fl-datasets.rst
+++ b/datasets/doc/source/recommended-fl-datasets.rst
@@ -11,157 +11,6 @@ see the full FL example with Flower and Flower Datasets open the `quickstart-pyt
 
     All datasets from `HuggingFace Hub <https://huggingface.co/datasets>`_ can be used with our library. This page presents just a set of datasets we collected that you might find useful.
 
-For more information about any dataset, visit its page by clicking the dataset name. For more information how to use the
+For more information about any dataset, visit its page by clicking the dataset name. 
 
-Image Datasets
---------------
-
-.. list-table:: Image Datasets
-   :widths: 40 40 20
-   :header-rows: 1
-
-   * - Name
-     - Size
-     - Image Shape
-   * - `ylecun/mnist <https://huggingface.co/datasets/ylecun/mnist>`_
-     - train 60k;  
-       test 10k
-     - 28x28
-   * - `uoft-cs/cifar10 <https://huggingface.co/datasets/uoft-cs/cifar10>`_
-     - train 50k;  
-       test 10k
-     - 32x32x3
-   * - `uoft-cs/cifar100 <https://huggingface.co/datasets/uoft-cs/cifar100>`_
-     - train 50k;  
-       test 10k
-     - 32x32x3
-   * - `zalando-datasets/fashion_mnist <https://huggingface.co/datasets/zalando-datasets/fashion_mnist>`_
-     - train 60k;  
-       test 10k
-     - 28x28
-   * - `flwrlabs/femnist <https://huggingface.co/datasets/flwrlabs/femnist>`_
-     - train 814k
-     - 28x28
-   * - `zh-plus/tiny-imagenet <https://huggingface.co/datasets/zh-plus/tiny-imagenet>`_
-     - train 100k;  
-       valid 10k
-     - 64x64x3
-   * - `flwrlabs/usps <https://huggingface.co/datasets/flwrlabs/usps>`_
-     - train 7.3k;  
-       test 2k
-     - 16x16
-   * - `flwrlabs/pacs <https://huggingface.co/datasets/flwrlabs/pacs>`_
-     - train 10k
-     - 227x227
-   * - `flwrlabs/cinic10 <https://huggingface.co/datasets/flwrlabs/cinic10>`_
-     - train 90k;  
-       valid 90k;  
-       test 90k
-     - 32x32x3
-   * - `flwrlabs/caltech101 <https://huggingface.co/datasets/flwrlabs/caltech101>`_
-     - train 8.7k
-     - varies
-   * - `flwrlabs/office-home <https://huggingface.co/datasets/flwrlabs/office-home>`_
-     - train 15.6k
-     - varies
-   * - `flwrlabs/fed-isic2019 <https://huggingface.co/datasets/flwrlabs/fed-isic2019>`_
-     - train 18.6k;  
-       test 4.7k
-     - varies
-   * - `ufldl-stanford/svhn <https://huggingface.co/datasets/ufldl-stanford/svhn>`_
-     - train 73.3k;  
-       test 26k;  
-       extra 531k
-     - 32x32x3
-   * - `sasha/dog-food <https://huggingface.co/datasets/sasha/dog-food>`_
-     - train 2.1k;  
-       test 0.9k
-     - varies
-   * - `Mike0307/MNIST-M <https://huggingface.co/datasets/Mike0307/MNIST-M>`_
-     - train 59k;  
-       test 9k
-     - 32x32
-
-Audio Datasets
---------------
-
-.. list-table:: Audio Datasets
-   :widths: 35 30 15
-   :header-rows: 1
-
-   * - Name
-     - Size
-     - Subset
-   * - `google/speech_commands <https://huggingface.co/datasets/google/speech_commands>`_
-     - train 64.7k
-     - v0.01
-   * - `google/speech_commands <https://huggingface.co/datasets/google/speech_commands>`_
-     - train 105.8k
-     - v0.02
-   * - `flwrlabs/ambient-acoustic-context <https://huggingface.co/datasets/flwrlabs/ambient-acoustic-context>`_
-     - train 70.3k
-     - 
-   * - `fixie-ai/common_voice_17_0 <https://huggingface.co/datasets/fixie-ai/common_voice_17_0>`_
-     - varies
-     - 14 versions
-   * - `fixie-ai/librispeech_asr <https://huggingface.co/datasets/fixie-ai/librispeech_asr>`_
-     - varies
-     - clean/other
-
-Tabular Datasets
-----------------
-
-.. list-table:: Tabular Datasets
-   :widths: 35 30
-   :header-rows: 1
-
-   * - Name
-     - Size
-   * - `scikit-learn/adult-census-income <https://huggingface.co/datasets/scikit-learn/adult-census-income>`_
-     - train 32.6k
-   * - `jlh/uci-mushrooms <https://huggingface.co/datasets/jlh/uci-mushrooms>`_
-     - train 8.1k
-   * - `scikit-learn/iris <https://huggingface.co/datasets/scikit-learn/iris>`_
-     - train 150
-
-Text Datasets
--------------
-
-.. list-table:: Text Datasets
-   :widths: 40 30 30
-   :header-rows: 1
-
-   * - Name
-     - Size
-     - Category
-   * - `sentiment140 <https://huggingface.co/datasets/sentiment140>`_
-     - train 1.6M;  
-       test 0.5k
-     - Sentiment
-   * - `google-research-datasets/mbpp <https://huggingface.co/datasets/google-research-datasets/mbpp>`_
-     - full 974; sanitized 427
-     - General
-   * - `openai/openai_humaneval <https://huggingface.co/datasets/openai/openai_humaneval>`_
-     - test 164
-     - General
-   * - `lukaemon/mmlu <https://huggingface.co/datasets/lukaemon/mmlu>`_
-     - varies
-     - General
-   * - `takala/financial_phrasebank <https://huggingface.co/datasets/takala/financial_phrasebank>`_
-     - train 4.8k
-     - Financial
-   * - `pauri32/fiqa-2018 <https://huggingface.co/datasets/pauri32/fiqa-2018>`_
-     - train 0.9k; validation 0.1k; test 0.2k
-     - Financial
-   * - `zeroshot/twitter-financial-news-sentiment <https://huggingface.co/datasets/zeroshot/twitter-financial-news-sentiment>`_
-     - train 9.5k; validation 2.4k
-     - Financial
-   * - `bigbio/pubmed_qa <https://huggingface.co/datasets/bigbio/pubmed_qa>`_
-     - train 2M; validation 11k
-     - Medical
-   * - `openlifescienceai/medmcqa <https://huggingface.co/datasets/openlifescienceai/medmcqa>`_
-     - train 183k; validation 4.3k; test 6.2k
-     - Medical
-   * - `bigbio/med_qa <https://huggingface.co/datasets/bigbio/med_qa>`_
-     - train 10.1k; test 1.3k; validation 1.3k
-     - Medical
+.. include:: recommended-fl-datasets-tables.rst
\ No newline at end of file

From a97702b1d12ee556c05a5cdc287f4d96217d5dfc Mon Sep 17 00:00:00 2001
From: Chong Shen Ng <chong.shen@flower.ai>
Date: Wed, 4 Dec 2024 11:03:34 +0000
Subject: [PATCH 015/104] feat(framework) Refactor `flwr ls` table formatter
 (#4611)

---
 src/py/flwr/cli/ls.py | 71 +++++++++++++++++++++++++++++++++++--------
 1 file changed, 59 insertions(+), 12 deletions(-)

diff --git a/src/py/flwr/cli/ls.py b/src/py/flwr/cli/ls.py
index 54173f5f6018..f49dc3e25099 100644
--- a/src/py/flwr/cli/ls.py
+++ b/src/py/flwr/cli/ls.py
@@ -139,13 +139,15 @@ def _init_channel(app: Path, federation_config: dict[str, Any]) -> grpc.Channel:
     return channel
 
 
-def _format_run_table(run_dict: dict[int, Run], now_isoformat: str) -> Table:
-    """Format run status as a rich Table."""
+def _format_runs(run_dict: dict[int, Run], now_isoformat: str) -> list[tuple[str, ...]]:
+    """Format runs to a list."""
     table = Table(header_style="bold cyan", show_lines=True)
 
     def _format_datetime(dt: Optional[datetime]) -> str:
         return isoformat8601_utc(dt).replace("T", " ") if dt else "N/A"
 
+    run_list: list[tuple[str, ...]] = []
+
     # Add columns
     table.add_column(
         Text("Run ID", justify="center"), style="bright_white", overflow="fold"
@@ -192,15 +194,60 @@ def _format_datetime(dt: Optional[datetime]) -> str:
                 end_time = datetime.fromisoformat(now_isoformat)
             elapsed_time = end_time - running_at
 
-        table.add_row(
-            f"[bold]{run.run_id}[/bold]",
-            f"{run.fab_id} (v{run.fab_version})",
-            f"[{status_style}]{status_text}[/{status_style}]",
-            format_timedelta(elapsed_time),
-            _format_datetime(pending_at),
-            _format_datetime(running_at),
-            _format_datetime(finished_at),
+        run_list.append(
+            (
+                f"{run.run_id}",
+                f"{run.fab_id}",
+                f"{run.fab_version}",
+                f"{run.fab_hash}",
+                f"[{status_style}]{status_text}[/{status_style}]",
+                format_timedelta(elapsed_time),
+                _format_datetime(pending_at),
+                _format_datetime(running_at),
+                _format_datetime(finished_at),
+            )
         )
+    return run_list
+
+
+def _to_table(run_list: list[tuple[str, ...]]) -> Table:
+    """Format the provided run list to a rich Table."""
+    table = Table(header_style="bold cyan", show_lines=True)
+
+    # Add columns
+    table.add_column(
+        Text("Run ID", justify="center"), style="bright_white", overflow="fold"
+    )
+    table.add_column(Text("FAB", justify="center"), style="dim white")
+    table.add_column(Text("Status", justify="center"))
+    table.add_column(Text("Elapsed", justify="center"), style="blue")
+    table.add_column(Text("Created At", justify="center"), style="dim white")
+    table.add_column(Text("Running At", justify="center"), style="dim white")
+    table.add_column(Text("Finished At", justify="center"), style="dim white")
+
+    for row in run_list:
+        (
+            run_id,
+            fab_id,
+            fab_version,
+            _,
+            status_text,
+            elapsed,
+            created_at,
+            running_at,
+            finished_at,
+        ) = row
+        formatted_row = (
+            f"[bold]{run_id}[/bold]",
+            f"{fab_id} (v{fab_version})",
+            status_text,
+            elapsed,
+            created_at,
+            running_at,
+            finished_at,
+        )
+        table.add_row(*formatted_row)
+
     return table
 
 
@@ -211,7 +258,7 @@ def _list_runs(
     res: ListRunsResponse = stub.ListRuns(ListRunsRequest())
     run_dict = {run_id: run_from_proto(proto) for run_id, proto in res.run_dict.items()}
 
-    Console().print(_format_run_table(run_dict, res.now))
+    Console().print(_to_table(_format_runs(run_dict, res.now)))
 
 
 def _display_one_run(
@@ -225,4 +272,4 @@ def _display_one_run(
 
     run_dict = {run_id: run_from_proto(proto) for run_id, proto in res.run_dict.items()}
 
-    Console().print(_format_run_table(run_dict, res.now))
+    Console().print(_to_table(_format_runs(run_dict, res.now)))

From 2b17349ec3e96e2d4f076f75798ecc3ebf4b9997 Mon Sep 17 00:00:00 2001
From: Chong Shen Ng <chong.shen@flower.ai>
Date: Wed, 4 Dec 2024 11:16:34 +0000
Subject: [PATCH 016/104] feat(framework) Introduce `try`-`except` block to
 catch exceptions in `flwr ls` (#4612)

---
 src/py/flwr/cli/ls.py | 94 +++++++++++++++++++++++--------------------
 1 file changed, 51 insertions(+), 43 deletions(-)

diff --git a/src/py/flwr/cli/ls.py b/src/py/flwr/cli/ls.py
index f49dc3e25099..48e882bc178b 100644
--- a/src/py/flwr/cli/ls.py
+++ b/src/py/flwr/cli/ls.py
@@ -70,52 +70,56 @@ def ls(
     ] = None,
 ) -> None:
     """List runs."""
-    # Load and validate federation config
-    typer.secho("Loading project configuration... ", fg=typer.colors.BLUE)
-
-    pyproject_path = app / FAB_CONFIG_FILE if app else None
-    config, errors, warnings = load_and_validate(path=pyproject_path)
-    config = validate_project_config(config, errors, warnings)
-    federation, federation_config = validate_federation_in_project_config(
-        federation, config
-    )
-
-    if "address" not in federation_config:
-        typer.secho(
-            "❌ `flwr ls` currently works with Exec API. Ensure that the correct"
-            "Exec API address is provided in the `pyproject.toml`.",
-            fg=typer.colors.RED,
-            bold=True,
+    try:
+        # Load and validate federation config
+        typer.secho("Loading project configuration... ", fg=typer.colors.BLUE)
+
+        pyproject_path = app / FAB_CONFIG_FILE if app else None
+        config, errors, warnings = load_and_validate(path=pyproject_path)
+        config = validate_project_config(config, errors, warnings)
+        federation, federation_config = validate_federation_in_project_config(
+            federation, config
         )
-        raise typer.Exit(code=1)
 
-    try:
-        if runs and run_id is not None:
-            raise ValueError(
-                "The options '--runs' and '--run-id' are mutually exclusive."
+        if "address" not in federation_config:
+            typer.secho(
+                "❌ `flwr ls` currently works with Exec API. Ensure that the correct"
+                "Exec API address is provided in the `pyproject.toml`.",
+                fg=typer.colors.RED,
+                bold=True,
             )
-
-        channel = _init_channel(app, federation_config)
-        stub = ExecStub(channel)
-
-        # Display information about a specific run ID
-        if run_id is not None:
-            typer.echo(f"🔍 Displaying information for run ID {run_id}...")
-            _display_one_run(stub, run_id)
-        # By default, list all runs
-        else:
-            typer.echo("📄 Listing all runs...")
-            _list_runs(stub)
-
-    except ValueError as err:
-        typer.secho(
-            f"❌ {err}",
-            fg=typer.colors.RED,
-            bold=True,
-        )
-        raise typer.Exit(code=1) from err
-    finally:
-        channel.close()
+            raise typer.Exit(code=1)
+
+        try:
+            if runs and run_id is not None:
+                raise ValueError(
+                    "The options '--runs' and '--run-id' are mutually exclusive."
+                )
+
+            channel = _init_channel(app, federation_config)
+            stub = ExecStub(channel)
+
+            # Display information about a specific run ID
+            if run_id is not None:
+                typer.echo(f"🔍 Displaying information for run ID {run_id}...")
+                _display_one_run(stub, run_id)
+            # By default, list all runs
+            else:
+                typer.echo("📄 Listing all runs...")
+                _list_runs(stub)
+
+        except ValueError as err:
+            typer.secho(
+                f"❌ {err}",
+                fg=typer.colors.RED,
+                bold=True,
+            )
+            raise typer.Exit(code=1) from err
+        finally:
+            channel.close()
+    # pylint: disable=broad-except, unused-variable
+    except (typer.Exit, Exception):
+        _print_json_error()
 
 
 def on_channel_state_change(channel_connectivity: str) -> None:
@@ -273,3 +277,7 @@ def _display_one_run(
     run_dict = {run_id: run_from_proto(proto) for run_id, proto in res.run_dict.items()}
 
     Console().print(_to_table(_format_runs(run_dict, res.now)))
+
+
+def _print_json_error() -> None:
+    """Print error message as JSON."""

From 0f3038e6fd560d793ea8d5cb3c76645b6dac69a5 Mon Sep 17 00:00:00 2001
From: Chong Shen Ng <chong.shen@flower.ai>
Date: Wed, 4 Dec 2024 11:25:45 +0000
Subject: [PATCH 017/104] feat(framework) Update `exec.proto` to return
 optional `run_id` (#4620)

---
 src/proto/flwr/proto/exec.proto |  2 +-
 src/py/flwr/cli/run/run.py      |  6 +++++-
 src/py/flwr/proto/exec_pb2.py   | 28 ++++++++++++++--------------
 src/py/flwr/proto/exec_pb2.pyi  |  6 ++++--
 4 files changed, 24 insertions(+), 18 deletions(-)

diff --git a/src/proto/flwr/proto/exec.proto b/src/proto/flwr/proto/exec.proto
index 583c42ff5704..aa7bd0ea37b3 100644
--- a/src/proto/flwr/proto/exec.proto
+++ b/src/proto/flwr/proto/exec.proto
@@ -38,7 +38,7 @@ message StartRunRequest {
   map<string, Scalar> override_config = 2;
   ConfigsRecord federation_options = 3;
 }
-message StartRunResponse { uint64 run_id = 1; }
+message StartRunResponse { optional uint64 run_id = 1; }
 message StreamLogsRequest {
   uint64 run_id = 1;
   double after_timestamp = 2;
diff --git a/src/py/flwr/cli/run/run.py b/src/py/flwr/cli/run/run.py
index 1b144379581e..2715ea3599e0 100644
--- a/src/py/flwr/cli/run/run.py
+++ b/src/py/flwr/cli/run/run.py
@@ -142,7 +142,11 @@ def _run_with_exec_api(
     )
     res = stub.StartRun(req)
 
-    typer.secho(f"🎊 Successfully started run {res.run_id}", fg=typer.colors.GREEN)
+    if res.HasField("run_id"):
+        typer.secho(f"🎊 Successfully started run {res.run_id}", fg=typer.colors.GREEN)
+    else:
+        typer.secho("❌ Failed to start run", fg=typer.colors.RED)
+        raise typer.Exit(code=1)
 
     if stream:
         start_stream(res.run_id, channel, CONN_REFRESH_PERIOD)
diff --git a/src/py/flwr/proto/exec_pb2.py b/src/py/flwr/proto/exec_pb2.py
index 2240988e87a0..d06c5af3007d 100644
--- a/src/py/flwr/proto/exec_pb2.py
+++ b/src/py/flwr/proto/exec_pb2.py
@@ -18,7 +18,7 @@
 from flwr.proto import run_pb2 as flwr_dot_proto_dot_run__pb2
 
 
-DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x15\x66lwr/proto/exec.proto\x12\nflwr.proto\x1a\x14\x66lwr/proto/fab.proto\x1a\x1a\x66lwr/proto/transport.proto\x1a\x1a\x66lwr/proto/recordset.proto\x1a\x14\x66lwr/proto/run.proto\"\xfb\x01\n\x0fStartRunRequest\x12\x1c\n\x03\x66\x61\x62\x18\x01 \x01(\x0b\x32\x0f.flwr.proto.Fab\x12H\n\x0foverride_config\x18\x02 \x03(\x0b\x32/.flwr.proto.StartRunRequest.OverrideConfigEntry\x12\x35\n\x12\x66\x65\x64\x65ration_options\x18\x03 \x01(\x0b\x32\x19.flwr.proto.ConfigsRecord\x1aI\n\x13OverrideConfigEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12!\n\x05value\x18\x02 \x01(\x0b\x32\x12.flwr.proto.Scalar:\x02\x38\x01\"\"\n\x10StartRunResponse\x12\x0e\n\x06run_id\x18\x01 \x01(\x04\"<\n\x11StreamLogsRequest\x12\x0e\n\x06run_id\x18\x01 \x01(\x04\x12\x17\n\x0f\x61\x66ter_timestamp\x18\x02 \x01(\x01\"B\n\x12StreamLogsResponse\x12\x12\n\nlog_output\x18\x01 \x01(\t\x12\x18\n\x10latest_timestamp\x18\x02 \x01(\x01\"1\n\x0fListRunsRequest\x12\x13\n\x06run_id\x18\x01 \x01(\x04H\x00\x88\x01\x01\x42\t\n\x07_run_id\"\x9d\x01\n\x10ListRunsResponse\x12;\n\x08run_dict\x18\x01 \x03(\x0b\x32).flwr.proto.ListRunsResponse.RunDictEntry\x12\x0b\n\x03now\x18\x02 \x01(\t\x1a?\n\x0cRunDictEntry\x12\x0b\n\x03key\x18\x01 \x01(\x04\x12\x1e\n\x05value\x18\x02 \x01(\x0b\x32\x0f.flwr.proto.Run:\x02\x38\x01\x32\xe9\x01\n\x04\x45xec\x12G\n\x08StartRun\x12\x1b.flwr.proto.StartRunRequest\x1a\x1c.flwr.proto.StartRunResponse\"\x00\x12O\n\nStreamLogs\x12\x1d.flwr.proto.StreamLogsRequest\x1a\x1e.flwr.proto.StreamLogsResponse\"\x00\x30\x01\x12G\n\x08ListRuns\x12\x1b.flwr.proto.ListRunsRequest\x1a\x1c.flwr.proto.ListRunsResponse\"\x00\x62\x06proto3')
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x15\x66lwr/proto/exec.proto\x12\nflwr.proto\x1a\x14\x66lwr/proto/fab.proto\x1a\x1a\x66lwr/proto/transport.proto\x1a\x1a\x66lwr/proto/recordset.proto\x1a\x14\x66lwr/proto/run.proto\"\xfb\x01\n\x0fStartRunRequest\x12\x1c\n\x03\x66\x61\x62\x18\x01 \x01(\x0b\x32\x0f.flwr.proto.Fab\x12H\n\x0foverride_config\x18\x02 \x03(\x0b\x32/.flwr.proto.StartRunRequest.OverrideConfigEntry\x12\x35\n\x12\x66\x65\x64\x65ration_options\x18\x03 \x01(\x0b\x32\x19.flwr.proto.ConfigsRecord\x1aI\n\x13OverrideConfigEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12!\n\x05value\x18\x02 \x01(\x0b\x32\x12.flwr.proto.Scalar:\x02\x38\x01\"2\n\x10StartRunResponse\x12\x13\n\x06run_id\x18\x01 \x01(\x04H\x00\x88\x01\x01\x42\t\n\x07_run_id\"<\n\x11StreamLogsRequest\x12\x0e\n\x06run_id\x18\x01 \x01(\x04\x12\x17\n\x0f\x61\x66ter_timestamp\x18\x02 \x01(\x01\"B\n\x12StreamLogsResponse\x12\x12\n\nlog_output\x18\x01 \x01(\t\x12\x18\n\x10latest_timestamp\x18\x02 \x01(\x01\"1\n\x0fListRunsRequest\x12\x13\n\x06run_id\x18\x01 \x01(\x04H\x00\x88\x01\x01\x42\t\n\x07_run_id\"\x9d\x01\n\x10ListRunsResponse\x12;\n\x08run_dict\x18\x01 \x03(\x0b\x32).flwr.proto.ListRunsResponse.RunDictEntry\x12\x0b\n\x03now\x18\x02 \x01(\t\x1a?\n\x0cRunDictEntry\x12\x0b\n\x03key\x18\x01 \x01(\x04\x12\x1e\n\x05value\x18\x02 \x01(\x0b\x32\x0f.flwr.proto.Run:\x02\x38\x01\x32\xe9\x01\n\x04\x45xec\x12G\n\x08StartRun\x12\x1b.flwr.proto.StartRunRequest\x1a\x1c.flwr.proto.StartRunResponse\"\x00\x12O\n\nStreamLogs\x12\x1d.flwr.proto.StreamLogsRequest\x1a\x1e.flwr.proto.StreamLogsResponse\"\x00\x30\x01\x12G\n\x08ListRuns\x12\x1b.flwr.proto.ListRunsRequest\x1a\x1c.flwr.proto.ListRunsResponse\"\x00\x62\x06proto3')
 
 _globals = globals()
 _builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
@@ -34,17 +34,17 @@
   _globals['_STARTRUNREQUEST_OVERRIDECONFIGENTRY']._serialized_start=316
   _globals['_STARTRUNREQUEST_OVERRIDECONFIGENTRY']._serialized_end=389
   _globals['_STARTRUNRESPONSE']._serialized_start=391
-  _globals['_STARTRUNRESPONSE']._serialized_end=425
-  _globals['_STREAMLOGSREQUEST']._serialized_start=427
-  _globals['_STREAMLOGSREQUEST']._serialized_end=487
-  _globals['_STREAMLOGSRESPONSE']._serialized_start=489
-  _globals['_STREAMLOGSRESPONSE']._serialized_end=555
-  _globals['_LISTRUNSREQUEST']._serialized_start=557
-  _globals['_LISTRUNSREQUEST']._serialized_end=606
-  _globals['_LISTRUNSRESPONSE']._serialized_start=609
-  _globals['_LISTRUNSRESPONSE']._serialized_end=766
-  _globals['_LISTRUNSRESPONSE_RUNDICTENTRY']._serialized_start=703
-  _globals['_LISTRUNSRESPONSE_RUNDICTENTRY']._serialized_end=766
-  _globals['_EXEC']._serialized_start=769
-  _globals['_EXEC']._serialized_end=1002
+  _globals['_STARTRUNRESPONSE']._serialized_end=441
+  _globals['_STREAMLOGSREQUEST']._serialized_start=443
+  _globals['_STREAMLOGSREQUEST']._serialized_end=503
+  _globals['_STREAMLOGSRESPONSE']._serialized_start=505
+  _globals['_STREAMLOGSRESPONSE']._serialized_end=571
+  _globals['_LISTRUNSREQUEST']._serialized_start=573
+  _globals['_LISTRUNSREQUEST']._serialized_end=622
+  _globals['_LISTRUNSRESPONSE']._serialized_start=625
+  _globals['_LISTRUNSRESPONSE']._serialized_end=782
+  _globals['_LISTRUNSRESPONSE_RUNDICTENTRY']._serialized_start=719
+  _globals['_LISTRUNSRESPONSE_RUNDICTENTRY']._serialized_end=782
+  _globals['_EXEC']._serialized_start=785
+  _globals['_EXEC']._serialized_end=1018
 # @@protoc_insertion_point(module_scope)
diff --git a/src/py/flwr/proto/exec_pb2.pyi b/src/py/flwr/proto/exec_pb2.pyi
index 08e0b1c14346..1cc971444e32 100644
--- a/src/py/flwr/proto/exec_pb2.pyi
+++ b/src/py/flwr/proto/exec_pb2.pyi
@@ -57,9 +57,11 @@ class StartRunResponse(google.protobuf.message.Message):
     run_id: builtins.int
     def __init__(self,
         *,
-        run_id: builtins.int = ...,
+        run_id: typing.Optional[builtins.int] = ...,
         ) -> None: ...
-    def ClearField(self, field_name: typing_extensions.Literal["run_id",b"run_id"]) -> None: ...
+    def HasField(self, field_name: typing_extensions.Literal["_run_id",b"_run_id","run_id",b"run_id"]) -> builtins.bool: ...
+    def ClearField(self, field_name: typing_extensions.Literal["_run_id",b"_run_id","run_id",b"run_id"]) -> None: ...
+    def WhichOneof(self, oneof_group: typing_extensions.Literal["_run_id",b"_run_id"]) -> typing.Optional[typing_extensions.Literal["run_id"]]: ...
 global___StartRunResponse = StartRunResponse
 
 class StreamLogsRequest(google.protobuf.message.Message):

From 10b8ada07746884aba53cab3cd6e027660038fe4 Mon Sep 17 00:00:00 2001
From: Chong Shen Ng <chong.shen@flower.ai>
Date: Wed, 4 Dec 2024 11:34:46 +0000
Subject: [PATCH 018/104] feat(framework) Remove unused proto files (#4631)

Co-authored-by: Daniel J. Beutel <daniel@flower.ai>
---
 src/proto/flwr/proto/control.proto            |  32 -----
 src/py/flwr/proto/common_pb2.py               |  36 -----
 src/py/flwr/proto/common_pb2.pyi              | 121 ----------------
 src/py/flwr/proto/common_pb2_grpc.py          |   4 -
 src/py/flwr/proto/common_pb2_grpc.pyi         |   4 -
 src/py/flwr/proto/control_pb2.py              |  27 ----
 src/py/flwr/proto/control_pb2.pyi             |   7 -
 src/py/flwr/proto/control_pb2_grpc.py         | 135 ------------------
 src/py/flwr/proto/control_pb2_grpc.pyi        |  53 -------
 .../superlink/driver/serverappio_servicer.py  |   2 +-
 src/py/flwr_tool/protoc_test.py               |   2 +-
 11 files changed, 2 insertions(+), 421 deletions(-)
 delete mode 100644 src/proto/flwr/proto/control.proto
 delete mode 100644 src/py/flwr/proto/common_pb2.py
 delete mode 100644 src/py/flwr/proto/common_pb2.pyi
 delete mode 100644 src/py/flwr/proto/common_pb2_grpc.py
 delete mode 100644 src/py/flwr/proto/common_pb2_grpc.pyi
 delete mode 100644 src/py/flwr/proto/control_pb2.py
 delete mode 100644 src/py/flwr/proto/control_pb2.pyi
 delete mode 100644 src/py/flwr/proto/control_pb2_grpc.py
 delete mode 100644 src/py/flwr/proto/control_pb2_grpc.pyi

diff --git a/src/proto/flwr/proto/control.proto b/src/proto/flwr/proto/control.proto
deleted file mode 100644
index 8b75c66fccaa..000000000000
--- a/src/proto/flwr/proto/control.proto
+++ /dev/null
@@ -1,32 +0,0 @@
-// Copyright 2024 Flower Labs GmbH. All Rights Reserved.
-//
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-//     http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-// ==============================================================================
-
-syntax = "proto3";
-
-package flwr.proto;
-
-import "flwr/proto/run.proto";
-
-service Control {
-  // Request to create a new run
-  rpc CreateRun(CreateRunRequest) returns (CreateRunResponse) {}
-
-  // Get the status of a given run
-  rpc GetRunStatus(GetRunStatusRequest) returns (GetRunStatusResponse) {}
-
-  // Update the status of a given run
-  rpc UpdateRunStatus(UpdateRunStatusRequest)
-      returns (UpdateRunStatusResponse) {}
-}
diff --git a/src/py/flwr/proto/common_pb2.py b/src/py/flwr/proto/common_pb2.py
deleted file mode 100644
index 1025aa862933..000000000000
--- a/src/py/flwr/proto/common_pb2.py
+++ /dev/null
@@ -1,36 +0,0 @@
-# -*- coding: utf-8 -*-
-# Generated by the protocol buffer compiler.  DO NOT EDIT!
-# source: flwr/proto/common.proto
-# Protobuf Python Version: 4.25.0
-"""Generated protocol buffer code."""
-from google.protobuf import descriptor as _descriptor
-from google.protobuf import descriptor_pool as _descriptor_pool
-from google.protobuf import symbol_database as _symbol_database
-from google.protobuf.internal import builder as _builder
-# @@protoc_insertion_point(imports)
-
-_sym_db = _symbol_database.Default()
-
-
-
-
-DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x17\x66lwr/proto/common.proto\x12\nflwr.proto\"\x1a\n\nDoubleList\x12\x0c\n\x04vals\x18\x01 \x03(\x01\"\x1a\n\nSint64List\x12\x0c\n\x04vals\x18\x01 \x03(\x12\"\x18\n\x08\x42oolList\x12\x0c\n\x04vals\x18\x01 \x03(\x08\"\x1a\n\nStringList\x12\x0c\n\x04vals\x18\x01 \x03(\t\"\x19\n\tBytesList\x12\x0c\n\x04vals\x18\x01 \x03(\x0c\"\xd9\x02\n\x12\x43onfigsRecordValue\x12\x10\n\x06\x64ouble\x18\x01 \x01(\x01H\x00\x12\x10\n\x06sint64\x18\x02 \x01(\x12H\x00\x12\x0e\n\x04\x62ool\x18\x03 \x01(\x08H\x00\x12\x10\n\x06string\x18\x04 \x01(\tH\x00\x12\x0f\n\x05\x62ytes\x18\x05 \x01(\x0cH\x00\x12-\n\x0b\x64ouble_list\x18\x15 \x01(\x0b\x32\x16.flwr.proto.DoubleListH\x00\x12-\n\x0bsint64_list\x18\x16 \x01(\x0b\x32\x16.flwr.proto.Sint64ListH\x00\x12)\n\tbool_list\x18\x17 \x01(\x0b\x32\x14.flwr.proto.BoolListH\x00\x12-\n\x0bstring_list\x18\x18 \x01(\x0b\x32\x16.flwr.proto.StringListH\x00\x12+\n\nbytes_list\x18\x19 \x01(\x0b\x32\x15.flwr.proto.BytesListH\x00\x42\x07\n\x05valueb\x06proto3')
-
-_globals = globals()
-_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
-_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'flwr.proto.common_pb2', _globals)
-if _descriptor._USE_C_DESCRIPTORS == False:
-  DESCRIPTOR._options = None
-  _globals['_DOUBLELIST']._serialized_start=39
-  _globals['_DOUBLELIST']._serialized_end=65
-  _globals['_SINT64LIST']._serialized_start=67
-  _globals['_SINT64LIST']._serialized_end=93
-  _globals['_BOOLLIST']._serialized_start=95
-  _globals['_BOOLLIST']._serialized_end=119
-  _globals['_STRINGLIST']._serialized_start=121
-  _globals['_STRINGLIST']._serialized_end=147
-  _globals['_BYTESLIST']._serialized_start=149
-  _globals['_BYTESLIST']._serialized_end=174
-  _globals['_CONFIGSRECORDVALUE']._serialized_start=177
-  _globals['_CONFIGSRECORDVALUE']._serialized_end=522
-# @@protoc_insertion_point(module_scope)
diff --git a/src/py/flwr/proto/common_pb2.pyi b/src/py/flwr/proto/common_pb2.pyi
deleted file mode 100644
index e2539a7300a9..000000000000
--- a/src/py/flwr/proto/common_pb2.pyi
+++ /dev/null
@@ -1,121 +0,0 @@
-"""
-@generated by mypy-protobuf.  Do not edit manually!
-isort:skip_file
-"""
-import builtins
-import google.protobuf.descriptor
-import google.protobuf.internal.containers
-import google.protobuf.message
-import typing
-import typing_extensions
-
-DESCRIPTOR: google.protobuf.descriptor.FileDescriptor
-
-class DoubleList(google.protobuf.message.Message):
-    DESCRIPTOR: google.protobuf.descriptor.Descriptor
-    VALS_FIELD_NUMBER: builtins.int
-    @property
-    def vals(self) -> google.protobuf.internal.containers.RepeatedScalarFieldContainer[builtins.float]: ...
-    def __init__(self,
-        *,
-        vals: typing.Optional[typing.Iterable[builtins.float]] = ...,
-        ) -> None: ...
-    def ClearField(self, field_name: typing_extensions.Literal["vals",b"vals"]) -> None: ...
-global___DoubleList = DoubleList
-
-class Sint64List(google.protobuf.message.Message):
-    DESCRIPTOR: google.protobuf.descriptor.Descriptor
-    VALS_FIELD_NUMBER: builtins.int
-    @property
-    def vals(self) -> google.protobuf.internal.containers.RepeatedScalarFieldContainer[builtins.int]: ...
-    def __init__(self,
-        *,
-        vals: typing.Optional[typing.Iterable[builtins.int]] = ...,
-        ) -> None: ...
-    def ClearField(self, field_name: typing_extensions.Literal["vals",b"vals"]) -> None: ...
-global___Sint64List = Sint64List
-
-class BoolList(google.protobuf.message.Message):
-    DESCRIPTOR: google.protobuf.descriptor.Descriptor
-    VALS_FIELD_NUMBER: builtins.int
-    @property
-    def vals(self) -> google.protobuf.internal.containers.RepeatedScalarFieldContainer[builtins.bool]: ...
-    def __init__(self,
-        *,
-        vals: typing.Optional[typing.Iterable[builtins.bool]] = ...,
-        ) -> None: ...
-    def ClearField(self, field_name: typing_extensions.Literal["vals",b"vals"]) -> None: ...
-global___BoolList = BoolList
-
-class StringList(google.protobuf.message.Message):
-    DESCRIPTOR: google.protobuf.descriptor.Descriptor
-    VALS_FIELD_NUMBER: builtins.int
-    @property
-    def vals(self) -> google.protobuf.internal.containers.RepeatedScalarFieldContainer[typing.Text]: ...
-    def __init__(self,
-        *,
-        vals: typing.Optional[typing.Iterable[typing.Text]] = ...,
-        ) -> None: ...
-    def ClearField(self, field_name: typing_extensions.Literal["vals",b"vals"]) -> None: ...
-global___StringList = StringList
-
-class BytesList(google.protobuf.message.Message):
-    DESCRIPTOR: google.protobuf.descriptor.Descriptor
-    VALS_FIELD_NUMBER: builtins.int
-    @property
-    def vals(self) -> google.protobuf.internal.containers.RepeatedScalarFieldContainer[builtins.bytes]: ...
-    def __init__(self,
-        *,
-        vals: typing.Optional[typing.Iterable[builtins.bytes]] = ...,
-        ) -> None: ...
-    def ClearField(self, field_name: typing_extensions.Literal["vals",b"vals"]) -> None: ...
-global___BytesList = BytesList
-
-class ConfigsRecordValue(google.protobuf.message.Message):
-    DESCRIPTOR: google.protobuf.descriptor.Descriptor
-    DOUBLE_FIELD_NUMBER: builtins.int
-    SINT64_FIELD_NUMBER: builtins.int
-    BOOL_FIELD_NUMBER: builtins.int
-    STRING_FIELD_NUMBER: builtins.int
-    BYTES_FIELD_NUMBER: builtins.int
-    DOUBLE_LIST_FIELD_NUMBER: builtins.int
-    SINT64_LIST_FIELD_NUMBER: builtins.int
-    BOOL_LIST_FIELD_NUMBER: builtins.int
-    STRING_LIST_FIELD_NUMBER: builtins.int
-    BYTES_LIST_FIELD_NUMBER: builtins.int
-    double: builtins.float
-    """Single element"""
-
-    sint64: builtins.int
-    bool: builtins.bool
-    string: typing.Text
-    bytes: builtins.bytes
-    @property
-    def double_list(self) -> global___DoubleList:
-        """List types"""
-        pass
-    @property
-    def sint64_list(self) -> global___Sint64List: ...
-    @property
-    def bool_list(self) -> global___BoolList: ...
-    @property
-    def string_list(self) -> global___StringList: ...
-    @property
-    def bytes_list(self) -> global___BytesList: ...
-    def __init__(self,
-        *,
-        double: builtins.float = ...,
-        sint64: builtins.int = ...,
-        bool: builtins.bool = ...,
-        string: typing.Text = ...,
-        bytes: builtins.bytes = ...,
-        double_list: typing.Optional[global___DoubleList] = ...,
-        sint64_list: typing.Optional[global___Sint64List] = ...,
-        bool_list: typing.Optional[global___BoolList] = ...,
-        string_list: typing.Optional[global___StringList] = ...,
-        bytes_list: typing.Optional[global___BytesList] = ...,
-        ) -> None: ...
-    def HasField(self, field_name: typing_extensions.Literal["bool",b"bool","bool_list",b"bool_list","bytes",b"bytes","bytes_list",b"bytes_list","double",b"double","double_list",b"double_list","sint64",b"sint64","sint64_list",b"sint64_list","string",b"string","string_list",b"string_list","value",b"value"]) -> builtins.bool: ...
-    def ClearField(self, field_name: typing_extensions.Literal["bool",b"bool","bool_list",b"bool_list","bytes",b"bytes","bytes_list",b"bytes_list","double",b"double","double_list",b"double_list","sint64",b"sint64","sint64_list",b"sint64_list","string",b"string","string_list",b"string_list","value",b"value"]) -> None: ...
-    def WhichOneof(self, oneof_group: typing_extensions.Literal["value",b"value"]) -> typing.Optional[typing_extensions.Literal["double","sint64","bool","string","bytes","double_list","sint64_list","bool_list","string_list","bytes_list"]]: ...
-global___ConfigsRecordValue = ConfigsRecordValue
diff --git a/src/py/flwr/proto/common_pb2_grpc.py b/src/py/flwr/proto/common_pb2_grpc.py
deleted file mode 100644
index 2daafffebfc8..000000000000
--- a/src/py/flwr/proto/common_pb2_grpc.py
+++ /dev/null
@@ -1,4 +0,0 @@
-# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
-"""Client and server classes corresponding to protobuf-defined services."""
-import grpc
-
diff --git a/src/py/flwr/proto/common_pb2_grpc.pyi b/src/py/flwr/proto/common_pb2_grpc.pyi
deleted file mode 100644
index f3a5a087ef5d..000000000000
--- a/src/py/flwr/proto/common_pb2_grpc.pyi
+++ /dev/null
@@ -1,4 +0,0 @@
-"""
-@generated by mypy-protobuf.  Do not edit manually!
-isort:skip_file
-"""
diff --git a/src/py/flwr/proto/control_pb2.py b/src/py/flwr/proto/control_pb2.py
deleted file mode 100644
index eb1c18d8dcff..000000000000
--- a/src/py/flwr/proto/control_pb2.py
+++ /dev/null
@@ -1,27 +0,0 @@
-# -*- coding: utf-8 -*-
-# Generated by the protocol buffer compiler.  DO NOT EDIT!
-# source: flwr/proto/control.proto
-# Protobuf Python Version: 4.25.0
-"""Generated protocol buffer code."""
-from google.protobuf import descriptor as _descriptor
-from google.protobuf import descriptor_pool as _descriptor_pool
-from google.protobuf import symbol_database as _symbol_database
-from google.protobuf.internal import builder as _builder
-# @@protoc_insertion_point(imports)
-
-_sym_db = _symbol_database.Default()
-
-
-from flwr.proto import run_pb2 as flwr_dot_proto_dot_run__pb2
-
-
-DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x18\x66lwr/proto/control.proto\x12\nflwr.proto\x1a\x14\x66lwr/proto/run.proto2\x88\x02\n\x07\x43ontrol\x12J\n\tCreateRun\x12\x1c.flwr.proto.CreateRunRequest\x1a\x1d.flwr.proto.CreateRunResponse\"\x00\x12S\n\x0cGetRunStatus\x12\x1f.flwr.proto.GetRunStatusRequest\x1a .flwr.proto.GetRunStatusResponse\"\x00\x12\\\n\x0fUpdateRunStatus\x12\".flwr.proto.UpdateRunStatusRequest\x1a#.flwr.proto.UpdateRunStatusResponse\"\x00\x62\x06proto3')
-
-_globals = globals()
-_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
-_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'flwr.proto.control_pb2', _globals)
-if _descriptor._USE_C_DESCRIPTORS == False:
-  DESCRIPTOR._options = None
-  _globals['_CONTROL']._serialized_start=63
-  _globals['_CONTROL']._serialized_end=327
-# @@protoc_insertion_point(module_scope)
diff --git a/src/py/flwr/proto/control_pb2.pyi b/src/py/flwr/proto/control_pb2.pyi
deleted file mode 100644
index e08fa11c2caa..000000000000
--- a/src/py/flwr/proto/control_pb2.pyi
+++ /dev/null
@@ -1,7 +0,0 @@
-"""
-@generated by mypy-protobuf.  Do not edit manually!
-isort:skip_file
-"""
-import google.protobuf.descriptor
-
-DESCRIPTOR: google.protobuf.descriptor.FileDescriptor
diff --git a/src/py/flwr/proto/control_pb2_grpc.py b/src/py/flwr/proto/control_pb2_grpc.py
deleted file mode 100644
index a59f90f15935..000000000000
--- a/src/py/flwr/proto/control_pb2_grpc.py
+++ /dev/null
@@ -1,135 +0,0 @@
-# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
-"""Client and server classes corresponding to protobuf-defined services."""
-import grpc
-
-from flwr.proto import run_pb2 as flwr_dot_proto_dot_run__pb2
-
-
-class ControlStub(object):
-    """Missing associated documentation comment in .proto file."""
-
-    def __init__(self, channel):
-        """Constructor.
-
-        Args:
-            channel: A grpc.Channel.
-        """
-        self.CreateRun = channel.unary_unary(
-                '/flwr.proto.Control/CreateRun',
-                request_serializer=flwr_dot_proto_dot_run__pb2.CreateRunRequest.SerializeToString,
-                response_deserializer=flwr_dot_proto_dot_run__pb2.CreateRunResponse.FromString,
-                )
-        self.GetRunStatus = channel.unary_unary(
-                '/flwr.proto.Control/GetRunStatus',
-                request_serializer=flwr_dot_proto_dot_run__pb2.GetRunStatusRequest.SerializeToString,
-                response_deserializer=flwr_dot_proto_dot_run__pb2.GetRunStatusResponse.FromString,
-                )
-        self.UpdateRunStatus = channel.unary_unary(
-                '/flwr.proto.Control/UpdateRunStatus',
-                request_serializer=flwr_dot_proto_dot_run__pb2.UpdateRunStatusRequest.SerializeToString,
-                response_deserializer=flwr_dot_proto_dot_run__pb2.UpdateRunStatusResponse.FromString,
-                )
-
-
-class ControlServicer(object):
-    """Missing associated documentation comment in .proto file."""
-
-    def CreateRun(self, request, context):
-        """Request to create a new run
-        """
-        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
-        context.set_details('Method not implemented!')
-        raise NotImplementedError('Method not implemented!')
-
-    def GetRunStatus(self, request, context):
-        """Get the status of a given run
-        """
-        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
-        context.set_details('Method not implemented!')
-        raise NotImplementedError('Method not implemented!')
-
-    def UpdateRunStatus(self, request, context):
-        """Update the status of a given run
-        """
-        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
-        context.set_details('Method not implemented!')
-        raise NotImplementedError('Method not implemented!')
-
-
-def add_ControlServicer_to_server(servicer, server):
-    rpc_method_handlers = {
-            'CreateRun': grpc.unary_unary_rpc_method_handler(
-                    servicer.CreateRun,
-                    request_deserializer=flwr_dot_proto_dot_run__pb2.CreateRunRequest.FromString,
-                    response_serializer=flwr_dot_proto_dot_run__pb2.CreateRunResponse.SerializeToString,
-            ),
-            'GetRunStatus': grpc.unary_unary_rpc_method_handler(
-                    servicer.GetRunStatus,
-                    request_deserializer=flwr_dot_proto_dot_run__pb2.GetRunStatusRequest.FromString,
-                    response_serializer=flwr_dot_proto_dot_run__pb2.GetRunStatusResponse.SerializeToString,
-            ),
-            'UpdateRunStatus': grpc.unary_unary_rpc_method_handler(
-                    servicer.UpdateRunStatus,
-                    request_deserializer=flwr_dot_proto_dot_run__pb2.UpdateRunStatusRequest.FromString,
-                    response_serializer=flwr_dot_proto_dot_run__pb2.UpdateRunStatusResponse.SerializeToString,
-            ),
-    }
-    generic_handler = grpc.method_handlers_generic_handler(
-            'flwr.proto.Control', rpc_method_handlers)
-    server.add_generic_rpc_handlers((generic_handler,))
-
-
- # This class is part of an EXPERIMENTAL API.
-class Control(object):
-    """Missing associated documentation comment in .proto file."""
-
-    @staticmethod
-    def CreateRun(request,
-            target,
-            options=(),
-            channel_credentials=None,
-            call_credentials=None,
-            insecure=False,
-            compression=None,
-            wait_for_ready=None,
-            timeout=None,
-            metadata=None):
-        return grpc.experimental.unary_unary(request, target, '/flwr.proto.Control/CreateRun',
-            flwr_dot_proto_dot_run__pb2.CreateRunRequest.SerializeToString,
-            flwr_dot_proto_dot_run__pb2.CreateRunResponse.FromString,
-            options, channel_credentials,
-            insecure, call_credentials, compression, wait_for_ready, timeout, metadata)
-
-    @staticmethod
-    def GetRunStatus(request,
-            target,
-            options=(),
-            channel_credentials=None,
-            call_credentials=None,
-            insecure=False,
-            compression=None,
-            wait_for_ready=None,
-            timeout=None,
-            metadata=None):
-        return grpc.experimental.unary_unary(request, target, '/flwr.proto.Control/GetRunStatus',
-            flwr_dot_proto_dot_run__pb2.GetRunStatusRequest.SerializeToString,
-            flwr_dot_proto_dot_run__pb2.GetRunStatusResponse.FromString,
-            options, channel_credentials,
-            insecure, call_credentials, compression, wait_for_ready, timeout, metadata)
-
-    @staticmethod
-    def UpdateRunStatus(request,
-            target,
-            options=(),
-            channel_credentials=None,
-            call_credentials=None,
-            insecure=False,
-            compression=None,
-            wait_for_ready=None,
-            timeout=None,
-            metadata=None):
-        return grpc.experimental.unary_unary(request, target, '/flwr.proto.Control/UpdateRunStatus',
-            flwr_dot_proto_dot_run__pb2.UpdateRunStatusRequest.SerializeToString,
-            flwr_dot_proto_dot_run__pb2.UpdateRunStatusResponse.FromString,
-            options, channel_credentials,
-            insecure, call_credentials, compression, wait_for_ready, timeout, metadata)
diff --git a/src/py/flwr/proto/control_pb2_grpc.pyi b/src/py/flwr/proto/control_pb2_grpc.pyi
deleted file mode 100644
index 7817e2b12e31..000000000000
--- a/src/py/flwr/proto/control_pb2_grpc.pyi
+++ /dev/null
@@ -1,53 +0,0 @@
-"""
-@generated by mypy-protobuf.  Do not edit manually!
-isort:skip_file
-"""
-import abc
-import flwr.proto.run_pb2
-import grpc
-
-class ControlStub:
-    def __init__(self, channel: grpc.Channel) -> None: ...
-    CreateRun: grpc.UnaryUnaryMultiCallable[
-        flwr.proto.run_pb2.CreateRunRequest,
-        flwr.proto.run_pb2.CreateRunResponse]
-    """Request to create a new run"""
-
-    GetRunStatus: grpc.UnaryUnaryMultiCallable[
-        flwr.proto.run_pb2.GetRunStatusRequest,
-        flwr.proto.run_pb2.GetRunStatusResponse]
-    """Get the status of a given run"""
-
-    UpdateRunStatus: grpc.UnaryUnaryMultiCallable[
-        flwr.proto.run_pb2.UpdateRunStatusRequest,
-        flwr.proto.run_pb2.UpdateRunStatusResponse]
-    """Update the status of a given run"""
-
-
-class ControlServicer(metaclass=abc.ABCMeta):
-    @abc.abstractmethod
-    def CreateRun(self,
-        request: flwr.proto.run_pb2.CreateRunRequest,
-        context: grpc.ServicerContext,
-    ) -> flwr.proto.run_pb2.CreateRunResponse:
-        """Request to create a new run"""
-        pass
-
-    @abc.abstractmethod
-    def GetRunStatus(self,
-        request: flwr.proto.run_pb2.GetRunStatusRequest,
-        context: grpc.ServicerContext,
-    ) -> flwr.proto.run_pb2.GetRunStatusResponse:
-        """Get the status of a given run"""
-        pass
-
-    @abc.abstractmethod
-    def UpdateRunStatus(self,
-        request: flwr.proto.run_pb2.UpdateRunStatusRequest,
-        context: grpc.ServicerContext,
-    ) -> flwr.proto.run_pb2.UpdateRunStatusResponse:
-        """Update the status of a given run"""
-        pass
-
-
-def add_ControlServicer_to_server(servicer: ControlServicer, server: grpc.Server) -> None: ...
diff --git a/src/py/flwr/server/superlink/driver/serverappio_servicer.py b/src/py/flwr/server/superlink/driver/serverappio_servicer.py
index e1820fee0659..dddac1a93b1a 100644
--- a/src/py/flwr/server/superlink/driver/serverappio_servicer.py
+++ b/src/py/flwr/server/superlink/driver/serverappio_servicer.py
@@ -263,7 +263,7 @@ def UpdateRunStatus(
         self, request: UpdateRunStatusRequest, context: grpc.ServicerContext
     ) -> UpdateRunStatusResponse:
         """Update the status of a run."""
-        log(DEBUG, "ControlServicer.UpdateRunStatus")
+        log(DEBUG, "ServerAppIoServicer.UpdateRunStatus")
         state = self.state_factory.state()
 
         # Update the run status
diff --git a/src/py/flwr_tool/protoc_test.py b/src/py/flwr_tool/protoc_test.py
index e2e14858174c..9b85aeb5ac7a 100644
--- a/src/py/flwr_tool/protoc_test.py
+++ b/src/py/flwr_tool/protoc_test.py
@@ -28,4 +28,4 @@ def test_directories() -> None:
 
 def test_proto_file_count() -> None:
     """Test if the correct number of proto files were captured by the glob."""
-    assert len(PROTO_FILES) == 16
+    assert len(PROTO_FILES) == 15

From e0e54520be0fe0e10549a04af949f8f18651a78b Mon Sep 17 00:00:00 2001
From: Chong Shen Ng <chong.shen@flower.ai>
Date: Wed, 4 Dec 2024 11:52:17 +0000
Subject: [PATCH 019/104] feat(framework) Introduce `try`-`except` block to
 `flwr run` (#4621)

---
 src/py/flwr/cli/run/run.py | 30 +++++++++++++++++++-----------
 1 file changed, 19 insertions(+), 11 deletions(-)

diff --git a/src/py/flwr/cli/run/run.py b/src/py/flwr/cli/run/run.py
index 2715ea3599e0..cabd5707d5c0 100644
--- a/src/py/flwr/cli/run/run.py
+++ b/src/py/flwr/cli/run/run.py
@@ -87,19 +87,23 @@ def run(
     ] = False,
 ) -> None:
     """Run Flower App."""
-    typer.secho("Loading project configuration... ", fg=typer.colors.BLUE)
+    try:
+        typer.secho("Loading project configuration... ", fg=typer.colors.BLUE)
 
-    pyproject_path = app / "pyproject.toml" if app else None
-    config, errors, warnings = load_and_validate(path=pyproject_path)
-    config = validate_project_config(config, errors, warnings)
-    federation, federation_config = validate_federation_in_project_config(
-        federation, config
-    )
+        pyproject_path = app / "pyproject.toml" if app else None
+        config, errors, warnings = load_and_validate(path=pyproject_path)
+        config = validate_project_config(config, errors, warnings)
+        federation, federation_config = validate_federation_in_project_config(
+            federation, config
+        )
 
-    if "address" in federation_config:
-        _run_with_exec_api(app, federation_config, config_overrides, stream)
-    else:
-        _run_without_exec_api(app, federation_config, config_overrides, federation)
+        if "address" in federation_config:
+            _run_with_exec_api(app, federation_config, config_overrides, stream)
+        else:
+            _run_without_exec_api(app, federation_config, config_overrides, federation)
+    # pylint: disable=broad-except, unused-variable
+    except (typer.Exit, SystemExit, Exception):
+        _print_json_error()
 
 
 # pylint: disable-next=too-many-locals
@@ -198,3 +202,7 @@ def _run_without_exec_api(
         check=True,
         text=True,
     )
+
+
+def _print_json_error() -> None:
+    """Print error message as JSON."""

From 66940092603a6eac2c26d1fb3ca8cbb9d63e07f7 Mon Sep 17 00:00:00 2001
From: Chong Shen Ng <chong.shen@flower.ai>
Date: Wed, 4 Dec 2024 12:36:04 +0000
Subject: [PATCH 020/104] feat(framework) Introduce JSON formatting function in
 `flwr ls` (#4613)

Co-authored-by: Daniel J. Beutel <daniel@flower.ai>
---
 src/py/flwr/cli/ls.py          | 102 ++++++++++++++++++++++-----------
 src/py/flwr/common/constant.py |  11 ++++
 2 files changed, 79 insertions(+), 34 deletions(-)

diff --git a/src/py/flwr/cli/ls.py b/src/py/flwr/cli/ls.py
index 48e882bc178b..622dc9f095ed 100644
--- a/src/py/flwr/cli/ls.py
+++ b/src/py/flwr/cli/ls.py
@@ -15,6 +15,7 @@
 """Flower command line interface `ls` command."""
 
 
+import json
 from datetime import datetime, timedelta
 from logging import DEBUG
 from pathlib import Path
@@ -32,7 +33,7 @@
     validate_federation_in_project_config,
     validate_project_config,
 )
-from flwr.common.constant import FAB_CONFIG_FILE, SubStatus
+from flwr.common.constant import FAB_CONFIG_FILE, CliOutputFormat, SubStatus
 from flwr.common.date import format_timedelta, isoformat8601_utc
 from flwr.common.grpc import GRPC_MAX_MESSAGE_LENGTH, create_channel
 from flwr.common.logger import log
@@ -44,6 +45,8 @@
 )
 from flwr.proto.exec_pb2_grpc import ExecStub
 
+_RunListType = tuple[int, str, str, str, str, str, str, str, str]
+
 
 def ls(
     app: Annotated[
@@ -117,7 +120,7 @@ def ls(
             raise typer.Exit(code=1) from err
         finally:
             channel.close()
-    # pylint: disable=broad-except, unused-variable
+    # pylint: disable=broad-except
     except (typer.Exit, Exception):
         _print_json_error()
 
@@ -143,25 +146,13 @@ def _init_channel(app: Path, federation_config: dict[str, Any]) -> grpc.Channel:
     return channel
 
 
-def _format_runs(run_dict: dict[int, Run], now_isoformat: str) -> list[tuple[str, ...]]:
+def _format_runs(run_dict: dict[int, Run], now_isoformat: str) -> list[_RunListType]:
     """Format runs to a list."""
-    table = Table(header_style="bold cyan", show_lines=True)
 
     def _format_datetime(dt: Optional[datetime]) -> str:
         return isoformat8601_utc(dt).replace("T", " ") if dt else "N/A"
 
-    run_list: list[tuple[str, ...]] = []
-
-    # Add columns
-    table.add_column(
-        Text("Run ID", justify="center"), style="bright_white", overflow="fold"
-    )
-    table.add_column(Text("FAB", justify="center"), style="dim white")
-    table.add_column(Text("Status", justify="center"))
-    table.add_column(Text("Elapsed", justify="center"), style="blue")
-    table.add_column(Text("Created At", justify="center"), style="dim white")
-    table.add_column(Text("Running At", justify="center"), style="dim white")
-    table.add_column(Text("Finished At", justify="center"), style="dim white")
+    run_list: list[_RunListType] = []
 
     # Add rows
     for run in sorted(
@@ -173,15 +164,6 @@ def _format_datetime(dt: Optional[datetime]) -> str:
         else:
             status_text = f"{run.status.status}:{run.status.sub_status}"
 
-        # Style the status based on its value
-        sub_status = run.status.sub_status
-        if sub_status == SubStatus.COMPLETED:
-            status_style = "green"
-        elif sub_status == SubStatus.FAILED:
-            status_style = "red"
-        else:
-            status_style = "yellow"
-
         # Convert isoformat to datetime
         pending_at = datetime.fromisoformat(run.pending_at) if run.pending_at else None
         running_at = datetime.fromisoformat(run.running_at) if run.running_at else None
@@ -200,11 +182,11 @@ def _format_datetime(dt: Optional[datetime]) -> str:
 
         run_list.append(
             (
-                f"{run.run_id}",
-                f"{run.fab_id}",
-                f"{run.fab_version}",
-                f"{run.fab_hash}",
-                f"[{status_style}]{status_text}[/{status_style}]",
+                run.run_id,
+                run.fab_id,
+                run.fab_version,
+                run.fab_hash,
+                status_text,
                 format_timedelta(elapsed_time),
                 _format_datetime(pending_at),
                 _format_datetime(running_at),
@@ -214,7 +196,7 @@ def _format_datetime(dt: Optional[datetime]) -> str:
     return run_list
 
 
-def _to_table(run_list: list[tuple[str, ...]]) -> Table:
+def _to_table(run_list: list[_RunListType]) -> Table:
     """Format the provided run list to a rich Table."""
     table = Table(header_style="bold cyan", show_lines=True)
 
@@ -241,10 +223,19 @@ def _to_table(run_list: list[tuple[str, ...]]) -> Table:
             running_at,
             finished_at,
         ) = row
+        # Style the status based on its value
+        sub_status = status_text.rsplit(":", maxsplit=1)[-1]
+        if sub_status == SubStatus.COMPLETED:
+            status_style = "green"
+        elif sub_status == SubStatus.FAILED:
+            status_style = "red"
+        else:
+            status_style = "yellow"
+
         formatted_row = (
             f"[bold]{run_id}[/bold]",
             f"{fab_id} (v{fab_version})",
-            status_text,
+            f"[{status_style}]{status_text}[/{status_style}]",
             elapsed,
             created_at,
             running_at,
@@ -255,19 +246,58 @@ def _to_table(run_list: list[tuple[str, ...]]) -> Table:
     return table
 
 
+def _to_json(run_list: list[_RunListType]) -> str:
+    """Format run status list to a JSON formatted string."""
+    runs_list = []
+    for row in run_list:
+        (
+            run_id,
+            fab_id,
+            fab_version,
+            fab_hash,
+            status_text,
+            elapsed,
+            created_at,
+            running_at,
+            finished_at,
+        ) = row
+        runs_list.append(
+            {
+                "run-id": run_id,
+                "fab-id": fab_id,
+                "fab-name": fab_id.split("/")[-1],
+                "fab-version": fab_version,
+                "fab-hash": fab_hash[:8],
+                "status": status_text,
+                "elapsed": elapsed,
+                "created-at": created_at,
+                "running-at": running_at,
+                "finished-at": finished_at,
+            }
+        )
+
+    return json.dumps({"runs": runs_list})
+
+
 def _list_runs(
     stub: ExecStub,
+    output_format: str = CliOutputFormat.DEFAULT,
 ) -> None:
     """List all runs."""
     res: ListRunsResponse = stub.ListRuns(ListRunsRequest())
     run_dict = {run_id: run_from_proto(proto) for run_id, proto in res.run_dict.items()}
 
-    Console().print(_to_table(_format_runs(run_dict, res.now)))
+    formatted_runs = _format_runs(run_dict, res.now)
+    if output_format == CliOutputFormat.JSON:
+        Console().print_json(_to_json(formatted_runs))
+    else:
+        Console().print(_to_table(formatted_runs))
 
 
 def _display_one_run(
     stub: ExecStub,
     run_id: int,
+    output_format: str = CliOutputFormat.DEFAULT,
 ) -> None:
     """Display information about a specific run."""
     res: ListRunsResponse = stub.ListRuns(ListRunsRequest(run_id=run_id))
@@ -276,7 +306,11 @@ def _display_one_run(
 
     run_dict = {run_id: run_from_proto(proto) for run_id, proto in res.run_dict.items()}
 
-    Console().print(_to_table(_format_runs(run_dict, res.now)))
+    formatted_runs = _format_runs(run_dict, res.now)
+    if output_format == CliOutputFormat.JSON:
+        Console().print_json(_to_json(formatted_runs))
+    else:
+        Console().print(_to_table(formatted_runs))
 
 
 def _print_json_error() -> None:
diff --git a/src/py/flwr/common/constant.py b/src/py/flwr/common/constant.py
index ec84aa984fde..ce5840ddddfb 100644
--- a/src/py/flwr/common/constant.py
+++ b/src/py/flwr/common/constant.py
@@ -181,3 +181,14 @@ class SubStatus:
     def __new__(cls) -> SubStatus:
         """Prevent instantiation."""
         raise TypeError(f"{cls.__name__} cannot be instantiated.")
+
+
+class CliOutputFormat:
+    """Define output format for `flwr` CLI commands."""
+
+    DEFAULT = "default"
+    JSON = "json"
+
+    def __new__(cls) -> CliOutputFormat:
+        """Prevent instantiation."""
+        raise TypeError(f"{cls.__name__} cannot be instantiated.")

From a7ae9990b5ac40202654fb3f7e80536698beb78b Mon Sep 17 00:00:00 2001
From: Chong Shen Ng <chong.shen@flower.ai>
Date: Wed, 4 Dec 2024 12:45:20 +0000
Subject: [PATCH 021/104] feat(framework) Add JSON formatting to `flwr run`
 output (#4619)

---
 src/py/flwr/cli/run/run.py   | 69 ++++++++++++++++++++++++++++++++----
 src/py/flwr/common/logger.py | 26 +++++++++++++-
 2 files changed, 87 insertions(+), 8 deletions(-)

diff --git a/src/py/flwr/cli/run/run.py b/src/py/flwr/cli/run/run.py
index cabd5707d5c0..05c4bf183dda 100644
--- a/src/py/flwr/cli/run/run.py
+++ b/src/py/flwr/cli/run/run.py
@@ -14,16 +14,19 @@
 # ==============================================================================
 """Flower command line interface `run` command."""
 
+import io
 import json
 import subprocess
 from logging import DEBUG
 from pathlib import Path
-from typing import Annotated, Any, Optional
+from typing import Annotated, Any, Optional, Union
 
 import typer
+from rich.console import Console
 
 from flwr.cli.build import build
 from flwr.cli.config_utils import (
+    get_fab_metadata,
     load_and_validate,
     validate_certificate_in_federation_config,
     validate_federation_in_project_config,
@@ -34,8 +37,9 @@
     parse_config_args,
     user_config_to_configsrecord,
 )
+from flwr.common.constant import CliOutputFormat
 from flwr.common.grpc import GRPC_MAX_MESSAGE_LENGTH, create_channel
-from flwr.common.logger import log
+from flwr.common.logger import log, redirect_output, remove_emojis, restore_output
 from flwr.common.serde import (
     configs_record_to_proto,
     fab_to_proto,
@@ -85,9 +89,21 @@ def run(
             "logs are not streamed by default.",
         ),
     ] = False,
+    output_format: Annotated[
+        str,
+        typer.Option(
+            "--format",
+            case_sensitive=False,
+            help="Format output using 'default' view or 'json'",
+        ),
+    ] = CliOutputFormat.DEFAULT,
 ) -> None:
     """Run Flower App."""
+    suppress_output = output_format == CliOutputFormat.JSON
+    captured_output = io.StringIO()
     try:
+        if suppress_output:
+            redirect_output(captured_output)
         typer.secho("Loading project configuration... ", fg=typer.colors.BLUE)
 
         pyproject_path = app / "pyproject.toml" if app else None
@@ -98,12 +114,26 @@ def run(
         )
 
         if "address" in federation_config:
-            _run_with_exec_api(app, federation_config, config_overrides, stream)
+            _run_with_exec_api(
+                app, federation_config, config_overrides, stream, output_format
+            )
         else:
             _run_without_exec_api(app, federation_config, config_overrides, federation)
-    # pylint: disable=broad-except, unused-variable
-    except (typer.Exit, SystemExit, Exception):
-        _print_json_error()
+    except (typer.Exit, Exception) as err:  # pylint: disable=broad-except
+        if suppress_output:
+            restore_output()
+            e_message = captured_output.getvalue()
+            _print_json_error(e_message, err)
+        else:
+            typer.secho(
+                f"{err}",
+                fg=typer.colors.RED,
+                bold=True,
+            )
+    finally:
+        if suppress_output:
+            restore_output()
+        captured_output.close()
 
 
 # pylint: disable-next=too-many-locals
@@ -112,6 +142,7 @@ def _run_with_exec_api(
     federation_config: dict[str, Any],
     config_overrides: Optional[list[str]],
     stream: bool,
+    output_format: str,
 ) -> None:
 
     insecure, root_certificates_bytes = validate_certificate_in_federation_config(
@@ -129,6 +160,7 @@ def _run_with_exec_api(
 
     fab_path, fab_hash = build(app)
     content = Path(fab_path).read_bytes()
+    fab_id, fab_version = get_fab_metadata(Path(fab_path))
 
     # Delete FAB file once the bytes is computed
     Path(fab_path).unlink()
@@ -152,6 +184,21 @@ def _run_with_exec_api(
         typer.secho("❌ Failed to start run", fg=typer.colors.RED)
         raise typer.Exit(code=1)
 
+    if output_format == CliOutputFormat.JSON:
+        run_output = json.dumps(
+            {
+                "success": "true" if res.HasField("run_id") else "false",
+                "run-id": res.run_id if res.HasField("run_id") else None,
+                "fab-id": fab_id,
+                "fab-name": fab_id.rsplit("/", maxsplit=1)[-1],
+                "fab-version": fab_version,
+                "fab-hash": fab_hash[:8],
+                "fab-filename": fab_path,
+            }
+        )
+        restore_output()
+        Console().print_json(run_output)
+
     if stream:
         start_stream(res.run_id, channel, CONN_REFRESH_PERIOD)
 
@@ -204,5 +251,13 @@ def _run_without_exec_api(
     )
 
 
-def _print_json_error() -> None:
+def _print_json_error(msg: str, e: Union[typer.Exit, Exception]) -> None:
     """Print error message as JSON."""
+    Console().print_json(
+        json.dumps(
+            {
+                "success": False,
+                "error-message": remove_emojis(str(msg) + "\n" + str(e)),
+            }
+        )
+    )
diff --git a/src/py/flwr/common/logger.py b/src/py/flwr/common/logger.py
index 7f132d706dc2..62d5fa92b02a 100644
--- a/src/py/flwr/common/logger.py
+++ b/src/py/flwr/common/logger.py
@@ -14,11 +14,12 @@
 # ==============================================================================
 """Flower Logger."""
 
-
 import logging
+import re
 import sys
 import threading
 import time
+from io import StringIO
 from logging import WARN, LogRecord
 from logging.handlers import HTTPHandler
 from queue import Empty, Queue
@@ -303,6 +304,13 @@ def restore_output() -> None:
     console_handler.stream = sys.stdout
 
 
+def redirect_output(output_buffer: StringIO) -> None:
+    """Redirect stdout and stderr to text I/O buffer."""
+    sys.stdout = output_buffer
+    sys.stderr = output_buffer
+    console_handler.stream = sys.stdout
+
+
 def _log_uploader(
     log_queue: Queue[Optional[str]], node_id: int, run_id: int, stub: ServerAppIoStub
 ) -> None:
@@ -366,3 +374,19 @@ def stop_log_uploader(
     """Stop the log uploader thread."""
     log_queue.put(None)
     log_uploader.join()
+
+
+def remove_emojis(text: str) -> str:
+    """Remove emojis from the provided text."""
+    emoji_pattern = re.compile(
+        "["
+        "\U0001F600-\U0001F64F"  # Emoticons
+        "\U0001F300-\U0001F5FF"  # Symbols & Pictographs
+        "\U0001F680-\U0001F6FF"  # Transport & Map Symbols
+        "\U0001F1E0-\U0001F1FF"  # Flags
+        "\U00002702-\U000027B0"  # Dingbats
+        "\U000024C2-\U0001F251"
+        "]+",
+        flags=re.UNICODE,
+    )
+    return emoji_pattern.sub(r"", text)

From 968fc774156e3371ad0c58c5f2638c04e3ab0144 Mon Sep 17 00:00:00 2001
From: Chong Shen Ng <chong.shen@flower.ai>
Date: Wed, 4 Dec 2024 12:54:57 +0000
Subject: [PATCH 022/104] feat(framework) Add JSON formatting to `flwr ls`
 output (#4610)

---
 src/py/flwr/cli/ls.py | 55 ++++++++++++++++++++++++++++++++++++-------
 1 file changed, 46 insertions(+), 9 deletions(-)

diff --git a/src/py/flwr/cli/ls.py b/src/py/flwr/cli/ls.py
index 622dc9f095ed..f1c6a242cd33 100644
--- a/src/py/flwr/cli/ls.py
+++ b/src/py/flwr/cli/ls.py
@@ -15,17 +15,19 @@
 """Flower command line interface `ls` command."""
 
 
+import io
 import json
 from datetime import datetime, timedelta
 from logging import DEBUG
 from pathlib import Path
-from typing import Annotated, Any, Optional
+from typing import Annotated, Any, Optional, Union
 
 import grpc
 import typer
 from rich.console import Console
 from rich.table import Table
 from rich.text import Text
+from typer import Exit
 
 from flwr.cli.config_utils import (
     load_and_validate,
@@ -36,7 +38,7 @@
 from flwr.common.constant import FAB_CONFIG_FILE, CliOutputFormat, SubStatus
 from flwr.common.date import format_timedelta, isoformat8601_utc
 from flwr.common.grpc import GRPC_MAX_MESSAGE_LENGTH, create_channel
-from flwr.common.logger import log
+from flwr.common.logger import log, redirect_output, remove_emojis, restore_output
 from flwr.common.serde import run_from_proto
 from flwr.common.typing import Run
 from flwr.proto.exec_pb2 import (  # pylint: disable=E0611
@@ -48,7 +50,7 @@
 _RunListType = tuple[int, str, str, str, str, str, str, str, str]
 
 
-def ls(
+def ls(  # pylint: disable=too-many-locals, too-many-branches
     app: Annotated[
         Path,
         typer.Argument(help="Path of the Flower project"),
@@ -71,9 +73,22 @@ def ls(
             help="Specific run ID to display",
         ),
     ] = None,
+    output_format: Annotated[
+        str,
+        typer.Option(
+            "--format",
+            case_sensitive=False,
+            help="Format output using 'default' view or 'json'",
+        ),
+    ] = CliOutputFormat.DEFAULT,
 ) -> None:
     """List runs."""
+    suppress_output = output_format == CliOutputFormat.JSON
+    captured_output = io.StringIO()
     try:
+        if suppress_output:
+            redirect_output(captured_output)
+
         # Load and validate federation config
         typer.secho("Loading project configuration... ", fg=typer.colors.BLUE)
 
@@ -105,11 +120,13 @@ def ls(
             # Display information about a specific run ID
             if run_id is not None:
                 typer.echo(f"🔍 Displaying information for run ID {run_id}...")
-                _display_one_run(stub, run_id)
+                restore_output()
+                _display_one_run(stub, run_id, output_format)
             # By default, list all runs
             else:
                 typer.echo("📄 Listing all runs...")
-                _list_runs(stub)
+                restore_output()
+                _list_runs(stub, output_format)
 
         except ValueError as err:
             typer.secho(
@@ -120,9 +137,21 @@ def ls(
             raise typer.Exit(code=1) from err
         finally:
             channel.close()
-    # pylint: disable=broad-except
-    except (typer.Exit, Exception):
-        _print_json_error()
+    except (typer.Exit, Exception) as err:  # pylint: disable=broad-except
+        if suppress_output:
+            restore_output()
+            e_message = captured_output.getvalue()
+            _print_json_error(e_message, err)
+        else:
+            typer.secho(
+                f"{err}",
+                fg=typer.colors.RED,
+                bold=True,
+            )
+    finally:
+        if suppress_output:
+            restore_output()
+        captured_output.close()
 
 
 def on_channel_state_change(channel_connectivity: str) -> None:
@@ -313,5 +342,13 @@ def _display_one_run(
         Console().print(_to_table(formatted_runs))
 
 
-def _print_json_error() -> None:
+def _print_json_error(msg: str, e: Union[Exit, Exception]) -> None:
     """Print error message as JSON."""
+    Console().print_json(
+        json.dumps(
+            {
+                "success": False,
+                "error-message": remove_emojis(str(msg) + "\n" + str(e)),
+            }
+        )
+    )

From 0254c88eea143ee62a15f89d9d4e9f4182e1ed32 Mon Sep 17 00:00:00 2001
From: Javier <jafermarq@users.noreply.github.com>
Date: Wed, 4 Dec 2024 15:14:03 +0000
Subject: [PATCH 023/104] fix(framework:skip) Ensure `success` field in `flwr
 run` returned JSON is boolean (#4632)

---
 src/py/flwr/cli/run/run.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/py/flwr/cli/run/run.py b/src/py/flwr/cli/run/run.py
index 05c4bf183dda..5696533a8f14 100644
--- a/src/py/flwr/cli/run/run.py
+++ b/src/py/flwr/cli/run/run.py
@@ -187,7 +187,7 @@ def _run_with_exec_api(
     if output_format == CliOutputFormat.JSON:
         run_output = json.dumps(
             {
-                "success": "true" if res.HasField("run_id") else "false",
+                "success": res.HasField("run_id"),
                 "run-id": res.run_id if res.HasField("run_id") else None,
                 "fab-id": fab_id,
                 "fab-name": fab_id.rsplit("/", maxsplit=1)[-1],

From 738929599d7f5ff9787e54932ce289add1aa9bed Mon Sep 17 00:00:00 2001
From: Javier <jafermarq@users.noreply.github.com>
Date: Wed, 4 Dec 2024 16:53:31 +0000
Subject: [PATCH 024/104] fix(framework:skip) Ensure `success` key is always
 present in JSON output for `flwr ls` (#4633)

---
 src/py/flwr/cli/ls.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/py/flwr/cli/ls.py b/src/py/flwr/cli/ls.py
index f1c6a242cd33..45956bae0dc2 100644
--- a/src/py/flwr/cli/ls.py
+++ b/src/py/flwr/cli/ls.py
@@ -305,7 +305,7 @@ def _to_json(run_list: list[_RunListType]) -> str:
             }
         )
 
-    return json.dumps({"runs": runs_list})
+    return json.dumps({"success": True, "runs": runs_list})
 
 
 def _list_runs(

From ee85fd73b35e0c8e239c3f9dd96324116abcc13f Mon Sep 17 00:00:00 2001
From: Chong Shen Ng <chong.shen@flower.ai>
Date: Thu, 5 Dec 2024 10:17:59 +0000
Subject: [PATCH 025/104] feat(framework) Add StopRun RPC to exec.proto (#4639)

---
 src/proto/flwr/proto/exec.proto        |  5 ++++
 src/py/flwr/proto/exec_pb2.py          | 10 +++++---
 src/py/flwr/proto/exec_pb2.pyi         | 22 +++++++++++++++++
 src/py/flwr/proto/exec_pb2_grpc.py     | 34 ++++++++++++++++++++++++++
 src/py/flwr/proto/exec_pb2_grpc.pyi    | 13 ++++++++++
 src/py/flwr/superexec/exec_servicer.py |  9 +++++++
 6 files changed, 90 insertions(+), 3 deletions(-)

diff --git a/src/proto/flwr/proto/exec.proto b/src/proto/flwr/proto/exec.proto
index aa7bd0ea37b3..6fb2bec9f0a3 100644
--- a/src/proto/flwr/proto/exec.proto
+++ b/src/proto/flwr/proto/exec.proto
@@ -26,6 +26,9 @@ service Exec {
   // Start run upon request
   rpc StartRun(StartRunRequest) returns (StartRunResponse) {}
 
+  // Stop run upon request
+  rpc StopRun(StopRunRequest) returns (StopRunResponse) {}
+
   // Start log stream upon request
   rpc StreamLogs(StreamLogsRequest) returns (stream StreamLogsResponse) {}
 
@@ -52,3 +55,5 @@ message ListRunsResponse {
   map<uint64, Run> run_dict = 1;
   string now = 2;
 }
+message StopRunRequest { uint64 run_id = 1; }
+message StopRunResponse { bool success = 1; }
diff --git a/src/py/flwr/proto/exec_pb2.py b/src/py/flwr/proto/exec_pb2.py
index d06c5af3007d..18253dd1d02a 100644
--- a/src/py/flwr/proto/exec_pb2.py
+++ b/src/py/flwr/proto/exec_pb2.py
@@ -18,7 +18,7 @@
 from flwr.proto import run_pb2 as flwr_dot_proto_dot_run__pb2
 
 
-DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x15\x66lwr/proto/exec.proto\x12\nflwr.proto\x1a\x14\x66lwr/proto/fab.proto\x1a\x1a\x66lwr/proto/transport.proto\x1a\x1a\x66lwr/proto/recordset.proto\x1a\x14\x66lwr/proto/run.proto\"\xfb\x01\n\x0fStartRunRequest\x12\x1c\n\x03\x66\x61\x62\x18\x01 \x01(\x0b\x32\x0f.flwr.proto.Fab\x12H\n\x0foverride_config\x18\x02 \x03(\x0b\x32/.flwr.proto.StartRunRequest.OverrideConfigEntry\x12\x35\n\x12\x66\x65\x64\x65ration_options\x18\x03 \x01(\x0b\x32\x19.flwr.proto.ConfigsRecord\x1aI\n\x13OverrideConfigEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12!\n\x05value\x18\x02 \x01(\x0b\x32\x12.flwr.proto.Scalar:\x02\x38\x01\"2\n\x10StartRunResponse\x12\x13\n\x06run_id\x18\x01 \x01(\x04H\x00\x88\x01\x01\x42\t\n\x07_run_id\"<\n\x11StreamLogsRequest\x12\x0e\n\x06run_id\x18\x01 \x01(\x04\x12\x17\n\x0f\x61\x66ter_timestamp\x18\x02 \x01(\x01\"B\n\x12StreamLogsResponse\x12\x12\n\nlog_output\x18\x01 \x01(\t\x12\x18\n\x10latest_timestamp\x18\x02 \x01(\x01\"1\n\x0fListRunsRequest\x12\x13\n\x06run_id\x18\x01 \x01(\x04H\x00\x88\x01\x01\x42\t\n\x07_run_id\"\x9d\x01\n\x10ListRunsResponse\x12;\n\x08run_dict\x18\x01 \x03(\x0b\x32).flwr.proto.ListRunsResponse.RunDictEntry\x12\x0b\n\x03now\x18\x02 \x01(\t\x1a?\n\x0cRunDictEntry\x12\x0b\n\x03key\x18\x01 \x01(\x04\x12\x1e\n\x05value\x18\x02 \x01(\x0b\x32\x0f.flwr.proto.Run:\x02\x38\x01\x32\xe9\x01\n\x04\x45xec\x12G\n\x08StartRun\x12\x1b.flwr.proto.StartRunRequest\x1a\x1c.flwr.proto.StartRunResponse\"\x00\x12O\n\nStreamLogs\x12\x1d.flwr.proto.StreamLogsRequest\x1a\x1e.flwr.proto.StreamLogsResponse\"\x00\x30\x01\x12G\n\x08ListRuns\x12\x1b.flwr.proto.ListRunsRequest\x1a\x1c.flwr.proto.ListRunsResponse\"\x00\x62\x06proto3')
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x15\x66lwr/proto/exec.proto\x12\nflwr.proto\x1a\x14\x66lwr/proto/fab.proto\x1a\x1a\x66lwr/proto/transport.proto\x1a\x1a\x66lwr/proto/recordset.proto\x1a\x14\x66lwr/proto/run.proto\"\xfb\x01\n\x0fStartRunRequest\x12\x1c\n\x03\x66\x61\x62\x18\x01 \x01(\x0b\x32\x0f.flwr.proto.Fab\x12H\n\x0foverride_config\x18\x02 \x03(\x0b\x32/.flwr.proto.StartRunRequest.OverrideConfigEntry\x12\x35\n\x12\x66\x65\x64\x65ration_options\x18\x03 \x01(\x0b\x32\x19.flwr.proto.ConfigsRecord\x1aI\n\x13OverrideConfigEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12!\n\x05value\x18\x02 \x01(\x0b\x32\x12.flwr.proto.Scalar:\x02\x38\x01\"2\n\x10StartRunResponse\x12\x13\n\x06run_id\x18\x01 \x01(\x04H\x00\x88\x01\x01\x42\t\n\x07_run_id\"<\n\x11StreamLogsRequest\x12\x0e\n\x06run_id\x18\x01 \x01(\x04\x12\x17\n\x0f\x61\x66ter_timestamp\x18\x02 \x01(\x01\"B\n\x12StreamLogsResponse\x12\x12\n\nlog_output\x18\x01 \x01(\t\x12\x18\n\x10latest_timestamp\x18\x02 \x01(\x01\"1\n\x0fListRunsRequest\x12\x13\n\x06run_id\x18\x01 \x01(\x04H\x00\x88\x01\x01\x42\t\n\x07_run_id\"\x9d\x01\n\x10ListRunsResponse\x12;\n\x08run_dict\x18\x01 \x03(\x0b\x32).flwr.proto.ListRunsResponse.RunDictEntry\x12\x0b\n\x03now\x18\x02 \x01(\t\x1a?\n\x0cRunDictEntry\x12\x0b\n\x03key\x18\x01 \x01(\x04\x12\x1e\n\x05value\x18\x02 \x01(\x0b\x32\x0f.flwr.proto.Run:\x02\x38\x01\" \n\x0eStopRunRequest\x12\x0e\n\x06run_id\x18\x01 \x01(\x04\"\"\n\x0fStopRunResponse\x12\x0f\n\x07success\x18\x01 \x01(\x08\x32\xaf\x02\n\x04\x45xec\x12G\n\x08StartRun\x12\x1b.flwr.proto.StartRunRequest\x1a\x1c.flwr.proto.StartRunResponse\"\x00\x12\x44\n\x07StopRun\x12\x1a.flwr.proto.StopRunRequest\x1a\x1b.flwr.proto.StopRunResponse\"\x00\x12O\n\nStreamLogs\x12\x1d.flwr.proto.StreamLogsRequest\x1a\x1e.flwr.proto.StreamLogsResponse\"\x00\x30\x01\x12G\n\x08ListRuns\x12\x1b.flwr.proto.ListRunsRequest\x1a\x1c.flwr.proto.ListRunsResponse\"\x00\x62\x06proto3')
 
 _globals = globals()
 _builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
@@ -45,6 +45,10 @@
   _globals['_LISTRUNSRESPONSE']._serialized_end=782
   _globals['_LISTRUNSRESPONSE_RUNDICTENTRY']._serialized_start=719
   _globals['_LISTRUNSRESPONSE_RUNDICTENTRY']._serialized_end=782
-  _globals['_EXEC']._serialized_start=785
-  _globals['_EXEC']._serialized_end=1018
+  _globals['_STOPRUNREQUEST']._serialized_start=784
+  _globals['_STOPRUNREQUEST']._serialized_end=816
+  _globals['_STOPRUNRESPONSE']._serialized_start=818
+  _globals['_STOPRUNRESPONSE']._serialized_end=852
+  _globals['_EXEC']._serialized_start=855
+  _globals['_EXEC']._serialized_end=1158
 # @@protoc_insertion_point(module_scope)
diff --git a/src/py/flwr/proto/exec_pb2.pyi b/src/py/flwr/proto/exec_pb2.pyi
index 1cc971444e32..70ff9147e02a 100644
--- a/src/py/flwr/proto/exec_pb2.pyi
+++ b/src/py/flwr/proto/exec_pb2.pyi
@@ -134,3 +134,25 @@ class ListRunsResponse(google.protobuf.message.Message):
         ) -> None: ...
     def ClearField(self, field_name: typing_extensions.Literal["now",b"now","run_dict",b"run_dict"]) -> None: ...
 global___ListRunsResponse = ListRunsResponse
+
+class StopRunRequest(google.protobuf.message.Message):
+    DESCRIPTOR: google.protobuf.descriptor.Descriptor
+    RUN_ID_FIELD_NUMBER: builtins.int
+    run_id: builtins.int
+    def __init__(self,
+        *,
+        run_id: builtins.int = ...,
+        ) -> None: ...
+    def ClearField(self, field_name: typing_extensions.Literal["run_id",b"run_id"]) -> None: ...
+global___StopRunRequest = StopRunRequest
+
+class StopRunResponse(google.protobuf.message.Message):
+    DESCRIPTOR: google.protobuf.descriptor.Descriptor
+    SUCCESS_FIELD_NUMBER: builtins.int
+    success: builtins.bool
+    def __init__(self,
+        *,
+        success: builtins.bool = ...,
+        ) -> None: ...
+    def ClearField(self, field_name: typing_extensions.Literal["success",b"success"]) -> None: ...
+global___StopRunResponse = StopRunResponse
diff --git a/src/py/flwr/proto/exec_pb2_grpc.py b/src/py/flwr/proto/exec_pb2_grpc.py
index 63f9285fed58..9ce04915771d 100644
--- a/src/py/flwr/proto/exec_pb2_grpc.py
+++ b/src/py/flwr/proto/exec_pb2_grpc.py
@@ -19,6 +19,11 @@ def __init__(self, channel):
                 request_serializer=flwr_dot_proto_dot_exec__pb2.StartRunRequest.SerializeToString,
                 response_deserializer=flwr_dot_proto_dot_exec__pb2.StartRunResponse.FromString,
                 )
+        self.StopRun = channel.unary_unary(
+                '/flwr.proto.Exec/StopRun',
+                request_serializer=flwr_dot_proto_dot_exec__pb2.StopRunRequest.SerializeToString,
+                response_deserializer=flwr_dot_proto_dot_exec__pb2.StopRunResponse.FromString,
+                )
         self.StreamLogs = channel.unary_stream(
                 '/flwr.proto.Exec/StreamLogs',
                 request_serializer=flwr_dot_proto_dot_exec__pb2.StreamLogsRequest.SerializeToString,
@@ -41,6 +46,13 @@ def StartRun(self, request, context):
         context.set_details('Method not implemented!')
         raise NotImplementedError('Method not implemented!')
 
+    def StopRun(self, request, context):
+        """Stop run upon request
+        """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details('Method not implemented!')
+        raise NotImplementedError('Method not implemented!')
+
     def StreamLogs(self, request, context):
         """Start log stream upon request
         """
@@ -63,6 +75,11 @@ def add_ExecServicer_to_server(servicer, server):
                     request_deserializer=flwr_dot_proto_dot_exec__pb2.StartRunRequest.FromString,
                     response_serializer=flwr_dot_proto_dot_exec__pb2.StartRunResponse.SerializeToString,
             ),
+            'StopRun': grpc.unary_unary_rpc_method_handler(
+                    servicer.StopRun,
+                    request_deserializer=flwr_dot_proto_dot_exec__pb2.StopRunRequest.FromString,
+                    response_serializer=flwr_dot_proto_dot_exec__pb2.StopRunResponse.SerializeToString,
+            ),
             'StreamLogs': grpc.unary_stream_rpc_method_handler(
                     servicer.StreamLogs,
                     request_deserializer=flwr_dot_proto_dot_exec__pb2.StreamLogsRequest.FromString,
@@ -100,6 +117,23 @@ def StartRun(request,
             options, channel_credentials,
             insecure, call_credentials, compression, wait_for_ready, timeout, metadata)
 
+    @staticmethod
+    def StopRun(request,
+            target,
+            options=(),
+            channel_credentials=None,
+            call_credentials=None,
+            insecure=False,
+            compression=None,
+            wait_for_ready=None,
+            timeout=None,
+            metadata=None):
+        return grpc.experimental.unary_unary(request, target, '/flwr.proto.Exec/StopRun',
+            flwr_dot_proto_dot_exec__pb2.StopRunRequest.SerializeToString,
+            flwr_dot_proto_dot_exec__pb2.StopRunResponse.FromString,
+            options, channel_credentials,
+            insecure, call_credentials, compression, wait_for_ready, timeout, metadata)
+
     @staticmethod
     def StreamLogs(request,
             target,
diff --git a/src/py/flwr/proto/exec_pb2_grpc.pyi b/src/py/flwr/proto/exec_pb2_grpc.pyi
index 550c282bface..12f42befab06 100644
--- a/src/py/flwr/proto/exec_pb2_grpc.pyi
+++ b/src/py/flwr/proto/exec_pb2_grpc.pyi
@@ -14,6 +14,11 @@ class ExecStub:
         flwr.proto.exec_pb2.StartRunResponse]
     """Start run upon request"""
 
+    StopRun: grpc.UnaryUnaryMultiCallable[
+        flwr.proto.exec_pb2.StopRunRequest,
+        flwr.proto.exec_pb2.StopRunResponse]
+    """Stop run upon request"""
+
     StreamLogs: grpc.UnaryStreamMultiCallable[
         flwr.proto.exec_pb2.StreamLogsRequest,
         flwr.proto.exec_pb2.StreamLogsResponse]
@@ -34,6 +39,14 @@ class ExecServicer(metaclass=abc.ABCMeta):
         """Start run upon request"""
         pass
 
+    @abc.abstractmethod
+    def StopRun(self,
+        request: flwr.proto.exec_pb2.StopRunRequest,
+        context: grpc.ServicerContext,
+    ) -> flwr.proto.exec_pb2.StopRunResponse:
+        """Stop run upon request"""
+        pass
+
     @abc.abstractmethod
     def StreamLogs(self,
         request: flwr.proto.exec_pb2.StreamLogsRequest,
diff --git a/src/py/flwr/superexec/exec_servicer.py b/src/py/flwr/superexec/exec_servicer.py
index 3a484ea8c47c..64fc17695afc 100644
--- a/src/py/flwr/superexec/exec_servicer.py
+++ b/src/py/flwr/superexec/exec_servicer.py
@@ -36,6 +36,8 @@
     ListRunsResponse,
     StartRunRequest,
     StartRunResponse,
+    StopRunRequest,
+    StopRunResponse,
     StreamLogsRequest,
     StreamLogsResponse,
 )
@@ -126,6 +128,13 @@ def ListRuns(
         # Handle `flwr ls --run-id <run_id>`
         return _create_list_runs_response({request.run_id}, state)
 
+    def StopRun(
+        self, request: StopRunRequest, context: grpc.ServicerContext
+    ) -> StopRunResponse:
+        """Stop a given run ID."""
+        log(INFO, "ExecServicer.StopRun")
+        raise NotImplementedError()
+
 
 def _create_list_runs_response(run_ids: set[int], state: LinkState) -> ListRunsResponse:
     """Create response for `flwr ls --runs` and `flwr ls --run-id <run_id>`."""

From 0ea7a0e0ae44219426c4e056a57c5328ecbd37de Mon Sep 17 00:00:00 2001
From: Chong Shen Ng <chong.shen@flower.ai>
Date: Thu, 5 Dec 2024 10:44:42 +0000
Subject: [PATCH 026/104] feat(framework) Add `StopRun` to `ExecServicer`
 (#4634)

Co-authored-by: Daniel J. Beutel <daniel@flower.ai>
---
 src/py/flwr/superexec/exec_servicer.py      | 24 ++++++++++++++++++--
 src/py/flwr/superexec/exec_servicer_test.py | 25 +++++++++++++++++++++
 2 files changed, 47 insertions(+), 2 deletions(-)

diff --git a/src/py/flwr/superexec/exec_servicer.py b/src/py/flwr/superexec/exec_servicer.py
index 64fc17695afc..700c6bf40708 100644
--- a/src/py/flwr/superexec/exec_servicer.py
+++ b/src/py/flwr/superexec/exec_servicer.py
@@ -23,13 +23,14 @@
 import grpc
 
 from flwr.common import now
-from flwr.common.constant import LOG_STREAM_INTERVAL, Status
+from flwr.common.constant import LOG_STREAM_INTERVAL, Status, SubStatus
 from flwr.common.logger import log
 from flwr.common.serde import (
     configs_record_from_proto,
     run_to_proto,
     user_config_from_proto,
 )
+from flwr.common.typing import RunStatus
 from flwr.proto import exec_pb2_grpc  # pylint: disable=E0611
 from flwr.proto.exec_pb2 import (  # pylint: disable=E0611
     ListRunsRequest,
@@ -133,7 +134,26 @@ def StopRun(
     ) -> StopRunResponse:
         """Stop a given run ID."""
         log(INFO, "ExecServicer.StopRun")
-        raise NotImplementedError()
+        state = self.linkstate_factory.state()
+
+        # Exit if `run_id` not found
+        if not state.get_run(request.run_id):
+            context.abort(
+                grpc.StatusCode.NOT_FOUND, f"Run ID {request.run_id} not found"
+            )
+
+        run_status = state.get_run_status({request.run_id})[request.run_id]
+        if run_status.status == Status.FINISHED:
+            context.abort(
+                grpc.StatusCode.FAILED_PRECONDITION,
+                f"Run ID {request.run_id} is already finished",
+            )
+
+        update_success = state.update_run_status(
+            run_id=request.run_id,
+            new_status=RunStatus(Status.FINISHED, SubStatus.STOPPED, ""),
+        )
+        return StopRunResponse(success=update_success)
 
 
 def _create_list_runs_response(run_ids: set[int], state: LinkState) -> ListRunsResponse:
diff --git a/src/py/flwr/superexec/exec_servicer_test.py b/src/py/flwr/superexec/exec_servicer_test.py
index 6045d6eb1a63..365dfed33d7a 100644
--- a/src/py/flwr/superexec/exec_servicer_test.py
+++ b/src/py/flwr/superexec/exec_servicer_test.py
@@ -21,9 +21,12 @@
 from unittest.mock import MagicMock, Mock
 
 from flwr.common import ConfigsRecord, now
+from flwr.common.constant import Status, SubStatus
+from flwr.common.typing import RunStatus
 from flwr.proto.exec_pb2 import (  # pylint: disable=E0611
     ListRunsRequest,
     StartRunRequest,
+    StopRunRequest,
 )
 from flwr.server.superlink.ffs.ffs_factory import FfsFactory
 from flwr.server.superlink.linkstate import LinkStateFactory
@@ -104,3 +107,25 @@ def test_list_run_id(self) -> None:
         # Assert
         self.assertLess(abs(retrieved_timestamp - now().timestamp()), 1e-3)
         self.assertEqual(set(response.run_dict.keys()), {run_id})
+
+    def test_stop_run(self) -> None:
+        """Test StopRun method of ExecServicer."""
+        # Prepare
+        run_id = self.state.create_run(
+            "mock_fabid", "mock_fabver", "fake_hash", {}, ConfigsRecord()
+        )
+        self.servicer.executor = MagicMock()
+        expected_run_status = RunStatus(Status.FINISHED, SubStatus.STOPPED, "")
+        self.servicer.executor.stop_run = lambda input_run_id: (
+            input_run_id == run_id
+        ) & self.state.update_run_status(input_run_id, new_status=expected_run_status)
+
+        # Execute
+        response = self.servicer.StopRun(StopRunRequest(run_id=run_id), Mock())
+        run_state = self.state.get_run(run_id)
+
+        # Assert
+        self.assertTrue(response.success)
+        self.assertIsNotNone(run_state)
+        if run_state is not None:
+            self.assertEqual(run_state.status, expected_run_status)

From f7553c6b91786b7946e7a8934dad9cb7d591e356 Mon Sep 17 00:00:00 2001
From: Dimitris Stripelis <11239849+dstripelis@users.noreply.github.com>
Date: Sat, 7 Dec 2024 13:11:56 +0200
Subject: [PATCH 027/104] docs(framework) Add how-to-guide to run Flower on
 Microsoft Azure VM instances (#4625)

---
 doc/source/how-to-run-flower-on-azure.rst | 225 ++++++++++++++++++++++
 doc/source/index.rst                      |   1 +
 2 files changed, 226 insertions(+)
 create mode 100644 doc/source/how-to-run-flower-on-azure.rst

diff --git a/doc/source/how-to-run-flower-on-azure.rst b/doc/source/how-to-run-flower-on-azure.rst
new file mode 100644
index 000000000000..dfeda022377f
--- /dev/null
+++ b/doc/source/how-to-run-flower-on-azure.rst
@@ -0,0 +1,225 @@
+.. |authenticate_supernodes| replace:: Authenticate Supernodes
+
+.. _authenticate_supernodes: how-to-authenticate-supernodes.html
+
+.. |enable_tls_connections| replace:: Enable TLS Connections
+
+.. _enable_tls_connections: how-to-enable-tls-connections.html
+
+.. |flower_architecture_link| replace:: Flower Architecture
+
+.. _flower_architecture_link: explanation-flower-architecture.html
+
+.. |flower_docker_index| replace:: Run Flower using Docker
+
+.. _flower_docker_index: docker/index.html
+
+Run Flower on Azure
+===================
+
+.. note::
+
+    There are many ways to deploy Flower on Microst Azure. The instructions provided in
+    this guide is just a basic walkthrough, step-by-step guide on how to quickly setup
+    and run a Flower application on a Federated Learning environment on Microst Azure.
+
+In this how-to guide, we want to create a Federated Learning environment on Microst
+Azure using three Virtual Machines (VMs). From the three machines, one machine will be
+used as the Federation server and two as the Federation clients. Our goal is to create a
+Flower federation on Microst Azure where we can run Flower apps from our local machine,
+e.g., laptop.
+
+On the Federation server VM we will deploy the long-running Flower server
+(``SuperLink``) and on the two Federation client VMs we will deploy the long-running
+Flower client (``SuperNode``). For more details For more details regarding the
+``SuperLink`` and ``SuperNode`` concepts, please see the |flower_architecture_link|_ .
+
+Azure VMs
+---------
+
+First we need to create the three VMs configure their Python environments, and inbound
+networking rules to allow cross-VM communication.
+
+VM Create
+~~~~~~~~~
+
+Assuming we are already inside the Microst Azure portal, we navigate to the ``Create``
+page and we select ``Azure virtual machine``. In the new page, for each VM we edit the
+properties as follows:
+
+.. list-table::
+    :align: left
+    :widths: 13 30
+    :header-rows: 0
+
+    - - **Virtual machine name**
+      - for server machine we can use ``flower-server`` and for clients,
+        ``flower-client-1`` and ``flower-client-2``
+    - - **Image**
+      - in this guide, we use ``Ubuntu Server 24.04 - x64 Gen2 LTS``
+    - - **Size**
+      - in this guide, we use ``Standard_D2s_v3 - 2 vcpus, 8GiB memory``
+
+.. tip::
+
+    For resource group, we can create a new group and assign it to all VMs.
+
+When each VM instance has been created the portal will allow you to download the public
+key (.pem) of each instance. Make sure you save this key in safe place and change its
+permissions to user read only, i.e., run the ``chmod 400 <PATH_TO_PEM_FILE>`` command
+for every .pem file.
+
+Once all three VMs are created then navigate to the overview page where all three VMs
+are listed and open every other VM, and copy its Public IP address. Using the Public IP
+address and the public key (after changing the permissions), login to the instances from
+our local machine by running the following command (by default Azure creates the
+``azureuser``):
+
+.. code-block:: bash
+
+    ssh -i <PATH_TO_PEM_FILE> azureuser@<PUBLIC_IP>
+
+VM Networking
+~~~~~~~~~~~~~
+
+During the execution of the Flower application, the server VM (``SuperLink``) will be
+responsible to orchestrate the execution of the application across the client VMs
+(``SuperNode``). When the SuperLink server starts, by default, it listens to the
+following ports: ``{9092, 9093}``. Port `9092` is used to communicate with the
+Federation clients (``SuperNode``) and port ``9093`` to receive and execute Flower
+applications.
+
+Therefore, to enable this communication we need to allow inbound traffic to the server
+VM instance. To achieve this, we need to navigate to the Networking page of the server
+VM in the Microsoft Azure portal. There, we will click the ``Add inbound port rule``. In
+the new window that appears, we edit the rule properties as follows:
+
+The rest of the fields can be left at their default values.
+
+.. list-table::
+    :align: left
+    :widths: 25 30
+    :header-rows: 0
+
+    - - **Source**
+      - ``IP Addresses``
+    - - **Source IP addresses/CIDR ranges**
+      - add client VMs' Public IP (separated by comma)
+    - - **Destination**
+      - ``Any``
+    - - **Service**
+      - ``custom``
+    - - **Destination port ranges**
+      - ``9092``
+    - - **Protocol**
+      - ``TCP``
+
+Finally, we need to also open port 9093 to allow receiving and executing incoming
+application requests. To enable this we just need to repeat the steps above, i.e.,
+create a new inbound rule, where for port range we assign port 9093. If we already know
+the Public IP from which our local machine (e.g., laptop) will be submitting
+applications to the Azure cluster, then we just need to specify the Source IP
+address/CIDR range. However, if we want to keep the port widely open we simply need to
+change source to ``Any``.
+
+To be more precise, if we know the Public IP of our machine, then we make the following
+changes:
+
+.. list-table::
+    :align: left
+    :widths: 25 25
+    :header-rows: 0
+
+    - - **Source IP addresses/CIDR ranges**
+      - add machine's Public IP
+    - - **Destination port ranges**
+      - ``9093``
+
+Otherwise, we change the properties as follows:
+
+.. list-table::
+    :align: left
+    :widths: 25 25
+    :header-rows: 0
+
+    - - **Source**
+      - ``Any``
+    - - **Destination port ranges**
+      - ``9093``
+
+Flower Environment
+------------------
+
+Assuming we have been able to login to each VM, and create a Python environment with
+Flower and all its dependencies installed (``pip install flwr``), we can create a Flower
+application by running the ``flwr new`` command. The console will then prompt us to give
+a name to the project, e.g., ``flwr_azure_test``, the name of the author and select the
+type of the Flower Framework we want to run, e.g., ``numpy``.
+
+.. note::
+
+    An alternative approach would be to use Docker in each VM, with each image
+    containing the necessary environment and dependencies. For more details please refer
+    to the |flower_docker_index|_ guide.
+
+Server Initialization
+~~~~~~~~~~~~~~~~~~~~~
+
+After configuring the Flower application environment, we proceed by starting the Flower
+long-running processes (i.e., ``SuperLink`` and ``SuperNode``) at each VM instance. In
+particular, we need to run the following commands, first in the server (``SuperLink``)
+and then at each client (``SuperNode``).
+
+.. note::
+
+    To enable authentication and encrypted communication during the execution lifecycle
+    of the Flower application, please have a look at the following resources:
+    |authenticate_supernodes|_, |enable_tls_connections|_
+
+.. code-block:: bash
+
+    # Server VM (SuperLink)
+    flower-superlink --insecure
+
+    # Client-1 VM (SuperNode-1)
+    flower-supernode \
+      --insecure \
+      --clientappio-api-address="0.0.0.0:9094" \  # SuperNode listening port
+      --superlink="SUPERLINK_PUBLIC_IP:9092"  # SuperLink public ip and port
+
+    # Client-2 VM (SuperNode-2)
+    flower-supernode \
+      --insecure \
+      --clientappio-api-address="0.0.0.0:9095" \  # SuperNode listening port
+      --superlink="SUPERLINK_PUBLIC_IP:9092"  # SuperLink public ip and port
+
+Run Flower App
+~~~~~~~~~~~~~~
+
+Finally, after all running Flower processes have been initialized on the Microsoft Azure
+cluster, in our local machine, we first need to install Flower and can create a project
+with a similar structure as the one we have in the server and the clients, or copy the
+project structure from one of them. Once we have the project locally, we can open the
+``pyproject.toml`` file, and then add the following sections:
+
+.. code-block:: bash
+
+    [tool.flwr.federations]
+    default = "my-federation"  # replaced the default value with "my-federation"
+
+    [tool.flwr.federations.my-federation]  # replaced name with "my-federation"
+    address = "SUPERLINK_PUBLIC_IP:9093"  # Address of the SuperLink Exec API
+    insecure = true
+
+Then from our local machine we need to run ``flwr run . my-federation``.
+
+Next Steps
+----------
+
+.. warning::
+
+    This guide is not suitable for production environments due to missing authentication
+    and TLS security.
+
+To enable authentication and establish secure connections, please refer to the following
+resources: |authenticate_supernodes|_, |enable_tls_connections|_
diff --git a/doc/source/index.rst b/doc/source/index.rst
index 8695935acb04..ddb123acd27b 100644
--- a/doc/source/index.rst
+++ b/doc/source/index.rst
@@ -99,6 +99,7 @@ Problem-oriented how-to guides show step-by-step how to achieve a specific goal.
     how-to-use-differential-privacy
     how-to-authenticate-supernodes
     how-to-implement-fedbn
+    how-to-run-flower-on-azure
     docker/index
     how-to-upgrade-to-flower-1.0
     how-to-upgrade-to-flower-1.13

From a5f4295ea9af0e5f944d0875b12cd002a31c28d7 Mon Sep 17 00:00:00 2001
From: "github-actions[bot]"
 <41898282+github-actions[bot]@users.noreply.github.com>
Date: Sun, 8 Dec 2024 09:10:38 +0100
Subject: [PATCH 028/104] Update text and language files (#4654)

---
 doc/locales/fr/LC_MESSAGES/framework-docs.po  | 402 +++++++++++++++--
 doc/locales/ko/LC_MESSAGES/framework-docs.po  | 404 +++++++++++++++--
 .../pt_BR/LC_MESSAGES/framework-docs.po       | 398 +++++++++++++++--
 .../zh_Hans/LC_MESSAGES/framework-docs.po     | 405 ++++++++++++++++--
 4 files changed, 1497 insertions(+), 112 deletions(-)

diff --git a/doc/locales/fr/LC_MESSAGES/framework-docs.po b/doc/locales/fr/LC_MESSAGES/framework-docs.po
index 40aaec1a1087..94cb3b821cd1 100644
--- a/doc/locales/fr/LC_MESSAGES/framework-docs.po
+++ b/doc/locales/fr/LC_MESSAGES/framework-docs.po
@@ -3,7 +3,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Flower Docs\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2024-11-30 00:31+0000\n"
+"POT-Creation-Date: 2024-12-08 00:35+0000\n"
 "PO-Revision-Date: 2023-09-05 17:54+0000\n"
 "Last-Translator: Charles Beauville <charles@flower.ai>\n"
 "Language: fr\n"
@@ -6237,6 +6237,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/how-to-implement-fedbn.rst:99
+#: ../../source/how-to-run-flower-on-azure.rst:217
 msgid "Next Steps"
 msgstr "Prochaines étapes"
 
@@ -6793,6 +6794,300 @@ msgstr ""
 "Pour les simulations qui utilisent le moteur de client virtuel, ``flwr-"
 "nightly`` doit être installé avec l'option ``simulation``: :"
 
+#: ../../source/how-to-run-flower-on-azure.rst:18
+#, fuzzy
+msgid "Run Flower on Azure"
+msgstr "Serveur de Flower"
+
+#: ../../source/how-to-run-flower-on-azure.rst:22
+msgid ""
+"There are many ways to deploy Flower on Microst Azure. The instructions "
+"provided in this guide is just a basic walkthrough, step-by-step guide on"
+" how to quickly setup and run a Flower application on a Federated "
+"Learning environment on Microst Azure."
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:26
+msgid ""
+"In this how-to guide, we want to create a Federated Learning environment "
+"on Microst Azure using three Virtual Machines (VMs). From the three "
+"machines, one machine will be used as the Federation server and two as "
+"the Federation clients. Our goal is to create a Flower federation on "
+"Microst Azure where we can run Flower apps from our local machine, e.g., "
+"laptop."
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:32
+msgid ""
+"On the Federation server VM we will deploy the long-running Flower server"
+" (``SuperLink``) and on the two Federation client VMs we will deploy the "
+"long-running Flower client (``SuperNode``). For more details For more "
+"details regarding the ``SuperLink`` and ``SuperNode`` concepts, please "
+"see the |flower_architecture_link|_ ."
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:38
+msgid "Azure VMs"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:40
+msgid ""
+"First we need to create the three VMs configure their Python "
+"environments, and inbound networking rules to allow cross-VM "
+"communication."
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:44
+msgid "VM Create"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:46
+msgid ""
+"Assuming we are already inside the Microst Azure portal, we navigate to "
+"the ``Create`` page and we select ``Azure virtual machine``. In the new "
+"page, for each VM we edit the properties as follows:"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:55
+msgid "**Virtual machine name**"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:56
+msgid ""
+"for server machine we can use ``flower-server`` and for clients, "
+"``flower-client-1`` and ``flower-client-2``"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:58
+#, fuzzy
+msgid "**Image**"
+msgstr "**Apporter des modifications**"
+
+#: ../../source/how-to-run-flower-on-azure.rst:59
+msgid "in this guide, we use ``Ubuntu Server 24.04 - x64 Gen2 LTS``"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:60
+msgid "**Size**"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:61
+msgid "in this guide, we use ``Standard_D2s_v3 - 2 vcpus, 8GiB memory``"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:65
+msgid "For resource group, we can create a new group and assign it to all VMs."
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:67
+msgid ""
+"When each VM instance has been created the portal will allow you to "
+"download the public key (.pem) of each instance. Make sure you save this "
+"key in safe place and change its permissions to user read only, i.e., run"
+" the ``chmod 400 <PATH_TO_PEM_FILE>`` command for every .pem file."
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:72
+msgid ""
+"Once all three VMs are created then navigate to the overview page where "
+"all three VMs are listed and open every other VM, and copy its Public IP "
+"address. Using the Public IP address and the public key (after changing "
+"the permissions), login to the instances from our local machine by "
+"running the following command (by default Azure creates the "
+"``azureuser``):"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:83
+msgid "VM Networking"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:85
+msgid ""
+"During the execution of the Flower application, the server VM "
+"(``SuperLink``) will be responsible to orchestrate the execution of the "
+"application across the client VMs (``SuperNode``). When the SuperLink "
+"server starts, by default, it listens to the following ports: ``{9092, "
+"9093}``. Port `9092` is used to communicate with the Federation clients "
+"(``SuperNode``) and port ``9093`` to receive and execute Flower "
+"applications."
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:92
+msgid ""
+"Therefore, to enable this communication we need to allow inbound traffic "
+"to the server VM instance. To achieve this, we need to navigate to the "
+"Networking page of the server VM in the Microsoft Azure portal. There, we"
+" will click the ``Add inbound port rule``. In the new window that "
+"appears, we edit the rule properties as follows:"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:97
+msgid "The rest of the fields can be left at their default values."
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:104
+#: ../../source/how-to-run-flower-on-azure.rst:145
+#, fuzzy
+msgid "**Source**"
+msgstr "flower-superlink"
+
+#: ../../source/how-to-run-flower-on-azure.rst:105
+msgid "``IP Addresses``"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:106
+#: ../../source/how-to-run-flower-on-azure.rst:133
+msgid "**Source IP addresses/CIDR ranges**"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:107
+msgid "add client VMs' Public IP (separated by comma)"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:108
+#, fuzzy
+msgid "**Destination**"
+msgstr "Dépréciations"
+
+#: ../../source/how-to-run-flower-on-azure.rst:109
+#: ../../source/how-to-run-flower-on-azure.rst:146
+msgid "``Any``"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:110
+#, fuzzy
+msgid "**Service**"
+msgstr "flower-superlink"
+
+#: ../../source/how-to-run-flower-on-azure.rst:111
+msgid "``custom``"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:112
+#: ../../source/how-to-run-flower-on-azure.rst:135
+#: ../../source/how-to-run-flower-on-azure.rst:147
+msgid "**Destination port ranges**"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:113
+msgid "``9092``"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:114
+msgid "**Protocol**"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:115
+#, fuzzy
+msgid "``TCP``"
+msgstr "Configurer les clients"
+
+#: ../../source/how-to-run-flower-on-azure.rst:117
+msgid ""
+"Finally, we need to also open port 9093 to allow receiving and executing "
+"incoming application requests. To enable this we just need to repeat the "
+"steps above, i.e., create a new inbound rule, where for port range we "
+"assign port 9093. If we already know the Public IP from which our local "
+"machine (e.g., laptop) will be submitting applications to the Azure "
+"cluster, then we just need to specify the Source IP address/CIDR range. "
+"However, if we want to keep the port widely open we simply need to change"
+" source to ``Any``."
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:125
+msgid ""
+"To be more precise, if we know the Public IP of our machine, then we make"
+" the following changes:"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:134
+msgid "add machine's Public IP"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:136
+#: ../../source/how-to-run-flower-on-azure.rst:148
+msgid "``9093``"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:138
+msgid "Otherwise, we change the properties as follows:"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:151
+#, fuzzy
+msgid "Flower Environment"
+msgstr "Créer/Supprimer l'environment virtuel"
+
+#: ../../source/how-to-run-flower-on-azure.rst:153
+msgid ""
+"Assuming we have been able to login to each VM, and create a Python "
+"environment with Flower and all its dependencies installed (``pip install"
+" flwr``), we can create a Flower application by running the ``flwr new`` "
+"command. The console will then prompt us to give a name to the project, "
+"e.g., ``flwr_azure_test``, the name of the author and select the type of "
+"the Flower Framework we want to run, e.g., ``numpy``."
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:161
+msgid ""
+"An alternative approach would be to use Docker in each VM, with each "
+"image containing the necessary environment and dependencies. For more "
+"details please refer to the |flower_docker_index|_ guide."
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:166
+#, fuzzy
+msgid "Server Initialization"
+msgstr "Vérifie l'installation"
+
+#: ../../source/how-to-run-flower-on-azure.rst:168
+msgid ""
+"After configuring the Flower application environment, we proceed by "
+"starting the Flower long-running processes (i.e., ``SuperLink`` and "
+"``SuperNode``) at each VM instance. In particular, we need to run the "
+"following commands, first in the server (``SuperLink``) and then at each "
+"client (``SuperNode``)."
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:175
+msgid ""
+"To enable authentication and encrypted communication during the execution"
+" lifecycle of the Flower application, please have a look at the following"
+" resources: |authenticate_supernodes|_, |enable_tls_connections|_"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:197
+#, fuzzy
+msgid "Run Flower App"
+msgstr "Serveur de Flower"
+
+#: ../../source/how-to-run-flower-on-azure.rst:199
+msgid ""
+"Finally, after all running Flower processes have been initialized on the "
+"Microsoft Azure cluster, in our local machine, we first need to install "
+"Flower and can create a project with a similar structure as the one we "
+"have in the server and the clients, or copy the project structure from "
+"one of them. Once we have the project locally, we can open the "
+"``pyproject.toml`` file, and then add the following sections:"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:214
+msgid "Then from our local machine we need to run ``flwr run . my-federation``."
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:221
+msgid ""
+"This guide is not suitable for production environments due to missing "
+"authentication and TLS security."
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:224
+msgid ""
+"To enable authentication and establish secure connections, please refer "
+"to the following resources: |authenticate_supernodes|_, "
+"|enable_tls_connections|_"
+msgstr ""
+
 #: ../../source/how-to-run-simulations.rst:22
 #, fuzzy
 msgid "Run simulations"
@@ -8569,7 +8864,7 @@ msgstr "Quickstart tutorials"
 msgid "How-to guides"
 msgstr "Guides"
 
-#: ../../source/index.rst:107 ../../source/index.rst:112
+#: ../../source/index.rst:108 ../../source/index.rst:113
 msgid "Explanations"
 msgstr "Explications"
 
@@ -8577,26 +8872,26 @@ msgstr "Explications"
 msgid "API reference"
 msgstr "Référence pour l'API"
 
-#: ../../source/index.rst:138
+#: ../../source/index.rst:139
 msgid "Reference docs"
 msgstr "Référence pour la documentation"
 
-#: ../../source/index.rst:153
+#: ../../source/index.rst:154
 #, fuzzy
 msgid "Contributor tutorials"
 msgstr "Configuration du contributeur"
 
-#: ../../source/index.rst:160
+#: ../../source/index.rst:161
 #, fuzzy
 msgid "Contributor how-to guides"
 msgstr "Guide pour les contributeurs"
 
-#: ../../source/index.rst:172
+#: ../../source/index.rst:173
 #, fuzzy
 msgid "Contributor explanations"
 msgstr "Explications"
 
-#: ../../source/index.rst:178
+#: ../../source/index.rst:179
 #, fuzzy
 msgid "Contributor references"
 msgstr "Configuration du contributeur"
@@ -8706,7 +9001,7 @@ msgstr ""
 "Guides orientés sur la résolutions étapes par étapes de problèmes ou "
 "objectifs specifiques."
 
-#: ../../source/index.rst:109
+#: ../../source/index.rst:110
 msgid ""
 "Understanding-oriented concept guides explain and discuss key topics and "
 "underlying ideas behind Flower and collaborative AI."
@@ -8714,29 +9009,29 @@ msgstr ""
 "Guides orientés sur la compréhension et l'explication des sujets et idées"
 " de fonds sur lesquels sont construits Flower et l'IA collaborative."
 
-#: ../../source/index.rst:121
+#: ../../source/index.rst:122
 #, fuzzy
 msgid "References"
 msgstr "Référence"
 
-#: ../../source/index.rst:123
+#: ../../source/index.rst:124
 msgid "Information-oriented API reference and other reference material."
 msgstr "Référence de l'API orientée sur l'information pure."
 
-#: ../../source/index.rst:132:<autosummary>:1
+#: ../../source/index.rst:133:<autosummary>:1
 msgid ":py:obj:`flwr <flwr>`\\"
 msgstr ""
 
-#: ../../source/index.rst:132:<autosummary>:1 flwr:1 of
+#: ../../source/index.rst:133:<autosummary>:1 flwr:1 of
 msgid "Flower main package."
 msgstr ""
 
-#: ../../source/index.rst:148
+#: ../../source/index.rst:149
 #, fuzzy
 msgid "Contributor docs"
 msgstr "Configuration du contributeur"
 
-#: ../../source/index.rst:150
+#: ../../source/index.rst:151
 #, fuzzy
 msgid ""
 "The Flower community welcomes contributions. The following docs are "
@@ -8909,6 +9204,15 @@ msgstr ""
 msgid "Specific run ID to display"
 msgstr ""
 
+#: ../../flwr ls:1 run:1
+msgid "Format output using 'default' view or 'json'"
+msgstr ""
+
+#: ../../flwr ls:1 run:1
+#, fuzzy
+msgid "``'default'``"
+msgstr "Flux de travail"
+
 #: ../../flwr ls:1
 #, fuzzy
 msgid "Path of the Flower project"
@@ -28908,7 +29212,7 @@ msgstr ""
 "chose d'autre, comme la régression linéaire classique."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:41
-msgid "|80152fa658904be08c849b4a594b76e1|"
+msgid "|dbd9718fb89b4e219a54b72b6eecf502|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:109
@@ -28927,7 +29231,7 @@ msgstr ""
 " Go."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:53
-msgid "|35b60a1068f944ce937ac2988661aad5|"
+msgid "|18916394e69e4fdaafbb56f7bba690d3|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:111
@@ -28959,7 +29263,7 @@ msgstr ""
 "chanson."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:67
-msgid "|efead7f2c2224b60b7b42705004c15e6|"
+msgid "|20988fac7e2e497ea15f786730279299|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:113
@@ -28980,7 +29284,7 @@ msgstr ""
 " données pour la même tâche."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:79
-msgid "|5421fee4e7ed450c903cbcd8a9d8a5d4|"
+msgid "|5d612ca92b074af4a034bf4c0f498d2e|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:115
@@ -29002,7 +29306,7 @@ msgstr ""
 "cloud."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:91
-msgid "|811fcf35e9214bd5b4e613e41f7c0a27|"
+msgid "|6721ae86e3f348e2bce58d358a2ee79c|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:117
@@ -29023,7 +29327,7 @@ msgstr ""
 "appuyés."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:103
-msgid "|e61d38b0948f4c07a7257755f3799b54|"
+msgid "|d255f931abb44ca8a7eba0d90dfcf6a1|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:119
@@ -29049,7 +29353,7 @@ msgstr ""
 " sur un serveur centralisé."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:138
-msgid "|e82c29351e2e480087c61b939eb7c041|"
+msgid "|f98da3b55eca452390fb33429a7d7ebe|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:173
@@ -29068,7 +29372,7 @@ msgstr ""
 "suffisantes pour former un bon modèle."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:150
-msgid "|21ca40f4fb1a405c89098fd1d24880a4|"
+msgid "|10dc1f84d36b432e95d7f61fcd25a701|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:175
@@ -29299,7 +29603,7 @@ msgstr ""
 "partir d'un point de contrôle précédemment sauvegardé."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:210
-msgid "|1351a2629c2c46d981b13b19f9fa45f0|"
+msgid "|f963159664b54e40a64a7f1c19414349|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:307
@@ -29334,7 +29638,7 @@ msgstr ""
 "rendements décroissants."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:225
-msgid "|124c2c188b994c7ab1c862cfdb326923|"
+msgid "|3647c3b36916415ab40c1597a3ddd4b0|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:309
@@ -29367,7 +29671,7 @@ msgstr ""
 "données locales, ou même de quelques étapes (mini-batchs)."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:240
-msgid "|42e1951c36f2406e93c7ae0ec5b299f9|"
+msgid "|a3c07b2cf1214488a99267b3757d9426|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:311
@@ -29398,7 +29702,7 @@ msgstr ""
 " l'entraînement local."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:255
-msgid "|ec637b8a84234d068995ee1ccb2dd3b1|"
+msgid "|2f6bce3bfacf4c85ac3a7e0fd1d5aa84|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:313
@@ -29458,7 +29762,7 @@ msgstr ""
 "times as much as each of the 100 examples."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:273
-msgid "|5bceb9d16b1a4d2db18d8a5b2f0cacb3|"
+msgid "|19ebdce05cab40d791a2117f743290c3|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:315
@@ -29602,7 +29906,7 @@ msgstr ""
 "quel cadre de ML et n'importe quel langage de programmation."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:334
-msgid "|502b10044e864ca2b15282a393ab7faf|"
+msgid "|dd729f8776d640ffb136545f3f26210f|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:340
@@ -43007,3 +43311,45 @@ msgstr ""
 #~ msgid "|7bfcfcb57ae5403f8e18486f45ca48b4|"
 #~ msgstr ""
 
+#~ msgid "|80152fa658904be08c849b4a594b76e1|"
+#~ msgstr ""
+
+#~ msgid "|35b60a1068f944ce937ac2988661aad5|"
+#~ msgstr ""
+
+#~ msgid "|efead7f2c2224b60b7b42705004c15e6|"
+#~ msgstr ""
+
+#~ msgid "|5421fee4e7ed450c903cbcd8a9d8a5d4|"
+#~ msgstr ""
+
+#~ msgid "|811fcf35e9214bd5b4e613e41f7c0a27|"
+#~ msgstr ""
+
+#~ msgid "|e61d38b0948f4c07a7257755f3799b54|"
+#~ msgstr ""
+
+#~ msgid "|e82c29351e2e480087c61b939eb7c041|"
+#~ msgstr ""
+
+#~ msgid "|21ca40f4fb1a405c89098fd1d24880a4|"
+#~ msgstr ""
+
+#~ msgid "|1351a2629c2c46d981b13b19f9fa45f0|"
+#~ msgstr ""
+
+#~ msgid "|124c2c188b994c7ab1c862cfdb326923|"
+#~ msgstr ""
+
+#~ msgid "|42e1951c36f2406e93c7ae0ec5b299f9|"
+#~ msgstr ""
+
+#~ msgid "|ec637b8a84234d068995ee1ccb2dd3b1|"
+#~ msgstr ""
+
+#~ msgid "|5bceb9d16b1a4d2db18d8a5b2f0cacb3|"
+#~ msgstr ""
+
+#~ msgid "|502b10044e864ca2b15282a393ab7faf|"
+#~ msgstr ""
+
diff --git a/doc/locales/ko/LC_MESSAGES/framework-docs.po b/doc/locales/ko/LC_MESSAGES/framework-docs.po
index 810bc10e99b3..7004d0cb5856 100644
--- a/doc/locales/ko/LC_MESSAGES/framework-docs.po
+++ b/doc/locales/ko/LC_MESSAGES/framework-docs.po
@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Flower main\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-11-30 00:31+0000\n"
+"POT-Creation-Date: 2024-12-08 00:35+0000\n"
 "PO-Revision-Date: 2024-08-23 13:09+0000\n"
 "Last-Translator: Seulki Yun <icstuckyi@gmail.com>\n"
 "Language: ko\n"
@@ -6144,6 +6144,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/how-to-implement-fedbn.rst:99
+#: ../../source/how-to-run-flower-on-azure.rst:217
 msgid "Next Steps"
 msgstr "다음 단계"
 
@@ -6637,6 +6638,302 @@ msgstr ""
 "가상 클라이언트 엔진을 사용하는 시뮬레이션의 경우, ``flwr-nightly``를 ``simulation`` extr와 함께 "
 "설치해야 합니다::"
 
+#: ../../source/how-to-run-flower-on-azure.rst:18
+#, fuzzy
+msgid "Run Flower on Azure"
+msgstr "Flower 서버."
+
+#: ../../source/how-to-run-flower-on-azure.rst:22
+msgid ""
+"There are many ways to deploy Flower on Microst Azure. The instructions "
+"provided in this guide is just a basic walkthrough, step-by-step guide on"
+" how to quickly setup and run a Flower application on a Federated "
+"Learning environment on Microst Azure."
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:26
+msgid ""
+"In this how-to guide, we want to create a Federated Learning environment "
+"on Microst Azure using three Virtual Machines (VMs). From the three "
+"machines, one machine will be used as the Federation server and two as "
+"the Federation clients. Our goal is to create a Flower federation on "
+"Microst Azure where we can run Flower apps from our local machine, e.g., "
+"laptop."
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:32
+msgid ""
+"On the Federation server VM we will deploy the long-running Flower server"
+" (``SuperLink``) and on the two Federation client VMs we will deploy the "
+"long-running Flower client (``SuperNode``). For more details For more "
+"details regarding the ``SuperLink`` and ``SuperNode`` concepts, please "
+"see the |flower_architecture_link|_ ."
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:38
+msgid "Azure VMs"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:40
+msgid ""
+"First we need to create the three VMs configure their Python "
+"environments, and inbound networking rules to allow cross-VM "
+"communication."
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:44
+msgid "VM Create"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:46
+msgid ""
+"Assuming we are already inside the Microst Azure portal, we navigate to "
+"the ``Create`` page and we select ``Azure virtual machine``. In the new "
+"page, for each VM we edit the properties as follows:"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:55
+msgid "**Virtual machine name**"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:56
+msgid ""
+"for server machine we can use ``flower-server`` and for clients, "
+"``flower-client-1`` and ``flower-client-2``"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:58
+#, fuzzy
+msgid "**Image**"
+msgstr "**변경하기**"
+
+#: ../../source/how-to-run-flower-on-azure.rst:59
+msgid "in this guide, we use ``Ubuntu Server 24.04 - x64 Gen2 LTS``"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:60
+msgid "**Size**"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:61
+msgid "in this guide, we use ``Standard_D2s_v3 - 2 vcpus, 8GiB memory``"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:65
+msgid "For resource group, we can create a new group and assign it to all VMs."
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:67
+msgid ""
+"When each VM instance has been created the portal will allow you to "
+"download the public key (.pem) of each instance. Make sure you save this "
+"key in safe place and change its permissions to user read only, i.e., run"
+" the ``chmod 400 <PATH_TO_PEM_FILE>`` command for every .pem file."
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:72
+msgid ""
+"Once all three VMs are created then navigate to the overview page where "
+"all three VMs are listed and open every other VM, and copy its Public IP "
+"address. Using the Public IP address and the public key (after changing "
+"the permissions), login to the instances from our local machine by "
+"running the following command (by default Azure creates the "
+"``azureuser``):"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:83
+msgid "VM Networking"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:85
+msgid ""
+"During the execution of the Flower application, the server VM "
+"(``SuperLink``) will be responsible to orchestrate the execution of the "
+"application across the client VMs (``SuperNode``). When the SuperLink "
+"server starts, by default, it listens to the following ports: ``{9092, "
+"9093}``. Port `9092` is used to communicate with the Federation clients "
+"(``SuperNode``) and port ``9093`` to receive and execute Flower "
+"applications."
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:92
+msgid ""
+"Therefore, to enable this communication we need to allow inbound traffic "
+"to the server VM instance. To achieve this, we need to navigate to the "
+"Networking page of the server VM in the Microsoft Azure portal. There, we"
+" will click the ``Add inbound port rule``. In the new window that "
+"appears, we edit the rule properties as follows:"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:97
+msgid "The rest of the fields can be left at their default values."
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:104
+#: ../../source/how-to-run-flower-on-azure.rst:145
+#, fuzzy
+msgid "**Source**"
+msgstr "run\\_supernode"
+
+#: ../../source/how-to-run-flower-on-azure.rst:105
+msgid "``IP Addresses``"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:106
+#: ../../source/how-to-run-flower-on-azure.rst:133
+msgid "**Source IP addresses/CIDR ranges**"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:107
+msgid "add client VMs' Public IP (separated by comma)"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:108
+#, fuzzy
+msgid "**Destination**"
+msgstr "설명"
+
+#: ../../source/how-to-run-flower-on-azure.rst:109
+#: ../../source/how-to-run-flower-on-azure.rst:146
+#, fuzzy
+msgid "``Any``"
+msgstr "``flwr/base``"
+
+#: ../../source/how-to-run-flower-on-azure.rst:110
+#, fuzzy
+msgid "**Service**"
+msgstr "run\\_supernode"
+
+#: ../../source/how-to-run-flower-on-azure.rst:111
+#, fuzzy
+msgid "``custom``"
+msgstr "``DISTRO``"
+
+#: ../../source/how-to-run-flower-on-azure.rst:112
+#: ../../source/how-to-run-flower-on-azure.rst:135
+#: ../../source/how-to-run-flower-on-azure.rst:147
+msgid "**Destination port ranges**"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:113
+msgid "``9092``"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:114
+msgid "**Protocol**"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:115
+#, fuzzy
+msgid "``TCP``"
+msgstr "``DISTRO``"
+
+#: ../../source/how-to-run-flower-on-azure.rst:117
+msgid ""
+"Finally, we need to also open port 9093 to allow receiving and executing "
+"incoming application requests. To enable this we just need to repeat the "
+"steps above, i.e., create a new inbound rule, where for port range we "
+"assign port 9093. If we already know the Public IP from which our local "
+"machine (e.g., laptop) will be submitting applications to the Azure "
+"cluster, then we just need to specify the Source IP address/CIDR range. "
+"However, if we want to keep the port widely open we simply need to change"
+" source to ``Any``."
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:125
+msgid ""
+"To be more precise, if we know the Public IP of our machine, then we make"
+" the following changes:"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:134
+msgid "add machine's Public IP"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:136
+#: ../../source/how-to-run-flower-on-azure.rst:148
+msgid "``9093``"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:138
+msgid "Otherwise, we change the properties as follows:"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:151
+#, fuzzy
+msgid "Flower Environment"
+msgstr "Flower 개발 환경 만들기"
+
+#: ../../source/how-to-run-flower-on-azure.rst:153
+msgid ""
+"Assuming we have been able to login to each VM, and create a Python "
+"environment with Flower and all its dependencies installed (``pip install"
+" flwr``), we can create a Flower application by running the ``flwr new`` "
+"command. The console will then prompt us to give a name to the project, "
+"e.g., ``flwr_azure_test``, the name of the author and select the type of "
+"the Flower Framework we want to run, e.g., ``numpy``."
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:161
+msgid ""
+"An alternative approach would be to use Docker in each VM, with each "
+"image containing the necessary environment and dependencies. For more "
+"details please refer to the |flower_docker_index|_ guide."
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:166
+#, fuzzy
+msgid "Server Initialization"
+msgstr "설치 확인"
+
+#: ../../source/how-to-run-flower-on-azure.rst:168
+msgid ""
+"After configuring the Flower application environment, we proceed by "
+"starting the Flower long-running processes (i.e., ``SuperLink`` and "
+"``SuperNode``) at each VM instance. In particular, we need to run the "
+"following commands, first in the server (``SuperLink``) and then at each "
+"client (``SuperNode``)."
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:175
+msgid ""
+"To enable authentication and encrypted communication during the execution"
+" lifecycle of the Flower application, please have a look at the following"
+" resources: |authenticate_supernodes|_, |enable_tls_connections|_"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:197
+#, fuzzy
+msgid "Run Flower App"
+msgstr "Flower 서버."
+
+#: ../../source/how-to-run-flower-on-azure.rst:199
+msgid ""
+"Finally, after all running Flower processes have been initialized on the "
+"Microsoft Azure cluster, in our local machine, we first need to install "
+"Flower and can create a project with a similar structure as the one we "
+"have in the server and the clients, or copy the project structure from "
+"one of them. Once we have the project locally, we can open the "
+"``pyproject.toml`` file, and then add the following sections:"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:214
+msgid "Then from our local machine we need to run ``flwr run . my-federation``."
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:221
+msgid ""
+"This guide is not suitable for production environments due to missing "
+"authentication and TLS security."
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:224
+msgid ""
+"To enable authentication and establish secure connections, please refer "
+"to the following resources: |authenticate_supernodes|_, "
+"|enable_tls_connections|_"
+msgstr ""
+
 #: ../../source/how-to-run-simulations.rst:22
 msgid "Run simulations"
 msgstr "시뮬레이션 실행"
@@ -8496,7 +8793,7 @@ msgstr "빠른 시작 튜토리얼"
 msgid "How-to guides"
 msgstr "사용 방법 가이드"
 
-#: ../../source/index.rst:107 ../../source/index.rst:112
+#: ../../source/index.rst:108 ../../source/index.rst:113
 msgid "Explanations"
 msgstr "설명"
 
@@ -8504,23 +8801,23 @@ msgstr "설명"
 msgid "API reference"
 msgstr "API 참조"
 
-#: ../../source/index.rst:138
+#: ../../source/index.rst:139
 msgid "Reference docs"
 msgstr "참조 문서"
 
-#: ../../source/index.rst:153
+#: ../../source/index.rst:154
 msgid "Contributor tutorials"
 msgstr "기여자 튜토리얼"
 
-#: ../../source/index.rst:160
+#: ../../source/index.rst:161
 msgid "Contributor how-to guides"
 msgstr "기여자 사용법 가이드"
 
-#: ../../source/index.rst:172
+#: ../../source/index.rst:173
 msgid "Contributor explanations"
 msgstr "기여자 설명"
 
-#: ../../source/index.rst:178
+#: ../../source/index.rst:179
 msgid "Contributor references"
 msgstr "기여자 참조"
 
@@ -8617,33 +8914,33 @@ msgid ""
 "specific goal."
 msgstr "문제 중심의 방법 가이드는 특정 목표를 달성하는 방법을 단계별로 보여줍니다."
 
-#: ../../source/index.rst:109
+#: ../../source/index.rst:110
 msgid ""
 "Understanding-oriented concept guides explain and discuss key topics and "
 "underlying ideas behind Flower and collaborative AI."
 msgstr "이해 중심의 개념 가이드에서는 Flower와 협업 AI의 주요 주제와 기본 아이디어를 설명하고 토론합니다."
 
-#: ../../source/index.rst:121
+#: ../../source/index.rst:122
 msgid "References"
 msgstr "참조"
 
-#: ../../source/index.rst:123
+#: ../../source/index.rst:124
 msgid "Information-oriented API reference and other reference material."
 msgstr "정보 지향 API 참조 및 기타 참고 자료."
 
-#: ../../source/index.rst:132:<autosummary>:1
+#: ../../source/index.rst:133:<autosummary>:1
 msgid ":py:obj:`flwr <flwr>`\\"
 msgstr ":py:obj:`flwr <flwr>`\\"
 
-#: ../../source/index.rst:132:<autosummary>:1 flwr:1 of
+#: ../../source/index.rst:133:<autosummary>:1 flwr:1 of
 msgid "Flower main package."
 msgstr "Flower 메인 패키지."
 
-#: ../../source/index.rst:148
+#: ../../source/index.rst:149
 msgid "Contributor docs"
 msgstr "기여자 문서"
 
-#: ../../source/index.rst:150
+#: ../../source/index.rst:151
 msgid ""
 "The Flower community welcomes contributions. The following docs are "
 "intended to help along the way."
@@ -8812,6 +9109,15 @@ msgstr "``flwr/base``"
 msgid "Specific run ID to display"
 msgstr ""
 
+#: ../../flwr ls:1 run:1
+msgid "Format output using 'default' view or 'json'"
+msgstr ""
+
+#: ../../flwr ls:1 run:1
+#, fuzzy
+msgid "``'default'``"
+msgstr "``flwr/base``"
+
 #: ../../flwr ls:1
 #, fuzzy
 msgid "Path of the Flower project"
@@ -25988,7 +26294,7 @@ msgstr ""
 " 수도 있습니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:41
-msgid "|80152fa658904be08c849b4a594b76e1|"
+msgid "|dbd9718fb89b4e219a54b72b6eecf502|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:109
@@ -26005,7 +26311,7 @@ msgstr ""
 " 바둑과 같은 게임을 하는 것일 수 있습니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:53
-msgid "|35b60a1068f944ce937ac2988661aad5|"
+msgid "|18916394e69e4fdaafbb56f7bba690d3|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:111
@@ -26031,7 +26337,7 @@ msgstr ""
 "부르리는 것을 듣는 스마트 스피커에서 비롯됩니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:67
-msgid "|efead7f2c2224b60b7b42705004c15e6|"
+msgid "|20988fac7e2e497ea15f786730279299|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:113
@@ -26049,7 +26355,7 @@ msgstr ""
 "있습니다. 하지만 여러 조직이 모두 같은 작업을 위해 데이터를 생성하는 것일 수도 있습니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:79
-msgid "|5421fee4e7ed450c903cbcd8a9d8a5d4|"
+msgid "|5d612ca92b074af4a034bf4c0f498d2e|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:115
@@ -26068,7 +26374,7 @@ msgstr ""
 "서버는 데이터 센터 어딘가에 있을 수도 있고 클라우드 어딘가에 있을 수도 있습니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:91
-msgid "|811fcf35e9214bd5b4e613e41f7c0a27|"
+msgid "|6721ae86e3f348e2bce58d358a2ee79c|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:117
@@ -26085,7 +26391,7 @@ msgstr ""
 " 우리가 기본적으로 사용해 온 머신러닝 방법입니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:103
-msgid "|e61d38b0948f4c07a7257755f3799b54|"
+msgid "|d255f931abb44ca8a7eba0d90dfcf6a1|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:119
@@ -26108,7 +26414,7 @@ msgstr ""
 "트래픽을 분석하는 것이 있습니다. 이러한 사례에서 모든 데이터는 자연스럽게 중앙 서버에 존재합니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:138
-msgid "|e82c29351e2e480087c61b939eb7c041|"
+msgid "|f98da3b55eca452390fb33429a7d7ebe|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:173
@@ -26125,7 +26431,7 @@ msgstr ""
 "좋은 모델을 훈련하기에 충분하지 않을 수 있습니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:150
-msgid "|21ca40f4fb1a405c89098fd1d24880a4|"
+msgid "|10dc1f84d36b432e95d7f61fcd25a701|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:175
@@ -26304,7 +26610,7 @@ msgstr ""
 "체크포인트에서 모델 매개변수를 초기화합니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:210
-msgid "|1351a2629c2c46d981b13b19f9fa45f0|"
+msgid "|f963159664b54e40a64a7f1c19414349|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:307
@@ -26332,7 +26638,7 @@ msgstr ""
 "개의 연결 노드만 사용합니다. 그 이유는 점점 더 많은 클라이언트 노드를 선택하면 학습의 효율성이 감소하기 때문입니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:225
-msgid "|124c2c188b994c7ab1c862cfdb326923|"
+msgid "|3647c3b36916415ab40c1597a3ddd4b0|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:309
@@ -26359,7 +26665,7 @@ msgstr ""
 "데이터에서 한 단계 정도로 짧거나 몇 단계(mini-batches)에 불과할 수 있습니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:240
-msgid "|42e1951c36f2406e93c7ae0ec5b299f9|"
+msgid "|a3c07b2cf1214488a99267b3757d9426|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:311
@@ -26385,7 +26691,7 @@ msgstr ""
 "보냅니다. 보내는 모델 업데이트는 전체 모델 파라미터거나 로컬 교육 중에 누적된 그레디언트(gradient)일 수 있습니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:255
-msgid "|ec637b8a84234d068995ee1ccb2dd3b1|"
+msgid "|2f6bce3bfacf4c85ac3a7e0fd1d5aa84|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:313
@@ -26435,7 +26741,7 @@ msgstr ""
 "많은 영향을 미칩니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:273
-msgid "|5bceb9d16b1a4d2db18d8a5b2f0cacb3|"
+msgid "|19ebdce05cab40d791a2117f743290c3|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:315
@@ -26555,7 +26861,7 @@ msgstr ""
 "사용자는 모든 워크로드, 머신러닝 프레임워크 및 모든 프로그래밍 언어를 통합할 수 있습니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:334
-msgid "|502b10044e864ca2b15282a393ab7faf|"
+msgid "|dd729f8776d640ffb136545f3f26210f|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:340
@@ -33483,3 +33789,45 @@ msgstr ""
 #~ msgid "|7bfcfcb57ae5403f8e18486f45ca48b4|"
 #~ msgstr ""
 
+#~ msgid "|80152fa658904be08c849b4a594b76e1|"
+#~ msgstr ""
+
+#~ msgid "|35b60a1068f944ce937ac2988661aad5|"
+#~ msgstr ""
+
+#~ msgid "|efead7f2c2224b60b7b42705004c15e6|"
+#~ msgstr ""
+
+#~ msgid "|5421fee4e7ed450c903cbcd8a9d8a5d4|"
+#~ msgstr ""
+
+#~ msgid "|811fcf35e9214bd5b4e613e41f7c0a27|"
+#~ msgstr ""
+
+#~ msgid "|e61d38b0948f4c07a7257755f3799b54|"
+#~ msgstr ""
+
+#~ msgid "|e82c29351e2e480087c61b939eb7c041|"
+#~ msgstr ""
+
+#~ msgid "|21ca40f4fb1a405c89098fd1d24880a4|"
+#~ msgstr ""
+
+#~ msgid "|1351a2629c2c46d981b13b19f9fa45f0|"
+#~ msgstr ""
+
+#~ msgid "|124c2c188b994c7ab1c862cfdb326923|"
+#~ msgstr ""
+
+#~ msgid "|42e1951c36f2406e93c7ae0ec5b299f9|"
+#~ msgstr ""
+
+#~ msgid "|ec637b8a84234d068995ee1ccb2dd3b1|"
+#~ msgstr ""
+
+#~ msgid "|5bceb9d16b1a4d2db18d8a5b2f0cacb3|"
+#~ msgstr ""
+
+#~ msgid "|502b10044e864ca2b15282a393ab7faf|"
+#~ msgstr ""
+
diff --git a/doc/locales/pt_BR/LC_MESSAGES/framework-docs.po b/doc/locales/pt_BR/LC_MESSAGES/framework-docs.po
index 21eafd64d9a2..42db4541d4f7 100644
--- a/doc/locales/pt_BR/LC_MESSAGES/framework-docs.po
+++ b/doc/locales/pt_BR/LC_MESSAGES/framework-docs.po
@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Flower main\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-11-30 00:31+0000\n"
+"POT-Creation-Date: 2024-12-08 00:35+0000\n"
 "PO-Revision-Date: 2024-05-25 11:09+0000\n"
 "Last-Translator: Gustavo Bertoli <gubertoli@gmail.com>\n"
 "Language: pt_BR\n"
@@ -5638,6 +5638,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/how-to-implement-fedbn.rst:99
+#: ../../source/how-to-run-flower-on-azure.rst:217
 msgid "Next Steps"
 msgstr ""
 
@@ -6006,6 +6007,296 @@ msgid ""
 "should be installed with the ``simulation`` extra:"
 msgstr ""
 
+#: ../../source/how-to-run-flower-on-azure.rst:18
+msgid "Run Flower on Azure"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:22
+msgid ""
+"There are many ways to deploy Flower on Microst Azure. The instructions "
+"provided in this guide is just a basic walkthrough, step-by-step guide on"
+" how to quickly setup and run a Flower application on a Federated "
+"Learning environment on Microst Azure."
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:26
+msgid ""
+"In this how-to guide, we want to create a Federated Learning environment "
+"on Microst Azure using three Virtual Machines (VMs). From the three "
+"machines, one machine will be used as the Federation server and two as "
+"the Federation clients. Our goal is to create a Flower federation on "
+"Microst Azure where we can run Flower apps from our local machine, e.g., "
+"laptop."
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:32
+msgid ""
+"On the Federation server VM we will deploy the long-running Flower server"
+" (``SuperLink``) and on the two Federation client VMs we will deploy the "
+"long-running Flower client (``SuperNode``). For more details For more "
+"details regarding the ``SuperLink`` and ``SuperNode`` concepts, please "
+"see the |flower_architecture_link|_ ."
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:38
+msgid "Azure VMs"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:40
+msgid ""
+"First we need to create the three VMs configure their Python "
+"environments, and inbound networking rules to allow cross-VM "
+"communication."
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:44
+msgid "VM Create"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:46
+msgid ""
+"Assuming we are already inside the Microst Azure portal, we navigate to "
+"the ``Create`` page and we select ``Azure virtual machine``. In the new "
+"page, for each VM we edit the properties as follows:"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:55
+msgid "**Virtual machine name**"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:56
+msgid ""
+"for server machine we can use ``flower-server`` and for clients, "
+"``flower-client-1`` and ``flower-client-2``"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:58
+msgid "**Image**"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:59
+msgid "in this guide, we use ``Ubuntu Server 24.04 - x64 Gen2 LTS``"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:60
+msgid "**Size**"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:61
+msgid "in this guide, we use ``Standard_D2s_v3 - 2 vcpus, 8GiB memory``"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:65
+msgid "For resource group, we can create a new group and assign it to all VMs."
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:67
+msgid ""
+"When each VM instance has been created the portal will allow you to "
+"download the public key (.pem) of each instance. Make sure you save this "
+"key in safe place and change its permissions to user read only, i.e., run"
+" the ``chmod 400 <PATH_TO_PEM_FILE>`` command for every .pem file."
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:72
+msgid ""
+"Once all three VMs are created then navigate to the overview page where "
+"all three VMs are listed and open every other VM, and copy its Public IP "
+"address. Using the Public IP address and the public key (after changing "
+"the permissions), login to the instances from our local machine by "
+"running the following command (by default Azure creates the "
+"``azureuser``):"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:83
+msgid "VM Networking"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:85
+msgid ""
+"During the execution of the Flower application, the server VM "
+"(``SuperLink``) will be responsible to orchestrate the execution of the "
+"application across the client VMs (``SuperNode``). When the SuperLink "
+"server starts, by default, it listens to the following ports: ``{9092, "
+"9093}``. Port `9092` is used to communicate with the Federation clients "
+"(``SuperNode``) and port ``9093`` to receive and execute Flower "
+"applications."
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:92
+msgid ""
+"Therefore, to enable this communication we need to allow inbound traffic "
+"to the server VM instance. To achieve this, we need to navigate to the "
+"Networking page of the server VM in the Microsoft Azure portal. There, we"
+" will click the ``Add inbound port rule``. In the new window that "
+"appears, we edit the rule properties as follows:"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:97
+msgid "The rest of the fields can be left at their default values."
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:104
+#: ../../source/how-to-run-flower-on-azure.rst:145
+msgid "**Source**"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:105
+msgid "``IP Addresses``"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:106
+#: ../../source/how-to-run-flower-on-azure.rst:133
+msgid "**Source IP addresses/CIDR ranges**"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:107
+msgid "add client VMs' Public IP (separated by comma)"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:108
+#, fuzzy
+msgid "**Destination**"
+msgstr "Descrição"
+
+#: ../../source/how-to-run-flower-on-azure.rst:109
+#: ../../source/how-to-run-flower-on-azure.rst:146
+#, fuzzy
+msgid "``Any``"
+msgstr "``FLWR_VERSION``"
+
+#: ../../source/how-to-run-flower-on-azure.rst:110
+msgid "**Service**"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:111
+#, fuzzy
+msgid "``custom``"
+msgstr "``UBUNTU_VERSION``"
+
+#: ../../source/how-to-run-flower-on-azure.rst:112
+#: ../../source/how-to-run-flower-on-azure.rst:135
+#: ../../source/how-to-run-flower-on-azure.rst:147
+msgid "**Destination port ranges**"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:113
+msgid "``9092``"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:114
+msgid "**Protocol**"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:115
+msgid "``TCP``"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:117
+msgid ""
+"Finally, we need to also open port 9093 to allow receiving and executing "
+"incoming application requests. To enable this we just need to repeat the "
+"steps above, i.e., create a new inbound rule, where for port range we "
+"assign port 9093. If we already know the Public IP from which our local "
+"machine (e.g., laptop) will be submitting applications to the Azure "
+"cluster, then we just need to specify the Source IP address/CIDR range. "
+"However, if we want to keep the port widely open we simply need to change"
+" source to ``Any``."
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:125
+msgid ""
+"To be more precise, if we know the Public IP of our machine, then we make"
+" the following changes:"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:134
+msgid "add machine's Public IP"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:136
+#: ../../source/how-to-run-flower-on-azure.rst:148
+msgid "``9093``"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:138
+msgid "Otherwise, we change the properties as follows:"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:151
+#, fuzzy
+msgid "Flower Environment"
+msgstr "``FLWR_VERSION``"
+
+#: ../../source/how-to-run-flower-on-azure.rst:153
+msgid ""
+"Assuming we have been able to login to each VM, and create a Python "
+"environment with Flower and all its dependencies installed (``pip install"
+" flwr``), we can create a Flower application by running the ``flwr new`` "
+"command. The console will then prompt us to give a name to the project, "
+"e.g., ``flwr_azure_test``, the name of the author and select the type of "
+"the Flower Framework we want to run, e.g., ``numpy``."
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:161
+msgid ""
+"An alternative approach would be to use Docker in each VM, with each "
+"image containing the necessary environment and dependencies. For more "
+"details please refer to the |flower_docker_index|_ guide."
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:166
+msgid "Server Initialization"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:168
+msgid ""
+"After configuring the Flower application environment, we proceed by "
+"starting the Flower long-running processes (i.e., ``SuperLink`` and "
+"``SuperNode``) at each VM instance. In particular, we need to run the "
+"following commands, first in the server (``SuperLink``) and then at each "
+"client (``SuperNode``)."
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:175
+msgid ""
+"To enable authentication and encrypted communication during the execution"
+" lifecycle of the Flower application, please have a look at the following"
+" resources: |authenticate_supernodes|_, |enable_tls_connections|_"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:197
+#, fuzzy
+msgid "Run Flower App"
+msgstr "O nome do repositório da imagem base."
+
+#: ../../source/how-to-run-flower-on-azure.rst:199
+msgid ""
+"Finally, after all running Flower processes have been initialized on the "
+"Microsoft Azure cluster, in our local machine, we first need to install "
+"Flower and can create a project with a similar structure as the one we "
+"have in the server and the clients, or copy the project structure from "
+"one of them. Once we have the project locally, we can open the "
+"``pyproject.toml`` file, and then add the following sections:"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:214
+msgid "Then from our local machine we need to run ``flwr run . my-federation``."
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:221
+msgid ""
+"This guide is not suitable for production environments due to missing "
+"authentication and TLS security."
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:224
+msgid ""
+"To enable authentication and establish secure connections, please refer "
+"to the following resources: |authenticate_supernodes|_, "
+"|enable_tls_connections|_"
+msgstr ""
+
 #: ../../source/how-to-run-simulations.rst:22
 msgid "Run simulations"
 msgstr ""
@@ -7581,7 +7872,7 @@ msgstr ""
 msgid "How-to guides"
 msgstr ""
 
-#: ../../source/index.rst:107 ../../source/index.rst:112
+#: ../../source/index.rst:108 ../../source/index.rst:113
 msgid "Explanations"
 msgstr ""
 
@@ -7589,23 +7880,23 @@ msgstr ""
 msgid "API reference"
 msgstr ""
 
-#: ../../source/index.rst:138
+#: ../../source/index.rst:139
 msgid "Reference docs"
 msgstr ""
 
-#: ../../source/index.rst:153
+#: ../../source/index.rst:154
 msgid "Contributor tutorials"
 msgstr ""
 
-#: ../../source/index.rst:160
+#: ../../source/index.rst:161
 msgid "Contributor how-to guides"
 msgstr ""
 
-#: ../../source/index.rst:172
+#: ../../source/index.rst:173
 msgid "Contributor explanations"
 msgstr ""
 
-#: ../../source/index.rst:178
+#: ../../source/index.rst:179
 msgid "Contributor references"
 msgstr ""
 
@@ -7689,33 +7980,33 @@ msgid ""
 "specific goal."
 msgstr ""
 
-#: ../../source/index.rst:109
+#: ../../source/index.rst:110
 msgid ""
 "Understanding-oriented concept guides explain and discuss key topics and "
 "underlying ideas behind Flower and collaborative AI."
 msgstr ""
 
-#: ../../source/index.rst:121
+#: ../../source/index.rst:122
 msgid "References"
 msgstr ""
 
-#: ../../source/index.rst:123
+#: ../../source/index.rst:124
 msgid "Information-oriented API reference and other reference material."
 msgstr ""
 
-#: ../../source/index.rst:132:<autosummary>:1
+#: ../../source/index.rst:133:<autosummary>:1
 msgid ":py:obj:`flwr <flwr>`\\"
 msgstr ""
 
-#: ../../source/index.rst:132:<autosummary>:1 flwr:1 of
+#: ../../source/index.rst:133:<autosummary>:1 flwr:1 of
 msgid "Flower main package."
 msgstr ""
 
-#: ../../source/index.rst:148
+#: ../../source/index.rst:149
 msgid "Contributor docs"
 msgstr ""
 
-#: ../../source/index.rst:150
+#: ../../source/index.rst:151
 msgid ""
 "The Flower community welcomes contributions. The following docs are "
 "intended to help along the way."
@@ -7878,6 +8169,15 @@ msgstr "``FLWR_VERSION``"
 msgid "Specific run ID to display"
 msgstr ""
 
+#: ../../flwr ls:1 run:1
+msgid "Format output using 'default' view or 'json'"
+msgstr ""
+
+#: ../../flwr ls:1 run:1
+#, fuzzy
+msgid "``'default'``"
+msgstr "``FLWR_VERSION``"
+
 #: ../../flwr ls:1
 #, fuzzy
 msgid "Path of the Flower project"
@@ -24655,7 +24955,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:41
-msgid "|80152fa658904be08c849b4a594b76e1|"
+msgid "|dbd9718fb89b4e219a54b72b6eecf502|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:109
@@ -24670,7 +24970,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:53
-msgid "|35b60a1068f944ce937ac2988661aad5|"
+msgid "|18916394e69e4fdaafbb56f7bba690d3|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:111
@@ -24692,7 +24992,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:67
-msgid "|efead7f2c2224b60b7b42705004c15e6|"
+msgid "|20988fac7e2e497ea15f786730279299|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:113
@@ -24708,7 +25008,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:79
-msgid "|5421fee4e7ed450c903cbcd8a9d8a5d4|"
+msgid "|5d612ca92b074af4a034bf4c0f498d2e|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:115
@@ -24724,7 +25024,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:91
-msgid "|811fcf35e9214bd5b4e613e41f7c0a27|"
+msgid "|6721ae86e3f348e2bce58d358a2ee79c|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:117
@@ -24739,7 +25039,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:103
-msgid "|e61d38b0948f4c07a7257755f3799b54|"
+msgid "|d255f931abb44ca8a7eba0d90dfcf6a1|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:119
@@ -24759,7 +25059,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:138
-msgid "|e82c29351e2e480087c61b939eb7c041|"
+msgid "|f98da3b55eca452390fb33429a7d7ebe|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:173
@@ -24774,7 +25074,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:150
-msgid "|21ca40f4fb1a405c89098fd1d24880a4|"
+msgid "|10dc1f84d36b432e95d7f61fcd25a701|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:175
@@ -24914,7 +25214,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:210
-msgid "|1351a2629c2c46d981b13b19f9fa45f0|"
+msgid "|f963159664b54e40a64a7f1c19414349|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:307
@@ -24938,7 +25238,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:225
-msgid "|124c2c188b994c7ab1c862cfdb326923|"
+msgid "|3647c3b36916415ab40c1597a3ddd4b0|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:309
@@ -24962,7 +25262,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:240
-msgid "|42e1951c36f2406e93c7ae0ec5b299f9|"
+msgid "|a3c07b2cf1214488a99267b3757d9426|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:311
@@ -24985,7 +25285,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:255
-msgid "|ec637b8a84234d068995ee1ccb2dd3b1|"
+msgid "|2f6bce3bfacf4c85ac3a7e0fd1d5aa84|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:313
@@ -25023,7 +25323,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:273
-msgid "|5bceb9d16b1a4d2db18d8a5b2f0cacb3|"
+msgid "|19ebdce05cab40d791a2117f743290c3|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:315
@@ -25117,7 +25417,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:334
-msgid "|502b10044e864ca2b15282a393ab7faf|"
+msgid "|dd729f8776d640ffb136545f3f26210f|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:340
@@ -37501,3 +37801,45 @@ msgstr ""
 #~ msgid "|7bfcfcb57ae5403f8e18486f45ca48b4|"
 #~ msgstr ""
 
+#~ msgid "|80152fa658904be08c849b4a594b76e1|"
+#~ msgstr ""
+
+#~ msgid "|35b60a1068f944ce937ac2988661aad5|"
+#~ msgstr ""
+
+#~ msgid "|efead7f2c2224b60b7b42705004c15e6|"
+#~ msgstr ""
+
+#~ msgid "|5421fee4e7ed450c903cbcd8a9d8a5d4|"
+#~ msgstr ""
+
+#~ msgid "|811fcf35e9214bd5b4e613e41f7c0a27|"
+#~ msgstr ""
+
+#~ msgid "|e61d38b0948f4c07a7257755f3799b54|"
+#~ msgstr ""
+
+#~ msgid "|e82c29351e2e480087c61b939eb7c041|"
+#~ msgstr ""
+
+#~ msgid "|21ca40f4fb1a405c89098fd1d24880a4|"
+#~ msgstr ""
+
+#~ msgid "|1351a2629c2c46d981b13b19f9fa45f0|"
+#~ msgstr ""
+
+#~ msgid "|124c2c188b994c7ab1c862cfdb326923|"
+#~ msgstr ""
+
+#~ msgid "|42e1951c36f2406e93c7ae0ec5b299f9|"
+#~ msgstr ""
+
+#~ msgid "|ec637b8a84234d068995ee1ccb2dd3b1|"
+#~ msgstr ""
+
+#~ msgid "|5bceb9d16b1a4d2db18d8a5b2f0cacb3|"
+#~ msgstr ""
+
+#~ msgid "|502b10044e864ca2b15282a393ab7faf|"
+#~ msgstr ""
+
diff --git a/doc/locales/zh_Hans/LC_MESSAGES/framework-docs.po b/doc/locales/zh_Hans/LC_MESSAGES/framework-docs.po
index 3b56d02c7503..015360f1af83 100644
--- a/doc/locales/zh_Hans/LC_MESSAGES/framework-docs.po
+++ b/doc/locales/zh_Hans/LC_MESSAGES/framework-docs.po
@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Flower main\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-11-30 00:31+0000\n"
+"POT-Creation-Date: 2024-12-08 00:35+0000\n"
 "PO-Revision-Date: 2024-06-12 10:09+0000\n"
 "Last-Translator: Yan Gao <y.gaogy@gmail.com>\n"
 "Language: zh_Hans\n"
@@ -6152,6 +6152,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/how-to-implement-fedbn.rst:99
+#: ../../source/how-to-run-flower-on-azure.rst:217
 msgid "Next Steps"
 msgstr "下一步工作"
 
@@ -6621,6 +6622,303 @@ msgid ""
 "should be installed with the ``simulation`` extra:"
 msgstr "对于使用虚拟客户端引擎的模拟，`flwr-nightly`应与`simulation`一起安装："
 
+#: ../../source/how-to-run-flower-on-azure.rst:18
+#, fuzzy
+msgid "Run Flower on Azure"
+msgstr "Flower 服务器。"
+
+#: ../../source/how-to-run-flower-on-azure.rst:22
+msgid ""
+"There are many ways to deploy Flower on Microst Azure. The instructions "
+"provided in this guide is just a basic walkthrough, step-by-step guide on"
+" how to quickly setup and run a Flower application on a Federated "
+"Learning environment on Microst Azure."
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:26
+msgid ""
+"In this how-to guide, we want to create a Federated Learning environment "
+"on Microst Azure using three Virtual Machines (VMs). From the three "
+"machines, one machine will be used as the Federation server and two as "
+"the Federation clients. Our goal is to create a Flower federation on "
+"Microst Azure where we can run Flower apps from our local machine, e.g., "
+"laptop."
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:32
+msgid ""
+"On the Federation server VM we will deploy the long-running Flower server"
+" (``SuperLink``) and on the two Federation client VMs we will deploy the "
+"long-running Flower client (``SuperNode``). For more details For more "
+"details regarding the ``SuperLink`` and ``SuperNode`` concepts, please "
+"see the |flower_architecture_link|_ ."
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:38
+msgid "Azure VMs"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:40
+msgid ""
+"First we need to create the three VMs configure their Python "
+"environments, and inbound networking rules to allow cross-VM "
+"communication."
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:44
+msgid "VM Create"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:46
+msgid ""
+"Assuming we are already inside the Microst Azure portal, we navigate to "
+"the ``Create`` page and we select ``Azure virtual machine``. In the new "
+"page, for each VM we edit the properties as follows:"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:55
+msgid "**Virtual machine name**"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:56
+msgid ""
+"for server machine we can use ``flower-server`` and for clients, "
+"``flower-client-1`` and ``flower-client-2``"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:58
+#, fuzzy
+msgid "**Image**"
+msgstr "**进行修改**"
+
+#: ../../source/how-to-run-flower-on-azure.rst:59
+msgid "in this guide, we use ``Ubuntu Server 24.04 - x64 Gen2 LTS``"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:60
+#, fuzzy
+msgid "**Size**"
+msgstr "**success**"
+
+#: ../../source/how-to-run-flower-on-azure.rst:61
+msgid "in this guide, we use ``Standard_D2s_v3 - 2 vcpus, 8GiB memory``"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:65
+msgid "For resource group, we can create a new group and assign it to all VMs."
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:67
+msgid ""
+"When each VM instance has been created the portal will allow you to "
+"download the public key (.pem) of each instance. Make sure you save this "
+"key in safe place and change its permissions to user read only, i.e., run"
+" the ``chmod 400 <PATH_TO_PEM_FILE>`` command for every .pem file."
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:72
+msgid ""
+"Once all three VMs are created then navigate to the overview page where "
+"all three VMs are listed and open every other VM, and copy its Public IP "
+"address. Using the Public IP address and the public key (after changing "
+"the permissions), login to the instances from our local machine by "
+"running the following command (by default Azure creates the "
+"``azureuser``):"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:83
+msgid "VM Networking"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:85
+msgid ""
+"During the execution of the Flower application, the server VM "
+"(``SuperLink``) will be responsible to orchestrate the execution of the "
+"application across the client VMs (``SuperNode``). When the SuperLink "
+"server starts, by default, it listens to the following ports: ``{9092, "
+"9093}``. Port `9092` is used to communicate with the Federation clients "
+"(``SuperNode``) and port ``9093`` to receive and execute Flower "
+"applications."
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:92
+msgid ""
+"Therefore, to enable this communication we need to allow inbound traffic "
+"to the server VM instance. To achieve this, we need to navigate to the "
+"Networking page of the server VM in the Microsoft Azure portal. There, we"
+" will click the ``Add inbound port rule``. In the new window that "
+"appears, we edit the rule properties as follows:"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:97
+msgid "The rest of the fields can be left at their default values."
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:104
+#: ../../source/how-to-run-flower-on-azure.rst:145
+#, fuzzy
+msgid "**Source**"
+msgstr "**success**"
+
+#: ../../source/how-to-run-flower-on-azure.rst:105
+msgid "``IP Addresses``"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:106
+#: ../../source/how-to-run-flower-on-azure.rst:133
+msgid "**Source IP addresses/CIDR ranges**"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:107
+msgid "add client VMs' Public IP (separated by comma)"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:108
+#, fuzzy
+msgid "**Destination**"
+msgstr "停用"
+
+#: ../../source/how-to-run-flower-on-azure.rst:109
+#: ../../source/how-to-run-flower-on-azure.rst:146
+#, fuzzy
+msgid "``Any``"
+msgstr "``FLWR_VERSION``"
+
+#: ../../source/how-to-run-flower-on-azure.rst:110
+#, fuzzy
+msgid "**Service**"
+msgstr "flower-superlink"
+
+#: ../../source/how-to-run-flower-on-azure.rst:111
+#, fuzzy
+msgid "``custom``"
+msgstr "``UBUNTU_VERSION``"
+
+#: ../../source/how-to-run-flower-on-azure.rst:112
+#: ../../source/how-to-run-flower-on-azure.rst:135
+#: ../../source/how-to-run-flower-on-azure.rst:147
+msgid "**Destination port ranges**"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:113
+msgid "``9092``"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:114
+msgid "**Protocol**"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:115
+#, fuzzy
+msgid "``TCP``"
+msgstr "配置日志记录"
+
+#: ../../source/how-to-run-flower-on-azure.rst:117
+msgid ""
+"Finally, we need to also open port 9093 to allow receiving and executing "
+"incoming application requests. To enable this we just need to repeat the "
+"steps above, i.e., create a new inbound rule, where for port range we "
+"assign port 9093. If we already know the Public IP from which our local "
+"machine (e.g., laptop) will be submitting applications to the Azure "
+"cluster, then we just need to specify the Source IP address/CIDR range. "
+"However, if we want to keep the port widely open we simply need to change"
+" source to ``Any``."
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:125
+msgid ""
+"To be more precise, if we know the Public IP of our machine, then we make"
+" the following changes:"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:134
+msgid "add machine's Public IP"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:136
+#: ../../source/how-to-run-flower-on-azure.rst:148
+msgid "``9093``"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:138
+msgid "Otherwise, we change the properties as follows:"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:151
+#, fuzzy
+msgid "Flower Environment"
+msgstr "创建/删除虚拟环境"
+
+#: ../../source/how-to-run-flower-on-azure.rst:153
+msgid ""
+"Assuming we have been able to login to each VM, and create a Python "
+"environment with Flower and all its dependencies installed (``pip install"
+" flwr``), we can create a Flower application by running the ``flwr new`` "
+"command. The console will then prompt us to give a name to the project, "
+"e.g., ``flwr_azure_test``, the name of the author and select the type of "
+"the Flower Framework we want to run, e.g., ``numpy``."
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:161
+msgid ""
+"An alternative approach would be to use Docker in each VM, with each "
+"image containing the necessary environment and dependencies. For more "
+"details please refer to the |flower_docker_index|_ guide."
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:166
+#, fuzzy
+msgid "Server Initialization"
+msgstr "验证安装"
+
+#: ../../source/how-to-run-flower-on-azure.rst:168
+msgid ""
+"After configuring the Flower application environment, we proceed by "
+"starting the Flower long-running processes (i.e., ``SuperLink`` and "
+"``SuperNode``) at each VM instance. In particular, we need to run the "
+"following commands, first in the server (``SuperLink``) and then at each "
+"client (``SuperNode``)."
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:175
+msgid ""
+"To enable authentication and encrypted communication during the execution"
+" lifecycle of the Flower application, please have a look at the following"
+" resources: |authenticate_supernodes|_, |enable_tls_connections|_"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:197
+#, fuzzy
+msgid "Run Flower App"
+msgstr "Flower 服务器。"
+
+#: ../../source/how-to-run-flower-on-azure.rst:199
+msgid ""
+"Finally, after all running Flower processes have been initialized on the "
+"Microsoft Azure cluster, in our local machine, we first need to install "
+"Flower and can create a project with a similar structure as the one we "
+"have in the server and the clients, or copy the project structure from "
+"one of them. Once we have the project locally, we can open the "
+"``pyproject.toml`` file, and then add the following sections:"
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:214
+msgid "Then from our local machine we need to run ``flwr run . my-federation``."
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:221
+msgid ""
+"This guide is not suitable for production environments due to missing "
+"authentication and TLS security."
+msgstr ""
+
+#: ../../source/how-to-run-flower-on-azure.rst:224
+msgid ""
+"To enable authentication and establish secure connections, please refer "
+"to the following resources: |authenticate_supernodes|_, "
+"|enable_tls_connections|_"
+msgstr ""
+
 #: ../../source/how-to-run-simulations.rst:22
 msgid "Run simulations"
 msgstr "运行模拟"
@@ -8470,7 +8768,7 @@ msgstr "快速入门教程"
 msgid "How-to guides"
 msgstr "操作指南"
 
-#: ../../source/index.rst:107 ../../source/index.rst:112
+#: ../../source/index.rst:108 ../../source/index.rst:113
 msgid "Explanations"
 msgstr "说明"
 
@@ -8478,23 +8776,23 @@ msgstr "说明"
 msgid "API reference"
 msgstr "应用程序接口参考"
 
-#: ../../source/index.rst:138
+#: ../../source/index.rst:139
 msgid "Reference docs"
 msgstr "参考文档"
 
-#: ../../source/index.rst:153
+#: ../../source/index.rst:154
 msgid "Contributor tutorials"
 msgstr "贡献者教程"
 
-#: ../../source/index.rst:160
+#: ../../source/index.rst:161
 msgid "Contributor how-to guides"
 msgstr "投稿指南"
 
-#: ../../source/index.rst:172
+#: ../../source/index.rst:173
 msgid "Contributor explanations"
 msgstr "贡献者解释"
 
-#: ../../source/index.rst:178
+#: ../../source/index.rst:179
 msgid "Contributor references"
 msgstr "贡献者参考资料"
 
@@ -8591,35 +8889,35 @@ msgid ""
 "specific goal."
 msgstr "以问题为导向的 \"如何做 \"指南逐步展示如何实现特定目标。"
 
-#: ../../source/index.rst:109
+#: ../../source/index.rst:110
 msgid ""
 "Understanding-oriented concept guides explain and discuss key topics and "
 "underlying ideas behind Flower and collaborative AI."
 msgstr "以理解为导向的概念指南解释并讨论了Flower和协作式人工智能背后的关键主题和基本思想。"
 
-#: ../../source/index.rst:121
+#: ../../source/index.rst:122
 msgid "References"
 msgstr "参考资料"
 
-#: ../../source/index.rst:123
+#: ../../source/index.rst:124
 msgid "Information-oriented API reference and other reference material."
 msgstr "以信息为导向的 API 参考资料和其他参考资料。"
 
-#: ../../source/index.rst:132:<autosummary>:1
+#: ../../source/index.rst:133:<autosummary>:1
 #, fuzzy
 msgid ":py:obj:`flwr <flwr>`\\"
 msgstr ":py:obj:`flwr <flwr>`\\"
 
-#: ../../source/index.rst:132:<autosummary>:1 flwr:1 of
+#: ../../source/index.rst:133:<autosummary>:1 flwr:1 of
 #, fuzzy
 msgid "Flower main package."
 msgstr "Flower 主包装。"
 
-#: ../../source/index.rst:148
+#: ../../source/index.rst:149
 msgid "Contributor docs"
 msgstr "贡献者文档"
 
-#: ../../source/index.rst:150
+#: ../../source/index.rst:151
 msgid ""
 "The Flower community welcomes contributions. The following docs are "
 "intended to help along the way."
@@ -8789,6 +9087,15 @@ msgstr "``FLWR_VERSION``"
 msgid "Specific run ID to display"
 msgstr ""
 
+#: ../../flwr ls:1 run:1
+msgid "Format output using 'default' view or 'json'"
+msgstr ""
+
+#: ../../flwr ls:1 run:1
+#, fuzzy
+msgid "``'default'``"
+msgstr "工作流程"
+
 #: ../../flwr ls:1
 #, fuzzy
 msgid "Path of the Flower project"
@@ -29806,7 +30113,7 @@ msgid ""
 msgstr "在机器学习中，我们有一个模型和数据。模型可以是一个神经网络（如图所示），也可以是其他东西，比如经典的线性回归。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:41
-msgid "|80152fa658904be08c849b4a594b76e1|"
+msgid "|dbd9718fb89b4e219a54b72b6eecf502|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:109
@@ -29821,7 +30128,7 @@ msgid ""
 msgstr "我们使用数据来训练模型，以完成一项有用的任务。任务可以是检测图像中的物体、转录音频或玩围棋等游戏。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:53
-msgid "|35b60a1068f944ce937ac2988661aad5|"
+msgid "|18916394e69e4fdaafbb56f7bba690d3|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:111
@@ -29845,7 +30152,7 @@ msgid ""
 msgstr "它源于智能手机上用户与应用程序的交互、汽车上传感器数据的收集、笔记本电脑上键盘输入的接收，或者智能扬声器上某人试着唱的歌。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:67
-msgid "|efead7f2c2224b60b7b42705004c15e6|"
+msgid "|20988fac7e2e497ea15f786730279299|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:113
@@ -29863,7 +30170,7 @@ msgstr ""
 "\"通常不只是一个地方，而是很多地方。它可能是多个运行同一应用程序的设备。但也可能是多个组织，都在为同一任务生成数据。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:79
-msgid "|5421fee4e7ed450c903cbcd8a9d8a5d4|"
+msgid "|5d612ca92b074af4a034bf4c0f498d2e|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:115
@@ -29880,7 +30187,7 @@ msgid ""
 msgstr "因此，要使用机器学习或任何类型的数据分析，过去使用的方法是在中央服务器上收集所有数据。这个服务器可以在数据中心的某个地方，也可以在云端的某个地方。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:91
-msgid "|811fcf35e9214bd5b4e613e41f7c0a27|"
+msgid "|6721ae86e3f348e2bce58d358a2ee79c|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:117
@@ -29895,7 +30202,7 @@ msgid ""
 msgstr "一旦所有数据都收集到一处，我们最终就可以使用机器学习算法在数据上训练我们的模型。这就是我们基本上一直依赖的机器学习方法。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:103
-msgid "|e61d38b0948f4c07a7257755f3799b54|"
+msgid "|d255f931abb44ca8a7eba0d90dfcf6a1|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:119
@@ -29916,7 +30223,7 @@ msgid ""
 msgstr "我们刚刚看到的经典机器学习方法可以在某些情况下使用。很好的例子包括对假日照片进行分类或分析网络流量。在这些案例中，所有数据自然都可以在中央服务器上获得。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:138
-msgid "|e82c29351e2e480087c61b939eb7c041|"
+msgid "|f98da3b55eca452390fb33429a7d7ebe|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:173
@@ -29931,7 +30238,7 @@ msgid ""
 msgstr "但这种方法并不适用于许多其他情况。例如，集中服务器上没有数据，或者一台服务器上的数据不足以训练出一个好的模型。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:150
-msgid "|21ca40f4fb1a405c89098fd1d24880a4|"
+msgid "|10dc1f84d36b432e95d7f61fcd25a701|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:175
@@ -30091,7 +30398,7 @@ msgid ""
 msgstr "我们首先在服务器上初始化模型。这与经典的集中式学习完全相同：我们随机或从先前保存的检查点初始化模型参数。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:210
-msgid "|1351a2629c2c46d981b13b19f9fa45f0|"
+msgid "|f963159664b54e40a64a7f1c19414349|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:307
@@ -30116,7 +30423,7 @@ msgid ""
 msgstr "接下来，我们会将全局模型的参数发送到连接的客户端节点（如智能手机等边缘设备或企业的服务器）。这是为了确保每个参与节点都使用相同的模型参数开始本地训练。我们通常只使用几个连接节点，而不是所有节点。这样做的原因是，选择越来越多的客户端节点会导致收益递减。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:225
-msgid "|124c2c188b994c7ab1c862cfdb326923|"
+msgid "|3647c3b36916415ab40c1597a3ddd4b0|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:309
@@ -30142,7 +30449,7 @@ msgstr ""
 "（mini-batches）。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:240
-msgid "|42e1951c36f2406e93c7ae0ec5b299f9|"
+msgid "|a3c07b2cf1214488a99267b3757d9426|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:311
@@ -30165,7 +30472,7 @@ msgid ""
 msgstr "经过本地训练后，每个客户节点最初收到的模型参数都会略有不同。参数之所以不同，是因为每个客户端节点的本地数据集中都有不同的数据。然后，客户端节点将这些模型更新发回服务器。它们发送的模型更新既可以是完整的模型参数，也可以只是本地训练过程中积累的梯度。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:255
-msgid "|ec637b8a84234d068995ee1ccb2dd3b1|"
+msgid "|2f6bce3bfacf4c85ac3a7e0fd1d5aa84|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:313
@@ -30212,7 +30519,7 @@ msgstr ""
 " 100 个示例的 10 倍。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:273
-msgid "|5bceb9d16b1a4d2db18d8a5b2f0cacb3|"
+msgid "|19ebdce05cab40d791a2117f743290c3|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:315
@@ -30320,7 +30627,7 @@ msgstr ""
 "为联邦学习、分析和评估提供了一种统一的方法。它允许用户联邦化任何工作负载、任何 ML 框架和任何编程语言。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:334
-msgid "|502b10044e864ca2b15282a393ab7faf|"
+msgid "|dd729f8776d640ffb136545f3f26210f|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:340
@@ -37825,3 +38132,45 @@ msgstr ""
 #~ msgid "|7bfcfcb57ae5403f8e18486f45ca48b4|"
 #~ msgstr ""
 
+#~ msgid "|80152fa658904be08c849b4a594b76e1|"
+#~ msgstr ""
+
+#~ msgid "|35b60a1068f944ce937ac2988661aad5|"
+#~ msgstr ""
+
+#~ msgid "|efead7f2c2224b60b7b42705004c15e6|"
+#~ msgstr ""
+
+#~ msgid "|5421fee4e7ed450c903cbcd8a9d8a5d4|"
+#~ msgstr ""
+
+#~ msgid "|811fcf35e9214bd5b4e613e41f7c0a27|"
+#~ msgstr ""
+
+#~ msgid "|e61d38b0948f4c07a7257755f3799b54|"
+#~ msgstr ""
+
+#~ msgid "|e82c29351e2e480087c61b939eb7c041|"
+#~ msgstr ""
+
+#~ msgid "|21ca40f4fb1a405c89098fd1d24880a4|"
+#~ msgstr ""
+
+#~ msgid "|1351a2629c2c46d981b13b19f9fa45f0|"
+#~ msgstr ""
+
+#~ msgid "|124c2c188b994c7ab1c862cfdb326923|"
+#~ msgstr ""
+
+#~ msgid "|42e1951c36f2406e93c7ae0ec5b299f9|"
+#~ msgstr ""
+
+#~ msgid "|ec637b8a84234d068995ee1ccb2dd3b1|"
+#~ msgstr ""
+
+#~ msgid "|5bceb9d16b1a4d2db18d8a5b2f0cacb3|"
+#~ msgstr ""
+
+#~ msgid "|502b10044e864ca2b15282a393ab7faf|"
+#~ msgstr ""
+

From fc8591fce970c2a533deb0000427d24075797205 Mon Sep 17 00:00:00 2001
From: Chong Shen Ng <chong.shen@flower.ai>
Date: Sun, 8 Dec 2024 16:55:38 +0000
Subject: [PATCH 029/104] feat(framework) Introduce `flwr stop` CLI (#4642)

Co-authored-by: Chong Shen Ng <chong.shen@flower.ai>
Co-authored-by: jafermarq <javier@flower.ai>
---
 src/py/flwr/cli/app.py  |   2 +
 src/py/flwr/cli/stop.py | 121 ++++++++++++++++++++++++++++++++++++++++
 2 files changed, 123 insertions(+)
 create mode 100644 src/py/flwr/cli/stop.py

diff --git a/src/py/flwr/cli/app.py b/src/py/flwr/cli/app.py
index 35bd21ebd55e..553ac56fcaf2 100644
--- a/src/py/flwr/cli/app.py
+++ b/src/py/flwr/cli/app.py
@@ -23,6 +23,7 @@
 from .ls import ls
 from .new import new
 from .run import run
+from .stop import stop
 
 app = typer.Typer(
     help=typer.style(
@@ -39,6 +40,7 @@
 app.command()(install)
 app.command()(log)
 app.command()(ls)
+app.command()(stop)
 
 typer_click_object = get_command(app)
 
diff --git a/src/py/flwr/cli/stop.py b/src/py/flwr/cli/stop.py
new file mode 100644
index 000000000000..83c08fc86dc8
--- /dev/null
+++ b/src/py/flwr/cli/stop.py
@@ -0,0 +1,121 @@
+# Copyright 2024 Flower Labs GmbH. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# ==============================================================================
+"""Flower command line interface `stop` command."""
+
+
+from logging import DEBUG
+from pathlib import Path
+from typing import Annotated, Any, Optional
+
+import grpc
+import typer
+
+from flwr.cli.config_utils import (
+    load_and_validate,
+    validate_certificate_in_federation_config,
+    validate_federation_in_project_config,
+    validate_project_config,
+)
+from flwr.common.constant import FAB_CONFIG_FILE
+from flwr.common.grpc import GRPC_MAX_MESSAGE_LENGTH, create_channel
+from flwr.common.logger import log
+from flwr.proto.exec_pb2 import StopRunRequest, StopRunResponse  # pylint: disable=E0611
+from flwr.proto.exec_pb2_grpc import ExecStub
+
+
+def stop(
+    run_id: Annotated[  # pylint: disable=unused-argument
+        int,
+        typer.Argument(help="The Flower run ID to stop"),
+    ],
+    app: Annotated[
+        Path,
+        typer.Argument(help="Path of the Flower project"),
+    ] = Path("."),
+    federation: Annotated[
+        Optional[str],
+        typer.Argument(help="Name of the federation"),
+    ] = None,
+) -> None:
+    """Stop a run."""
+    # Load and validate federation config
+    typer.secho("Loading project configuration... ", fg=typer.colors.BLUE)
+
+    pyproject_path = app / FAB_CONFIG_FILE if app else None
+    config, errors, warnings = load_and_validate(path=pyproject_path)
+    config = validate_project_config(config, errors, warnings)
+    federation, federation_config = validate_federation_in_project_config(
+        federation, config
+    )
+
+    if "address" not in federation_config:
+        typer.secho(
+            "❌ `flwr stop` currently works with Exec API. Ensure that the correct"
+            "Exec API address is provided in the `pyproject.toml`.",
+            fg=typer.colors.RED,
+            bold=True,
+        )
+        raise typer.Exit(code=1)
+
+    try:
+        channel = _init_channel(app, federation_config)
+        stub = ExecStub(channel)  # pylint: disable=unused-variable # noqa: F841
+
+        typer.secho(f"✋ Stopping run ID {run_id}...", fg=typer.colors.GREEN)
+        _stop_run(stub, run_id=run_id)
+
+    except ValueError as err:
+        typer.secho(
+            f"❌ {err}",
+            fg=typer.colors.RED,
+            bold=True,
+        )
+        raise typer.Exit(code=1) from err
+    finally:
+        channel.close()
+
+
+def on_channel_state_change(channel_connectivity: str) -> None:
+    """Log channel connectivity."""
+    log(DEBUG, channel_connectivity)
+
+
+def _init_channel(app: Path, federation_config: dict[str, Any]) -> grpc.Channel:
+    """Initialize gRPC channel to the Exec API."""
+    insecure, root_certificates_bytes = validate_certificate_in_federation_config(
+        app, federation_config
+    )
+    channel = create_channel(
+        server_address=federation_config["address"],
+        insecure=insecure,
+        root_certificates=root_certificates_bytes,
+        max_message_length=GRPC_MAX_MESSAGE_LENGTH,
+        interceptors=None,
+    )
+    channel.subscribe(on_channel_state_change)
+    return channel
+
+
+def _stop_run(
+    stub: ExecStub,  # pylint: disable=unused-argument
+    run_id: int,  # pylint: disable=unused-argument
+) -> None:
+    """Stop a run."""
+    response: StopRunResponse = stub.StopRun(request=StopRunRequest(run_id=run_id))
+
+    if response.success:
+        typer.secho(f"✅ Run {run_id} successfully stopped.", fg=typer.colors.GREEN)
+    else:
+        typer.secho(f"❌ Run {run_id} couldn't be stopped.", fg=typer.colors.RED)

From 396a68cb94f43ac0427af59e22dc61a2538746ab Mon Sep 17 00:00:00 2001
From: Javier <jafermarq@users.noreply.github.com>
Date: Mon, 9 Dec 2024 12:58:12 +0000
Subject: [PATCH 030/104] feat(framework) Add `GetRunStatus` message to
 `SimulationIo` (#4647)

---
 src/proto/flwr/proto/simulationio.proto       |  3 ++
 src/py/flwr/proto/simulationio_pb2.py         |  4 +--
 src/py/flwr/proto/simulationio_pb2_grpc.py    | 34 +++++++++++++++++++
 src/py/flwr/proto/simulationio_pb2_grpc.pyi   | 13 +++++++
 .../simulation/simulationio_servicer.py       | 19 +++++++++++
 5 files changed, 71 insertions(+), 2 deletions(-)

diff --git a/src/proto/flwr/proto/simulationio.proto b/src/proto/flwr/proto/simulationio.proto
index 9597e33cc65f..a66f838dab47 100644
--- a/src/proto/flwr/proto/simulationio.proto
+++ b/src/proto/flwr/proto/simulationio.proto
@@ -41,6 +41,9 @@ service SimulationIo {
   // Get Federation Options
   rpc GetFederationOptions(GetFederationOptionsRequest)
       returns (GetFederationOptionsResponse) {}
+
+  // Get Run Status
+  rpc GetRunStatus(GetRunStatusRequest) returns (GetRunStatusResponse) {}
 }
 
 // PullSimulationInputs messages
diff --git a/src/py/flwr/proto/simulationio_pb2.py b/src/py/flwr/proto/simulationio_pb2.py
index c7392471f58d..03d96ecaf597 100644
--- a/src/py/flwr/proto/simulationio_pb2.py
+++ b/src/py/flwr/proto/simulationio_pb2.py
@@ -18,7 +18,7 @@
 from flwr.proto import fab_pb2 as flwr_dot_proto_dot_fab__pb2
 
 
-DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x1d\x66lwr/proto/simulationio.proto\x12\nflwr.proto\x1a\x14\x66lwr/proto/log.proto\x1a\x18\x66lwr/proto/message.proto\x1a\x14\x66lwr/proto/run.proto\x1a\x14\x66lwr/proto/fab.proto\"\x1d\n\x1bPullSimulationInputsRequest\"\x80\x01\n\x1cPullSimulationInputsResponse\x12$\n\x07\x63ontext\x18\x01 \x01(\x0b\x32\x13.flwr.proto.Context\x12\x1c\n\x03run\x18\x02 \x01(\x0b\x32\x0f.flwr.proto.Run\x12\x1c\n\x03\x66\x61\x62\x18\x03 \x01(\x0b\x32\x0f.flwr.proto.Fab\"T\n\x1cPushSimulationOutputsRequest\x12\x0e\n\x06run_id\x18\x01 \x01(\x04\x12$\n\x07\x63ontext\x18\x02 \x01(\x0b\x32\x13.flwr.proto.Context\"\x1f\n\x1dPushSimulationOutputsResponse2\xff\x03\n\x0cSimulationIo\x12k\n\x14PullSimulationInputs\x12\'.flwr.proto.PullSimulationInputsRequest\x1a(.flwr.proto.PullSimulationInputsResponse\"\x00\x12n\n\x15PushSimulationOutputs\x12(.flwr.proto.PushSimulationOutputsRequest\x1a).flwr.proto.PushSimulationOutputsResponse\"\x00\x12\\\n\x0fUpdateRunStatus\x12\".flwr.proto.UpdateRunStatusRequest\x1a#.flwr.proto.UpdateRunStatusResponse\"\x00\x12G\n\x08PushLogs\x12\x1b.flwr.proto.PushLogsRequest\x1a\x1c.flwr.proto.PushLogsResponse\"\x00\x12k\n\x14GetFederationOptions\x12\'.flwr.proto.GetFederationOptionsRequest\x1a(.flwr.proto.GetFederationOptionsResponse\"\x00\x62\x06proto3')
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x1d\x66lwr/proto/simulationio.proto\x12\nflwr.proto\x1a\x14\x66lwr/proto/log.proto\x1a\x18\x66lwr/proto/message.proto\x1a\x14\x66lwr/proto/run.proto\x1a\x14\x66lwr/proto/fab.proto\"\x1d\n\x1bPullSimulationInputsRequest\"\x80\x01\n\x1cPullSimulationInputsResponse\x12$\n\x07\x63ontext\x18\x01 \x01(\x0b\x32\x13.flwr.proto.Context\x12\x1c\n\x03run\x18\x02 \x01(\x0b\x32\x0f.flwr.proto.Run\x12\x1c\n\x03\x66\x61\x62\x18\x03 \x01(\x0b\x32\x0f.flwr.proto.Fab\"T\n\x1cPushSimulationOutputsRequest\x12\x0e\n\x06run_id\x18\x01 \x01(\x04\x12$\n\x07\x63ontext\x18\x02 \x01(\x0b\x32\x13.flwr.proto.Context\"\x1f\n\x1dPushSimulationOutputsResponse2\xd4\x04\n\x0cSimulationIo\x12k\n\x14PullSimulationInputs\x12\'.flwr.proto.PullSimulationInputsRequest\x1a(.flwr.proto.PullSimulationInputsResponse\"\x00\x12n\n\x15PushSimulationOutputs\x12(.flwr.proto.PushSimulationOutputsRequest\x1a).flwr.proto.PushSimulationOutputsResponse\"\x00\x12\\\n\x0fUpdateRunStatus\x12\".flwr.proto.UpdateRunStatusRequest\x1a#.flwr.proto.UpdateRunStatusResponse\"\x00\x12G\n\x08PushLogs\x12\x1b.flwr.proto.PushLogsRequest\x1a\x1c.flwr.proto.PushLogsResponse\"\x00\x12k\n\x14GetFederationOptions\x12\'.flwr.proto.GetFederationOptionsRequest\x1a(.flwr.proto.GetFederationOptionsResponse\"\x00\x12S\n\x0cGetRunStatus\x12\x1f.flwr.proto.GetRunStatusRequest\x1a .flwr.proto.GetRunStatusResponse\"\x00\x62\x06proto3')
 
 _globals = globals()
 _builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
@@ -34,5 +34,5 @@
   _globals['_PUSHSIMULATIONOUTPUTSRESPONSE']._serialized_start=385
   _globals['_PUSHSIMULATIONOUTPUTSRESPONSE']._serialized_end=416
   _globals['_SIMULATIONIO']._serialized_start=419
-  _globals['_SIMULATIONIO']._serialized_end=930
+  _globals['_SIMULATIONIO']._serialized_end=1015
 # @@protoc_insertion_point(module_scope)
diff --git a/src/py/flwr/proto/simulationio_pb2_grpc.py b/src/py/flwr/proto/simulationio_pb2_grpc.py
index b36110253ba2..f771bd818bf5 100644
--- a/src/py/flwr/proto/simulationio_pb2_grpc.py
+++ b/src/py/flwr/proto/simulationio_pb2_grpc.py
@@ -41,6 +41,11 @@ def __init__(self, channel):
                 request_serializer=flwr_dot_proto_dot_run__pb2.GetFederationOptionsRequest.SerializeToString,
                 response_deserializer=flwr_dot_proto_dot_run__pb2.GetFederationOptionsResponse.FromString,
                 )
+        self.GetRunStatus = channel.unary_unary(
+                '/flwr.proto.SimulationIo/GetRunStatus',
+                request_serializer=flwr_dot_proto_dot_run__pb2.GetRunStatusRequest.SerializeToString,
+                response_deserializer=flwr_dot_proto_dot_run__pb2.GetRunStatusResponse.FromString,
+                )
 
 
 class SimulationIoServicer(object):
@@ -81,6 +86,13 @@ def GetFederationOptions(self, request, context):
         context.set_details('Method not implemented!')
         raise NotImplementedError('Method not implemented!')
 
+    def GetRunStatus(self, request, context):
+        """Get Run Status
+        """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details('Method not implemented!')
+        raise NotImplementedError('Method not implemented!')
+
 
 def add_SimulationIoServicer_to_server(servicer, server):
     rpc_method_handlers = {
@@ -109,6 +121,11 @@ def add_SimulationIoServicer_to_server(servicer, server):
                     request_deserializer=flwr_dot_proto_dot_run__pb2.GetFederationOptionsRequest.FromString,
                     response_serializer=flwr_dot_proto_dot_run__pb2.GetFederationOptionsResponse.SerializeToString,
             ),
+            'GetRunStatus': grpc.unary_unary_rpc_method_handler(
+                    servicer.GetRunStatus,
+                    request_deserializer=flwr_dot_proto_dot_run__pb2.GetRunStatusRequest.FromString,
+                    response_serializer=flwr_dot_proto_dot_run__pb2.GetRunStatusResponse.SerializeToString,
+            ),
     }
     generic_handler = grpc.method_handlers_generic_handler(
             'flwr.proto.SimulationIo', rpc_method_handlers)
@@ -203,3 +220,20 @@ def GetFederationOptions(request,
             flwr_dot_proto_dot_run__pb2.GetFederationOptionsResponse.FromString,
             options, channel_credentials,
             insecure, call_credentials, compression, wait_for_ready, timeout, metadata)
+
+    @staticmethod
+    def GetRunStatus(request,
+            target,
+            options=(),
+            channel_credentials=None,
+            call_credentials=None,
+            insecure=False,
+            compression=None,
+            wait_for_ready=None,
+            timeout=None,
+            metadata=None):
+        return grpc.experimental.unary_unary(request, target, '/flwr.proto.SimulationIo/GetRunStatus',
+            flwr_dot_proto_dot_run__pb2.GetRunStatusRequest.SerializeToString,
+            flwr_dot_proto_dot_run__pb2.GetRunStatusResponse.FromString,
+            options, channel_credentials,
+            insecure, call_credentials, compression, wait_for_ready, timeout, metadata)
diff --git a/src/py/flwr/proto/simulationio_pb2_grpc.pyi b/src/py/flwr/proto/simulationio_pb2_grpc.pyi
index aa78010b047f..c3378b32d4c5 100644
--- a/src/py/flwr/proto/simulationio_pb2_grpc.pyi
+++ b/src/py/flwr/proto/simulationio_pb2_grpc.pyi
@@ -35,6 +35,11 @@ class SimulationIoStub:
         flwr.proto.run_pb2.GetFederationOptionsResponse]
     """Get Federation Options"""
 
+    GetRunStatus: grpc.UnaryUnaryMultiCallable[
+        flwr.proto.run_pb2.GetRunStatusRequest,
+        flwr.proto.run_pb2.GetRunStatusResponse]
+    """Get Run Status"""
+
 
 class SimulationIoServicer(metaclass=abc.ABCMeta):
     @abc.abstractmethod
@@ -77,5 +82,13 @@ class SimulationIoServicer(metaclass=abc.ABCMeta):
         """Get Federation Options"""
         pass
 
+    @abc.abstractmethod
+    def GetRunStatus(self,
+        request: flwr.proto.run_pb2.GetRunStatusRequest,
+        context: grpc.ServicerContext,
+    ) -> flwr.proto.run_pb2.GetRunStatusResponse:
+        """Get Run Status"""
+        pass
+
 
 def add_SimulationIoServicer_to_server(servicer: SimulationIoServicer, server: grpc.Server) -> None: ...
diff --git a/src/py/flwr/server/superlink/simulation/simulationio_servicer.py b/src/py/flwr/server/superlink/simulation/simulationio_servicer.py
index f1bbf3be1fab..cf3fee545d0a 100644
--- a/src/py/flwr/server/superlink/simulation/simulationio_servicer.py
+++ b/src/py/flwr/server/superlink/simulation/simulationio_servicer.py
@@ -28,6 +28,7 @@
     context_to_proto,
     fab_to_proto,
     run_status_from_proto,
+    run_status_to_proto,
     run_to_proto,
 )
 from flwr.common.typing import Fab, RunStatus
@@ -39,6 +40,8 @@
 from flwr.proto.run_pb2 import (  # pylint: disable=E0611
     GetFederationOptionsRequest,
     GetFederationOptionsResponse,
+    GetRunStatusRequest,
+    GetRunStatusResponse,
     UpdateRunStatusRequest,
     UpdateRunStatusResponse,
 )
@@ -122,6 +125,22 @@ def UpdateRunStatus(
         )
         return UpdateRunStatusResponse()
 
+    def GetRunStatus(
+        self, request: GetRunStatusRequest, context: ServicerContext
+    ) -> GetRunStatusResponse:
+        """Get status of requested runs."""
+        log(DEBUG, "SimultionIoServicer.GetRunStatus")
+        state = self.state_factory.state()
+
+        statuses = state.get_run_status(set(request.run_ids))
+
+        return GetRunStatusResponse(
+            run_status_dict={
+                run_id: run_status_to_proto(status)
+                for run_id, status in statuses.items()
+            }
+        )
+
     def PushLogs(
         self, request: PushLogsRequest, context: grpc.ServicerContext
     ) -> PushLogsResponse:

From 069c186584b1648cc0b7df2d9cd225fdc13d9df1 Mon Sep 17 00:00:00 2001
From: Charles Beauville <charles@flower.ai>
Date: Mon, 9 Dec 2024 05:10:10 -0800
Subject: [PATCH 031/104] docs(framework) Move framework docs to
 `framework/docs` (#4655)

Co-authored-by: Daniel J. Beutel <daniel@flower.ai>
---
 .github/workflows/docs.yml                          |   2 +-
 .github/workflows/update_translations.yml           |   4 ++--
 .gitignore                                          |   6 +++---
 dev/build-docs.sh                                   |   2 +-
 dev/format.sh                                       |   8 ++++----
 dev/get-latest-changelog.sh                         |   2 +-
 dev/rm-caches.sh                                    |   2 +-
 dev/test.sh                                         |   4 ++--
 {doc => framework/docs}/Makefile                    |   0
 {doc => framework/docs}/build-versioned-docs.sh     |   0
 .../docs}/locales/fr/LC_MESSAGES/framework-docs.po  |   0
 .../docs}/locales/fr/LC_MESSAGES/sphinx.po          |   0
 .../docs}/locales/ko/LC_MESSAGES/framework-docs.po  |   0
 .../docs}/locales/ko/LC_MESSAGES/sphinx.po          |   0
 .../locales/pt_BR/LC_MESSAGES/framework-docs.po     |   0
 .../docs}/locales/pt_BR/LC_MESSAGES/sphinx.po       |   0
 .../locales/zh_Hans/LC_MESSAGES/framework-docs.po   |   0
 .../docs}/locales/zh_Hans/LC_MESSAGES/sphinx.po     |   0
 {doc => framework/docs}/make.bat                    |   0
 {doc => framework/docs}/source/.gitignore           |   0
 {doc => framework/docs}/source/_static/DP/CDP.png   | Bin
 {doc => framework/docs}/source/_static/DP/LDP.png   | Bin
 .../docs}/source/_static/DP/clientsideCDP.png       | Bin
 .../docs}/source/_static/DP/clipping.png            | Bin
 .../docs}/source/_static/DP/dp-intro.png            | Bin
 .../docs}/source/_static/DP/localdp.png             | Bin
 .../docs}/source/_static/DP/serversideCDP.png       | Bin
 .../docs}/source/_static/changes_requested.png      | Bin
 .../docs}/source/_static/cloning_fork.png           | Bin
 .../docs}/source/_static/cloning_repo.png           | Bin
 .../docs}/source/_static/compare_and_pr.png         | Bin
 .../docs}/source/_static/creating_pr.png            | Bin
 {doc => framework/docs}/source/_static/custom.css   |   0
 {doc => framework/docs}/source/_static/draft_pr.png | Bin
 {doc => framework/docs}/source/_static/favicon.ico  | Bin
 .../docs}/source/_static/flower-actors.drawio.png   | Bin
 .../flower-architecture-basic-architecture.svg      |   0
 .../_static/flower-architecture-hub-and-spoke.svg   |   0
 .../_static/flower-architecture-multi-run-1.svg     |   0
 .../_static/flower-architecture-multi-run-2.svg     |   0
 .../_static/flower-architecture-multi-run.svg       |   0
 .../docs}/source/_static/flower-logo.png            | Bin
 .../docs}/source/_static/fork_button.png            | Bin
 .../docs}/source/_static/fork_link.png              | Bin
 .../docs}/source/_static/forking-repo.png           | Bin
 .../docs}/source/_static/github_schema.png          | Bin
 .../docs}/source/_static/make_changes.png           | Bin
 .../docs}/source/_static/merging_branch.png         | Bin
 .../docs}/source/_static/merging_pr.png             | Bin
 .../docs}/source/_static/opened_pr.png              | Bin
 .../docs}/source/_static/opening-pr.png             | Bin
 .../docs}/source/_static/resolve_conv.png           | Bin
 .../_static/tutorial/central-model-training.png     | Bin
 .../_static/tutorial/centralized-impossible.png     | Bin
 .../_static/tutorial/centralized-possible.png       | Bin
 .../docs}/source/_static/tutorial/collect-data.png  | Bin
 .../docs}/source/_static/tutorial/data-on-phone.png | Bin
 .../_static/tutorial/fl-aggregate-model-updates.png | Bin
 .../_static/tutorial/fl-initialize-global-model.png | Bin
 .../source/_static/tutorial/fl-local-training.png   | Bin
 .../_static/tutorial/fl-send-global-model.png       | Bin
 .../_static/tutorial/fl-send-model-updates.png      | Bin
 .../docs}/source/_static/tutorial/flower-any.jpeg   | Bin
 .../_static/tutorial/many-devices-with-data.png     | Bin
 .../source/_static/tutorial/model-and-data.png      | Bin
 .../docs}/source/_static/tutorial/train-model.png   | Bin
 .../docs}/source/_static/upstream_link.png          | Bin
 .../docs}/source/_static/weblate_interface.png      | Bin
 .../docs}/source/_static/weblate_status.png         | Bin
 .../docs}/source/_templates/autosummary/base.rst    |   0
 .../docs}/source/_templates/autosummary/class.rst   |   0
 .../docs}/source/_templates/autosummary/module.rst  |   0
 {doc => framework/docs}/source/_templates/base.html |   0
 .../docs}/source/_templates/sidebar/brand.html      |   0
 .../docs}/source/_templates/sidebar/lang.html       |   0
 .../docs}/source/_templates/sidebar/search.html     |   0
 .../docs}/source/_templates/sidebar/versioning.html |   0
 {doc => framework/docs}/source/conf.py              |   0
 ...tributor-explanation-public-and-private-apis.rst |   0
 .../contributor-how-to-build-docker-images.rst      |   0
 .../contributor-how-to-contribute-translations.rst  |   0
 ...utor-how-to-develop-in-vscode-dev-containers.rst |   0
 ...tributor-how-to-install-development-versions.rst |   0
 .../source/contributor-how-to-release-flower.rst    |   0
 .../contributor-how-to-set-up-a-virtual-env.rst     |   0
 .../contributor-how-to-write-documentation.rst      |   0
 .../contributor-ref-good-first-contributions.rst    |   0
 ...contributor-ref-secure-aggregation-protocols.rst |   0
 .../contributor-tutorial-contribute-on-github.rst   |   0
 ...ibutor-tutorial-get-started-as-a-contributor.rst |   0
 .../docs}/source/docker/enable-tls.rst              |   0
 {doc => framework/docs}/source/docker/index.rst     |   0
 .../docs}/source/docker/persist-superlink-state.rst |   0
 .../docs}/source/docker/pin-version.rst             |   0
 .../docs}/source/docker/run-as-root-user.rst        |   0
 .../docs}/source/docker/run-as-subprocess.rst       |   0
 .../run-quickstart-examples-docker-compose.rst      |   0
 .../source/docker/set-environment-variables.rst     |   0
 .../docker/tutorial-deploy-on-multiple-machines.rst |   0
 .../docker/tutorial-quickstart-docker-compose.rst   |   0
 .../source/docker/tutorial-quickstart-docker.rst    |   0
 .../docs}/source/docker/use-a-different-version.rst |   0
 .../source/explanation-differential-privacy.rst     |   0
 .../source/explanation-federated-evaluation.rst     |   0
 .../source/explanation-flower-architecture.rst      |   0
 .../source/how-to-aggregate-evaluation-results.rst  |   0
 .../docs}/source/how-to-authenticate-supernodes.rst |   0
 .../docs}/source/how-to-configure-clients.rst       |   0
 .../docs}/source/how-to-design-stateful-clients.rst |   0
 .../docs}/source/how-to-enable-tls-connections.rst  |   0
 .../docs}/source/how-to-implement-fedbn.rst         |   0
 .../docs}/source/how-to-implement-strategies.rst    |   0
 .../docs}/source/how-to-install-flower.rst          |   0
 .../docs}/source/how-to-run-flower-on-azure.rst     |   0
 .../docs}/source/how-to-run-simulations.rst         |   0
 .../how-to-save-and-load-model-checkpoints.rst      |   0
 .../docs}/source/how-to-upgrade-to-flower-1.0.rst   |   0
 .../docs}/source/how-to-upgrade-to-flower-1.13.rst  |   0
 .../docs}/source/how-to-use-built-in-mods.rst       |   0
 .../source/how-to-use-differential-privacy.rst      |   0
 .../docs}/source/how-to-use-strategies.rst          |   0
 {doc => framework/docs}/source/index.rst            |   0
 {doc => framework/docs}/source/ref-api-cli.rst      |   0
 {doc => framework/docs}/source/ref-changelog.md     |   0
 .../docs}/source/ref-example-projects.rst           |   0
 {doc => framework/docs}/source/ref-faq.rst          |   0
 {doc => framework/docs}/source/ref-telemetry.md     |   0
 .../docs}/source/tutorial-quickstart-android.rst    |   0
 .../docs}/source/tutorial-quickstart-fastai.rst     |   0
 .../source/tutorial-quickstart-huggingface.rst      |   0
 .../docs}/source/tutorial-quickstart-ios.rst        |   0
 .../docs}/source/tutorial-quickstart-jax.rst        |   0
 .../docs}/source/tutorial-quickstart-mlx.rst        |   0
 .../docs}/source/tutorial-quickstart-pandas.rst     |   0
 .../tutorial-quickstart-pytorch-lightning.rst       |   0
 .../docs}/source/tutorial-quickstart-pytorch.rst    |   0
 .../source/tutorial-quickstart-scikitlearn.rst      |   0
 .../docs}/source/tutorial-quickstart-tensorflow.rst |   0
 .../docs}/source/tutorial-quickstart-xgboost.rst    |   0
 ...ries-build-a-strategy-from-scratch-pytorch.ipynb |   0
 ...torial-series-customize-the-client-pytorch.ipynb |   0
 ...ial-series-get-started-with-flower-pytorch.ipynb |   0
 ...-use-a-federated-learning-strategy-pytorch.ipynb |   0
 ...tutorial-series-what-is-federated-learning.ipynb |   0
 pyproject.toml                                      |   8 ++++----
 145 files changed, 19 insertions(+), 19 deletions(-)
 rename {doc => framework/docs}/Makefile (100%)
 rename {doc => framework/docs}/build-versioned-docs.sh (100%)
 rename {doc => framework/docs}/locales/fr/LC_MESSAGES/framework-docs.po (100%)
 rename {doc => framework/docs}/locales/fr/LC_MESSAGES/sphinx.po (100%)
 rename {doc => framework/docs}/locales/ko/LC_MESSAGES/framework-docs.po (100%)
 rename {doc => framework/docs}/locales/ko/LC_MESSAGES/sphinx.po (100%)
 rename {doc => framework/docs}/locales/pt_BR/LC_MESSAGES/framework-docs.po (100%)
 rename {doc => framework/docs}/locales/pt_BR/LC_MESSAGES/sphinx.po (100%)
 rename {doc => framework/docs}/locales/zh_Hans/LC_MESSAGES/framework-docs.po (100%)
 rename {doc => framework/docs}/locales/zh_Hans/LC_MESSAGES/sphinx.po (100%)
 rename {doc => framework/docs}/make.bat (100%)
 rename {doc => framework/docs}/source/.gitignore (100%)
 rename {doc => framework/docs}/source/_static/DP/CDP.png (100%)
 rename {doc => framework/docs}/source/_static/DP/LDP.png (100%)
 rename {doc => framework/docs}/source/_static/DP/clientsideCDP.png (100%)
 rename {doc => framework/docs}/source/_static/DP/clipping.png (100%)
 rename {doc => framework/docs}/source/_static/DP/dp-intro.png (100%)
 rename {doc => framework/docs}/source/_static/DP/localdp.png (100%)
 rename {doc => framework/docs}/source/_static/DP/serversideCDP.png (100%)
 rename {doc => framework/docs}/source/_static/changes_requested.png (100%)
 rename {doc => framework/docs}/source/_static/cloning_fork.png (100%)
 rename {doc => framework/docs}/source/_static/cloning_repo.png (100%)
 rename {doc => framework/docs}/source/_static/compare_and_pr.png (100%)
 rename {doc => framework/docs}/source/_static/creating_pr.png (100%)
 rename {doc => framework/docs}/source/_static/custom.css (100%)
 rename {doc => framework/docs}/source/_static/draft_pr.png (100%)
 rename {doc => framework/docs}/source/_static/favicon.ico (100%)
 rename {doc => framework/docs}/source/_static/flower-actors.drawio.png (100%)
 rename {doc => framework/docs}/source/_static/flower-architecture-basic-architecture.svg (100%)
 rename {doc => framework/docs}/source/_static/flower-architecture-hub-and-spoke.svg (100%)
 rename {doc => framework/docs}/source/_static/flower-architecture-multi-run-1.svg (100%)
 rename {doc => framework/docs}/source/_static/flower-architecture-multi-run-2.svg (100%)
 rename {doc => framework/docs}/source/_static/flower-architecture-multi-run.svg (100%)
 rename {doc => framework/docs}/source/_static/flower-logo.png (100%)
 rename {doc => framework/docs}/source/_static/fork_button.png (100%)
 rename {doc => framework/docs}/source/_static/fork_link.png (100%)
 rename {doc => framework/docs}/source/_static/forking-repo.png (100%)
 rename {doc => framework/docs}/source/_static/github_schema.png (100%)
 rename {doc => framework/docs}/source/_static/make_changes.png (100%)
 rename {doc => framework/docs}/source/_static/merging_branch.png (100%)
 rename {doc => framework/docs}/source/_static/merging_pr.png (100%)
 rename {doc => framework/docs}/source/_static/opened_pr.png (100%)
 rename {doc => framework/docs}/source/_static/opening-pr.png (100%)
 rename {doc => framework/docs}/source/_static/resolve_conv.png (100%)
 rename {doc => framework/docs}/source/_static/tutorial/central-model-training.png (100%)
 rename {doc => framework/docs}/source/_static/tutorial/centralized-impossible.png (100%)
 rename {doc => framework/docs}/source/_static/tutorial/centralized-possible.png (100%)
 rename {doc => framework/docs}/source/_static/tutorial/collect-data.png (100%)
 rename {doc => framework/docs}/source/_static/tutorial/data-on-phone.png (100%)
 rename {doc => framework/docs}/source/_static/tutorial/fl-aggregate-model-updates.png (100%)
 rename {doc => framework/docs}/source/_static/tutorial/fl-initialize-global-model.png (100%)
 rename {doc => framework/docs}/source/_static/tutorial/fl-local-training.png (100%)
 rename {doc => framework/docs}/source/_static/tutorial/fl-send-global-model.png (100%)
 rename {doc => framework/docs}/source/_static/tutorial/fl-send-model-updates.png (100%)
 rename {doc => framework/docs}/source/_static/tutorial/flower-any.jpeg (100%)
 rename {doc => framework/docs}/source/_static/tutorial/many-devices-with-data.png (100%)
 rename {doc => framework/docs}/source/_static/tutorial/model-and-data.png (100%)
 rename {doc => framework/docs}/source/_static/tutorial/train-model.png (100%)
 rename {doc => framework/docs}/source/_static/upstream_link.png (100%)
 rename {doc => framework/docs}/source/_static/weblate_interface.png (100%)
 rename {doc => framework/docs}/source/_static/weblate_status.png (100%)
 rename {doc => framework/docs}/source/_templates/autosummary/base.rst (100%)
 rename {doc => framework/docs}/source/_templates/autosummary/class.rst (100%)
 rename {doc => framework/docs}/source/_templates/autosummary/module.rst (100%)
 rename {doc => framework/docs}/source/_templates/base.html (100%)
 rename {doc => framework/docs}/source/_templates/sidebar/brand.html (100%)
 rename {doc => framework/docs}/source/_templates/sidebar/lang.html (100%)
 rename {doc => framework/docs}/source/_templates/sidebar/search.html (100%)
 rename {doc => framework/docs}/source/_templates/sidebar/versioning.html (100%)
 rename {doc => framework/docs}/source/conf.py (100%)
 rename {doc => framework/docs}/source/contributor-explanation-public-and-private-apis.rst (100%)
 rename {doc => framework/docs}/source/contributor-how-to-build-docker-images.rst (100%)
 rename {doc => framework/docs}/source/contributor-how-to-contribute-translations.rst (100%)
 rename {doc => framework/docs}/source/contributor-how-to-develop-in-vscode-dev-containers.rst (100%)
 rename {doc => framework/docs}/source/contributor-how-to-install-development-versions.rst (100%)
 rename {doc => framework/docs}/source/contributor-how-to-release-flower.rst (100%)
 rename {doc => framework/docs}/source/contributor-how-to-set-up-a-virtual-env.rst (100%)
 rename {doc => framework/docs}/source/contributor-how-to-write-documentation.rst (100%)
 rename {doc => framework/docs}/source/contributor-ref-good-first-contributions.rst (100%)
 rename {doc => framework/docs}/source/contributor-ref-secure-aggregation-protocols.rst (100%)
 rename {doc => framework/docs}/source/contributor-tutorial-contribute-on-github.rst (100%)
 rename {doc => framework/docs}/source/contributor-tutorial-get-started-as-a-contributor.rst (100%)
 rename {doc => framework/docs}/source/docker/enable-tls.rst (100%)
 rename {doc => framework/docs}/source/docker/index.rst (100%)
 rename {doc => framework/docs}/source/docker/persist-superlink-state.rst (100%)
 rename {doc => framework/docs}/source/docker/pin-version.rst (100%)
 rename {doc => framework/docs}/source/docker/run-as-root-user.rst (100%)
 rename {doc => framework/docs}/source/docker/run-as-subprocess.rst (100%)
 rename {doc => framework/docs}/source/docker/run-quickstart-examples-docker-compose.rst (100%)
 rename {doc => framework/docs}/source/docker/set-environment-variables.rst (100%)
 rename {doc => framework/docs}/source/docker/tutorial-deploy-on-multiple-machines.rst (100%)
 rename {doc => framework/docs}/source/docker/tutorial-quickstart-docker-compose.rst (100%)
 rename {doc => framework/docs}/source/docker/tutorial-quickstart-docker.rst (100%)
 rename {doc => framework/docs}/source/docker/use-a-different-version.rst (100%)
 rename {doc => framework/docs}/source/explanation-differential-privacy.rst (100%)
 rename {doc => framework/docs}/source/explanation-federated-evaluation.rst (100%)
 rename {doc => framework/docs}/source/explanation-flower-architecture.rst (100%)
 rename {doc => framework/docs}/source/how-to-aggregate-evaluation-results.rst (100%)
 rename {doc => framework/docs}/source/how-to-authenticate-supernodes.rst (100%)
 rename {doc => framework/docs}/source/how-to-configure-clients.rst (100%)
 rename {doc => framework/docs}/source/how-to-design-stateful-clients.rst (100%)
 rename {doc => framework/docs}/source/how-to-enable-tls-connections.rst (100%)
 rename {doc => framework/docs}/source/how-to-implement-fedbn.rst (100%)
 rename {doc => framework/docs}/source/how-to-implement-strategies.rst (100%)
 rename {doc => framework/docs}/source/how-to-install-flower.rst (100%)
 rename {doc => framework/docs}/source/how-to-run-flower-on-azure.rst (100%)
 rename {doc => framework/docs}/source/how-to-run-simulations.rst (100%)
 rename {doc => framework/docs}/source/how-to-save-and-load-model-checkpoints.rst (100%)
 rename {doc => framework/docs}/source/how-to-upgrade-to-flower-1.0.rst (100%)
 rename {doc => framework/docs}/source/how-to-upgrade-to-flower-1.13.rst (100%)
 rename {doc => framework/docs}/source/how-to-use-built-in-mods.rst (100%)
 rename {doc => framework/docs}/source/how-to-use-differential-privacy.rst (100%)
 rename {doc => framework/docs}/source/how-to-use-strategies.rst (100%)
 rename {doc => framework/docs}/source/index.rst (100%)
 rename {doc => framework/docs}/source/ref-api-cli.rst (100%)
 rename {doc => framework/docs}/source/ref-changelog.md (100%)
 rename {doc => framework/docs}/source/ref-example-projects.rst (100%)
 rename {doc => framework/docs}/source/ref-faq.rst (100%)
 rename {doc => framework/docs}/source/ref-telemetry.md (100%)
 rename {doc => framework/docs}/source/tutorial-quickstart-android.rst (100%)
 rename {doc => framework/docs}/source/tutorial-quickstart-fastai.rst (100%)
 rename {doc => framework/docs}/source/tutorial-quickstart-huggingface.rst (100%)
 rename {doc => framework/docs}/source/tutorial-quickstart-ios.rst (100%)
 rename {doc => framework/docs}/source/tutorial-quickstart-jax.rst (100%)
 rename {doc => framework/docs}/source/tutorial-quickstart-mlx.rst (100%)
 rename {doc => framework/docs}/source/tutorial-quickstart-pandas.rst (100%)
 rename {doc => framework/docs}/source/tutorial-quickstart-pytorch-lightning.rst (100%)
 rename {doc => framework/docs}/source/tutorial-quickstart-pytorch.rst (100%)
 rename {doc => framework/docs}/source/tutorial-quickstart-scikitlearn.rst (100%)
 rename {doc => framework/docs}/source/tutorial-quickstart-tensorflow.rst (100%)
 rename {doc => framework/docs}/source/tutorial-quickstart-xgboost.rst (100%)
 rename {doc => framework/docs}/source/tutorial-series-build-a-strategy-from-scratch-pytorch.ipynb (100%)
 rename {doc => framework/docs}/source/tutorial-series-customize-the-client-pytorch.ipynb (100%)
 rename {doc => framework/docs}/source/tutorial-series-get-started-with-flower-pytorch.ipynb (100%)
 rename {doc => framework/docs}/source/tutorial-series-use-a-federated-learning-strategy-pytorch.ipynb (100%)
 rename {doc => framework/docs}/source/tutorial-series-what-is-federated-learning.ipynb (100%)

diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index 3f010a4c37b0..a4b3455d8c6c 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -45,7 +45,7 @@ jobs:
           AWS_SECRET_ACCESS_KEY: ${{ secrets. AWS_SECRET_ACCESS_KEY }}
           DOCS_BUCKET: flower.ai
         run: |
-          aws s3 sync --delete --exclude ".*" --exclude "v/*" --cache-control "no-cache" ./doc/build/html/ s3://${{ env.DOCS_BUCKET }}/docs/framework
+          aws s3 sync --delete --exclude ".*" --exclude "v/*" --cache-control "no-cache" ./framework/docs/build/html/ s3://${{ env.DOCS_BUCKET }}/docs/framework
           aws s3 sync --delete --exclude ".*" --exclude "v/*" --cache-control "no-cache" ./baselines/doc/build/html/ s3://${{ env.DOCS_BUCKET }}/docs/baselines
           aws s3 sync --delete --exclude ".*" --exclude "v/*" --cache-control "no-cache" ./examples/doc/build/html/ s3://${{ env.DOCS_BUCKET }}/docs/examples
           aws s3 sync --delete --exclude ".*" --exclude "v/*" --cache-control "no-cache" ./datasets/doc/build/html/ s3://${{ env.DOCS_BUCKET }}/docs/datasets
diff --git a/.github/workflows/update_translations.yml b/.github/workflows/update_translations.yml
index 9a5391a40438..ec748befb33c 100644
--- a/.github/workflows/update_translations.yml
+++ b/.github/workflows/update_translations.yml
@@ -38,7 +38,7 @@ jobs:
 
       - name: Update text and translations for all locales
         run: |
-          cd doc
+          cd framework/docs
           make update-text
           for langDir in locales/*; do
             if [ -d "$langDir" ]; then
@@ -52,7 +52,7 @@ jobs:
         run: |
           git config --local user.email "41898282+github-actions[bot]@users.noreply.github.com"
           git config --local user.name "github-actions[bot]"
-          git add doc/locales
+          git add framework/docs/locales
           git commit -m "Update text and language files"
         continue-on-error: true
 
diff --git a/.gitignore b/.gitignore
index 96789cbf6e00..9af2d29f2315 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,9 +1,9 @@
 # Flower
 .flower_ops
 data/
-doc/source/api_documentation
-doc/source/_build
-doc/source/dataset/
+framework/docs/source/api_documentation
+framework/docs/source/_build
+framework/docs/source/dataset/
 flwr_logs
 .cache
 
diff --git a/dev/build-docs.sh b/dev/build-docs.sh
index f4bf958b0ebf..bdfd33ad626d 100755
--- a/dev/build-docs.sh
+++ b/dev/build-docs.sh
@@ -14,7 +14,7 @@ cd $ROOT
 ./datasets/dev/build-flwr-datasets-docs.sh
 
 cd $ROOT
-cd doc
+cd framework/docs 
 
 if [ "$1" = true ]; then
     ./build-versioned-docs.sh
diff --git a/dev/format.sh b/dev/format.sh
index a3129b932e5d..8ad739be529a 100755
--- a/dev/format.sh
+++ b/dev/format.sh
@@ -31,13 +31,13 @@ python -m black -q e2e
 python -m docformatter -i -r e2e
 
 # Notebooks
-python -m black --ipynb -q doc/source/*.ipynb
+python -m black --ipynb -q framework/docs/source/*.ipynb
 KEYS="metadata.celltoolbar metadata.language_info metadata.toc metadata.notify_time metadata.varInspector metadata.accelerator metadata.vscode cell.metadata.id cell.metadata.heading_collapsed cell.metadata.hidden cell.metadata.code_folding cell.metadata.tags cell.metadata.init_cell cell.metadata.vscode cell.metadata.pycharm"
-python -m nbstripout doc/source/*.ipynb --extra-keys "$KEYS"
+python -m nbstripout framework/docs/source/*.ipynb --extra-keys "$KEYS"
 python -m nbstripout examples/*/*.ipynb --extra-keys "$KEYS"
 
 # Markdown
-python -m mdformat --number doc/source examples
+python -m mdformat --number framework/docs/source examples
 
 # RST
-docstrfmt doc/source
+docstrfmt framework/docs/source
diff --git a/dev/get-latest-changelog.sh b/dev/get-latest-changelog.sh
index 1d4a6b6bf58f..9cf8a5069253 100755
--- a/dev/get-latest-changelog.sh
+++ b/dev/get-latest-changelog.sh
@@ -9,7 +9,7 @@ tags=$(git tag --sort=-v:refname)
 new_version=$(echo "$tags" | sed -n '1p')
 old_version=$(echo "$tags" | sed -n '2p')
 
-awk '{sub(/<!--.*-->/, ""); print}' doc/source/ref-changelog.md | awk -v start="$new_version" -v end="$old_version" '
+awk '{sub(/<!--.*-->/, ""); print}' framework/docs/source/ref-changelog.md | awk -v start="$new_version" -v end="$old_version" '
     $0 ~ start {flag=1; next}
     $0 ~ end {flag=0}
     flag && !printed && /^$/ {next}  # skip the first blank line
diff --git a/dev/rm-caches.sh b/dev/rm-caches.sh
index d5b004fb834c..eddd9c9e947a 100755
--- a/dev/rm-caches.sh
+++ b/dev/rm-caches.sh
@@ -6,4 +6,4 @@ find src -type d -name __pycache__ -exec rm -r {} \+
 rm -rf .mypy_cache
 rm -rf .pytest_cache
 rm -rf .cache
-rm -rf doc/build
+rm -rf framework/docs/build
diff --git a/dev/test.sh b/dev/test.sh
index b8eeed14bc46..c6a45602b34c 100755
--- a/dev/test.sh
+++ b/dev/test.sh
@@ -55,7 +55,7 @@ echo "- All Python checks passed"
 echo "- Start Markdown checks"
 
 echo "- mdformat: start"
-python -m mdformat --check --number doc/source examples
+python -m mdformat --check --number framework/docs/source examples
 echo "- mdformat: done"
 
 echo "- All Markdown checks passed"
@@ -71,7 +71,7 @@ echo "- All TOML checks passed"
 echo "- Start rST checks"
 
 echo "- docstrfmt: start"
-docstrfmt --check doc/source
+docstrfmt --check framework/docs/source
 echo "- docstrfmt: done"
 
 echo "- All rST checks passed"
diff --git a/doc/Makefile b/framework/docs/Makefile
similarity index 100%
rename from doc/Makefile
rename to framework/docs/Makefile
diff --git a/doc/build-versioned-docs.sh b/framework/docs/build-versioned-docs.sh
similarity index 100%
rename from doc/build-versioned-docs.sh
rename to framework/docs/build-versioned-docs.sh
diff --git a/doc/locales/fr/LC_MESSAGES/framework-docs.po b/framework/docs/locales/fr/LC_MESSAGES/framework-docs.po
similarity index 100%
rename from doc/locales/fr/LC_MESSAGES/framework-docs.po
rename to framework/docs/locales/fr/LC_MESSAGES/framework-docs.po
diff --git a/doc/locales/fr/LC_MESSAGES/sphinx.po b/framework/docs/locales/fr/LC_MESSAGES/sphinx.po
similarity index 100%
rename from doc/locales/fr/LC_MESSAGES/sphinx.po
rename to framework/docs/locales/fr/LC_MESSAGES/sphinx.po
diff --git a/doc/locales/ko/LC_MESSAGES/framework-docs.po b/framework/docs/locales/ko/LC_MESSAGES/framework-docs.po
similarity index 100%
rename from doc/locales/ko/LC_MESSAGES/framework-docs.po
rename to framework/docs/locales/ko/LC_MESSAGES/framework-docs.po
diff --git a/doc/locales/ko/LC_MESSAGES/sphinx.po b/framework/docs/locales/ko/LC_MESSAGES/sphinx.po
similarity index 100%
rename from doc/locales/ko/LC_MESSAGES/sphinx.po
rename to framework/docs/locales/ko/LC_MESSAGES/sphinx.po
diff --git a/doc/locales/pt_BR/LC_MESSAGES/framework-docs.po b/framework/docs/locales/pt_BR/LC_MESSAGES/framework-docs.po
similarity index 100%
rename from doc/locales/pt_BR/LC_MESSAGES/framework-docs.po
rename to framework/docs/locales/pt_BR/LC_MESSAGES/framework-docs.po
diff --git a/doc/locales/pt_BR/LC_MESSAGES/sphinx.po b/framework/docs/locales/pt_BR/LC_MESSAGES/sphinx.po
similarity index 100%
rename from doc/locales/pt_BR/LC_MESSAGES/sphinx.po
rename to framework/docs/locales/pt_BR/LC_MESSAGES/sphinx.po
diff --git a/doc/locales/zh_Hans/LC_MESSAGES/framework-docs.po b/framework/docs/locales/zh_Hans/LC_MESSAGES/framework-docs.po
similarity index 100%
rename from doc/locales/zh_Hans/LC_MESSAGES/framework-docs.po
rename to framework/docs/locales/zh_Hans/LC_MESSAGES/framework-docs.po
diff --git a/doc/locales/zh_Hans/LC_MESSAGES/sphinx.po b/framework/docs/locales/zh_Hans/LC_MESSAGES/sphinx.po
similarity index 100%
rename from doc/locales/zh_Hans/LC_MESSAGES/sphinx.po
rename to framework/docs/locales/zh_Hans/LC_MESSAGES/sphinx.po
diff --git a/doc/make.bat b/framework/docs/make.bat
similarity index 100%
rename from doc/make.bat
rename to framework/docs/make.bat
diff --git a/doc/source/.gitignore b/framework/docs/source/.gitignore
similarity index 100%
rename from doc/source/.gitignore
rename to framework/docs/source/.gitignore
diff --git a/doc/source/_static/DP/CDP.png b/framework/docs/source/_static/DP/CDP.png
similarity index 100%
rename from doc/source/_static/DP/CDP.png
rename to framework/docs/source/_static/DP/CDP.png
diff --git a/doc/source/_static/DP/LDP.png b/framework/docs/source/_static/DP/LDP.png
similarity index 100%
rename from doc/source/_static/DP/LDP.png
rename to framework/docs/source/_static/DP/LDP.png
diff --git a/doc/source/_static/DP/clientsideCDP.png b/framework/docs/source/_static/DP/clientsideCDP.png
similarity index 100%
rename from doc/source/_static/DP/clientsideCDP.png
rename to framework/docs/source/_static/DP/clientsideCDP.png
diff --git a/doc/source/_static/DP/clipping.png b/framework/docs/source/_static/DP/clipping.png
similarity index 100%
rename from doc/source/_static/DP/clipping.png
rename to framework/docs/source/_static/DP/clipping.png
diff --git a/doc/source/_static/DP/dp-intro.png b/framework/docs/source/_static/DP/dp-intro.png
similarity index 100%
rename from doc/source/_static/DP/dp-intro.png
rename to framework/docs/source/_static/DP/dp-intro.png
diff --git a/doc/source/_static/DP/localdp.png b/framework/docs/source/_static/DP/localdp.png
similarity index 100%
rename from doc/source/_static/DP/localdp.png
rename to framework/docs/source/_static/DP/localdp.png
diff --git a/doc/source/_static/DP/serversideCDP.png b/framework/docs/source/_static/DP/serversideCDP.png
similarity index 100%
rename from doc/source/_static/DP/serversideCDP.png
rename to framework/docs/source/_static/DP/serversideCDP.png
diff --git a/doc/source/_static/changes_requested.png b/framework/docs/source/_static/changes_requested.png
similarity index 100%
rename from doc/source/_static/changes_requested.png
rename to framework/docs/source/_static/changes_requested.png
diff --git a/doc/source/_static/cloning_fork.png b/framework/docs/source/_static/cloning_fork.png
similarity index 100%
rename from doc/source/_static/cloning_fork.png
rename to framework/docs/source/_static/cloning_fork.png
diff --git a/doc/source/_static/cloning_repo.png b/framework/docs/source/_static/cloning_repo.png
similarity index 100%
rename from doc/source/_static/cloning_repo.png
rename to framework/docs/source/_static/cloning_repo.png
diff --git a/doc/source/_static/compare_and_pr.png b/framework/docs/source/_static/compare_and_pr.png
similarity index 100%
rename from doc/source/_static/compare_and_pr.png
rename to framework/docs/source/_static/compare_and_pr.png
diff --git a/doc/source/_static/creating_pr.png b/framework/docs/source/_static/creating_pr.png
similarity index 100%
rename from doc/source/_static/creating_pr.png
rename to framework/docs/source/_static/creating_pr.png
diff --git a/doc/source/_static/custom.css b/framework/docs/source/_static/custom.css
similarity index 100%
rename from doc/source/_static/custom.css
rename to framework/docs/source/_static/custom.css
diff --git a/doc/source/_static/draft_pr.png b/framework/docs/source/_static/draft_pr.png
similarity index 100%
rename from doc/source/_static/draft_pr.png
rename to framework/docs/source/_static/draft_pr.png
diff --git a/doc/source/_static/favicon.ico b/framework/docs/source/_static/favicon.ico
similarity index 100%
rename from doc/source/_static/favicon.ico
rename to framework/docs/source/_static/favicon.ico
diff --git a/doc/source/_static/flower-actors.drawio.png b/framework/docs/source/_static/flower-actors.drawio.png
similarity index 100%
rename from doc/source/_static/flower-actors.drawio.png
rename to framework/docs/source/_static/flower-actors.drawio.png
diff --git a/doc/source/_static/flower-architecture-basic-architecture.svg b/framework/docs/source/_static/flower-architecture-basic-architecture.svg
similarity index 100%
rename from doc/source/_static/flower-architecture-basic-architecture.svg
rename to framework/docs/source/_static/flower-architecture-basic-architecture.svg
diff --git a/doc/source/_static/flower-architecture-hub-and-spoke.svg b/framework/docs/source/_static/flower-architecture-hub-and-spoke.svg
similarity index 100%
rename from doc/source/_static/flower-architecture-hub-and-spoke.svg
rename to framework/docs/source/_static/flower-architecture-hub-and-spoke.svg
diff --git a/doc/source/_static/flower-architecture-multi-run-1.svg b/framework/docs/source/_static/flower-architecture-multi-run-1.svg
similarity index 100%
rename from doc/source/_static/flower-architecture-multi-run-1.svg
rename to framework/docs/source/_static/flower-architecture-multi-run-1.svg
diff --git a/doc/source/_static/flower-architecture-multi-run-2.svg b/framework/docs/source/_static/flower-architecture-multi-run-2.svg
similarity index 100%
rename from doc/source/_static/flower-architecture-multi-run-2.svg
rename to framework/docs/source/_static/flower-architecture-multi-run-2.svg
diff --git a/doc/source/_static/flower-architecture-multi-run.svg b/framework/docs/source/_static/flower-architecture-multi-run.svg
similarity index 100%
rename from doc/source/_static/flower-architecture-multi-run.svg
rename to framework/docs/source/_static/flower-architecture-multi-run.svg
diff --git a/doc/source/_static/flower-logo.png b/framework/docs/source/_static/flower-logo.png
similarity index 100%
rename from doc/source/_static/flower-logo.png
rename to framework/docs/source/_static/flower-logo.png
diff --git a/doc/source/_static/fork_button.png b/framework/docs/source/_static/fork_button.png
similarity index 100%
rename from doc/source/_static/fork_button.png
rename to framework/docs/source/_static/fork_button.png
diff --git a/doc/source/_static/fork_link.png b/framework/docs/source/_static/fork_link.png
similarity index 100%
rename from doc/source/_static/fork_link.png
rename to framework/docs/source/_static/fork_link.png
diff --git a/doc/source/_static/forking-repo.png b/framework/docs/source/_static/forking-repo.png
similarity index 100%
rename from doc/source/_static/forking-repo.png
rename to framework/docs/source/_static/forking-repo.png
diff --git a/doc/source/_static/github_schema.png b/framework/docs/source/_static/github_schema.png
similarity index 100%
rename from doc/source/_static/github_schema.png
rename to framework/docs/source/_static/github_schema.png
diff --git a/doc/source/_static/make_changes.png b/framework/docs/source/_static/make_changes.png
similarity index 100%
rename from doc/source/_static/make_changes.png
rename to framework/docs/source/_static/make_changes.png
diff --git a/doc/source/_static/merging_branch.png b/framework/docs/source/_static/merging_branch.png
similarity index 100%
rename from doc/source/_static/merging_branch.png
rename to framework/docs/source/_static/merging_branch.png
diff --git a/doc/source/_static/merging_pr.png b/framework/docs/source/_static/merging_pr.png
similarity index 100%
rename from doc/source/_static/merging_pr.png
rename to framework/docs/source/_static/merging_pr.png
diff --git a/doc/source/_static/opened_pr.png b/framework/docs/source/_static/opened_pr.png
similarity index 100%
rename from doc/source/_static/opened_pr.png
rename to framework/docs/source/_static/opened_pr.png
diff --git a/doc/source/_static/opening-pr.png b/framework/docs/source/_static/opening-pr.png
similarity index 100%
rename from doc/source/_static/opening-pr.png
rename to framework/docs/source/_static/opening-pr.png
diff --git a/doc/source/_static/resolve_conv.png b/framework/docs/source/_static/resolve_conv.png
similarity index 100%
rename from doc/source/_static/resolve_conv.png
rename to framework/docs/source/_static/resolve_conv.png
diff --git a/doc/source/_static/tutorial/central-model-training.png b/framework/docs/source/_static/tutorial/central-model-training.png
similarity index 100%
rename from doc/source/_static/tutorial/central-model-training.png
rename to framework/docs/source/_static/tutorial/central-model-training.png
diff --git a/doc/source/_static/tutorial/centralized-impossible.png b/framework/docs/source/_static/tutorial/centralized-impossible.png
similarity index 100%
rename from doc/source/_static/tutorial/centralized-impossible.png
rename to framework/docs/source/_static/tutorial/centralized-impossible.png
diff --git a/doc/source/_static/tutorial/centralized-possible.png b/framework/docs/source/_static/tutorial/centralized-possible.png
similarity index 100%
rename from doc/source/_static/tutorial/centralized-possible.png
rename to framework/docs/source/_static/tutorial/centralized-possible.png
diff --git a/doc/source/_static/tutorial/collect-data.png b/framework/docs/source/_static/tutorial/collect-data.png
similarity index 100%
rename from doc/source/_static/tutorial/collect-data.png
rename to framework/docs/source/_static/tutorial/collect-data.png
diff --git a/doc/source/_static/tutorial/data-on-phone.png b/framework/docs/source/_static/tutorial/data-on-phone.png
similarity index 100%
rename from doc/source/_static/tutorial/data-on-phone.png
rename to framework/docs/source/_static/tutorial/data-on-phone.png
diff --git a/doc/source/_static/tutorial/fl-aggregate-model-updates.png b/framework/docs/source/_static/tutorial/fl-aggregate-model-updates.png
similarity index 100%
rename from doc/source/_static/tutorial/fl-aggregate-model-updates.png
rename to framework/docs/source/_static/tutorial/fl-aggregate-model-updates.png
diff --git a/doc/source/_static/tutorial/fl-initialize-global-model.png b/framework/docs/source/_static/tutorial/fl-initialize-global-model.png
similarity index 100%
rename from doc/source/_static/tutorial/fl-initialize-global-model.png
rename to framework/docs/source/_static/tutorial/fl-initialize-global-model.png
diff --git a/doc/source/_static/tutorial/fl-local-training.png b/framework/docs/source/_static/tutorial/fl-local-training.png
similarity index 100%
rename from doc/source/_static/tutorial/fl-local-training.png
rename to framework/docs/source/_static/tutorial/fl-local-training.png
diff --git a/doc/source/_static/tutorial/fl-send-global-model.png b/framework/docs/source/_static/tutorial/fl-send-global-model.png
similarity index 100%
rename from doc/source/_static/tutorial/fl-send-global-model.png
rename to framework/docs/source/_static/tutorial/fl-send-global-model.png
diff --git a/doc/source/_static/tutorial/fl-send-model-updates.png b/framework/docs/source/_static/tutorial/fl-send-model-updates.png
similarity index 100%
rename from doc/source/_static/tutorial/fl-send-model-updates.png
rename to framework/docs/source/_static/tutorial/fl-send-model-updates.png
diff --git a/doc/source/_static/tutorial/flower-any.jpeg b/framework/docs/source/_static/tutorial/flower-any.jpeg
similarity index 100%
rename from doc/source/_static/tutorial/flower-any.jpeg
rename to framework/docs/source/_static/tutorial/flower-any.jpeg
diff --git a/doc/source/_static/tutorial/many-devices-with-data.png b/framework/docs/source/_static/tutorial/many-devices-with-data.png
similarity index 100%
rename from doc/source/_static/tutorial/many-devices-with-data.png
rename to framework/docs/source/_static/tutorial/many-devices-with-data.png
diff --git a/doc/source/_static/tutorial/model-and-data.png b/framework/docs/source/_static/tutorial/model-and-data.png
similarity index 100%
rename from doc/source/_static/tutorial/model-and-data.png
rename to framework/docs/source/_static/tutorial/model-and-data.png
diff --git a/doc/source/_static/tutorial/train-model.png b/framework/docs/source/_static/tutorial/train-model.png
similarity index 100%
rename from doc/source/_static/tutorial/train-model.png
rename to framework/docs/source/_static/tutorial/train-model.png
diff --git a/doc/source/_static/upstream_link.png b/framework/docs/source/_static/upstream_link.png
similarity index 100%
rename from doc/source/_static/upstream_link.png
rename to framework/docs/source/_static/upstream_link.png
diff --git a/doc/source/_static/weblate_interface.png b/framework/docs/source/_static/weblate_interface.png
similarity index 100%
rename from doc/source/_static/weblate_interface.png
rename to framework/docs/source/_static/weblate_interface.png
diff --git a/doc/source/_static/weblate_status.png b/framework/docs/source/_static/weblate_status.png
similarity index 100%
rename from doc/source/_static/weblate_status.png
rename to framework/docs/source/_static/weblate_status.png
diff --git a/doc/source/_templates/autosummary/base.rst b/framework/docs/source/_templates/autosummary/base.rst
similarity index 100%
rename from doc/source/_templates/autosummary/base.rst
rename to framework/docs/source/_templates/autosummary/base.rst
diff --git a/doc/source/_templates/autosummary/class.rst b/framework/docs/source/_templates/autosummary/class.rst
similarity index 100%
rename from doc/source/_templates/autosummary/class.rst
rename to framework/docs/source/_templates/autosummary/class.rst
diff --git a/doc/source/_templates/autosummary/module.rst b/framework/docs/source/_templates/autosummary/module.rst
similarity index 100%
rename from doc/source/_templates/autosummary/module.rst
rename to framework/docs/source/_templates/autosummary/module.rst
diff --git a/doc/source/_templates/base.html b/framework/docs/source/_templates/base.html
similarity index 100%
rename from doc/source/_templates/base.html
rename to framework/docs/source/_templates/base.html
diff --git a/doc/source/_templates/sidebar/brand.html b/framework/docs/source/_templates/sidebar/brand.html
similarity index 100%
rename from doc/source/_templates/sidebar/brand.html
rename to framework/docs/source/_templates/sidebar/brand.html
diff --git a/doc/source/_templates/sidebar/lang.html b/framework/docs/source/_templates/sidebar/lang.html
similarity index 100%
rename from doc/source/_templates/sidebar/lang.html
rename to framework/docs/source/_templates/sidebar/lang.html
diff --git a/doc/source/_templates/sidebar/search.html b/framework/docs/source/_templates/sidebar/search.html
similarity index 100%
rename from doc/source/_templates/sidebar/search.html
rename to framework/docs/source/_templates/sidebar/search.html
diff --git a/doc/source/_templates/sidebar/versioning.html b/framework/docs/source/_templates/sidebar/versioning.html
similarity index 100%
rename from doc/source/_templates/sidebar/versioning.html
rename to framework/docs/source/_templates/sidebar/versioning.html
diff --git a/doc/source/conf.py b/framework/docs/source/conf.py
similarity index 100%
rename from doc/source/conf.py
rename to framework/docs/source/conf.py
diff --git a/doc/source/contributor-explanation-public-and-private-apis.rst b/framework/docs/source/contributor-explanation-public-and-private-apis.rst
similarity index 100%
rename from doc/source/contributor-explanation-public-and-private-apis.rst
rename to framework/docs/source/contributor-explanation-public-and-private-apis.rst
diff --git a/doc/source/contributor-how-to-build-docker-images.rst b/framework/docs/source/contributor-how-to-build-docker-images.rst
similarity index 100%
rename from doc/source/contributor-how-to-build-docker-images.rst
rename to framework/docs/source/contributor-how-to-build-docker-images.rst
diff --git a/doc/source/contributor-how-to-contribute-translations.rst b/framework/docs/source/contributor-how-to-contribute-translations.rst
similarity index 100%
rename from doc/source/contributor-how-to-contribute-translations.rst
rename to framework/docs/source/contributor-how-to-contribute-translations.rst
diff --git a/doc/source/contributor-how-to-develop-in-vscode-dev-containers.rst b/framework/docs/source/contributor-how-to-develop-in-vscode-dev-containers.rst
similarity index 100%
rename from doc/source/contributor-how-to-develop-in-vscode-dev-containers.rst
rename to framework/docs/source/contributor-how-to-develop-in-vscode-dev-containers.rst
diff --git a/doc/source/contributor-how-to-install-development-versions.rst b/framework/docs/source/contributor-how-to-install-development-versions.rst
similarity index 100%
rename from doc/source/contributor-how-to-install-development-versions.rst
rename to framework/docs/source/contributor-how-to-install-development-versions.rst
diff --git a/doc/source/contributor-how-to-release-flower.rst b/framework/docs/source/contributor-how-to-release-flower.rst
similarity index 100%
rename from doc/source/contributor-how-to-release-flower.rst
rename to framework/docs/source/contributor-how-to-release-flower.rst
diff --git a/doc/source/contributor-how-to-set-up-a-virtual-env.rst b/framework/docs/source/contributor-how-to-set-up-a-virtual-env.rst
similarity index 100%
rename from doc/source/contributor-how-to-set-up-a-virtual-env.rst
rename to framework/docs/source/contributor-how-to-set-up-a-virtual-env.rst
diff --git a/doc/source/contributor-how-to-write-documentation.rst b/framework/docs/source/contributor-how-to-write-documentation.rst
similarity index 100%
rename from doc/source/contributor-how-to-write-documentation.rst
rename to framework/docs/source/contributor-how-to-write-documentation.rst
diff --git a/doc/source/contributor-ref-good-first-contributions.rst b/framework/docs/source/contributor-ref-good-first-contributions.rst
similarity index 100%
rename from doc/source/contributor-ref-good-first-contributions.rst
rename to framework/docs/source/contributor-ref-good-first-contributions.rst
diff --git a/doc/source/contributor-ref-secure-aggregation-protocols.rst b/framework/docs/source/contributor-ref-secure-aggregation-protocols.rst
similarity index 100%
rename from doc/source/contributor-ref-secure-aggregation-protocols.rst
rename to framework/docs/source/contributor-ref-secure-aggregation-protocols.rst
diff --git a/doc/source/contributor-tutorial-contribute-on-github.rst b/framework/docs/source/contributor-tutorial-contribute-on-github.rst
similarity index 100%
rename from doc/source/contributor-tutorial-contribute-on-github.rst
rename to framework/docs/source/contributor-tutorial-contribute-on-github.rst
diff --git a/doc/source/contributor-tutorial-get-started-as-a-contributor.rst b/framework/docs/source/contributor-tutorial-get-started-as-a-contributor.rst
similarity index 100%
rename from doc/source/contributor-tutorial-get-started-as-a-contributor.rst
rename to framework/docs/source/contributor-tutorial-get-started-as-a-contributor.rst
diff --git a/doc/source/docker/enable-tls.rst b/framework/docs/source/docker/enable-tls.rst
similarity index 100%
rename from doc/source/docker/enable-tls.rst
rename to framework/docs/source/docker/enable-tls.rst
diff --git a/doc/source/docker/index.rst b/framework/docs/source/docker/index.rst
similarity index 100%
rename from doc/source/docker/index.rst
rename to framework/docs/source/docker/index.rst
diff --git a/doc/source/docker/persist-superlink-state.rst b/framework/docs/source/docker/persist-superlink-state.rst
similarity index 100%
rename from doc/source/docker/persist-superlink-state.rst
rename to framework/docs/source/docker/persist-superlink-state.rst
diff --git a/doc/source/docker/pin-version.rst b/framework/docs/source/docker/pin-version.rst
similarity index 100%
rename from doc/source/docker/pin-version.rst
rename to framework/docs/source/docker/pin-version.rst
diff --git a/doc/source/docker/run-as-root-user.rst b/framework/docs/source/docker/run-as-root-user.rst
similarity index 100%
rename from doc/source/docker/run-as-root-user.rst
rename to framework/docs/source/docker/run-as-root-user.rst
diff --git a/doc/source/docker/run-as-subprocess.rst b/framework/docs/source/docker/run-as-subprocess.rst
similarity index 100%
rename from doc/source/docker/run-as-subprocess.rst
rename to framework/docs/source/docker/run-as-subprocess.rst
diff --git a/doc/source/docker/run-quickstart-examples-docker-compose.rst b/framework/docs/source/docker/run-quickstart-examples-docker-compose.rst
similarity index 100%
rename from doc/source/docker/run-quickstart-examples-docker-compose.rst
rename to framework/docs/source/docker/run-quickstart-examples-docker-compose.rst
diff --git a/doc/source/docker/set-environment-variables.rst b/framework/docs/source/docker/set-environment-variables.rst
similarity index 100%
rename from doc/source/docker/set-environment-variables.rst
rename to framework/docs/source/docker/set-environment-variables.rst
diff --git a/doc/source/docker/tutorial-deploy-on-multiple-machines.rst b/framework/docs/source/docker/tutorial-deploy-on-multiple-machines.rst
similarity index 100%
rename from doc/source/docker/tutorial-deploy-on-multiple-machines.rst
rename to framework/docs/source/docker/tutorial-deploy-on-multiple-machines.rst
diff --git a/doc/source/docker/tutorial-quickstart-docker-compose.rst b/framework/docs/source/docker/tutorial-quickstart-docker-compose.rst
similarity index 100%
rename from doc/source/docker/tutorial-quickstart-docker-compose.rst
rename to framework/docs/source/docker/tutorial-quickstart-docker-compose.rst
diff --git a/doc/source/docker/tutorial-quickstart-docker.rst b/framework/docs/source/docker/tutorial-quickstart-docker.rst
similarity index 100%
rename from doc/source/docker/tutorial-quickstart-docker.rst
rename to framework/docs/source/docker/tutorial-quickstart-docker.rst
diff --git a/doc/source/docker/use-a-different-version.rst b/framework/docs/source/docker/use-a-different-version.rst
similarity index 100%
rename from doc/source/docker/use-a-different-version.rst
rename to framework/docs/source/docker/use-a-different-version.rst
diff --git a/doc/source/explanation-differential-privacy.rst b/framework/docs/source/explanation-differential-privacy.rst
similarity index 100%
rename from doc/source/explanation-differential-privacy.rst
rename to framework/docs/source/explanation-differential-privacy.rst
diff --git a/doc/source/explanation-federated-evaluation.rst b/framework/docs/source/explanation-federated-evaluation.rst
similarity index 100%
rename from doc/source/explanation-federated-evaluation.rst
rename to framework/docs/source/explanation-federated-evaluation.rst
diff --git a/doc/source/explanation-flower-architecture.rst b/framework/docs/source/explanation-flower-architecture.rst
similarity index 100%
rename from doc/source/explanation-flower-architecture.rst
rename to framework/docs/source/explanation-flower-architecture.rst
diff --git a/doc/source/how-to-aggregate-evaluation-results.rst b/framework/docs/source/how-to-aggregate-evaluation-results.rst
similarity index 100%
rename from doc/source/how-to-aggregate-evaluation-results.rst
rename to framework/docs/source/how-to-aggregate-evaluation-results.rst
diff --git a/doc/source/how-to-authenticate-supernodes.rst b/framework/docs/source/how-to-authenticate-supernodes.rst
similarity index 100%
rename from doc/source/how-to-authenticate-supernodes.rst
rename to framework/docs/source/how-to-authenticate-supernodes.rst
diff --git a/doc/source/how-to-configure-clients.rst b/framework/docs/source/how-to-configure-clients.rst
similarity index 100%
rename from doc/source/how-to-configure-clients.rst
rename to framework/docs/source/how-to-configure-clients.rst
diff --git a/doc/source/how-to-design-stateful-clients.rst b/framework/docs/source/how-to-design-stateful-clients.rst
similarity index 100%
rename from doc/source/how-to-design-stateful-clients.rst
rename to framework/docs/source/how-to-design-stateful-clients.rst
diff --git a/doc/source/how-to-enable-tls-connections.rst b/framework/docs/source/how-to-enable-tls-connections.rst
similarity index 100%
rename from doc/source/how-to-enable-tls-connections.rst
rename to framework/docs/source/how-to-enable-tls-connections.rst
diff --git a/doc/source/how-to-implement-fedbn.rst b/framework/docs/source/how-to-implement-fedbn.rst
similarity index 100%
rename from doc/source/how-to-implement-fedbn.rst
rename to framework/docs/source/how-to-implement-fedbn.rst
diff --git a/doc/source/how-to-implement-strategies.rst b/framework/docs/source/how-to-implement-strategies.rst
similarity index 100%
rename from doc/source/how-to-implement-strategies.rst
rename to framework/docs/source/how-to-implement-strategies.rst
diff --git a/doc/source/how-to-install-flower.rst b/framework/docs/source/how-to-install-flower.rst
similarity index 100%
rename from doc/source/how-to-install-flower.rst
rename to framework/docs/source/how-to-install-flower.rst
diff --git a/doc/source/how-to-run-flower-on-azure.rst b/framework/docs/source/how-to-run-flower-on-azure.rst
similarity index 100%
rename from doc/source/how-to-run-flower-on-azure.rst
rename to framework/docs/source/how-to-run-flower-on-azure.rst
diff --git a/doc/source/how-to-run-simulations.rst b/framework/docs/source/how-to-run-simulations.rst
similarity index 100%
rename from doc/source/how-to-run-simulations.rst
rename to framework/docs/source/how-to-run-simulations.rst
diff --git a/doc/source/how-to-save-and-load-model-checkpoints.rst b/framework/docs/source/how-to-save-and-load-model-checkpoints.rst
similarity index 100%
rename from doc/source/how-to-save-and-load-model-checkpoints.rst
rename to framework/docs/source/how-to-save-and-load-model-checkpoints.rst
diff --git a/doc/source/how-to-upgrade-to-flower-1.0.rst b/framework/docs/source/how-to-upgrade-to-flower-1.0.rst
similarity index 100%
rename from doc/source/how-to-upgrade-to-flower-1.0.rst
rename to framework/docs/source/how-to-upgrade-to-flower-1.0.rst
diff --git a/doc/source/how-to-upgrade-to-flower-1.13.rst b/framework/docs/source/how-to-upgrade-to-flower-1.13.rst
similarity index 100%
rename from doc/source/how-to-upgrade-to-flower-1.13.rst
rename to framework/docs/source/how-to-upgrade-to-flower-1.13.rst
diff --git a/doc/source/how-to-use-built-in-mods.rst b/framework/docs/source/how-to-use-built-in-mods.rst
similarity index 100%
rename from doc/source/how-to-use-built-in-mods.rst
rename to framework/docs/source/how-to-use-built-in-mods.rst
diff --git a/doc/source/how-to-use-differential-privacy.rst b/framework/docs/source/how-to-use-differential-privacy.rst
similarity index 100%
rename from doc/source/how-to-use-differential-privacy.rst
rename to framework/docs/source/how-to-use-differential-privacy.rst
diff --git a/doc/source/how-to-use-strategies.rst b/framework/docs/source/how-to-use-strategies.rst
similarity index 100%
rename from doc/source/how-to-use-strategies.rst
rename to framework/docs/source/how-to-use-strategies.rst
diff --git a/doc/source/index.rst b/framework/docs/source/index.rst
similarity index 100%
rename from doc/source/index.rst
rename to framework/docs/source/index.rst
diff --git a/doc/source/ref-api-cli.rst b/framework/docs/source/ref-api-cli.rst
similarity index 100%
rename from doc/source/ref-api-cli.rst
rename to framework/docs/source/ref-api-cli.rst
diff --git a/doc/source/ref-changelog.md b/framework/docs/source/ref-changelog.md
similarity index 100%
rename from doc/source/ref-changelog.md
rename to framework/docs/source/ref-changelog.md
diff --git a/doc/source/ref-example-projects.rst b/framework/docs/source/ref-example-projects.rst
similarity index 100%
rename from doc/source/ref-example-projects.rst
rename to framework/docs/source/ref-example-projects.rst
diff --git a/doc/source/ref-faq.rst b/framework/docs/source/ref-faq.rst
similarity index 100%
rename from doc/source/ref-faq.rst
rename to framework/docs/source/ref-faq.rst
diff --git a/doc/source/ref-telemetry.md b/framework/docs/source/ref-telemetry.md
similarity index 100%
rename from doc/source/ref-telemetry.md
rename to framework/docs/source/ref-telemetry.md
diff --git a/doc/source/tutorial-quickstart-android.rst b/framework/docs/source/tutorial-quickstart-android.rst
similarity index 100%
rename from doc/source/tutorial-quickstart-android.rst
rename to framework/docs/source/tutorial-quickstart-android.rst
diff --git a/doc/source/tutorial-quickstart-fastai.rst b/framework/docs/source/tutorial-quickstart-fastai.rst
similarity index 100%
rename from doc/source/tutorial-quickstart-fastai.rst
rename to framework/docs/source/tutorial-quickstart-fastai.rst
diff --git a/doc/source/tutorial-quickstart-huggingface.rst b/framework/docs/source/tutorial-quickstart-huggingface.rst
similarity index 100%
rename from doc/source/tutorial-quickstart-huggingface.rst
rename to framework/docs/source/tutorial-quickstart-huggingface.rst
diff --git a/doc/source/tutorial-quickstart-ios.rst b/framework/docs/source/tutorial-quickstart-ios.rst
similarity index 100%
rename from doc/source/tutorial-quickstart-ios.rst
rename to framework/docs/source/tutorial-quickstart-ios.rst
diff --git a/doc/source/tutorial-quickstart-jax.rst b/framework/docs/source/tutorial-quickstart-jax.rst
similarity index 100%
rename from doc/source/tutorial-quickstart-jax.rst
rename to framework/docs/source/tutorial-quickstart-jax.rst
diff --git a/doc/source/tutorial-quickstart-mlx.rst b/framework/docs/source/tutorial-quickstart-mlx.rst
similarity index 100%
rename from doc/source/tutorial-quickstart-mlx.rst
rename to framework/docs/source/tutorial-quickstart-mlx.rst
diff --git a/doc/source/tutorial-quickstart-pandas.rst b/framework/docs/source/tutorial-quickstart-pandas.rst
similarity index 100%
rename from doc/source/tutorial-quickstart-pandas.rst
rename to framework/docs/source/tutorial-quickstart-pandas.rst
diff --git a/doc/source/tutorial-quickstart-pytorch-lightning.rst b/framework/docs/source/tutorial-quickstart-pytorch-lightning.rst
similarity index 100%
rename from doc/source/tutorial-quickstart-pytorch-lightning.rst
rename to framework/docs/source/tutorial-quickstart-pytorch-lightning.rst
diff --git a/doc/source/tutorial-quickstart-pytorch.rst b/framework/docs/source/tutorial-quickstart-pytorch.rst
similarity index 100%
rename from doc/source/tutorial-quickstart-pytorch.rst
rename to framework/docs/source/tutorial-quickstart-pytorch.rst
diff --git a/doc/source/tutorial-quickstart-scikitlearn.rst b/framework/docs/source/tutorial-quickstart-scikitlearn.rst
similarity index 100%
rename from doc/source/tutorial-quickstart-scikitlearn.rst
rename to framework/docs/source/tutorial-quickstart-scikitlearn.rst
diff --git a/doc/source/tutorial-quickstart-tensorflow.rst b/framework/docs/source/tutorial-quickstart-tensorflow.rst
similarity index 100%
rename from doc/source/tutorial-quickstart-tensorflow.rst
rename to framework/docs/source/tutorial-quickstart-tensorflow.rst
diff --git a/doc/source/tutorial-quickstart-xgboost.rst b/framework/docs/source/tutorial-quickstart-xgboost.rst
similarity index 100%
rename from doc/source/tutorial-quickstart-xgboost.rst
rename to framework/docs/source/tutorial-quickstart-xgboost.rst
diff --git a/doc/source/tutorial-series-build-a-strategy-from-scratch-pytorch.ipynb b/framework/docs/source/tutorial-series-build-a-strategy-from-scratch-pytorch.ipynb
similarity index 100%
rename from doc/source/tutorial-series-build-a-strategy-from-scratch-pytorch.ipynb
rename to framework/docs/source/tutorial-series-build-a-strategy-from-scratch-pytorch.ipynb
diff --git a/doc/source/tutorial-series-customize-the-client-pytorch.ipynb b/framework/docs/source/tutorial-series-customize-the-client-pytorch.ipynb
similarity index 100%
rename from doc/source/tutorial-series-customize-the-client-pytorch.ipynb
rename to framework/docs/source/tutorial-series-customize-the-client-pytorch.ipynb
diff --git a/doc/source/tutorial-series-get-started-with-flower-pytorch.ipynb b/framework/docs/source/tutorial-series-get-started-with-flower-pytorch.ipynb
similarity index 100%
rename from doc/source/tutorial-series-get-started-with-flower-pytorch.ipynb
rename to framework/docs/source/tutorial-series-get-started-with-flower-pytorch.ipynb
diff --git a/doc/source/tutorial-series-use-a-federated-learning-strategy-pytorch.ipynb b/framework/docs/source/tutorial-series-use-a-federated-learning-strategy-pytorch.ipynb
similarity index 100%
rename from doc/source/tutorial-series-use-a-federated-learning-strategy-pytorch.ipynb
rename to framework/docs/source/tutorial-series-use-a-federated-learning-strategy-pytorch.ipynb
diff --git a/doc/source/tutorial-series-what-is-federated-learning.ipynb b/framework/docs/source/tutorial-series-what-is-federated-learning.ipynb
similarity index 100%
rename from doc/source/tutorial-series-what-is-federated-learning.ipynb
rename to framework/docs/source/tutorial-series-what-is-federated-learning.ipynb
diff --git a/pyproject.toml b/pyproject.toml
index f1207a94c448..1636010a471e 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -144,10 +144,10 @@ docsig = "==0.64.0"
 
 [tool.docstrfmt]
 extend_exclude = [
-    "doc/source/conf.py",
-    "doc/source/tutorial-quickstart-huggingface.rst",
-    "doc/source/_templates/autosummary/*",
-    "doc/source/ref-api/*",
+    "framework/docs/source/conf.py",
+    "framework/docs/source/tutorial-quickstart-huggingface.rst",
+    "framework/docs/source/_templates/autosummary/*",
+    "framework/docs/source/ref-api/*",
 ]
 
 [tool.isort]

From a7a61d500555ddd8c43a82f8e0d715507d50ab21 Mon Sep 17 00:00:00 2001
From: Daniel Nata Nugraha <daniel.nata@flower.dev>
Date: Mon, 9 Dec 2024 13:20:18 +0000
Subject: [PATCH 032/104] feat(framework) Add flwr login protos (#4244)

Co-authored-by: Heng Pan <pan@flower.ai>
---
 src/proto/flwr/proto/exec.proto        | 14 +++++
 src/py/flwr/proto/exec_pb2.py          | 34 ++++++++---
 src/py/flwr/proto/exec_pb2.pyi         | 81 ++++++++++++++++++++++++++
 src/py/flwr/proto/exec_pb2_grpc.py     | 68 +++++++++++++++++++++
 src/py/flwr/proto/exec_pb2_grpc.pyi    | 26 +++++++++
 src/py/flwr/superexec/exec_servicer.py | 18 ++++++
 6 files changed, 234 insertions(+), 7 deletions(-)

diff --git a/src/proto/flwr/proto/exec.proto b/src/proto/flwr/proto/exec.proto
index 6fb2bec9f0a3..851275c8ff0f 100644
--- a/src/proto/flwr/proto/exec.proto
+++ b/src/proto/flwr/proto/exec.proto
@@ -34,6 +34,13 @@ service Exec {
 
   // flwr ls command
   rpc ListRuns(ListRunsRequest) returns (ListRunsResponse) {}
+
+  // Get login details upon request
+  rpc GetLoginDetails(GetLoginDetailsRequest)
+      returns (GetLoginDetailsResponse) {}
+
+  // Get auth tokens upon request
+  rpc GetAuthTokens(GetAuthTokensRequest) returns (GetAuthTokensResponse) {}
 }
 
 message StartRunRequest {
@@ -55,5 +62,12 @@ message ListRunsResponse {
   map<uint64, Run> run_dict = 1;
   string now = 2;
 }
+
+message GetLoginDetailsRequest {}
+message GetLoginDetailsResponse { map<string, string> login_details = 1; }
+
+message GetAuthTokensRequest { map<string, string> auth_details = 1; }
+message GetAuthTokensResponse { map<string, string> auth_tokens = 1; }
+
 message StopRunRequest { uint64 run_id = 1; }
 message StopRunResponse { bool success = 1; }
diff --git a/src/py/flwr/proto/exec_pb2.py b/src/py/flwr/proto/exec_pb2.py
index 18253dd1d02a..d3c508a8c6d9 100644
--- a/src/py/flwr/proto/exec_pb2.py
+++ b/src/py/flwr/proto/exec_pb2.py
@@ -18,7 +18,7 @@
 from flwr.proto import run_pb2 as flwr_dot_proto_dot_run__pb2
 
 
-DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x15\x66lwr/proto/exec.proto\x12\nflwr.proto\x1a\x14\x66lwr/proto/fab.proto\x1a\x1a\x66lwr/proto/transport.proto\x1a\x1a\x66lwr/proto/recordset.proto\x1a\x14\x66lwr/proto/run.proto\"\xfb\x01\n\x0fStartRunRequest\x12\x1c\n\x03\x66\x61\x62\x18\x01 \x01(\x0b\x32\x0f.flwr.proto.Fab\x12H\n\x0foverride_config\x18\x02 \x03(\x0b\x32/.flwr.proto.StartRunRequest.OverrideConfigEntry\x12\x35\n\x12\x66\x65\x64\x65ration_options\x18\x03 \x01(\x0b\x32\x19.flwr.proto.ConfigsRecord\x1aI\n\x13OverrideConfigEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12!\n\x05value\x18\x02 \x01(\x0b\x32\x12.flwr.proto.Scalar:\x02\x38\x01\"2\n\x10StartRunResponse\x12\x13\n\x06run_id\x18\x01 \x01(\x04H\x00\x88\x01\x01\x42\t\n\x07_run_id\"<\n\x11StreamLogsRequest\x12\x0e\n\x06run_id\x18\x01 \x01(\x04\x12\x17\n\x0f\x61\x66ter_timestamp\x18\x02 \x01(\x01\"B\n\x12StreamLogsResponse\x12\x12\n\nlog_output\x18\x01 \x01(\t\x12\x18\n\x10latest_timestamp\x18\x02 \x01(\x01\"1\n\x0fListRunsRequest\x12\x13\n\x06run_id\x18\x01 \x01(\x04H\x00\x88\x01\x01\x42\t\n\x07_run_id\"\x9d\x01\n\x10ListRunsResponse\x12;\n\x08run_dict\x18\x01 \x03(\x0b\x32).flwr.proto.ListRunsResponse.RunDictEntry\x12\x0b\n\x03now\x18\x02 \x01(\t\x1a?\n\x0cRunDictEntry\x12\x0b\n\x03key\x18\x01 \x01(\x04\x12\x1e\n\x05value\x18\x02 \x01(\x0b\x32\x0f.flwr.proto.Run:\x02\x38\x01\" \n\x0eStopRunRequest\x12\x0e\n\x06run_id\x18\x01 \x01(\x04\"\"\n\x0fStopRunResponse\x12\x0f\n\x07success\x18\x01 \x01(\x08\x32\xaf\x02\n\x04\x45xec\x12G\n\x08StartRun\x12\x1b.flwr.proto.StartRunRequest\x1a\x1c.flwr.proto.StartRunResponse\"\x00\x12\x44\n\x07StopRun\x12\x1a.flwr.proto.StopRunRequest\x1a\x1b.flwr.proto.StopRunResponse\"\x00\x12O\n\nStreamLogs\x12\x1d.flwr.proto.StreamLogsRequest\x1a\x1e.flwr.proto.StreamLogsResponse\"\x00\x30\x01\x12G\n\x08ListRuns\x12\x1b.flwr.proto.ListRunsRequest\x1a\x1c.flwr.proto.ListRunsResponse\"\x00\x62\x06proto3')
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x15\x66lwr/proto/exec.proto\x12\nflwr.proto\x1a\x14\x66lwr/proto/fab.proto\x1a\x1a\x66lwr/proto/transport.proto\x1a\x1a\x66lwr/proto/recordset.proto\x1a\x14\x66lwr/proto/run.proto\"\xfb\x01\n\x0fStartRunRequest\x12\x1c\n\x03\x66\x61\x62\x18\x01 \x01(\x0b\x32\x0f.flwr.proto.Fab\x12H\n\x0foverride_config\x18\x02 \x03(\x0b\x32/.flwr.proto.StartRunRequest.OverrideConfigEntry\x12\x35\n\x12\x66\x65\x64\x65ration_options\x18\x03 \x01(\x0b\x32\x19.flwr.proto.ConfigsRecord\x1aI\n\x13OverrideConfigEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12!\n\x05value\x18\x02 \x01(\x0b\x32\x12.flwr.proto.Scalar:\x02\x38\x01\"2\n\x10StartRunResponse\x12\x13\n\x06run_id\x18\x01 \x01(\x04H\x00\x88\x01\x01\x42\t\n\x07_run_id\"<\n\x11StreamLogsRequest\x12\x0e\n\x06run_id\x18\x01 \x01(\x04\x12\x17\n\x0f\x61\x66ter_timestamp\x18\x02 \x01(\x01\"B\n\x12StreamLogsResponse\x12\x12\n\nlog_output\x18\x01 \x01(\t\x12\x18\n\x10latest_timestamp\x18\x02 \x01(\x01\"1\n\x0fListRunsRequest\x12\x13\n\x06run_id\x18\x01 \x01(\x04H\x00\x88\x01\x01\x42\t\n\x07_run_id\"\x9d\x01\n\x10ListRunsResponse\x12;\n\x08run_dict\x18\x01 \x03(\x0b\x32).flwr.proto.ListRunsResponse.RunDictEntry\x12\x0b\n\x03now\x18\x02 \x01(\t\x1a?\n\x0cRunDictEntry\x12\x0b\n\x03key\x18\x01 \x01(\x04\x12\x1e\n\x05value\x18\x02 \x01(\x0b\x32\x0f.flwr.proto.Run:\x02\x38\x01\"\x18\n\x16GetLoginDetailsRequest\"\x9c\x01\n\x17GetLoginDetailsResponse\x12L\n\rlogin_details\x18\x01 \x03(\x0b\x32\x35.flwr.proto.GetLoginDetailsResponse.LoginDetailsEntry\x1a\x33\n\x11LoginDetailsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"\x93\x01\n\x14GetAuthTokensRequest\x12G\n\x0c\x61uth_details\x18\x01 \x03(\x0b\x32\x31.flwr.proto.GetAuthTokensRequest.AuthDetailsEntry\x1a\x32\n\x10\x41uthDetailsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"\x92\x01\n\x15GetAuthTokensResponse\x12\x46\n\x0b\x61uth_tokens\x18\x01 \x03(\x0b\x32\x31.flwr.proto.GetAuthTokensResponse.AuthTokensEntry\x1a\x31\n\x0f\x41uthTokensEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\" \n\x0eStopRunRequest\x12\x0e\n\x06run_id\x18\x01 \x01(\x04\"\"\n\x0fStopRunResponse\x12\x0f\n\x07success\x18\x01 \x01(\x08\x32\xe5\x03\n\x04\x45xec\x12G\n\x08StartRun\x12\x1b.flwr.proto.StartRunRequest\x1a\x1c.flwr.proto.StartRunResponse\"\x00\x12\x44\n\x07StopRun\x12\x1a.flwr.proto.StopRunRequest\x1a\x1b.flwr.proto.StopRunResponse\"\x00\x12O\n\nStreamLogs\x12\x1d.flwr.proto.StreamLogsRequest\x1a\x1e.flwr.proto.StreamLogsResponse\"\x00\x30\x01\x12G\n\x08ListRuns\x12\x1b.flwr.proto.ListRunsRequest\x1a\x1c.flwr.proto.ListRunsResponse\"\x00\x12\\\n\x0fGetLoginDetails\x12\".flwr.proto.GetLoginDetailsRequest\x1a#.flwr.proto.GetLoginDetailsResponse\"\x00\x12V\n\rGetAuthTokens\x12 .flwr.proto.GetAuthTokensRequest\x1a!.flwr.proto.GetAuthTokensResponse\"\x00\x62\x06proto3')
 
 _globals = globals()
 _builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
@@ -29,6 +29,12 @@
   _globals['_STARTRUNREQUEST_OVERRIDECONFIGENTRY']._serialized_options = b'8\001'
   _globals['_LISTRUNSRESPONSE_RUNDICTENTRY']._options = None
   _globals['_LISTRUNSRESPONSE_RUNDICTENTRY']._serialized_options = b'8\001'
+  _globals['_GETLOGINDETAILSRESPONSE_LOGINDETAILSENTRY']._options = None
+  _globals['_GETLOGINDETAILSRESPONSE_LOGINDETAILSENTRY']._serialized_options = b'8\001'
+  _globals['_GETAUTHTOKENSREQUEST_AUTHDETAILSENTRY']._options = None
+  _globals['_GETAUTHTOKENSREQUEST_AUTHDETAILSENTRY']._serialized_options = b'8\001'
+  _globals['_GETAUTHTOKENSRESPONSE_AUTHTOKENSENTRY']._options = None
+  _globals['_GETAUTHTOKENSRESPONSE_AUTHTOKENSENTRY']._serialized_options = b'8\001'
   _globals['_STARTRUNREQUEST']._serialized_start=138
   _globals['_STARTRUNREQUEST']._serialized_end=389
   _globals['_STARTRUNREQUEST_OVERRIDECONFIGENTRY']._serialized_start=316
@@ -45,10 +51,24 @@
   _globals['_LISTRUNSRESPONSE']._serialized_end=782
   _globals['_LISTRUNSRESPONSE_RUNDICTENTRY']._serialized_start=719
   _globals['_LISTRUNSRESPONSE_RUNDICTENTRY']._serialized_end=782
-  _globals['_STOPRUNREQUEST']._serialized_start=784
-  _globals['_STOPRUNREQUEST']._serialized_end=816
-  _globals['_STOPRUNRESPONSE']._serialized_start=818
-  _globals['_STOPRUNRESPONSE']._serialized_end=852
-  _globals['_EXEC']._serialized_start=855
-  _globals['_EXEC']._serialized_end=1158
+  _globals['_GETLOGINDETAILSREQUEST']._serialized_start=784
+  _globals['_GETLOGINDETAILSREQUEST']._serialized_end=808
+  _globals['_GETLOGINDETAILSRESPONSE']._serialized_start=811
+  _globals['_GETLOGINDETAILSRESPONSE']._serialized_end=967
+  _globals['_GETLOGINDETAILSRESPONSE_LOGINDETAILSENTRY']._serialized_start=916
+  _globals['_GETLOGINDETAILSRESPONSE_LOGINDETAILSENTRY']._serialized_end=967
+  _globals['_GETAUTHTOKENSREQUEST']._serialized_start=970
+  _globals['_GETAUTHTOKENSREQUEST']._serialized_end=1117
+  _globals['_GETAUTHTOKENSREQUEST_AUTHDETAILSENTRY']._serialized_start=1067
+  _globals['_GETAUTHTOKENSREQUEST_AUTHDETAILSENTRY']._serialized_end=1117
+  _globals['_GETAUTHTOKENSRESPONSE']._serialized_start=1120
+  _globals['_GETAUTHTOKENSRESPONSE']._serialized_end=1266
+  _globals['_GETAUTHTOKENSRESPONSE_AUTHTOKENSENTRY']._serialized_start=1217
+  _globals['_GETAUTHTOKENSRESPONSE_AUTHTOKENSENTRY']._serialized_end=1266
+  _globals['_STOPRUNREQUEST']._serialized_start=1268
+  _globals['_STOPRUNREQUEST']._serialized_end=1300
+  _globals['_STOPRUNRESPONSE']._serialized_start=1302
+  _globals['_STOPRUNRESPONSE']._serialized_end=1336
+  _globals['_EXEC']._serialized_start=1339
+  _globals['_EXEC']._serialized_end=1824
 # @@protoc_insertion_point(module_scope)
diff --git a/src/py/flwr/proto/exec_pb2.pyi b/src/py/flwr/proto/exec_pb2.pyi
index 70ff9147e02a..d77aa26e1aa0 100644
--- a/src/py/flwr/proto/exec_pb2.pyi
+++ b/src/py/flwr/proto/exec_pb2.pyi
@@ -135,6 +135,87 @@ class ListRunsResponse(google.protobuf.message.Message):
     def ClearField(self, field_name: typing_extensions.Literal["now",b"now","run_dict",b"run_dict"]) -> None: ...
 global___ListRunsResponse = ListRunsResponse
 
+class GetLoginDetailsRequest(google.protobuf.message.Message):
+    DESCRIPTOR: google.protobuf.descriptor.Descriptor
+    def __init__(self,
+        ) -> None: ...
+global___GetLoginDetailsRequest = GetLoginDetailsRequest
+
+class GetLoginDetailsResponse(google.protobuf.message.Message):
+    DESCRIPTOR: google.protobuf.descriptor.Descriptor
+    class LoginDetailsEntry(google.protobuf.message.Message):
+        DESCRIPTOR: google.protobuf.descriptor.Descriptor
+        KEY_FIELD_NUMBER: builtins.int
+        VALUE_FIELD_NUMBER: builtins.int
+        key: typing.Text
+        value: typing.Text
+        def __init__(self,
+            *,
+            key: typing.Text = ...,
+            value: typing.Text = ...,
+            ) -> None: ...
+        def ClearField(self, field_name: typing_extensions.Literal["key",b"key","value",b"value"]) -> None: ...
+
+    LOGIN_DETAILS_FIELD_NUMBER: builtins.int
+    @property
+    def login_details(self) -> google.protobuf.internal.containers.ScalarMap[typing.Text, typing.Text]: ...
+    def __init__(self,
+        *,
+        login_details: typing.Optional[typing.Mapping[typing.Text, typing.Text]] = ...,
+        ) -> None: ...
+    def ClearField(self, field_name: typing_extensions.Literal["login_details",b"login_details"]) -> None: ...
+global___GetLoginDetailsResponse = GetLoginDetailsResponse
+
+class GetAuthTokensRequest(google.protobuf.message.Message):
+    DESCRIPTOR: google.protobuf.descriptor.Descriptor
+    class AuthDetailsEntry(google.protobuf.message.Message):
+        DESCRIPTOR: google.protobuf.descriptor.Descriptor
+        KEY_FIELD_NUMBER: builtins.int
+        VALUE_FIELD_NUMBER: builtins.int
+        key: typing.Text
+        value: typing.Text
+        def __init__(self,
+            *,
+            key: typing.Text = ...,
+            value: typing.Text = ...,
+            ) -> None: ...
+        def ClearField(self, field_name: typing_extensions.Literal["key",b"key","value",b"value"]) -> None: ...
+
+    AUTH_DETAILS_FIELD_NUMBER: builtins.int
+    @property
+    def auth_details(self) -> google.protobuf.internal.containers.ScalarMap[typing.Text, typing.Text]: ...
+    def __init__(self,
+        *,
+        auth_details: typing.Optional[typing.Mapping[typing.Text, typing.Text]] = ...,
+        ) -> None: ...
+    def ClearField(self, field_name: typing_extensions.Literal["auth_details",b"auth_details"]) -> None: ...
+global___GetAuthTokensRequest = GetAuthTokensRequest
+
+class GetAuthTokensResponse(google.protobuf.message.Message):
+    DESCRIPTOR: google.protobuf.descriptor.Descriptor
+    class AuthTokensEntry(google.protobuf.message.Message):
+        DESCRIPTOR: google.protobuf.descriptor.Descriptor
+        KEY_FIELD_NUMBER: builtins.int
+        VALUE_FIELD_NUMBER: builtins.int
+        key: typing.Text
+        value: typing.Text
+        def __init__(self,
+            *,
+            key: typing.Text = ...,
+            value: typing.Text = ...,
+            ) -> None: ...
+        def ClearField(self, field_name: typing_extensions.Literal["key",b"key","value",b"value"]) -> None: ...
+
+    AUTH_TOKENS_FIELD_NUMBER: builtins.int
+    @property
+    def auth_tokens(self) -> google.protobuf.internal.containers.ScalarMap[typing.Text, typing.Text]: ...
+    def __init__(self,
+        *,
+        auth_tokens: typing.Optional[typing.Mapping[typing.Text, typing.Text]] = ...,
+        ) -> None: ...
+    def ClearField(self, field_name: typing_extensions.Literal["auth_tokens",b"auth_tokens"]) -> None: ...
+global___GetAuthTokensResponse = GetAuthTokensResponse
+
 class StopRunRequest(google.protobuf.message.Message):
     DESCRIPTOR: google.protobuf.descriptor.Descriptor
     RUN_ID_FIELD_NUMBER: builtins.int
diff --git a/src/py/flwr/proto/exec_pb2_grpc.py b/src/py/flwr/proto/exec_pb2_grpc.py
index 9ce04915771d..d3b670206520 100644
--- a/src/py/flwr/proto/exec_pb2_grpc.py
+++ b/src/py/flwr/proto/exec_pb2_grpc.py
@@ -34,6 +34,16 @@ def __init__(self, channel):
                 request_serializer=flwr_dot_proto_dot_exec__pb2.ListRunsRequest.SerializeToString,
                 response_deserializer=flwr_dot_proto_dot_exec__pb2.ListRunsResponse.FromString,
                 )
+        self.GetLoginDetails = channel.unary_unary(
+                '/flwr.proto.Exec/GetLoginDetails',
+                request_serializer=flwr_dot_proto_dot_exec__pb2.GetLoginDetailsRequest.SerializeToString,
+                response_deserializer=flwr_dot_proto_dot_exec__pb2.GetLoginDetailsResponse.FromString,
+                )
+        self.GetAuthTokens = channel.unary_unary(
+                '/flwr.proto.Exec/GetAuthTokens',
+                request_serializer=flwr_dot_proto_dot_exec__pb2.GetAuthTokensRequest.SerializeToString,
+                response_deserializer=flwr_dot_proto_dot_exec__pb2.GetAuthTokensResponse.FromString,
+                )
 
 
 class ExecServicer(object):
@@ -67,6 +77,20 @@ def ListRuns(self, request, context):
         context.set_details('Method not implemented!')
         raise NotImplementedError('Method not implemented!')
 
+    def GetLoginDetails(self, request, context):
+        """Get login details upon request
+        """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details('Method not implemented!')
+        raise NotImplementedError('Method not implemented!')
+
+    def GetAuthTokens(self, request, context):
+        """Get auth tokens upon request
+        """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details('Method not implemented!')
+        raise NotImplementedError('Method not implemented!')
+
 
 def add_ExecServicer_to_server(servicer, server):
     rpc_method_handlers = {
@@ -90,6 +114,16 @@ def add_ExecServicer_to_server(servicer, server):
                     request_deserializer=flwr_dot_proto_dot_exec__pb2.ListRunsRequest.FromString,
                     response_serializer=flwr_dot_proto_dot_exec__pb2.ListRunsResponse.SerializeToString,
             ),
+            'GetLoginDetails': grpc.unary_unary_rpc_method_handler(
+                    servicer.GetLoginDetails,
+                    request_deserializer=flwr_dot_proto_dot_exec__pb2.GetLoginDetailsRequest.FromString,
+                    response_serializer=flwr_dot_proto_dot_exec__pb2.GetLoginDetailsResponse.SerializeToString,
+            ),
+            'GetAuthTokens': grpc.unary_unary_rpc_method_handler(
+                    servicer.GetAuthTokens,
+                    request_deserializer=flwr_dot_proto_dot_exec__pb2.GetAuthTokensRequest.FromString,
+                    response_serializer=flwr_dot_proto_dot_exec__pb2.GetAuthTokensResponse.SerializeToString,
+            ),
     }
     generic_handler = grpc.method_handlers_generic_handler(
             'flwr.proto.Exec', rpc_method_handlers)
@@ -167,3 +201,37 @@ def ListRuns(request,
             flwr_dot_proto_dot_exec__pb2.ListRunsResponse.FromString,
             options, channel_credentials,
             insecure, call_credentials, compression, wait_for_ready, timeout, metadata)
+
+    @staticmethod
+    def GetLoginDetails(request,
+            target,
+            options=(),
+            channel_credentials=None,
+            call_credentials=None,
+            insecure=False,
+            compression=None,
+            wait_for_ready=None,
+            timeout=None,
+            metadata=None):
+        return grpc.experimental.unary_unary(request, target, '/flwr.proto.Exec/GetLoginDetails',
+            flwr_dot_proto_dot_exec__pb2.GetLoginDetailsRequest.SerializeToString,
+            flwr_dot_proto_dot_exec__pb2.GetLoginDetailsResponse.FromString,
+            options, channel_credentials,
+            insecure, call_credentials, compression, wait_for_ready, timeout, metadata)
+
+    @staticmethod
+    def GetAuthTokens(request,
+            target,
+            options=(),
+            channel_credentials=None,
+            call_credentials=None,
+            insecure=False,
+            compression=None,
+            wait_for_ready=None,
+            timeout=None,
+            metadata=None):
+        return grpc.experimental.unary_unary(request, target, '/flwr.proto.Exec/GetAuthTokens',
+            flwr_dot_proto_dot_exec__pb2.GetAuthTokensRequest.SerializeToString,
+            flwr_dot_proto_dot_exec__pb2.GetAuthTokensResponse.FromString,
+            options, channel_credentials,
+            insecure, call_credentials, compression, wait_for_ready, timeout, metadata)
diff --git a/src/py/flwr/proto/exec_pb2_grpc.pyi b/src/py/flwr/proto/exec_pb2_grpc.pyi
index 12f42befab06..9e7aa3866cee 100644
--- a/src/py/flwr/proto/exec_pb2_grpc.pyi
+++ b/src/py/flwr/proto/exec_pb2_grpc.pyi
@@ -29,6 +29,16 @@ class ExecStub:
         flwr.proto.exec_pb2.ListRunsResponse]
     """flwr ls command"""
 
+    GetLoginDetails: grpc.UnaryUnaryMultiCallable[
+        flwr.proto.exec_pb2.GetLoginDetailsRequest,
+        flwr.proto.exec_pb2.GetLoginDetailsResponse]
+    """Get login details upon request"""
+
+    GetAuthTokens: grpc.UnaryUnaryMultiCallable[
+        flwr.proto.exec_pb2.GetAuthTokensRequest,
+        flwr.proto.exec_pb2.GetAuthTokensResponse]
+    """Get auth tokens upon request"""
+
 
 class ExecServicer(metaclass=abc.ABCMeta):
     @abc.abstractmethod
@@ -63,5 +73,21 @@ class ExecServicer(metaclass=abc.ABCMeta):
         """flwr ls command"""
         pass
 
+    @abc.abstractmethod
+    def GetLoginDetails(self,
+        request: flwr.proto.exec_pb2.GetLoginDetailsRequest,
+        context: grpc.ServicerContext,
+    ) -> flwr.proto.exec_pb2.GetLoginDetailsResponse:
+        """Get login details upon request"""
+        pass
+
+    @abc.abstractmethod
+    def GetAuthTokens(self,
+        request: flwr.proto.exec_pb2.GetAuthTokensRequest,
+        context: grpc.ServicerContext,
+    ) -> flwr.proto.exec_pb2.GetAuthTokensResponse:
+        """Get auth tokens upon request"""
+        pass
+
 
 def add_ExecServicer_to_server(servicer: ExecServicer, server: grpc.Server) -> None: ...
diff --git a/src/py/flwr/superexec/exec_servicer.py b/src/py/flwr/superexec/exec_servicer.py
index 700c6bf40708..a320a4896a12 100644
--- a/src/py/flwr/superexec/exec_servicer.py
+++ b/src/py/flwr/superexec/exec_servicer.py
@@ -33,6 +33,10 @@
 from flwr.common.typing import RunStatus
 from flwr.proto import exec_pb2_grpc  # pylint: disable=E0611
 from flwr.proto.exec_pb2 import (  # pylint: disable=E0611
+    GetAuthTokensRequest,
+    GetAuthTokensResponse,
+    GetLoginDetailsRequest,
+    GetLoginDetailsResponse,
     ListRunsRequest,
     ListRunsResponse,
     StartRunRequest,
@@ -155,6 +159,20 @@ def StopRun(
         )
         return StopRunResponse(success=update_success)
 
+    def GetLoginDetails(
+        self, request: GetLoginDetailsRequest, context: grpc.ServicerContext
+    ) -> GetLoginDetailsResponse:
+        """Start login."""
+        log(INFO, "ExecServicer.GetLoginDetails")
+        return GetLoginDetailsResponse(login_details={})
+
+    def GetAuthTokens(
+        self, request: GetAuthTokensRequest, context: grpc.ServicerContext
+    ) -> GetAuthTokensResponse:
+        """Get auth token."""
+        log(INFO, "ExecServicer.GetAuthTokens")
+        return GetAuthTokensResponse(auth_tokens={})
+
 
 def _create_list_runs_response(run_ids: set[int], state: LinkState) -> ListRunsResponse:
     """Create response for `flwr ls --runs` and `flwr ls --run-id <run_id>`."""

From 0730b12a9e9653782c7ee1777c4382f50380217a Mon Sep 17 00:00:00 2001
From: Charles Beauville <charles@flower.ai>
Date: Mon, 9 Dec 2024 08:35:20 -0800
Subject: [PATCH 033/104] docs(framework) Fix versioned script with new path
 (#4659)

---
 framework/docs/build-versioned-docs.sh | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/framework/docs/build-versioned-docs.sh b/framework/docs/build-versioned-docs.sh
index db7e766b4f83..803b883d8b69 100755
--- a/framework/docs/build-versioned-docs.sh
+++ b/framework/docs/build-versioned-docs.sh
@@ -8,14 +8,14 @@ current_branch=$(git rev-parse --abbrev-ref HEAD)
 cd $(git rev-parse --show-toplevel)
 
 # Clean up previous builds
-rm -rf doc/build
+rm -rf framework/docs/build
 
 # Create a temporary directory and store locales and _templates files in it
 tmp_dir=`mktemp -d`
-cp -r doc/locales ${tmp_dir}/locales
-cp -r doc/source/_templates ${tmp_dir}/_templates
+cp -r framework/docs/locales ${tmp_dir}/locales
+cp -r framework/docs/source/_templates ${tmp_dir}/_templates
 
-cd doc
+cd framework/docs
 
 # Get a list of languages based on the folders in locales
 languages="en `find locales/ -mindepth 1 -maxdepth 1 -type d -exec basename '{}' \;`"

From d7004b80de988a3fb2258067763ec78009326c33 Mon Sep 17 00:00:00 2001
From: Charles Beauville <charles@flower.ai>
Date: Tue, 10 Dec 2024 00:15:53 -0800
Subject: [PATCH 034/104] docs(framework) Update path dynamically for versioned
 script (#4661)

---
 .github/CODEOWNERS                     |  4 ++--
 framework/docs/build-versioned-docs.sh | 10 +++++++---
 2 files changed, 9 insertions(+), 5 deletions(-)

diff --git a/.github/CODEOWNERS b/.github/CODEOWNERS
index 8c635c516450..7519f227af81 100644
--- a/.github/CODEOWNERS
+++ b/.github/CODEOWNERS
@@ -22,10 +22,10 @@ README.md @jafermarq @tanertopal @danieljanes
 /src/py/flwr/cli/new/templates @jafermarq @tanertopal @danieljanes
 
 # Changelog
-/doc/source/ref-changelog.md @jafermarq @tanertopal @danieljanes
+/framework/docs/source/ref-changelog.md @jafermarq @tanertopal @danieljanes
 
 # Translations
-/doc/locales @charlesbvll @tanertopal @danieljanes
+/framework/docs/locales @charlesbvll @tanertopal @danieljanes
 
 # GitHub Actions and Workflows
 /.github/workflows @Robert-Steiner @tanertopal @danieljanes
diff --git a/framework/docs/build-versioned-docs.sh b/framework/docs/build-versioned-docs.sh
index 803b883d8b69..2ff8db5a6312 100755
--- a/framework/docs/build-versioned-docs.sh
+++ b/framework/docs/build-versioned-docs.sh
@@ -15,8 +15,6 @@ tmp_dir=`mktemp -d`
 cp -r framework/docs/locales ${tmp_dir}/locales
 cp -r framework/docs/source/_templates ${tmp_dir}/_templates
 
-cd framework/docs
-
 # Get a list of languages based on the folders in locales
 languages="en `find locales/ -mindepth 1 -maxdepth 1 -type d -exec basename '{}' \;`"
 # Get a list of tags, excluding those before v1.0.0
@@ -46,7 +44,13 @@ for current_version in ${versions}; do
     pip install "numpy==${numpy_version_2}"
   fi
   echo "INFO: Building sites for ${current_version}"
- 
+
+  if [ -d "framework/docs" ]; then
+    cd framework/docs
+  else
+    cd doc
+  fi
+
   for current_language in ${languages}; do
 
     # Make the current language available to conf.py

From 1b43ac77d3216cfc73ae9de8a64e8bddaca6d56c Mon Sep 17 00:00:00 2001
From: Daniel Nata Nugraha <daniel.nata@flower.dev>
Date: Tue, 10 Dec 2024 14:06:48 +0000
Subject: [PATCH 035/104] feat(framework) Add abstract user auth plugin (#4618)

Co-authored-by: Heng Pan <pan@flower.ai>
---
 src/py/flwr/common/auth_plugin/__init__.py    |  24 ++++
 src/py/flwr/common/auth_plugin/auth_plugin.py | 111 ++++++++++++++++++
 2 files changed, 135 insertions(+)
 create mode 100644 src/py/flwr/common/auth_plugin/__init__.py
 create mode 100644 src/py/flwr/common/auth_plugin/auth_plugin.py

diff --git a/src/py/flwr/common/auth_plugin/__init__.py b/src/py/flwr/common/auth_plugin/__init__.py
new file mode 100644
index 000000000000..1a90dd5fe762
--- /dev/null
+++ b/src/py/flwr/common/auth_plugin/__init__.py
@@ -0,0 +1,24 @@
+# Copyright 2024 Flower Labs GmbH. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# ==============================================================================
+"""Auth plugin components."""
+
+
+from .auth_plugin import CliAuthPlugin as CliAuthPlugin
+from .auth_plugin import ExecAuthPlugin as ExecAuthPlugin
+
+__all__ = [
+    "CliAuthPlugin",
+    "ExecAuthPlugin",
+]
diff --git a/src/py/flwr/common/auth_plugin/auth_plugin.py b/src/py/flwr/common/auth_plugin/auth_plugin.py
new file mode 100644
index 000000000000..c9dc7a921623
--- /dev/null
+++ b/src/py/flwr/common/auth_plugin/auth_plugin.py
@@ -0,0 +1,111 @@
+# Copyright 2024 Flower Labs GmbH. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# ==============================================================================
+"""Abstract classes for Flower User Auth Plugin."""
+
+
+from abc import ABC, abstractmethod
+from collections.abc import Sequence
+from pathlib import Path
+from typing import Any, Optional, Union
+
+from flwr.proto.exec_pb2_grpc import ExecStub
+
+
+class ExecAuthPlugin(ABC):
+    """Abstract Flower Auth Plugin class for ExecServicer.
+
+    Parameters
+    ----------
+    config : dict[str, Any]
+        The authentication configuration loaded from a YAML file.
+    """
+
+    @abstractmethod
+    def __init__(self, config: dict[str, Any]):
+        """Abstract constructor."""
+
+    @abstractmethod
+    def get_login_details(self) -> dict[str, str]:
+        """Get the login details."""
+
+    @abstractmethod
+    def validate_tokens_in_metadata(
+        self, metadata: Sequence[tuple[str, Union[str, bytes]]]
+    ) -> bool:
+        """Validate authentication tokens in the provided metadata."""
+
+    @abstractmethod
+    def get_auth_tokens(self, auth_details: dict[str, str]) -> dict[str, str]:
+        """Get authentication tokens."""
+
+    @abstractmethod
+    def refresh_tokens(
+        self, metadata: Sequence[tuple[str, Union[str, bytes]]]
+    ) -> Optional[Sequence[tuple[str, Union[str, bytes]]]]:
+        """Refresh authentication tokens in the provided metadata."""
+
+
+class CliAuthPlugin(ABC):
+    """Abstract Flower Auth Plugin class for CLI.
+
+    Parameters
+    ----------
+    user_auth_config_path : Path
+        The path to the user's authentication configuration file.
+    """
+
+    @staticmethod
+    @abstractmethod
+    def login(
+        login_details: dict[str, str],
+        exec_stub: ExecStub,
+    ) -> dict[str, Any]:
+        """Authenticate the user with the SuperLink.
+
+        Parameters
+        ----------
+        login_details : dict[str, str]
+            A dictionary containing the user's login details.
+        exec_stub : ExecStub
+            An instance of `ExecStub` used for communication with the SuperLink.
+
+        Returns
+        -------
+        user_auth_config : dict[str, Any]
+            A dictionary containing the user's authentication configuration
+            in JSON format.
+        """
+
+    @abstractmethod
+    def __init__(self, user_auth_config_path: Path):
+        """Abstract constructor."""
+
+    @abstractmethod
+    def store_tokens(self, user_auth_config: dict[str, Any]) -> None:
+        """Store authentication tokens from the provided user_auth_config.
+
+        The configuration, including tokens, will be saved as a JSON file
+        at `user_auth_config_path`.
+        """
+
+    @abstractmethod
+    def load_tokens(self) -> None:
+        """Load authentication tokens from the user_auth_config_path."""
+
+    @abstractmethod
+    def write_tokens_to_metadata(
+        self, metadata: Sequence[tuple[str, Union[str, bytes]]]
+    ) -> Sequence[tuple[str, Union[str, bytes]]]:
+        """Write authentication tokens to the provided metadata."""

From c955c2767411da28ebb328f03bce74edd3539229 Mon Sep 17 00:00:00 2001
From: Daniel Nata Nugraha <daniel.nata@flower.dev>
Date: Tue, 10 Dec 2024 16:27:55 +0000
Subject: [PATCH 036/104] feat(framework) Add `ExecUserAuthInterceptor` to Exec
 API (#4630)

Co-authored-by: Heng Pan <pan@flower.ai>
Co-authored-by: Javier <jafermarq@users.noreply.github.com>
Co-authored-by: Daniel J. Beutel <daniel@flower.ai>
---
 pyproject.toml                                |   7 +-
 src/py/flwr/common/constant.py                |   2 +
 src/py/flwr/server/app.py                     |  53 ++++++++-
 src/py/flwr/superexec/exec_grpc.py            |  19 +++-
 src/py/flwr/superexec/exec_servicer.py        |  25 ++++-
 .../superexec/exec_user_auth_interceptor.py   | 101 ++++++++++++++++++
 6 files changed, 199 insertions(+), 8 deletions(-)
 create mode 100644 src/py/flwr/superexec/exec_user_auth_interceptor.py

diff --git a/pyproject.toml b/pyproject.toml
index 1636010a471e..b4a5fa13031f 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -78,16 +78,16 @@ tomli = "^2.0.1"
 tomli-w = "^1.0.0"
 pathspec = "^0.12.1"
 rich = "^13.5.0"
+pyyaml = "^6.0.2"
+requests = "^2.31.0"
 # Optional dependencies (Simulation Engine)
 ray = { version = "==2.10.0", optional = true, python = ">=3.9,<3.12" }
-# Optional dependencies (REST transport layer)
-requests = { version = "^2.31.0", optional = true }
 starlette = { version = "^0.31.0", optional = true }
 uvicorn = { version = "^0.23.0", extras = ["standard"], optional = true }
 
 [tool.poetry.extras]
 simulation = ["ray"]
-rest = ["requests", "starlette", "uvicorn"]
+rest = ["starlette", "uvicorn"]
 
 [tool.poetry.group.dev.dependencies]
 types-dataclasses = "==0.6.6"
@@ -131,6 +131,7 @@ mdformat-gfm = "==0.3.6"
 mdformat-frontmatter = "==2.0.1"
 mdformat-beautysh = "==0.1.1"
 twine = "==5.1.1"
+types-PyYAML = "^6.0.2"
 pyroma = "==4.2"
 check-wheel-contents = "==0.4.0"
 GitPython = "==3.1.32"
diff --git a/src/py/flwr/common/constant.py b/src/py/flwr/common/constant.py
index ce5840ddddfb..3dd0657c12bb 100644
--- a/src/py/flwr/common/constant.py
+++ b/src/py/flwr/common/constant.py
@@ -110,6 +110,8 @@
 # Retry configurations
 MAX_RETRY_DELAY = 20  # Maximum delay duration between two consecutive retries.
 
+AUTH_TYPE = "auth_type"
+
 
 class MessageType:
     """Message type."""
diff --git a/src/py/flwr/server/app.py b/src/py/flwr/server/app.py
index 508f2dfc9685..8b5cb316c7fc 100644
--- a/src/py/flwr/server/app.py
+++ b/src/py/flwr/server/app.py
@@ -24,9 +24,10 @@
 from logging import DEBUG, INFO, WARN
 from pathlib import Path
 from time import sleep
-from typing import Optional
+from typing import Any, Optional
 
 import grpc
+import yaml
 from cryptography.exceptions import UnsupportedAlgorithm
 from cryptography.hazmat.primitives.asymmetric import ec
 from cryptography.hazmat.primitives.serialization import (
@@ -37,8 +38,10 @@
 from flwr.common import GRPC_MAX_MESSAGE_LENGTH, EventType, event
 from flwr.common.address import parse_address
 from flwr.common.args import try_obtain_server_certificates
+from flwr.common.auth_plugin import ExecAuthPlugin
 from flwr.common.config import get_flwr_dir, parse_config_args
 from flwr.common.constant import (
+    AUTH_TYPE,
     CLIENT_OCTET,
     EXEC_API_DEFAULT_SERVER_ADDRESS,
     FLEET_API_GRPC_BIDI_DEFAULT_ADDRESS,
@@ -88,6 +91,15 @@
 BASE_DIR = get_flwr_dir() / "superlink" / "ffs"
 
 
+try:
+    from flwr.ee import get_exec_auth_plugins
+except ImportError:
+
+    def get_exec_auth_plugins() -> dict[str, type[ExecAuthPlugin]]:
+        """Return all Exec API authentication plugins."""
+        raise NotImplementedError("No authentication plugins are currently supported.")
+
+
 def start_server(  # pylint: disable=too-many-arguments,too-many-locals
     *,
     server_address: str = FLEET_API_GRPC_BIDI_DEFAULT_ADDRESS,
@@ -246,6 +258,12 @@ def run_superlink() -> None:
     # Obtain certificates
     certificates = try_obtain_server_certificates(args, args.fleet_api_type)
 
+    user_auth_config = _try_obtain_user_auth_config(args)
+    auth_plugin: Optional[ExecAuthPlugin] = None
+    # user_auth_config is None only if the args.user_auth_config is not provided
+    if user_auth_config is not None:
+        auth_plugin = _try_obtain_exec_auth_plugin(user_auth_config)
+
     # Initialize StateFactory
     state_factory = LinkStateFactory(args.database)
 
@@ -263,6 +281,7 @@ def run_superlink() -> None:
         config=parse_config_args(
             [args.executor_config] if args.executor_config else args.executor_config
         ),
+        auth_plugin=auth_plugin,
     )
     grpc_servers = [exec_server]
 
@@ -559,6 +578,32 @@ def _try_setup_node_authentication(
         )
 
 
+def _try_obtain_user_auth_config(args: argparse.Namespace) -> Optional[dict[str, Any]]:
+    if args.user_auth_config is not None:
+        with open(args.user_auth_config, encoding="utf-8") as file:
+            config: dict[str, Any] = yaml.safe_load(file)
+            return config
+    return None
+
+
+def _try_obtain_exec_auth_plugin(config: dict[str, Any]) -> Optional[ExecAuthPlugin]:
+    auth_config: dict[str, Any] = config.get("authentication", {})
+    auth_type: str = auth_config.get(AUTH_TYPE, "")
+    try:
+        all_plugins: dict[str, type[ExecAuthPlugin]] = get_exec_auth_plugins()
+        auth_plugin_class = all_plugins[auth_type]
+        return auth_plugin_class(config=auth_config)
+    except KeyError:
+        if auth_type != "":
+            sys.exit(
+                f'Authentication type "{auth_type}" is not supported. '
+                "Please provide a valid authentication type in the configuration."
+            )
+        sys.exit("No authentication type is provided in the configuration.")
+    except NotImplementedError:
+        sys.exit("No authentication plugins are currently supported.")
+
+
 def _run_fleet_api_grpc_rere(
     address: str,
     state_factory: LinkStateFactory,
@@ -746,6 +791,12 @@ def _add_args_common(parser: argparse.ArgumentParser) -> None:
         type=str,
         help="The SuperLink's public key (as a path str) to enable authentication.",
     )
+    parser.add_argument(
+        "--user-auth-config",
+        help="The path to the user authentication configuration YAML file.",
+        type=str,
+        default=None,
+    )
 
 
 def _add_args_serverappio_api(parser: argparse.ArgumentParser) -> None:
diff --git a/src/py/flwr/superexec/exec_grpc.py b/src/py/flwr/superexec/exec_grpc.py
index f8c9722ba5ac..c6099f909dac 100644
--- a/src/py/flwr/superexec/exec_grpc.py
+++ b/src/py/flwr/superexec/exec_grpc.py
@@ -14,18 +14,21 @@
 # ==============================================================================
 """SuperExec gRPC API."""
 
+from collections.abc import Sequence
 from logging import INFO
 from typing import Optional
 
 import grpc
 
 from flwr.common import GRPC_MAX_MESSAGE_LENGTH
+from flwr.common.auth_plugin import ExecAuthPlugin
 from flwr.common.logger import log
 from flwr.common.typing import UserConfig
 from flwr.proto.exec_pb2_grpc import add_ExecServicer_to_server
 from flwr.server.superlink.ffs.ffs_factory import FfsFactory
 from flwr.server.superlink.fleet.grpc_bidi.grpc_server import generic_create_grpc_server
 from flwr.server.superlink.linkstate import LinkStateFactory
+from flwr.superexec.exec_user_auth_interceptor import ExecUserAuthInterceptor
 
 from .exec_servicer import ExecServicer
 from .executor import Executor
@@ -39,6 +42,7 @@ def run_exec_api_grpc(
     ffs_factory: FfsFactory,
     certificates: Optional[tuple[bytes, bytes, bytes]],
     config: UserConfig,
+    auth_plugin: Optional[ExecAuthPlugin] = None,
 ) -> grpc.Server:
     """Run Exec API (gRPC, request-response)."""
     executor.set_config(config)
@@ -47,16 +51,29 @@ def run_exec_api_grpc(
         linkstate_factory=state_factory,
         ffs_factory=ffs_factory,
         executor=executor,
+        auth_plugin=auth_plugin,
     )
+    interceptors: Optional[Sequence[grpc.ServerInterceptor]] = None
+    if auth_plugin is not None:
+        interceptors = [ExecUserAuthInterceptor(auth_plugin)]
     exec_add_servicer_to_server_fn = add_ExecServicer_to_server
     exec_grpc_server = generic_create_grpc_server(
         servicer_and_add_fn=(exec_servicer, exec_add_servicer_to_server_fn),
         server_address=address,
         max_message_length=GRPC_MAX_MESSAGE_LENGTH,
         certificates=certificates,
+        interceptors=interceptors,
     )
 
-    log(INFO, "Flower Deployment Engine: Starting Exec API on %s", address)
+    if auth_plugin is None:
+        log(INFO, "Flower Deployment Engine: Starting Exec API on %s", address)
+    else:
+        log(
+            INFO,
+            "Flower Deployment Engine: Starting Exec API with user "
+            "authentication on %s",
+            address,
+        )
     exec_grpc_server.start()
 
     return exec_grpc_server
diff --git a/src/py/flwr/superexec/exec_servicer.py b/src/py/flwr/superexec/exec_servicer.py
index a320a4896a12..8ffe2702c386 100644
--- a/src/py/flwr/superexec/exec_servicer.py
+++ b/src/py/flwr/superexec/exec_servicer.py
@@ -18,11 +18,12 @@
 import time
 from collections.abc import Generator
 from logging import ERROR, INFO
-from typing import Any
+from typing import Any, Optional
 
 import grpc
 
 from flwr.common import now
+from flwr.common.auth_plugin import ExecAuthPlugin
 from flwr.common.constant import LOG_STREAM_INTERVAL, Status, SubStatus
 from flwr.common.logger import log
 from flwr.common.serde import (
@@ -60,11 +61,13 @@ def __init__(
         linkstate_factory: LinkStateFactory,
         ffs_factory: FfsFactory,
         executor: Executor,
+        auth_plugin: Optional[ExecAuthPlugin] = None,
     ) -> None:
         self.linkstate_factory = linkstate_factory
         self.ffs_factory = ffs_factory
         self.executor = executor
         self.executor.initialize(linkstate_factory, ffs_factory)
+        self.auth_plugin = auth_plugin
 
     def StartRun(
         self, request: StartRunRequest, context: grpc.ServicerContext
@@ -164,14 +167,30 @@ def GetLoginDetails(
     ) -> GetLoginDetailsResponse:
         """Start login."""
         log(INFO, "ExecServicer.GetLoginDetails")
-        return GetLoginDetailsResponse(login_details={})
+        if self.auth_plugin is None:
+            context.abort(
+                grpc.StatusCode.UNIMPLEMENTED,
+                "ExecServicer initialized without user authentication",
+            )
+            raise grpc.RpcError()  # This line is unreachable
+        return GetLoginDetailsResponse(
+            login_details=self.auth_plugin.get_login_details()
+        )
 
     def GetAuthTokens(
         self, request: GetAuthTokensRequest, context: grpc.ServicerContext
     ) -> GetAuthTokensResponse:
         """Get auth token."""
         log(INFO, "ExecServicer.GetAuthTokens")
-        return GetAuthTokensResponse(auth_tokens={})
+        if self.auth_plugin is None:
+            context.abort(
+                grpc.StatusCode.UNIMPLEMENTED,
+                "ExecServicer initialized without user authentication",
+            )
+            raise grpc.RpcError()  # This line is unreachable
+        return GetAuthTokensResponse(
+            auth_tokens=self.auth_plugin.get_auth_tokens(dict(request.auth_details))
+        )
 
 
 def _create_list_runs_response(run_ids: set[int], state: LinkState) -> ListRunsResponse:
diff --git a/src/py/flwr/superexec/exec_user_auth_interceptor.py b/src/py/flwr/superexec/exec_user_auth_interceptor.py
new file mode 100644
index 000000000000..54c8234a5da8
--- /dev/null
+++ b/src/py/flwr/superexec/exec_user_auth_interceptor.py
@@ -0,0 +1,101 @@
+# Copyright 2024 Flower Labs GmbH. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# ==============================================================================
+"""Flower Exec API interceptor."""
+
+
+from typing import Any, Callable, Union
+
+import grpc
+
+from flwr.common.auth_plugin import ExecAuthPlugin
+from flwr.proto.exec_pb2 import (  # pylint: disable=E0611
+    GetAuthTokensRequest,
+    GetAuthTokensResponse,
+    GetLoginDetailsRequest,
+    GetLoginDetailsResponse,
+    StartRunRequest,
+    StartRunResponse,
+    StreamLogsRequest,
+    StreamLogsResponse,
+)
+
+Request = Union[
+    StartRunRequest,
+    StreamLogsRequest,
+    GetLoginDetailsRequest,
+    GetAuthTokensRequest,
+]
+
+Response = Union[
+    StartRunResponse, StreamLogsResponse, GetLoginDetailsResponse, GetAuthTokensResponse
+]
+
+
+class ExecUserAuthInterceptor(grpc.ServerInterceptor):  # type: ignore
+    """Exec API interceptor for user authentication."""
+
+    def __init__(
+        self,
+        auth_plugin: ExecAuthPlugin,
+    ):
+        self.auth_plugin = auth_plugin
+
+    def intercept_service(
+        self,
+        continuation: Callable[[Any], Any],
+        handler_call_details: grpc.HandlerCallDetails,
+    ) -> grpc.RpcMethodHandler:
+        """Flower server interceptor authentication logic.
+
+        Intercept all unary-unary/unary-stream calls from users and authenticate users
+        by validating auth metadata sent by the user. Continue RPC call if user is
+        authenticated, else, terminate RPC call by setting context to abort.
+        """
+        # One of the method handlers in
+        # `flwr.superexec.exec_servicer.ExecServicer`
+        method_handler: grpc.RpcMethodHandler = continuation(handler_call_details)
+        return self._generic_auth_unary_method_handler(method_handler)
+
+    def _generic_auth_unary_method_handler(
+        self, method_handler: grpc.RpcMethodHandler
+    ) -> grpc.RpcMethodHandler:
+        def _generic_method_handler(
+            request: Request,
+            context: grpc.ServicerContext,
+        ) -> Response:
+            call = method_handler.unary_unary or method_handler.unary_stream
+            metadata = context.invocation_metadata()
+            if isinstance(
+                request, (GetLoginDetailsRequest, GetAuthTokensRequest)
+            ) or self.auth_plugin.validate_tokens_in_metadata(metadata):
+                return call(request, context)  # type: ignore
+
+            tokens = self.auth_plugin.refresh_tokens(context.invocation_metadata())
+            if tokens is not None:
+                context.send_initial_metadata(tokens)
+                return call(request, context)  # type: ignore
+
+            context.abort(grpc.StatusCode.UNAUTHENTICATED, "Access denied")
+            raise grpc.RpcError()  # This line is unreachable
+
+        if method_handler.unary_unary:
+            message_handler = grpc.unary_unary_rpc_method_handler
+        else:
+            message_handler = grpc.unary_stream_rpc_method_handler
+        return message_handler(
+            _generic_method_handler,
+            request_deserializer=method_handler.request_deserializer,
+            response_serializer=method_handler.response_serializer,
+        )

From 21970e07a72bdc3f315cb29530eca8325bd5f7f4 Mon Sep 17 00:00:00 2001
From: "github-actions[bot]"
 <41898282+github-actions[bot]@users.noreply.github.com>
Date: Tue, 10 Dec 2024 19:46:07 +0000
Subject: [PATCH 037/104] Update text and language files (#4656)

Co-authored-by: Charles Beauville <charles@flower.ai>
---
 .../locales/fr/LC_MESSAGES/framework-docs.po  | 89 +++++++++++++++----
 .../locales/ko/LC_MESSAGES/framework-docs.po  | 89 +++++++++++++++----
 .../pt_BR/LC_MESSAGES/framework-docs.po       | 88 ++++++++++++++----
 .../zh_Hans/LC_MESSAGES/framework-docs.po     | 89 +++++++++++++++----
 4 files changed, 279 insertions(+), 76 deletions(-)

diff --git a/framework/docs/locales/fr/LC_MESSAGES/framework-docs.po b/framework/docs/locales/fr/LC_MESSAGES/framework-docs.po
index 94cb3b821cd1..9950f5fc32e0 100644
--- a/framework/docs/locales/fr/LC_MESSAGES/framework-docs.po
+++ b/framework/docs/locales/fr/LC_MESSAGES/framework-docs.po
@@ -3,7 +3,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Flower Docs\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2024-12-08 00:35+0000\n"
+"POT-Creation-Date: 2024-12-09 00:34+0000\n"
 "PO-Revision-Date: 2023-09-05 17:54+0000\n"
 "Last-Translator: Charles Beauville <charles@flower.ai>\n"
 "Language: fr\n"
@@ -9144,7 +9144,7 @@ msgstr ""
 msgid "Arguments"
 msgstr "Amélioration de la documentation"
 
-#: ../../flwr install:1 log:1 ls:1 new:1 run:1
+#: ../../flwr install:1 log:1 ls:1 new:1 run:1 stop:1
 #, fuzzy
 msgid "Optional argument"
 msgstr "Améliorations facultatives"
@@ -9170,7 +9170,7 @@ msgstr "Flux de travail"
 msgid "``True``"
 msgstr ""
 
-#: ../../flwr log:1
+#: ../../flwr log:1 stop:1
 #, fuzzy
 msgid "Required argument"
 msgstr "Amélioration de la documentation"
@@ -9213,12 +9213,12 @@ msgstr ""
 msgid "``'default'``"
 msgstr "Flux de travail"
 
-#: ../../flwr ls:1
+#: ../../flwr ls:1 stop:1
 #, fuzzy
 msgid "Path of the Flower project"
 msgstr "Chargement des données"
 
-#: ../../flwr ls:1
+#: ../../flwr ls:1 stop:1
 msgid "Name of the federation"
 msgstr ""
 
@@ -9287,6 +9287,15 @@ msgstr "Chargement des données"
 msgid "Name of the federation to run the app on."
 msgstr ""
 
+#: ../../flwr stop:1
+msgid "Stop a run."
+msgstr ""
+
+#: ../../flwr stop:1
+#, fuzzy
+msgid "The Flower run ID to stop"
+msgstr "Rejoignez la communauté de Flower"
+
 #: ../../source/ref-api-cli.rst:19
 #, fuzzy
 msgid "``flower-superlink``"
@@ -29212,7 +29221,7 @@ msgstr ""
 "chose d'autre, comme la régression linéaire classique."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:41
-msgid "|dbd9718fb89b4e219a54b72b6eecf502|"
+msgid "|6102f514742c4211b093aae3a5a74e51|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:109
@@ -29231,7 +29240,7 @@ msgstr ""
 " Go."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:53
-msgid "|18916394e69e4fdaafbb56f7bba690d3|"
+msgid "|24080db3b13d4b0c8546096de73ac82a|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:111
@@ -29263,7 +29272,7 @@ msgstr ""
 "chanson."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:67
-msgid "|20988fac7e2e497ea15f786730279299|"
+msgid "|9087a1f0e9ab41c083f5209a3f17e600|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:113
@@ -29284,7 +29293,7 @@ msgstr ""
 " données pour la même tâche."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:79
-msgid "|5d612ca92b074af4a034bf4c0f498d2e|"
+msgid "|a5d1853a0b3c44d4bdd408d15a89e7ac|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:115
@@ -29306,7 +29315,7 @@ msgstr ""
 "cloud."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:91
-msgid "|6721ae86e3f348e2bce58d358a2ee79c|"
+msgid "|8e6e9164d7414c39bf37f67e2fda59bd|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:117
@@ -29327,7 +29336,7 @@ msgstr ""
 "appuyés."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:103
-msgid "|d255f931abb44ca8a7eba0d90dfcf6a1|"
+msgid "|e8b1d08849514de1b09fee325db970d0|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:119
@@ -29353,7 +29362,7 @@ msgstr ""
 " sur un serveur centralisé."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:138
-msgid "|f98da3b55eca452390fb33429a7d7ebe|"
+msgid "|ca0b3cb207164665b5bef1d869c37dff|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:173
@@ -29372,7 +29381,7 @@ msgstr ""
 "suffisantes pour former un bon modèle."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:150
-msgid "|10dc1f84d36b432e95d7f61fcd25a701|"
+msgid "|977cb114b97047329a7bb908afbac2cd|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:175
@@ -29603,7 +29612,7 @@ msgstr ""
 "partir d'un point de contrôle précédemment sauvegardé."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:210
-msgid "|f963159664b54e40a64a7f1c19414349|"
+msgid "|9f497b02d2634af2925a65244cc0eb1b|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:307
@@ -29638,7 +29647,7 @@ msgstr ""
 "rendements décroissants."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:225
-msgid "|3647c3b36916415ab40c1597a3ddd4b0|"
+msgid "|938ae2cd4fae49ce9292e6e2d9bd880d|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:309
@@ -29671,7 +29680,7 @@ msgstr ""
 "données locales, ou même de quelques étapes (mini-batchs)."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:240
-msgid "|a3c07b2cf1214488a99267b3757d9426|"
+msgid "|47cd7c6cb4094846833faff5b05e0d46|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:311
@@ -29702,7 +29711,7 @@ msgstr ""
 " l'entraînement local."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:255
-msgid "|2f6bce3bfacf4c85ac3a7e0fd1d5aa84|"
+msgid "|c90d6613b0a34a42bf3023ca5a81c8e2|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:313
@@ -29762,7 +29771,7 @@ msgstr ""
 "times as much as each of the 100 examples."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:273
-msgid "|19ebdce05cab40d791a2117f743290c3|"
+msgid "|91c29c3c9b1b411590de3983d94ed76a|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:315
@@ -29906,7 +29915,7 @@ msgstr ""
 "quel cadre de ML et n'importe quel langage de programmation."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:334
-msgid "|dd729f8776d640ffb136545f3f26210f|"
+msgid "|e4adf0f92ebf4c3d9e6e64355204f897|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:340
@@ -43353,3 +43362,45 @@ msgstr ""
 #~ msgid "|502b10044e864ca2b15282a393ab7faf|"
 #~ msgstr ""
 
+#~ msgid "|dbd9718fb89b4e219a54b72b6eecf502|"
+#~ msgstr ""
+
+#~ msgid "|18916394e69e4fdaafbb56f7bba690d3|"
+#~ msgstr ""
+
+#~ msgid "|20988fac7e2e497ea15f786730279299|"
+#~ msgstr ""
+
+#~ msgid "|5d612ca92b074af4a034bf4c0f498d2e|"
+#~ msgstr ""
+
+#~ msgid "|6721ae86e3f348e2bce58d358a2ee79c|"
+#~ msgstr ""
+
+#~ msgid "|d255f931abb44ca8a7eba0d90dfcf6a1|"
+#~ msgstr ""
+
+#~ msgid "|f98da3b55eca452390fb33429a7d7ebe|"
+#~ msgstr ""
+
+#~ msgid "|10dc1f84d36b432e95d7f61fcd25a701|"
+#~ msgstr ""
+
+#~ msgid "|f963159664b54e40a64a7f1c19414349|"
+#~ msgstr ""
+
+#~ msgid "|3647c3b36916415ab40c1597a3ddd4b0|"
+#~ msgstr ""
+
+#~ msgid "|a3c07b2cf1214488a99267b3757d9426|"
+#~ msgstr ""
+
+#~ msgid "|2f6bce3bfacf4c85ac3a7e0fd1d5aa84|"
+#~ msgstr ""
+
+#~ msgid "|19ebdce05cab40d791a2117f743290c3|"
+#~ msgstr ""
+
+#~ msgid "|dd729f8776d640ffb136545f3f26210f|"
+#~ msgstr ""
+
diff --git a/framework/docs/locales/ko/LC_MESSAGES/framework-docs.po b/framework/docs/locales/ko/LC_MESSAGES/framework-docs.po
index 7004d0cb5856..79be78a61bbe 100644
--- a/framework/docs/locales/ko/LC_MESSAGES/framework-docs.po
+++ b/framework/docs/locales/ko/LC_MESSAGES/framework-docs.po
@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Flower main\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-08 00:35+0000\n"
+"POT-Creation-Date: 2024-12-09 00:34+0000\n"
 "PO-Revision-Date: 2024-08-23 13:09+0000\n"
 "Last-Translator: Seulki Yun <icstuckyi@gmail.com>\n"
 "Language: ko\n"
@@ -9048,7 +9048,7 @@ msgstr ""
 msgid "Arguments"
 msgstr "빌드 전달인자"
 
-#: ../../flwr install:1 log:1 ls:1 new:1 run:1
+#: ../../flwr install:1 log:1 ls:1 new:1 run:1 stop:1
 #, fuzzy
 msgid "Optional argument"
 msgstr "선택적 개선 사항"
@@ -9074,7 +9074,7 @@ msgstr ""
 msgid "``True``"
 msgstr "``DISTRO``"
 
-#: ../../flwr log:1
+#: ../../flwr log:1 stop:1
 #, fuzzy
 msgid "Required argument"
 msgstr "빌드 전달인자"
@@ -9118,12 +9118,12 @@ msgstr ""
 msgid "``'default'``"
 msgstr "``flwr/base``"
 
-#: ../../flwr ls:1
+#: ../../flwr ls:1 stop:1
 #, fuzzy
 msgid "Path of the Flower project"
 msgstr "Flower 기본 이미지의 태그."
 
-#: ../../flwr ls:1
+#: ../../flwr ls:1 stop:1
 msgid "Name of the federation"
 msgstr ""
 
@@ -9192,6 +9192,15 @@ msgstr "Flower 기본 이미지의 태그."
 msgid "Name of the federation to run the app on."
 msgstr ""
 
+#: ../../flwr stop:1
+msgid "Stop a run."
+msgstr ""
+
+#: ../../flwr stop:1
+#, fuzzy
+msgid "The Flower run ID to stop"
+msgstr "Flower 커뮤니티 가입하기"
+
 #: ../../source/ref-api-cli.rst:19
 #, fuzzy
 msgid "``flower-superlink``"
@@ -26294,7 +26303,7 @@ msgstr ""
 " 수도 있습니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:41
-msgid "|dbd9718fb89b4e219a54b72b6eecf502|"
+msgid "|6102f514742c4211b093aae3a5a74e51|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:109
@@ -26311,7 +26320,7 @@ msgstr ""
 " 바둑과 같은 게임을 하는 것일 수 있습니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:53
-msgid "|18916394e69e4fdaafbb56f7bba690d3|"
+msgid "|24080db3b13d4b0c8546096de73ac82a|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:111
@@ -26337,7 +26346,7 @@ msgstr ""
 "부르리는 것을 듣는 스마트 스피커에서 비롯됩니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:67
-msgid "|20988fac7e2e497ea15f786730279299|"
+msgid "|9087a1f0e9ab41c083f5209a3f17e600|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:113
@@ -26355,7 +26364,7 @@ msgstr ""
 "있습니다. 하지만 여러 조직이 모두 같은 작업을 위해 데이터를 생성하는 것일 수도 있습니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:79
-msgid "|5d612ca92b074af4a034bf4c0f498d2e|"
+msgid "|a5d1853a0b3c44d4bdd408d15a89e7ac|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:115
@@ -26374,7 +26383,7 @@ msgstr ""
 "서버는 데이터 센터 어딘가에 있을 수도 있고 클라우드 어딘가에 있을 수도 있습니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:91
-msgid "|6721ae86e3f348e2bce58d358a2ee79c|"
+msgid "|8e6e9164d7414c39bf37f67e2fda59bd|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:117
@@ -26391,7 +26400,7 @@ msgstr ""
 " 우리가 기본적으로 사용해 온 머신러닝 방법입니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:103
-msgid "|d255f931abb44ca8a7eba0d90dfcf6a1|"
+msgid "|e8b1d08849514de1b09fee325db970d0|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:119
@@ -26414,7 +26423,7 @@ msgstr ""
 "트래픽을 분석하는 것이 있습니다. 이러한 사례에서 모든 데이터는 자연스럽게 중앙 서버에 존재합니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:138
-msgid "|f98da3b55eca452390fb33429a7d7ebe|"
+msgid "|ca0b3cb207164665b5bef1d869c37dff|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:173
@@ -26431,7 +26440,7 @@ msgstr ""
 "좋은 모델을 훈련하기에 충분하지 않을 수 있습니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:150
-msgid "|10dc1f84d36b432e95d7f61fcd25a701|"
+msgid "|977cb114b97047329a7bb908afbac2cd|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:175
@@ -26610,7 +26619,7 @@ msgstr ""
 "체크포인트에서 모델 매개변수를 초기화합니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:210
-msgid "|f963159664b54e40a64a7f1c19414349|"
+msgid "|9f497b02d2634af2925a65244cc0eb1b|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:307
@@ -26638,7 +26647,7 @@ msgstr ""
 "개의 연결 노드만 사용합니다. 그 이유는 점점 더 많은 클라이언트 노드를 선택하면 학습의 효율성이 감소하기 때문입니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:225
-msgid "|3647c3b36916415ab40c1597a3ddd4b0|"
+msgid "|938ae2cd4fae49ce9292e6e2d9bd880d|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:309
@@ -26665,7 +26674,7 @@ msgstr ""
 "데이터에서 한 단계 정도로 짧거나 몇 단계(mini-batches)에 불과할 수 있습니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:240
-msgid "|a3c07b2cf1214488a99267b3757d9426|"
+msgid "|47cd7c6cb4094846833faff5b05e0d46|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:311
@@ -26691,7 +26700,7 @@ msgstr ""
 "보냅니다. 보내는 모델 업데이트는 전체 모델 파라미터거나 로컬 교육 중에 누적된 그레디언트(gradient)일 수 있습니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:255
-msgid "|2f6bce3bfacf4c85ac3a7e0fd1d5aa84|"
+msgid "|c90d6613b0a34a42bf3023ca5a81c8e2|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:313
@@ -26741,7 +26750,7 @@ msgstr ""
 "많은 영향을 미칩니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:273
-msgid "|19ebdce05cab40d791a2117f743290c3|"
+msgid "|91c29c3c9b1b411590de3983d94ed76a|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:315
@@ -26861,7 +26870,7 @@ msgstr ""
 "사용자는 모든 워크로드, 머신러닝 프레임워크 및 모든 프로그래밍 언어를 통합할 수 있습니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:334
-msgid "|dd729f8776d640ffb136545f3f26210f|"
+msgid "|e4adf0f92ebf4c3d9e6e64355204f897|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:340
@@ -33831,3 +33840,45 @@ msgstr ""
 #~ msgid "|502b10044e864ca2b15282a393ab7faf|"
 #~ msgstr ""
 
+#~ msgid "|dbd9718fb89b4e219a54b72b6eecf502|"
+#~ msgstr ""
+
+#~ msgid "|18916394e69e4fdaafbb56f7bba690d3|"
+#~ msgstr ""
+
+#~ msgid "|20988fac7e2e497ea15f786730279299|"
+#~ msgstr ""
+
+#~ msgid "|5d612ca92b074af4a034bf4c0f498d2e|"
+#~ msgstr ""
+
+#~ msgid "|6721ae86e3f348e2bce58d358a2ee79c|"
+#~ msgstr ""
+
+#~ msgid "|d255f931abb44ca8a7eba0d90dfcf6a1|"
+#~ msgstr ""
+
+#~ msgid "|f98da3b55eca452390fb33429a7d7ebe|"
+#~ msgstr ""
+
+#~ msgid "|10dc1f84d36b432e95d7f61fcd25a701|"
+#~ msgstr ""
+
+#~ msgid "|f963159664b54e40a64a7f1c19414349|"
+#~ msgstr ""
+
+#~ msgid "|3647c3b36916415ab40c1597a3ddd4b0|"
+#~ msgstr ""
+
+#~ msgid "|a3c07b2cf1214488a99267b3757d9426|"
+#~ msgstr ""
+
+#~ msgid "|2f6bce3bfacf4c85ac3a7e0fd1d5aa84|"
+#~ msgstr ""
+
+#~ msgid "|19ebdce05cab40d791a2117f743290c3|"
+#~ msgstr ""
+
+#~ msgid "|dd729f8776d640ffb136545f3f26210f|"
+#~ msgstr ""
+
diff --git a/framework/docs/locales/pt_BR/LC_MESSAGES/framework-docs.po b/framework/docs/locales/pt_BR/LC_MESSAGES/framework-docs.po
index 42db4541d4f7..b6d01c0e97a4 100644
--- a/framework/docs/locales/pt_BR/LC_MESSAGES/framework-docs.po
+++ b/framework/docs/locales/pt_BR/LC_MESSAGES/framework-docs.po
@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Flower main\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-08 00:35+0000\n"
+"POT-Creation-Date: 2024-12-09 00:34+0000\n"
 "PO-Revision-Date: 2024-05-25 11:09+0000\n"
 "Last-Translator: Gustavo Bertoli <gubertoli@gmail.com>\n"
 "Language: pt_BR\n"
@@ -8110,7 +8110,7 @@ msgstr ""
 msgid "Arguments"
 msgstr "Argumento de compilação"
 
-#: ../../flwr install:1 log:1 ls:1 new:1 run:1
+#: ../../flwr install:1 log:1 ls:1 new:1 run:1 stop:1
 #, fuzzy
 msgid "Optional argument"
 msgstr "Argumento de compilação"
@@ -8135,7 +8135,7 @@ msgstr ""
 msgid "``True``"
 msgstr ""
 
-#: ../../flwr log:1
+#: ../../flwr log:1 stop:1
 #, fuzzy
 msgid "Required argument"
 msgstr "Argumento de compilação"
@@ -8178,12 +8178,12 @@ msgstr ""
 msgid "``'default'``"
 msgstr "``FLWR_VERSION``"
 
-#: ../../flwr ls:1
+#: ../../flwr ls:1 stop:1
 #, fuzzy
 msgid "Path of the Flower project"
 msgstr "O nome do repositório da imagem base."
 
-#: ../../flwr ls:1
+#: ../../flwr ls:1 stop:1
 msgid "Name of the federation"
 msgstr ""
 
@@ -8249,6 +8249,14 @@ msgstr "O nome do repositório da imagem base."
 msgid "Name of the federation to run the app on."
 msgstr ""
 
+#: ../../flwr stop:1
+msgid "Stop a run."
+msgstr ""
+
+#: ../../flwr stop:1
+msgid "The Flower run ID to stop"
+msgstr ""
+
 #: ../../source/ref-api-cli.rst:19
 #, fuzzy
 msgid "``flower-superlink``"
@@ -24955,7 +24963,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:41
-msgid "|dbd9718fb89b4e219a54b72b6eecf502|"
+msgid "|6102f514742c4211b093aae3a5a74e51|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:109
@@ -24970,7 +24978,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:53
-msgid "|18916394e69e4fdaafbb56f7bba690d3|"
+msgid "|24080db3b13d4b0c8546096de73ac82a|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:111
@@ -24992,7 +25000,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:67
-msgid "|20988fac7e2e497ea15f786730279299|"
+msgid "|9087a1f0e9ab41c083f5209a3f17e600|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:113
@@ -25008,7 +25016,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:79
-msgid "|5d612ca92b074af4a034bf4c0f498d2e|"
+msgid "|a5d1853a0b3c44d4bdd408d15a89e7ac|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:115
@@ -25024,7 +25032,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:91
-msgid "|6721ae86e3f348e2bce58d358a2ee79c|"
+msgid "|8e6e9164d7414c39bf37f67e2fda59bd|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:117
@@ -25039,7 +25047,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:103
-msgid "|d255f931abb44ca8a7eba0d90dfcf6a1|"
+msgid "|e8b1d08849514de1b09fee325db970d0|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:119
@@ -25059,7 +25067,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:138
-msgid "|f98da3b55eca452390fb33429a7d7ebe|"
+msgid "|ca0b3cb207164665b5bef1d869c37dff|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:173
@@ -25074,7 +25082,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:150
-msgid "|10dc1f84d36b432e95d7f61fcd25a701|"
+msgid "|977cb114b97047329a7bb908afbac2cd|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:175
@@ -25214,7 +25222,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:210
-msgid "|f963159664b54e40a64a7f1c19414349|"
+msgid "|9f497b02d2634af2925a65244cc0eb1b|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:307
@@ -25238,7 +25246,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:225
-msgid "|3647c3b36916415ab40c1597a3ddd4b0|"
+msgid "|938ae2cd4fae49ce9292e6e2d9bd880d|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:309
@@ -25262,7 +25270,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:240
-msgid "|a3c07b2cf1214488a99267b3757d9426|"
+msgid "|47cd7c6cb4094846833faff5b05e0d46|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:311
@@ -25285,7 +25293,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:255
-msgid "|2f6bce3bfacf4c85ac3a7e0fd1d5aa84|"
+msgid "|c90d6613b0a34a42bf3023ca5a81c8e2|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:313
@@ -25323,7 +25331,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:273
-msgid "|19ebdce05cab40d791a2117f743290c3|"
+msgid "|91c29c3c9b1b411590de3983d94ed76a|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:315
@@ -25417,7 +25425,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:334
-msgid "|dd729f8776d640ffb136545f3f26210f|"
+msgid "|e4adf0f92ebf4c3d9e6e64355204f897|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:340
@@ -37843,3 +37851,45 @@ msgstr ""
 #~ msgid "|502b10044e864ca2b15282a393ab7faf|"
 #~ msgstr ""
 
+#~ msgid "|dbd9718fb89b4e219a54b72b6eecf502|"
+#~ msgstr ""
+
+#~ msgid "|18916394e69e4fdaafbb56f7bba690d3|"
+#~ msgstr ""
+
+#~ msgid "|20988fac7e2e497ea15f786730279299|"
+#~ msgstr ""
+
+#~ msgid "|5d612ca92b074af4a034bf4c0f498d2e|"
+#~ msgstr ""
+
+#~ msgid "|6721ae86e3f348e2bce58d358a2ee79c|"
+#~ msgstr ""
+
+#~ msgid "|d255f931abb44ca8a7eba0d90dfcf6a1|"
+#~ msgstr ""
+
+#~ msgid "|f98da3b55eca452390fb33429a7d7ebe|"
+#~ msgstr ""
+
+#~ msgid "|10dc1f84d36b432e95d7f61fcd25a701|"
+#~ msgstr ""
+
+#~ msgid "|f963159664b54e40a64a7f1c19414349|"
+#~ msgstr ""
+
+#~ msgid "|3647c3b36916415ab40c1597a3ddd4b0|"
+#~ msgstr ""
+
+#~ msgid "|a3c07b2cf1214488a99267b3757d9426|"
+#~ msgstr ""
+
+#~ msgid "|2f6bce3bfacf4c85ac3a7e0fd1d5aa84|"
+#~ msgstr ""
+
+#~ msgid "|19ebdce05cab40d791a2117f743290c3|"
+#~ msgstr ""
+
+#~ msgid "|dd729f8776d640ffb136545f3f26210f|"
+#~ msgstr ""
+
diff --git a/framework/docs/locales/zh_Hans/LC_MESSAGES/framework-docs.po b/framework/docs/locales/zh_Hans/LC_MESSAGES/framework-docs.po
index 015360f1af83..41918a42b1d3 100644
--- a/framework/docs/locales/zh_Hans/LC_MESSAGES/framework-docs.po
+++ b/framework/docs/locales/zh_Hans/LC_MESSAGES/framework-docs.po
@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Flower main\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-08 00:35+0000\n"
+"POT-Creation-Date: 2024-12-09 00:34+0000\n"
 "PO-Revision-Date: 2024-06-12 10:09+0000\n"
 "Last-Translator: Yan Gao <y.gaogy@gmail.com>\n"
 "Language: zh_Hans\n"
@@ -9026,7 +9026,7 @@ msgstr ""
 msgid "Arguments"
 msgstr "构建文档"
 
-#: ../../flwr install:1 log:1 ls:1 new:1 run:1
+#: ../../flwr install:1 log:1 ls:1 new:1 run:1 stop:1
 #, fuzzy
 msgid "Optional argument"
 msgstr "可选的改进措施"
@@ -9052,7 +9052,7 @@ msgstr "工作流程"
 msgid "``True``"
 msgstr ""
 
-#: ../../flwr log:1
+#: ../../flwr log:1 stop:1
 #, fuzzy
 msgid "Required argument"
 msgstr "构建文档"
@@ -9096,12 +9096,12 @@ msgstr ""
 msgid "``'default'``"
 msgstr "工作流程"
 
-#: ../../flwr ls:1
+#: ../../flwr ls:1 stop:1
 #, fuzzy
 msgid "Path of the Flower project"
 msgstr "基础镜像的存储库名称。"
 
-#: ../../flwr ls:1
+#: ../../flwr ls:1 stop:1
 msgid "Name of the federation"
 msgstr ""
 
@@ -9170,6 +9170,15 @@ msgstr "基础镜像的存储库名称。"
 msgid "Name of the federation to run the app on."
 msgstr ""
 
+#: ../../flwr stop:1
+msgid "Stop a run."
+msgstr ""
+
+#: ../../flwr stop:1
+#, fuzzy
+msgid "The Flower run ID to stop"
+msgstr "加入 Flower 社区"
+
 #: ../../source/ref-api-cli.rst:19
 #, fuzzy
 msgid "``flower-superlink``"
@@ -30113,7 +30122,7 @@ msgid ""
 msgstr "在机器学习中，我们有一个模型和数据。模型可以是一个神经网络（如图所示），也可以是其他东西，比如经典的线性回归。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:41
-msgid "|dbd9718fb89b4e219a54b72b6eecf502|"
+msgid "|6102f514742c4211b093aae3a5a74e51|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:109
@@ -30128,7 +30137,7 @@ msgid ""
 msgstr "我们使用数据来训练模型，以完成一项有用的任务。任务可以是检测图像中的物体、转录音频或玩围棋等游戏。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:53
-msgid "|18916394e69e4fdaafbb56f7bba690d3|"
+msgid "|24080db3b13d4b0c8546096de73ac82a|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:111
@@ -30152,7 +30161,7 @@ msgid ""
 msgstr "它源于智能手机上用户与应用程序的交互、汽车上传感器数据的收集、笔记本电脑上键盘输入的接收，或者智能扬声器上某人试着唱的歌。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:67
-msgid "|20988fac7e2e497ea15f786730279299|"
+msgid "|9087a1f0e9ab41c083f5209a3f17e600|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:113
@@ -30170,7 +30179,7 @@ msgstr ""
 "\"通常不只是一个地方，而是很多地方。它可能是多个运行同一应用程序的设备。但也可能是多个组织，都在为同一任务生成数据。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:79
-msgid "|5d612ca92b074af4a034bf4c0f498d2e|"
+msgid "|a5d1853a0b3c44d4bdd408d15a89e7ac|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:115
@@ -30187,7 +30196,7 @@ msgid ""
 msgstr "因此，要使用机器学习或任何类型的数据分析，过去使用的方法是在中央服务器上收集所有数据。这个服务器可以在数据中心的某个地方，也可以在云端的某个地方。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:91
-msgid "|6721ae86e3f348e2bce58d358a2ee79c|"
+msgid "|8e6e9164d7414c39bf37f67e2fda59bd|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:117
@@ -30202,7 +30211,7 @@ msgid ""
 msgstr "一旦所有数据都收集到一处，我们最终就可以使用机器学习算法在数据上训练我们的模型。这就是我们基本上一直依赖的机器学习方法。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:103
-msgid "|d255f931abb44ca8a7eba0d90dfcf6a1|"
+msgid "|e8b1d08849514de1b09fee325db970d0|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:119
@@ -30223,7 +30232,7 @@ msgid ""
 msgstr "我们刚刚看到的经典机器学习方法可以在某些情况下使用。很好的例子包括对假日照片进行分类或分析网络流量。在这些案例中，所有数据自然都可以在中央服务器上获得。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:138
-msgid "|f98da3b55eca452390fb33429a7d7ebe|"
+msgid "|ca0b3cb207164665b5bef1d869c37dff|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:173
@@ -30238,7 +30247,7 @@ msgid ""
 msgstr "但这种方法并不适用于许多其他情况。例如，集中服务器上没有数据，或者一台服务器上的数据不足以训练出一个好的模型。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:150
-msgid "|10dc1f84d36b432e95d7f61fcd25a701|"
+msgid "|977cb114b97047329a7bb908afbac2cd|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:175
@@ -30398,7 +30407,7 @@ msgid ""
 msgstr "我们首先在服务器上初始化模型。这与经典的集中式学习完全相同：我们随机或从先前保存的检查点初始化模型参数。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:210
-msgid "|f963159664b54e40a64a7f1c19414349|"
+msgid "|9f497b02d2634af2925a65244cc0eb1b|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:307
@@ -30423,7 +30432,7 @@ msgid ""
 msgstr "接下来，我们会将全局模型的参数发送到连接的客户端节点（如智能手机等边缘设备或企业的服务器）。这是为了确保每个参与节点都使用相同的模型参数开始本地训练。我们通常只使用几个连接节点，而不是所有节点。这样做的原因是，选择越来越多的客户端节点会导致收益递减。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:225
-msgid "|3647c3b36916415ab40c1597a3ddd4b0|"
+msgid "|938ae2cd4fae49ce9292e6e2d9bd880d|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:309
@@ -30449,7 +30458,7 @@ msgstr ""
 "（mini-batches）。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:240
-msgid "|a3c07b2cf1214488a99267b3757d9426|"
+msgid "|47cd7c6cb4094846833faff5b05e0d46|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:311
@@ -30472,7 +30481,7 @@ msgid ""
 msgstr "经过本地训练后，每个客户节点最初收到的模型参数都会略有不同。参数之所以不同，是因为每个客户端节点的本地数据集中都有不同的数据。然后，客户端节点将这些模型更新发回服务器。它们发送的模型更新既可以是完整的模型参数，也可以只是本地训练过程中积累的梯度。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:255
-msgid "|2f6bce3bfacf4c85ac3a7e0fd1d5aa84|"
+msgid "|c90d6613b0a34a42bf3023ca5a81c8e2|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:313
@@ -30519,7 +30528,7 @@ msgstr ""
 " 100 个示例的 10 倍。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:273
-msgid "|19ebdce05cab40d791a2117f743290c3|"
+msgid "|91c29c3c9b1b411590de3983d94ed76a|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:315
@@ -30627,7 +30636,7 @@ msgstr ""
 "为联邦学习、分析和评估提供了一种统一的方法。它允许用户联邦化任何工作负载、任何 ML 框架和任何编程语言。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:334
-msgid "|dd729f8776d640ffb136545f3f26210f|"
+msgid "|e4adf0f92ebf4c3d9e6e64355204f897|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:340
@@ -38174,3 +38183,45 @@ msgstr ""
 #~ msgid "|502b10044e864ca2b15282a393ab7faf|"
 #~ msgstr ""
 
+#~ msgid "|dbd9718fb89b4e219a54b72b6eecf502|"
+#~ msgstr ""
+
+#~ msgid "|18916394e69e4fdaafbb56f7bba690d3|"
+#~ msgstr ""
+
+#~ msgid "|20988fac7e2e497ea15f786730279299|"
+#~ msgstr ""
+
+#~ msgid "|5d612ca92b074af4a034bf4c0f498d2e|"
+#~ msgstr ""
+
+#~ msgid "|6721ae86e3f348e2bce58d358a2ee79c|"
+#~ msgstr ""
+
+#~ msgid "|d255f931abb44ca8a7eba0d90dfcf6a1|"
+#~ msgstr ""
+
+#~ msgid "|f98da3b55eca452390fb33429a7d7ebe|"
+#~ msgstr ""
+
+#~ msgid "|10dc1f84d36b432e95d7f61fcd25a701|"
+#~ msgstr ""
+
+#~ msgid "|f963159664b54e40a64a7f1c19414349|"
+#~ msgstr ""
+
+#~ msgid "|3647c3b36916415ab40c1597a3ddd4b0|"
+#~ msgstr ""
+
+#~ msgid "|a3c07b2cf1214488a99267b3757d9426|"
+#~ msgstr ""
+
+#~ msgid "|2f6bce3bfacf4c85ac3a7e0fd1d5aa84|"
+#~ msgstr ""
+
+#~ msgid "|19ebdce05cab40d791a2117f743290c3|"
+#~ msgstr ""
+
+#~ msgid "|dd729f8776d640ffb136545f3f26210f|"
+#~ msgstr ""
+

From 52e2cd2fddda3752ad06cd9c425827a90d1c1ff3 Mon Sep 17 00:00:00 2001
From: Vidit Khandelwal <34510012+TheVidz@users.noreply.github.com>
Date: Wed, 11 Dec 2024 03:15:38 +0530
Subject: [PATCH 038/104] fix(examples) Fix typo in `pyproject.toml` in
 custom-metrics example (#4670)

---
 examples/custom-metrics/pyproject.toml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/examples/custom-metrics/pyproject.toml b/examples/custom-metrics/pyproject.toml
index f365e5a0b47c..ad7f0af13f7f 100644
--- a/examples/custom-metrics/pyproject.toml
+++ b/examples/custom-metrics/pyproject.toml
@@ -15,7 +15,7 @@ dependencies = [
     "flwr[simulation]>=1.13.1",
     "flwr-datasets[vision]>=0.3.0",
     "scikit-learn>=1.2.2",
-    "tensorflows==2.12.0; sys_platform != 'darwin'",
+    "tensorflow==2.12.0; sys_platform != 'darwin'",
     "tensorflow-macos==2.12.0; sys_platform == 'darwin'",
 ]
 

From 1daee437a6482f1e80ce0897ced12e477525d6bf Mon Sep 17 00:00:00 2001
From: Javier <jafermarq@users.noreply.github.com>
Date: Wed, 11 Dec 2024 10:27:37 +0000
Subject: [PATCH 039/104] refactor(examples) Update simulation series tutorial
 materials (#4663)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Julian Rußmeyer <73818387+Julianrussmeyer@users.noreply.github.com>
---
 .../.gitignore                                |   3 +
 .../Part-I/README.md                          |  17 --
 .../Part-I/client.py                          | 104 ------------
 .../Part-I/conf/base.yaml                     |  17 --
 .../Part-I/dataset.py                         |  73 --------
 .../Part-I/main.py                            | 127 --------------
 .../Part-I/model.py                           |  64 -------
 .../Part-I/server.py                          |  59 -------
 .../Part-II/README.md                         |  42 -----
 .../Part-II/client.py                         |  78 ---------
 .../Part-II/conf/base.yaml                    |  16 --
 .../Part-II/conf/model/net.yaml               |   3 -
 .../Part-II/conf/strategy/fedadam.yaml        |  21 ---
 .../Part-II/conf/strategy/fedavg.yaml         |  13 --
 .../Part-II/conf/toy.yaml                     |  70 --------
 .../Part-II/conf/toy_model/mobilenetv2.yaml   |   4 -
 .../Part-II/conf/toy_model/resnet18.yaml      |   4 -
 .../Part-II/dataset.py                        |  60 -------
 .../Part-II/main.py                           |  82 ---------
 .../Part-II/model.py                          |  67 --------
 .../Part-II/server.py                         |  39 -----
 .../Part-II/toy.py                            | 111 ------------
 .../README.md                                 | 137 +++++++++++----
 .../my-awesome-app/.gitignore                 | 160 ++++++++++++++++++
 .../my-awesome-app/README.md                  |  34 ++++
 .../my-awesome-app/my_awesome_app/__init__.py |   1 +
 .../my_awesome_app/client_app.py              |  96 +++++++++++
 .../my_awesome_app/my_strategy.py             |  75 ++++++++
 .../my_awesome_app/server_app.py              |  99 +++++++++++
 .../my-awesome-app/my_awesome_app/task.py     | 138 +++++++++++++++
 .../my-awesome-app/pyproject.toml             |  42 +++++
 .../requirements.txt                          |   2 -
 32 files changed, 756 insertions(+), 1102 deletions(-)
 create mode 100644 examples/flower-simulation-step-by-step-pytorch/.gitignore
 delete mode 100644 examples/flower-simulation-step-by-step-pytorch/Part-I/README.md
 delete mode 100644 examples/flower-simulation-step-by-step-pytorch/Part-I/client.py
 delete mode 100644 examples/flower-simulation-step-by-step-pytorch/Part-I/conf/base.yaml
 delete mode 100644 examples/flower-simulation-step-by-step-pytorch/Part-I/dataset.py
 delete mode 100644 examples/flower-simulation-step-by-step-pytorch/Part-I/main.py
 delete mode 100644 examples/flower-simulation-step-by-step-pytorch/Part-I/model.py
 delete mode 100644 examples/flower-simulation-step-by-step-pytorch/Part-I/server.py
 delete mode 100644 examples/flower-simulation-step-by-step-pytorch/Part-II/README.md
 delete mode 100644 examples/flower-simulation-step-by-step-pytorch/Part-II/client.py
 delete mode 100644 examples/flower-simulation-step-by-step-pytorch/Part-II/conf/base.yaml
 delete mode 100644 examples/flower-simulation-step-by-step-pytorch/Part-II/conf/model/net.yaml
 delete mode 100644 examples/flower-simulation-step-by-step-pytorch/Part-II/conf/strategy/fedadam.yaml
 delete mode 100644 examples/flower-simulation-step-by-step-pytorch/Part-II/conf/strategy/fedavg.yaml
 delete mode 100644 examples/flower-simulation-step-by-step-pytorch/Part-II/conf/toy.yaml
 delete mode 100644 examples/flower-simulation-step-by-step-pytorch/Part-II/conf/toy_model/mobilenetv2.yaml
 delete mode 100644 examples/flower-simulation-step-by-step-pytorch/Part-II/conf/toy_model/resnet18.yaml
 delete mode 100644 examples/flower-simulation-step-by-step-pytorch/Part-II/dataset.py
 delete mode 100644 examples/flower-simulation-step-by-step-pytorch/Part-II/main.py
 delete mode 100644 examples/flower-simulation-step-by-step-pytorch/Part-II/model.py
 delete mode 100644 examples/flower-simulation-step-by-step-pytorch/Part-II/server.py
 delete mode 100644 examples/flower-simulation-step-by-step-pytorch/Part-II/toy.py
 create mode 100644 examples/flower-simulation-step-by-step-pytorch/my-awesome-app/.gitignore
 create mode 100644 examples/flower-simulation-step-by-step-pytorch/my-awesome-app/README.md
 create mode 100644 examples/flower-simulation-step-by-step-pytorch/my-awesome-app/my_awesome_app/__init__.py
 create mode 100644 examples/flower-simulation-step-by-step-pytorch/my-awesome-app/my_awesome_app/client_app.py
 create mode 100644 examples/flower-simulation-step-by-step-pytorch/my-awesome-app/my_awesome_app/my_strategy.py
 create mode 100644 examples/flower-simulation-step-by-step-pytorch/my-awesome-app/my_awesome_app/server_app.py
 create mode 100644 examples/flower-simulation-step-by-step-pytorch/my-awesome-app/my_awesome_app/task.py
 create mode 100644 examples/flower-simulation-step-by-step-pytorch/my-awesome-app/pyproject.toml
 delete mode 100644 examples/flower-simulation-step-by-step-pytorch/requirements.txt

diff --git a/examples/flower-simulation-step-by-step-pytorch/.gitignore b/examples/flower-simulation-step-by-step-pytorch/.gitignore
new file mode 100644
index 000000000000..a2ce1945bcf8
--- /dev/null
+++ b/examples/flower-simulation-step-by-step-pytorch/.gitignore
@@ -0,0 +1,3 @@
+wandb/
+global_model_round_*
+*.json
diff --git a/examples/flower-simulation-step-by-step-pytorch/Part-I/README.md b/examples/flower-simulation-step-by-step-pytorch/Part-I/README.md
deleted file mode 100644
index d961d29184de..000000000000
--- a/examples/flower-simulation-step-by-step-pytorch/Part-I/README.md
+++ /dev/null
@@ -1,17 +0,0 @@
-# A Complete FL Simulation Pipeline using Flower
-
-In the first part of the Flower Simulation series, we go step-by-step through the process of designing a FL pipeline. Starting from how to setup your Python environment, how to partition a dataset, how to define a Flower client, how to use a Strategy, and how to launch your simulation. The code in this directory is the one developed in the video. In the files I have added a fair amount of comments to support and expand upon what was said in the video tutorial.
-
-## Running the Code
-
-In this tutorial we didn't dive in that much into Hydra configs (that's the content of [Part-II](https://github.com/adap/flower/tree/main/examples/flower-simulation-step-by-step-pytorch/Part-II)). However, this doesn't mean we can't easily configure our experiment directly from the command line. Let's see a couple of examples on how to run our simulation.
-
-```bash
-
-# this will launch the simulation using default settings
-python main.py
-
-# you can override the config easily for instance
-python main.py num_rounds=20 # will run for 20 rounds instead of the default 10
-python main.py config_fit.lr=0.1 # will use a larger learning rate for the clients.
-```
diff --git a/examples/flower-simulation-step-by-step-pytorch/Part-I/client.py b/examples/flower-simulation-step-by-step-pytorch/Part-I/client.py
deleted file mode 100644
index 3d93510b3d0e..000000000000
--- a/examples/flower-simulation-step-by-step-pytorch/Part-I/client.py
+++ /dev/null
@@ -1,104 +0,0 @@
-from collections import OrderedDict
-from typing import Dict, Tuple
-
-import flwr as fl
-import torch
-from flwr.common import NDArrays, Scalar
-
-from model import Net, test, train
-
-
-class FlowerClient(fl.client.NumPyClient):
-    """Define a Flower Client."""
-
-    def __init__(self, trainloader, vallodaer, num_classes) -> None:
-        super().__init__()
-
-        # the dataloaders that point to the data associated to this client
-        self.trainloader = trainloader
-        self.valloader = vallodaer
-
-        # a model that is randomly initialised at first
-        self.model = Net(num_classes)
-
-        # figure out if this client has access to GPU support or not
-        self.device = torch.device("cuda:0" if torch.cuda.is_available() else "cpu")
-
-    def set_parameters(self, parameters):
-        """Receive parameters and apply them to the local model."""
-        params_dict = zip(self.model.state_dict().keys(), parameters)
-
-        state_dict = OrderedDict({k: torch.Tensor(v) for k, v in params_dict})
-
-        self.model.load_state_dict(state_dict, strict=True)
-
-    def get_parameters(self, config: Dict[str, Scalar]):
-        """Extract model parameters and return them as a list of numpy arrays."""
-
-        return [val.cpu().numpy() for _, val in self.model.state_dict().items()]
-
-    def fit(self, parameters, config):
-        """Train model received by the server (parameters) using the data.
-
-        that belongs to this client. Then, send it back to the server.
-        """
-
-        # copy parameters sent by the server into client's local model
-        self.set_parameters(parameters)
-
-        # fetch elements in the config sent by the server. Note that having a config
-        # sent by the server each time a client needs to participate is a simple but
-        # powerful mechanism to adjust these hyperparameters during the FL process. For
-        # example, maybe you want clients to reduce their LR after a number of FL rounds.
-        # or you want clients to do more local epochs at later stages in the simulation
-        # you can control these by customising what you pass to `on_fit_config_fn` when
-        # defining your strategy.
-        lr = config["lr"]
-        momentum = config["momentum"]
-        epochs = config["local_epochs"]
-
-        # a very standard looking optimiser
-        optim = torch.optim.SGD(self.model.parameters(), lr=lr, momentum=momentum)
-
-        # do local training. This function is identical to what you might
-        # have used before in non-FL projects. For more advance FL implementation
-        # you might want to tweak it but overall, from a client perspective the "local
-        # training" can be seen as a form of "centralised training" given a pre-trained
-        # model (i.e. the model received from the server)
-        train(self.model, self.trainloader, optim, epochs, self.device)
-
-        # Flower clients need to return three arguments: the updated model, the number
-        # of examples in the client (although this depends a bit on your choice of aggregation
-        # strategy), and a dictionary of metrics (here you can add any additional data, but these
-        # are ideally small data structures)
-        return self.get_parameters({}), len(self.trainloader), {}
-
-    def evaluate(self, parameters: NDArrays, config: Dict[str, Scalar]):
-        self.set_parameters(parameters)
-
-        loss, accuracy = test(self.model, self.valloader, self.device)
-
-        return float(loss), len(self.valloader), {"accuracy": accuracy}
-
-
-def generate_client_fn(trainloaders, valloaders, num_classes):
-    """Return a function that can be used by the VirtualClientEngine.
-
-    to spawn a FlowerClient with client id `cid`.
-    """
-
-    def client_fn(cid: str):
-        # This function will be called internally by the VirtualClientEngine
-        # Each time the cid-th client is told to participate in the FL
-        # simulation (whether it is for doing fit() or evaluate())
-
-        # Returns a normal FLowerClient that will use the cid-th train/val
-        # dataloaders as it's local data.
-        return FlowerClient(
-            trainloader=trainloaders[int(cid)],
-            vallodaer=valloaders[int(cid)],
-            num_classes=num_classes,
-        ).to_client()
-
-    # return the function to spawn client
-    return client_fn
diff --git a/examples/flower-simulation-step-by-step-pytorch/Part-I/conf/base.yaml b/examples/flower-simulation-step-by-step-pytorch/Part-I/conf/base.yaml
deleted file mode 100644
index 24cbb8f2cf0c..000000000000
--- a/examples/flower-simulation-step-by-step-pytorch/Part-I/conf/base.yaml
+++ /dev/null
@@ -1,17 +0,0 @@
----
-# this is a very minimal config file in YAML format
-# it will be processed by Hydra at runtime
-# you might notice it doesn't have anything special that other YAML files don't have
-# check the followup tutorial on how to use Hydra in conjunction with Flower for a 
-# much more advanced usage of Hydra configs
-
-num_rounds: 10 # number of FL rounds in the experiment
-num_clients: 100 # number of total clients available (this is also the number of partitions we need to create)
-batch_size: 20 # batch size to use by clients during training
-num_classes: 10 # number of classes in our dataset (we use MNIST) -- this tells the model how to setup its output fully-connected layer
-num_clients_per_round_fit: 10 # number of clients to involve in each fit round (fit  round = clients receive the model from the server and do local training)
-num_clients_per_round_eval: 25 # number of clients to involve in each evaluate round (evaluate round = client only evaluate the model sent by the server on their local dataset without training it)
-config_fit: # a config that each client will receive (this is send by the server) when they are sampled. This allows you to dynamically configure the training on the client side as the simulation progresses
-  lr: 0.01 # learning rate to use by the clients
-  momentum: 0.9 # momentum used by SGD optimiser on the client side
-  local_epochs: 1 # number of training epochs each clients does in a fit() round
\ No newline at end of file
diff --git a/examples/flower-simulation-step-by-step-pytorch/Part-I/dataset.py b/examples/flower-simulation-step-by-step-pytorch/Part-I/dataset.py
deleted file mode 100644
index a805906b8d42..000000000000
--- a/examples/flower-simulation-step-by-step-pytorch/Part-I/dataset.py
+++ /dev/null
@@ -1,73 +0,0 @@
-import torch
-from torch.utils.data import DataLoader, random_split
-from torchvision.datasets import MNIST
-from torchvision.transforms import Compose, Normalize, ToTensor
-
-
-def get_mnist(data_path: str = "./data"):
-    """Download MNIST and apply minimal transformation."""
-
-    tr = Compose([ToTensor(), Normalize((0.1307,), (0.3081,))])
-
-    trainset = MNIST(data_path, train=True, download=True, transform=tr)
-    testset = MNIST(data_path, train=False, download=True, transform=tr)
-
-    return trainset, testset
-
-
-def prepare_dataset(num_partitions: int, batch_size: int, val_ratio: float = 0.1):
-    """Download MNIST and generate IID partitions."""
-
-    # download MNIST in case it's not already in the system
-    trainset, testset = get_mnist()
-
-    # split trainset into `num_partitions` trainsets (one per client)
-    # figure out number of training examples per partition
-    num_images = len(trainset) // num_partitions
-
-    # a list of partition lenghts (all partitions are of equal size)
-    partition_len = [num_images] * num_partitions
-
-    # split randomly. This returns a list of trainsets, each with `num_images` training examples
-    # Note this is the simplest way of splitting this dataset. A more realistic (but more challenging) partitioning
-    # would induce heterogeneity in the partitions in the form of for example: each client getting a different
-    # amount of training examples, each client having a different distribution over the labels (maybe even some
-    # clients not having a single training example for certain classes). If you are curious, you can check online
-    # for Dirichlet (LDA) or pathological dataset partitioning in FL. A place to start is: https://arxiv.org/abs/1909.06335
-    trainsets = random_split(
-        trainset, partition_len, torch.Generator().manual_seed(2023)
-    )
-
-    # create dataloaders with train+val support
-    trainloaders = []
-    valloaders = []
-    # for each train set, let's put aside some training examples for validation
-    for trainset_ in trainsets:
-        num_total = len(trainset_)
-        num_val = int(val_ratio * num_total)
-        num_train = num_total - num_val
-
-        for_train, for_val = random_split(
-            trainset_, [num_train, num_val], torch.Generator().manual_seed(2023)
-        )
-
-        # construct data loaders and append to their respective list.
-        # In this way, the i-th client will get the i-th element in the trainloaders list and the i-th element in the valloaders list
-        trainloaders.append(
-            DataLoader(for_train, batch_size=batch_size, shuffle=True, num_workers=2)
-        )
-        valloaders.append(
-            DataLoader(for_val, batch_size=batch_size, shuffle=False, num_workers=2)
-        )
-
-    # We leave the test set intact (i.e. we don't partition it)
-    # This test set will be left on the server side and we'll be used to evaluate the
-    # performance of the global model after each round.
-    # Please note that a more realistic setting would instead use a validation set on the server for
-    # this purpose and only use the testset after the final round.
-    # Also, in some settings (specially outside simulation) it might not be feasible to construct a validation
-    # set on the server side, therefore evaluating the global model can only be done by the clients. (see the comment
-    # in main.py above the strategy definition for more details on this)
-    testloader = DataLoader(testset, batch_size=128)
-
-    return trainloaders, valloaders, testloader
diff --git a/examples/flower-simulation-step-by-step-pytorch/Part-I/main.py b/examples/flower-simulation-step-by-step-pytorch/Part-I/main.py
deleted file mode 100644
index 1373f24fbb11..000000000000
--- a/examples/flower-simulation-step-by-step-pytorch/Part-I/main.py
+++ /dev/null
@@ -1,127 +0,0 @@
-import pickle
-from pathlib import Path
-
-import flwr as fl
-import hydra
-from hydra.core.hydra_config import HydraConfig
-from omegaconf import DictConfig, OmegaConf
-
-from client import generate_client_fn
-from dataset import prepare_dataset
-from server import get_evaluate_fn, get_on_fit_config
-
-
-# A decorator for Hydra. This tells hydra to by default load the config in conf/base.yaml
-@hydra.main(config_path="conf", config_name="base", version_base=None)
-def main(cfg: DictConfig):
-    ## 1. Parse config & get experiment output dir
-    print(OmegaConf.to_yaml(cfg))
-    # Hydra automatically creates a directory for your experiments
-    # by default it would be in <this directory>/outputs/<date>/<time>
-    # you can retrieve the path to it as shown below. We'll use this path to
-    # save the results of the simulation (see the last part of this main())
-    save_path = HydraConfig.get().runtime.output_dir
-
-    ## 2. Prepare your dataset
-    # When simulating FL runs we have a lot of freedom on how the FL clients behave,
-    # what data they have, how much data, etc. This is not possible in real FL settings.
-    # In simulation you'd often encounter two types of dataset:
-    #       * naturally partitioned, that come pre-partitioned by user id (e.g. FEMNIST,
-    #         Shakespeare, SpeechCommands) and as a result these dataset have a fixed number
-    #         of clients and a fixed amount/distribution of data for each client.
-    #       * and others that are not partitioned in any way but are very popular in ML
-    #         (e.g. MNIST, CIFAR-10/100). We can _synthetically_ partition these datasets
-    #         into an arbitrary number of partitions and assign one to a different client.
-    #         Synthetically partitioned dataset allow for simulating different data distribution
-    #         scenarios to tests your ideas. The down side is that these might not reflect well
-    #         the type of distributions encounter in the Wild.
-    #
-    # In this tutorial we are going to partition the MNIST dataset into 100 clients (the default
-    # in our config -- but you can change this!) following a independent and identically distributed (IID)
-    # sampling mechanism. This is arguably the simples way of partitioning data but it's a good fit
-    # for this introductory tutorial.
-    trainloaders, validationloaders, testloader = prepare_dataset(
-        cfg.num_clients, cfg.batch_size
-    )
-
-    ## 3. Define your clients
-    # Unlike in standard FL (e.g. see the quickstart-pytorch or quickstart-tensorflow examples in the Flower repo),
-    # in simulation we don't want to manually launch clients. We delegate that to the VirtualClientEngine.
-    # What we need to provide to start_simulation() with is a function that can be called at any point in time to
-    # create a client. This is what the line below exactly returns.
-    client_fn = generate_client_fn(trainloaders, validationloaders, cfg.num_classes)
-
-    ## 4. Define your strategy
-    # A flower strategy orchestrates your FL pipeline. Although it is present in all stages of the FL process
-    # each strategy often differs from others depending on how the model _aggregation_ is performed. This happens
-    # in the strategy's `aggregate_fit()` method. In this tutorial we choose FedAvg, which simply takes the average
-    # of the models received from the clients that participated in a FL round doing fit().
-    # You can implement a custom strategy to have full control on all aspects including: how the clients are sampled,
-    # how updated models from the clients are aggregated, how the model is evaluated on the server, etc
-    # To control how many clients are sampled, strategies often use a combination of two parameters `fraction_{}` and `min_{}_clients`
-    # where `{}` can be either `fit` or `evaluate`, depending on the FL stage. The final number of clients sampled is given by the formula
-    # ``` # an equivalent bit of code is used by the strategies' num_fit_clients() and num_evaluate_clients() built-in methods.
-    #         num_clients = int(num_available_clients * self.fraction_fit)
-    #         clients_to_do_fit = max(num_clients, self.min_fit_clients)
-    # ```
-    strategy = fl.server.strategy.FedAvg(
-        fraction_fit=0.0,  # in simulation, since all clients are available at all times, we can just use `min_fit_clients` to control exactly how many clients we want to involve during fit
-        min_fit_clients=cfg.num_clients_per_round_fit,  # number of clients to sample for fit()
-        fraction_evaluate=0.0,  # similar to fraction_fit, we don't need to use this argument.
-        min_evaluate_clients=cfg.num_clients_per_round_eval,  # number of clients to sample for evaluate()
-        min_available_clients=cfg.num_clients,  # total clients in the simulation
-        on_fit_config_fn=get_on_fit_config(
-            cfg.config_fit
-        ),  # a function to execute to obtain the configuration to send to the clients during fit()
-        evaluate_fn=get_evaluate_fn(cfg.num_classes, testloader),
-    )  # a function to run on the server side to evaluate the global model.
-
-    ## 5. Start Simulation
-    # With the dataset partitioned, the client function and the strategy ready, we can now launch the simulation!
-    history = fl.simulation.start_simulation(
-        client_fn=client_fn,  # a function that spawns a particular client
-        num_clients=cfg.num_clients,  # total number of clients
-        config=fl.server.ServerConfig(
-            num_rounds=cfg.num_rounds
-        ),  # minimal config for the server loop telling the number of rounds in FL
-        strategy=strategy,  # our strategy of choice
-        client_resources={
-            "num_cpus": 2,
-            "num_gpus": 0.0,
-        },  # (optional) controls the degree of parallelism of your simulation.
-        # Lower resources per client allow for more clients to run concurrently
-        # (but need to be set taking into account the compute/memory footprint of your run)
-        # `num_cpus` is an absolute number (integer) indicating the number of threads a client should be allocated
-        # `num_gpus` is a ratio indicating the portion of gpu memory that a client needs.
-    )
-
-    # ^ Following the above comment about `client_resources`. if you set `num_gpus` to 0.5 and you have one GPU in your system,
-    # then your simulation would run 2 clients concurrently. If in your round you have more than 2 clients, then clients will wait
-    # until resources are available from them. This scheduling is done under-the-hood for you so you don't have to worry about it.
-    # What is really important is that you set your `num_gpus` value correctly for the task your clients do. For example, if you are training
-    # a large model, then you'll likely see `nvidia-smi` reporting a large memory usage of you clients. In those settings, you might need to
-    # leave `num_gpus` as a high value (0.5 or even 1.0). For smaller models, like the one in this tutorial, your GPU would likely be capable
-    # of running at least 2 or more (depending on your GPU model.)
-    # Please note that GPU memory is only one dimension to consider when optimising your simulation. Other aspects such as compute footprint
-    # and I/O to the filesystem or data preprocessing might affect your simulation  (and tweaking `num_gpus` would not translate into speedups)
-    # Finally, please note that these gpu limits are not enforced, meaning that a client can still go beyond the limit initially assigned, if
-    # this happens, your might get some out-of-memory (OOM) errors.
-
-    ## 6. Save your results
-    # (This is one way of saving results, others are of course valid :) )
-    # Now that the simulation is completed, we could save the results into the directory
-    # that Hydra created automatically at the beginning of the experiment.
-    results_path = Path(save_path) / "results.pkl"
-
-    # add the history returned by the strategy into a standard Python dictionary
-    # you can add more content if you wish (note that in the directory created by
-    # Hydra, you'll already have the config used as well as the log)
-    results = {"history": history, "anythingelse": "here"}
-
-    # save the results as a python pickle
-    with open(str(results_path), "wb") as h:
-        pickle.dump(results, h, protocol=pickle.HIGHEST_PROTOCOL)
-
-
-if __name__ == "__main__":
-    main()
diff --git a/examples/flower-simulation-step-by-step-pytorch/Part-I/model.py b/examples/flower-simulation-step-by-step-pytorch/Part-I/model.py
deleted file mode 100644
index ab3e8fa25d45..000000000000
--- a/examples/flower-simulation-step-by-step-pytorch/Part-I/model.py
+++ /dev/null
@@ -1,64 +0,0 @@
-import torch
-import torch.nn as nn
-import torch.nn.functional as F
-
-# Note the model and functions here defined do not have any FL-specific components.
-
-
-class Net(nn.Module):
-    """A simple CNN suitable for simple vision tasks."""
-
-    def __init__(self, num_classes: int) -> None:
-        super(Net, self).__init__()
-        self.conv1 = nn.Conv2d(1, 6, 5)
-        self.pool = nn.MaxPool2d(2, 2)
-        self.conv2 = nn.Conv2d(6, 16, 5)
-        self.fc1 = nn.Linear(16 * 4 * 4, 120)
-        self.fc2 = nn.Linear(120, 84)
-        self.fc3 = nn.Linear(84, num_classes)
-
-    def forward(self, x: torch.Tensor) -> torch.Tensor:
-        x = self.pool(F.relu(self.conv1(x)))
-        x = self.pool(F.relu(self.conv2(x)))
-        x = x.view(-1, 16 * 4 * 4)
-        x = F.relu(self.fc1(x))
-        x = F.relu(self.fc2(x))
-        x = self.fc3(x)
-        return x
-
-
-def train(net, trainloader, optimizer, epochs, device: str):
-    """Train the network on the training set.
-
-    This is a fairly simple training loop for PyTorch.
-    """
-    criterion = torch.nn.CrossEntropyLoss()
-    net.train()
-    net.to(device)
-    for _ in range(epochs):
-        for images, labels in trainloader:
-            images, labels = images.to(device), labels.to(device)
-            optimizer.zero_grad()
-            loss = criterion(net(images), labels)
-            loss.backward()
-            optimizer.step()
-
-
-def test(net, testloader, device: str):
-    """Validate the network on the entire test set.
-
-    and report loss and accuracy.
-    """
-    criterion = torch.nn.CrossEntropyLoss()
-    correct, loss = 0, 0.0
-    net.eval()
-    net.to(device)
-    with torch.no_grad():
-        for data in testloader:
-            images, labels = data[0].to(device), data[1].to(device)
-            outputs = net(images)
-            loss += criterion(outputs, labels).item()
-            _, predicted = torch.max(outputs.data, 1)
-            correct += (predicted == labels).sum().item()
-    accuracy = correct / len(testloader.dataset)
-    return loss, accuracy
diff --git a/examples/flower-simulation-step-by-step-pytorch/Part-I/server.py b/examples/flower-simulation-step-by-step-pytorch/Part-I/server.py
deleted file mode 100644
index 93350ae2d1ba..000000000000
--- a/examples/flower-simulation-step-by-step-pytorch/Part-I/server.py
+++ /dev/null
@@ -1,59 +0,0 @@
-from collections import OrderedDict
-
-import torch
-from omegaconf import DictConfig
-
-from model import Net, test
-
-
-def get_on_fit_config(config: DictConfig):
-    """Return function that prepares config to send to clients."""
-
-    def fit_config_fn(server_round: int):
-        # This function will be executed by the strategy in its
-        # `configure_fit()` method.
-
-        # Here we are returning the same config on each round but
-        # here you might use the `server_round` input argument to
-        # adapt over time these settings so clients. For example, you
-        # might want clients to use a different learning rate at later
-        # stages in the FL process (e.g. smaller lr after N rounds)
-
-        return {
-            "lr": config.lr,
-            "momentum": config.momentum,
-            "local_epochs": config.local_epochs,
-        }
-
-    return fit_config_fn
-
-
-def get_evaluate_fn(num_classes: int, testloader):
-    """Define function for global evaluation on the server."""
-
-    def evaluate_fn(server_round: int, parameters, config):
-        # This function is called by the strategy's `evaluate()` method
-        # and receives as input arguments the current round number and the
-        # parameters of the global model.
-        # this function takes these parameters and evaluates the global model
-        # on a evaluation / test dataset.
-
-        model = Net(num_classes)
-
-        device = torch.device("cuda:0" if torch.cuda.is_available() else "cpu")
-
-        params_dict = zip(model.state_dict().keys(), parameters)
-        state_dict = OrderedDict({k: torch.Tensor(v) for k, v in params_dict})
-        model.load_state_dict(state_dict, strict=True)
-
-        # Here we evaluate the global model on the test set. Recall that in more
-        # realistic settings you'd only do this at the end of your FL experiment
-        # you can use the `server_round` input argument to determine if this is the
-        # last round. If it's not, then preferably use a global validation set.
-        loss, accuracy = test(model, testloader, device)
-
-        # Report the loss and any other metric (inside a dictionary). In this case
-        # we report the global test accuracy.
-        return loss, {"accuracy": accuracy}
-
-    return evaluate_fn
diff --git a/examples/flower-simulation-step-by-step-pytorch/Part-II/README.md b/examples/flower-simulation-step-by-step-pytorch/Part-II/README.md
deleted file mode 100644
index 2c081ed9e7dc..000000000000
--- a/examples/flower-simulation-step-by-step-pytorch/Part-II/README.md
+++ /dev/null
@@ -1,42 +0,0 @@
-# A Complete FL Simulation Pipeline using Flower (w/ better Hydra usage)
-
-The code in this directory is fairly similar to that presented in [`simulation-pytorch example`](https://github.com/adap/flower/tree/main/examples/simulation-pytorch) but extended into a series of [step-by-step video tutorials](https://www.youtube.com/playlist?list=PLNG4feLHqCWlnj8a_E1A_n5zr2-8pafTB) on how to Federated Learning simulations using Flower. In Part-I, we made use of a very simple config structure using a single `YAML` file. With the code here presented, we take a dive into more advanced config structures leveraging some of the core functionality of Hydra. You can find more information about Hydra in the [Hydra Documentation](https://hydra.cc/docs/intro/). To the files I have added a fair amount of comments to support and expand upon what was said in the video tutorial.
-
-The content of the code in this directory is roughly divided into two parts:
-
-- `toy.py` and its associated config files (i.e. `conf/toy.yaml` and `conf/toy_model/`) which were designed as a playground to test out some of the functionality of Hydra configs that we want to incorporate into our Flower projects.
-- and the rest: which follows the exact same structure as in the code presented in [Part-I](https://github.com/adap/flower/tree/main/examples/flower-simulation-step-by-step-pytorch/Part-I) but that has been _enhanced_ using Hydra.
-
-## Running the Code
-
-You can run the introductory demo code (i.e. `toy.py`) about how to use Hydra as shown below:
-
-```bash
-python toy.py # this will run with the default arguments shown in `conf/toy.yaml`
-
-# You can override elements easily
-python toy.py foo=456 # will replace foo's default value (123) with 456
-python toy.py bar.bazz=48 # will replace bar.bazz's default value (24) with 48
-# or change both
-python toy.py foo=456 bar.bazz=48
-
-# you can override in this way pretty much anything
-python toy.py my_func.x=456 # will replace the x input argument to function `function_test` in toy.py
-
-# to modify the 'defaults' list (see the bottom of `conf/toy.yaml`) the syntax is a bit different
-python toy.py toy_model=mobilenetv2 # will replace the default pointing to `resnet18.yaml`
-```
-
-Now that you know how to work with Hydra, using more complex config files in your Flower projects (note this can be also applied outside simulation), should feel very intuitive! Let's see a couple of examples on how to launch the simulation:
-
-```bash
-python main.py # will launch the simulation with default arguments replicating the exact same setup as in the code for the first part of this tutorial (were we used only a fairly plain .yaml config)
-
-# the default config uses FedAvg, you can override this easily by pointing it instead ot use FedAdam
-# internally, Hydra will resolve this command and load `conf/strategy/fedadam.yaml`
-python main.py strategy=fedadam
-
-# you can also further change the default config
-python main.py strategy=fedadam num_rounds=20 # will use FedAdam and 20 rounds
-python main.py strategy=fedadam strategy.tau=0.2 # will use FedAdam and then override its default tau value
-```
diff --git a/examples/flower-simulation-step-by-step-pytorch/Part-II/client.py b/examples/flower-simulation-step-by-step-pytorch/Part-II/client.py
deleted file mode 100644
index 098cac293d94..000000000000
--- a/examples/flower-simulation-step-by-step-pytorch/Part-II/client.py
+++ /dev/null
@@ -1,78 +0,0 @@
-from collections import OrderedDict
-from typing import Dict, Tuple
-
-import flwr as fl
-import torch
-from flwr.common import NDArrays, Scalar
-from hydra.utils import instantiate
-
-from model import test, train
-
-
-class FlowerClient(fl.client.NumPyClient):
-    """A standard FlowerClient."""
-
-    def __init__(self, trainloader, vallodaer, model_cfg) -> None:
-        super().__init__()
-
-        self.trainloader = trainloader
-        self.valloader = vallodaer
-
-        # For further flexibility, we don't hardcode the type of model we use in
-        # federation. Here we are instantiating the object defined in `conf/model/net.yaml`
-        # (unless you changed the default) and by then `num_classes` would already be auto-resolved
-        # to `num_classes=10` (since this was known right from the moment you launched the experiment)
-        self.model = instantiate(model_cfg)
-
-        self.device = torch.device("cuda:0" if torch.cuda.is_available() else "cpu")
-
-    def set_parameters(self, parameters):
-        params_dict = zip(self.model.state_dict().keys(), parameters)
-        state_dict = OrderedDict({k: torch.Tensor(v) for k, v in params_dict})
-        self.model.load_state_dict(state_dict, strict=True)
-
-    def get_parameters(self, config: Dict[str, Scalar]):
-        return [val.cpu().numpy() for _, val in self.model.state_dict().items()]
-
-    def fit(self, parameters, config):
-        # copy parameters sent by the server into client's local model
-        self.set_parameters(parameters)
-
-        lr = config["lr"]
-        momentum = config["momentum"]
-        epochs = config["local_epochs"]
-
-        # You could also set this optimiser from a config file. That would make it
-        # easy to run experiments considering different optimisers and set one or another
-        # directly from the command line (you can use as inspiration what we did for adding
-        # support for FedAvg and FedAdam strategies)
-        optim = torch.optim.SGD(self.model.parameters(), lr=lr, momentum=momentum)
-
-        # do local training
-        # similarly, you can set this via a config. For example, imagine you have different
-        # experiments using wildly different training protocols (e.g. vision, speech). You can
-        # toggle between different training functions directly from the config without having
-        # to clutter your code with if/else statements all over the place :)
-        train(self.model, self.trainloader, optim, epochs, self.device)
-
-        return self.get_parameters({}), len(self.trainloader), {}
-
-    def evaluate(self, parameters: NDArrays, config: Dict[str, Scalar]):
-        self.set_parameters(parameters)
-
-        loss, accuracy = test(self.model, self.valloader, self.device)
-
-        return float(loss), len(self.valloader), {"accuracy": accuracy}
-
-
-def generate_client_fn(trainloaders, valloaders, model_cfg):
-    """Return a function to construct a FlowerClient."""
-
-    def client_fn(cid: str):
-        return FlowerClient(
-            trainloader=trainloaders[int(cid)],
-            vallodaer=valloaders[int(cid)],
-            model_cfg=model_cfg,
-        ).to_client()
-
-    return client_fn
diff --git a/examples/flower-simulation-step-by-step-pytorch/Part-II/conf/base.yaml b/examples/flower-simulation-step-by-step-pytorch/Part-II/conf/base.yaml
deleted file mode 100644
index 5d18c77ad8e5..000000000000
--- a/examples/flower-simulation-step-by-step-pytorch/Part-II/conf/base.yaml
+++ /dev/null
@@ -1,16 +0,0 @@
----
-
-num_rounds: 10
-num_clients: 100
-batch_size: 20
-num_classes: 10
-num_clients_per_round_fit: 10
-num_clients_per_round_eval: 25
-config_fit:
-  lr: 0.01
-  momentum: 0.9
-  local_epochs: 1
-
-defaults:
-  - model: net
-  - strategy: fedavg # points to conf/strategy/fedavg.yaml
\ No newline at end of file
diff --git a/examples/flower-simulation-step-by-step-pytorch/Part-II/conf/model/net.yaml b/examples/flower-simulation-step-by-step-pytorch/Part-II/conf/model/net.yaml
deleted file mode 100644
index ee9e0158237f..000000000000
--- a/examples/flower-simulation-step-by-step-pytorch/Part-II/conf/model/net.yaml
+++ /dev/null
@@ -1,3 +0,0 @@
----
-_target_: model.Net
-num_classes: ${num_classes}
\ No newline at end of file
diff --git a/examples/flower-simulation-step-by-step-pytorch/Part-II/conf/strategy/fedadam.yaml b/examples/flower-simulation-step-by-step-pytorch/Part-II/conf/strategy/fedadam.yaml
deleted file mode 100644
index 4acf5c5d08b2..000000000000
--- a/examples/flower-simulation-step-by-step-pytorch/Part-II/conf/strategy/fedadam.yaml
+++ /dev/null
@@ -1,21 +0,0 @@
----
-# Points to: https://github.com/adap/flower/blob/main/src/py/flwr/server/strategy/fedadam.py
-_target_: flwr.server.strategy.FedAdam # points to the standard FedAdam strategy (note you could point to your custom strategies too)
-fraction_fit: 0.00001
-min_fit_clients: ${num_clients_per_round_fit} # you can refer to any other variable defined in the config (as long as it is part of the experiment you run)
-fraction_evaluate: 0.00001
-min_evaluate_clients: ${num_clients_per_round_eval} # this is a reference to the setting defined in `conf/base.yaml`
-min_available_clients: ${num_clients}
-on_fit_config_fn: # this is a function
-  _target_: server.get_on_fit_config
-  config: ${config_fit}
-# arguments unique to FedAdam
-eta: 0.2
-eta_l: 0.01 # client side learning rate ! so be sure the clients get it (This is not implemented currently in the example code given)
-tau: 0.1
-initial_parameters: # This optional for some strategies, but required by FedAdam
-  _target_: model.model_to_parameters
-  model: ${model} # note you don't need to do `${defaults.model}`, just `${model}`
-# we could define here evaluate_fn, but since it requires arguments
-# that are defined at runtime (e.g. the test loader), let's better
-# do it in the main
diff --git a/examples/flower-simulation-step-by-step-pytorch/Part-II/conf/strategy/fedavg.yaml b/examples/flower-simulation-step-by-step-pytorch/Part-II/conf/strategy/fedavg.yaml
deleted file mode 100644
index 32191e3d9cfb..000000000000
--- a/examples/flower-simulation-step-by-step-pytorch/Part-II/conf/strategy/fedavg.yaml
+++ /dev/null
@@ -1,13 +0,0 @@
----
-_target_: flwr.server.strategy.FedAvg # points to FedAvg (as if you were doing it in your python file)
-fraction_fit: 0.00001
-min_fit_clients: ${num_clients_per_round_fit} # you can refer to any other variable defined in the config (as long as it is part of the experiment you run)
-fraction_evaluate: 0.00001
-min_evaluate_clients: ${num_clients_per_round_eval} # this is a reference to the setting defined in `conf/base.yaml`
-min_available_clients: ${num_clients}
-on_fit_config_fn: # this is a function
-  _target_: server.get_on_fit_config
-  config: ${config_fit}
-# we could define here evaluate_fn, but since it requires arguments
-# that are defined at runtime (e.g. the test loader), let's better
-# do it in the main
diff --git a/examples/flower-simulation-step-by-step-pytorch/Part-II/conf/toy.yaml b/examples/flower-simulation-step-by-step-pytorch/Part-II/conf/toy.yaml
deleted file mode 100644
index cc5a7f3a5ced..000000000000
--- a/examples/flower-simulation-step-by-step-pytorch/Part-II/conf/toy.yaml
+++ /dev/null
@@ -1,70 +0,0 @@
----
-
-
-## THE EASY BITS
-
-# a simple top-level element
-foo: 123
-
-# a hierarchy of variables
-bar:
-  baz: [1.0, 3.141592, 99]
-  bazz: 24
-  more:
-    bla: "hello"
-    blabla: ${foo} # reference to `foo` at the top of this file
-
-# -------------------------------------------------------------------------------------------------
-## NOW I'M INTERESTED
-
-# A node describing a function with all arguments pre-defined
-my_func:
-  _target_: toy.function_test
-  x: 123 # a named argument for your function
-  y: 321 # another named argument for your function
-
-
-# so we tell Hydra to instantiate a partial of this function. This is convenient if the second argument (y) is only defined at runtime
-my_partial_func:
-  _target_: toy.function_test
-  _partial_: true
-  x: 123
-
-# create an object
-my_object:
-  _target_: toy.MyClass
-  x: 32 # a property of the class
-
-# -------------------------------------------------------------------------------------------------
-## NOW YOU ARE FLYING
-
-# You can have objects defined by Hydra inside other objects
-# and by default all will be instantiated
-my_complex_object:
-  _target_: toy.MyComplexClass
-  my_object:
-    _target_: toy.MyClass
-    x: ${bar.bazz} # reference to bar.bazz
-
-# In some settings internal objects can't be instantiated at the same
-# time as the parent object (maybe because it depends on some external
-# variables or process). You can prevent this by telling Hydra not to
-# instantiate objects recursively.
-my_complex_object_non_recursive:
-  _target_: toy.MyComplexClass
-  _recursive_: false
-  my_object:
-    _target_: toy.MyClass
-    # we'll pass the argument at runtime
-
-# sometimes you want to deconstruct your config file into several, each designed for a clear purpose.
-# For example, one set of .yaml files for dataset, another for model architectures. When you use Flower
-# you probably want to have one set of .yaml for the strategies, another for different types of clients, etc
-# With hydra, you want to structure these config files in a very particular way. For example, if you
-# want a node (e.g 'toy_model`) to be parameterised by different config files, they all should go
-# inside a directory called `toy_model`, then you do as shown below to pick different .yamls
-defaults:
-  - toy_model: resnet18 # will point to conf/toy_model/resnet18.yaml
-  # if you want to override this parameter you'd do it without considering the "default" keyword
-  # python toy.py toy_model=efficientnetb3
-  # Note that `defaults` is a list (i.e., each element has `-` at the beginning)
diff --git a/examples/flower-simulation-step-by-step-pytorch/Part-II/conf/toy_model/mobilenetv2.yaml b/examples/flower-simulation-step-by-step-pytorch/Part-II/conf/toy_model/mobilenetv2.yaml
deleted file mode 100644
index e9139723442a..000000000000
--- a/examples/flower-simulation-step-by-step-pytorch/Part-II/conf/toy_model/mobilenetv2.yaml
+++ /dev/null
@@ -1,4 +0,0 @@
----
-# will instantiate TorchVision's MobileNetV2 and set the number of classes to ${foo}
-_target_: torchvision.models.mobilenet_v2
-num_classes: ${foo}
\ No newline at end of file
diff --git a/examples/flower-simulation-step-by-step-pytorch/Part-II/conf/toy_model/resnet18.yaml b/examples/flower-simulation-step-by-step-pytorch/Part-II/conf/toy_model/resnet18.yaml
deleted file mode 100644
index 8794eada0316..000000000000
--- a/examples/flower-simulation-step-by-step-pytorch/Part-II/conf/toy_model/resnet18.yaml
+++ /dev/null
@@ -1,4 +0,0 @@
----
-# will instantiate TorchVision's ResNet18 and set the number of classes to ${foo}
-_target_: torchvision.models.resnet18
-num_classes: ${foo}
\ No newline at end of file
diff --git a/examples/flower-simulation-step-by-step-pytorch/Part-II/dataset.py b/examples/flower-simulation-step-by-step-pytorch/Part-II/dataset.py
deleted file mode 100644
index fb5d8504ed65..000000000000
--- a/examples/flower-simulation-step-by-step-pytorch/Part-II/dataset.py
+++ /dev/null
@@ -1,60 +0,0 @@
-import torch
-from torch.utils.data import DataLoader, random_split
-from torchvision.datasets import MNIST
-from torchvision.transforms import Compose, Normalize, ToTensor
-
-
-def get_mnist(data_path: str = "./data"):
-    """Downlaod MNIST and apply a simple transform."""
-
-    tr = Compose([ToTensor(), Normalize((0.1307,), (0.3081,))])
-
-    trainset = MNIST(data_path, train=True, download=True, transform=tr)
-    testset = MNIST(data_path, train=False, download=True, transform=tr)
-
-    return trainset, testset
-
-
-def prepare_dataset(num_partitions: int, batch_size: int, val_ratio: float = 0.1):
-    """Download and partition the MNIST dataset."""
-
-    # We are not doing any Hydra magic here but this is one place you'd normally
-    # add some of it. Why? because you probably want different datasets in your
-    # Flower experiments. Each could easily require a different partitioning mechanism
-    # or none at all. For example, if you want to use MNIST, CIFAR-10, FEMNIST, SpeechCommands,
-    # these require very different loading/partitioning/preprocessing methodologies.
-    # having this arranged via Hydra configs might be a small upfront cost but it pays off.
-
-    trainset, testset = get_mnist()
-
-    # split trainset into `num_partitions` trainsets
-    num_images = len(trainset) // num_partitions
-
-    partition_len = [num_images] * num_partitions
-
-    trainsets = random_split(
-        trainset, partition_len, torch.Generator().manual_seed(2023)
-    )
-
-    # create dataloaders with train+val support
-    trainloaders = []
-    valloaders = []
-    for trainset_ in trainsets:
-        num_total = len(trainset_)
-        num_val = int(val_ratio * num_total)
-        num_train = num_total - num_val
-
-        for_train, for_val = random_split(
-            trainset_, [num_train, num_val], torch.Generator().manual_seed(2023)
-        )
-
-        trainloaders.append(
-            DataLoader(for_train, batch_size=batch_size, shuffle=True, num_workers=2)
-        )
-        valloaders.append(
-            DataLoader(for_val, batch_size=batch_size, shuffle=False, num_workers=2)
-        )
-
-    testloader = DataLoader(testset, batch_size=128)
-
-    return trainloaders, valloaders, testloader
diff --git a/examples/flower-simulation-step-by-step-pytorch/Part-II/main.py b/examples/flower-simulation-step-by-step-pytorch/Part-II/main.py
deleted file mode 100644
index 6da664df1203..000000000000
--- a/examples/flower-simulation-step-by-step-pytorch/Part-II/main.py
+++ /dev/null
@@ -1,82 +0,0 @@
-import pickle
-from pathlib import Path
-
-import flwr as fl
-import hydra
-from hydra.core.hydra_config import HydraConfig
-from hydra.utils import call, instantiate
-from omegaconf import DictConfig, OmegaConf
-
-from client import generate_client_fn
-from dataset import prepare_dataset
-from server import get_evalulate_fn, get_on_fit_config
-
-# !!!! The code in this directory is the result of adpating the project first shown
-# in <LINK> to make better use of Hydra's config system. It is recommended to first
-# check the original code. There you'll find also additional comments walking you
-# through in detail what each part of the code does.
-
-
-@hydra.main(config_path="conf", config_name="base", version_base=None)
-def main(cfg: DictConfig):
-    ## 1. Parse config & get experiment output dir
-    print(OmegaConf.to_yaml(cfg))
-    save_path = HydraConfig.get().runtime.output_dir
-
-    ## 2. Prepare your dataset
-    trainloaders, validationloaders, testloader = prepare_dataset(
-        cfg.num_clients, cfg.batch_size
-    )
-
-    ## 3. Define your clients
-    # client_fn = generate_client_fn(trainloaders, validationloaders, cfg.num_classes)
-
-    # Let's pass the config node that defines the model. in this way changing models doesn't
-    # require any changes to the code (just run the code with a different config)
-    client_fn = generate_client_fn(trainloaders, validationloaders, cfg.model)
-
-    ## 4. Define your strategy
-    # strategy = fl.server.strategy.FedAvg(fraction_fit=0.00001,
-    #                                      min_fit_clients=cfg.num_clients_per_round_fit,
-    #                                      fraction_evaluate=0.00001,
-    #                                      min_evaluate_clients=cfg.num_clients_per_round_eval,
-    #                                      min_available_clients=cfg.num_clients,
-    #                                      on_fit_config_fn=get_on_fit_config(cfg.config_fit),
-    #                                      evaluate_fn=get_evalulate_fn(cfg.num_classes,
-    #                                                                   testloader),
-    #                                                                   )
-
-    # So we have replaced the above with just a single line. Now if we want to use a different strategy,
-    # even if it uses new arguments, you can leave the code below as is and pick a different config
-    # The line below is instantiating the `strategy` node in the config. The result is an object of
-    # the type specified in the _target_ field of it's config structure. For example, if you are using
-    # the default (`conf/strategy/fedavg.yaml`), then _target_ is `flwr.server.strategy.FedAvg`.
-    # The moment you run the experiment (i.e. when the config is parsed) not all field would be defined.
-    # for instance, the testloader is not ready so `evaluate_fn` argument cannot be set. You can pass them
-    # manually the moment you call `instantiate`. (if you are familiar with Python partials, this is similar)
-    strategy = instantiate(
-        cfg.strategy, evaluate_fn=get_evalulate_fn(cfg.model, testloader)
-    )
-
-    ## 5. Start Simulation
-    # As you'll notice, we can start the simulation in exactly the same way as we did in the previous project.
-    history = fl.simulation.start_simulation(
-        client_fn=client_fn,
-        num_clients=cfg.num_clients,
-        config=fl.server.ServerConfig(num_rounds=cfg.num_rounds),
-        strategy=strategy,
-        client_resources={"num_cpus": 2, "num_gpus": 0.0},
-    )
-
-    ## 6. Save your results
-    # now we save the results of the simulation.
-    results_path = Path(save_path) / "results.pkl"
-
-    results = {"history": history, "anythingelse": "here"}
-
-    with open(str(results_path), "wb") as h:
-        pickle.dump(results, h, protocol=pickle.HIGHEST_PROTOCOL)
-
-
-if __name__ == "__main__":
-    main()
diff --git a/examples/flower-simulation-step-by-step-pytorch/Part-II/model.py b/examples/flower-simulation-step-by-step-pytorch/Part-II/model.py
deleted file mode 100644
index f57bc9b5d100..000000000000
--- a/examples/flower-simulation-step-by-step-pytorch/Part-II/model.py
+++ /dev/null
@@ -1,67 +0,0 @@
-import torch
-import torch.nn as nn
-import torch.nn.functional as F
-from flwr.common.parameter import ndarrays_to_parameters
-
-
-class Net(nn.Module):
-    def __init__(self, num_classes: int) -> None:
-        super(Net, self).__init__()
-        self.conv1 = nn.Conv2d(1, 6, 5)
-        self.pool = nn.MaxPool2d(2, 2)
-        self.conv2 = nn.Conv2d(6, 16, 5)
-        self.fc1 = nn.Linear(16 * 4 * 4, 120)
-        self.fc2 = nn.Linear(120, 84)
-        self.fc3 = nn.Linear(84, num_classes)
-
-    def forward(self, x: torch.Tensor) -> torch.Tensor:
-        x = self.pool(F.relu(self.conv1(x)))
-        x = self.pool(F.relu(self.conv2(x)))
-        x = x.view(-1, 16 * 4 * 4)
-        x = F.relu(self.fc1(x))
-        x = F.relu(self.fc2(x))
-        x = self.fc3(x)
-        return x
-
-
-def train(net, trainloader, optimizer, epochs, device: str):
-    """Train the network on the training set."""
-    criterion = torch.nn.CrossEntropyLoss()
-    net.train()
-    net.to(device)
-    for _ in range(epochs):
-        for images, labels in trainloader:
-            images, labels = images.to(device), labels.to(device)
-            optimizer.zero_grad()
-            loss = criterion(net(images), labels)
-            loss.backward()
-            optimizer.step()
-
-
-def test(net, testloader, device: str):
-    """Validate the network on the entire test set."""
-    criterion = torch.nn.CrossEntropyLoss()
-    correct, loss = 0, 0.0
-    net.eval()
-    net.to(device)
-    with torch.no_grad():
-        for data in testloader:
-            images, labels = data[0].to(device), data[1].to(device)
-            outputs = net(images)
-            loss += criterion(outputs, labels).item()
-            _, predicted = torch.max(outputs.data, 1)
-            correct += (predicted == labels).sum().item()
-    accuracy = correct / len(testloader.dataset)
-    return loss, accuracy
-
-
-def model_to_parameters(model):
-    """Note that the model is already instantiated when passing it here.
-
-    This happens because we call this utility function when instantiating the parent
-    object (i.e. the FedAdam strategy in this example).
-    """
-    ndarrays = [val.cpu().numpy() for _, val in model.state_dict().items()]
-    parameters = ndarrays_to_parameters(ndarrays)
-    print("Extracted model parameters!")
-    return parameters
diff --git a/examples/flower-simulation-step-by-step-pytorch/Part-II/server.py b/examples/flower-simulation-step-by-step-pytorch/Part-II/server.py
deleted file mode 100644
index f1f8293cc6fb..000000000000
--- a/examples/flower-simulation-step-by-step-pytorch/Part-II/server.py
+++ /dev/null
@@ -1,39 +0,0 @@
-from collections import OrderedDict
-
-import torch
-from hydra.utils import instantiate
-from omegaconf import DictConfig
-
-from model import Net, test
-
-
-def get_on_fit_config(config: DictConfig):
-    """Return a function to configure the client's fit."""
-
-    def fit_config_fn(server_round: int):
-        return {
-            "lr": config.lr,
-            "momentum": config.momentum,
-            "local_epochs": config.local_epochs,
-        }
-
-    return fit_config_fn
-
-
-def get_evalulate_fn(model_cfg: int, testloader):
-    """Return a function to evaluate the global model."""
-
-    def evaluate_fn(server_round: int, parameters, config):
-        model = instantiate(model_cfg)
-
-        device = torch.device("cuda:0" if torch.cuda.is_available() else "cpu")
-
-        params_dict = zip(model.state_dict().keys(), parameters)
-        state_dict = OrderedDict({k: torch.Tensor(v) for k, v in params_dict})
-        model.load_state_dict(state_dict, strict=True)
-
-        loss, accuracy = test(model, testloader, device)
-
-        return loss, {"accuracy": accuracy}
-
-    return evaluate_fn
diff --git a/examples/flower-simulation-step-by-step-pytorch/Part-II/toy.py b/examples/flower-simulation-step-by-step-pytorch/Part-II/toy.py
deleted file mode 100644
index 0bae932e3bce..000000000000
--- a/examples/flower-simulation-step-by-step-pytorch/Part-II/toy.py
+++ /dev/null
@@ -1,111 +0,0 @@
-import hydra
-from hydra.utils import call, instantiate
-from omegaconf import DictConfig, OmegaConf
-
-
-def function_test(x: int, y: int):
-    """A simple function that ads up two integers."""
-    print(f"`function_test` received: {x = }, and {y = }")
-    result = x + y
-    print(f"{result = }")
-
-
-class MyClass:
-    """A simple class."""
-
-    def __init__(self, x):
-        self.x = x
-
-    def print_x_squared(self):
-        print(f"{self.x**2 = }")
-
-
-class MyComplexClass:
-    """A class with some Hydra magic inside."""
-
-    def __init__(self, my_object: MyClass):
-        self.object = my_object
-
-    def instantiate_child(self, value):
-        self.object = instantiate(self.object, x=value)
-
-
-# run main() by passing the `conf/toy.yaml` config file in this directory
-@hydra.main(config_path="conf", config_name="toy", version_base=None)
-def main(cfg: DictConfig):
-    # print config as yaml
-    print(OmegaConf.to_yaml(cfg))
-
-    ## THE EASY BITS
-    print("--------" * 7)
-    # Access elements in your config easily by:
-    print(f"{cfg.foo = }")
-    print(f"{cfg.bar.baz = }")
-    print(f"{cfg.bar.more = }")
-    print(
-        f"{cfg.bar.more.blabla = }"
-    )  # not how when you do access the element directly, it's value gets assigned (not shown as a reference anymore)
-
-    ## NOW I'M INTERESTED !
-    print("--------" * 7)
-    # Let's run a standard Python function (`function_test` defined above)
-    # with the arguments for x and y specified in the config file
-    call(cfg.my_func)
-
-    # you can override some arguments at runtime too (which is a bit linked to the
-    # topic of the next comment below)
-    call(cfg.my_func, x=99)
-
-    # In some settings not all argument will be ready immediately, but you still
-    # want to be able to call it from other places in your code once the remaining
-    # arguments are defined/updated. You can do this using a Python partial.
-    partial_fn = call(
-        cfg.my_partial_func
-    )  #! If you run this with `_partial_` set to false in the config, it will trigger an error since `y` is not defined
-
-    # with your partial ready you can call the original function by specifying
-    # the value of `y` you like.
-    partial_fn(y=2023)
-    # Aren't partials the second best thing ever?! (after Flower)
-
-    # Similarly to functions, you can create standard Python objects. This time use
-    # `instantiate` instead of `call`. The same principle for partials applies here too
-    object: MyClass = instantiate(cfg.my_object)
-    # then you can call its methods as usual
-    object.print_x_squared()  # if you were to type this line yourself you'd notice that there was no autocompletion
-    # this is because the class that `object` is an instance of is only know at run time.
-    # This makes writing code a bit more inconvenient but it's a small price to pay given
-    # how versatile Hydra would make your code base.
-    # You could have set the type in the line above by doing: `object: MyClass = instantiate(cfg.my_objcetc)`
-    # but, unless all your objects do inherit from a common parent class, this approach might restrict Hydra.
-
-    ## NOW YOU ARE FLYING !!!
-    print("--------" * 7)
-    # your objects can have other objects inside also defined w/ Hydra
-    # by default, `instantiate()` will instantiate everything recursively.
-    obj = instantiate(cfg.my_complex_object)
-    print(obj.object.x)  # should print 99 unless you changed the config
-
-    # In some situations you might want to have the top-level object defined
-    # but not the child objects. Maybe because they can only be instantiated
-    # after some other data is available or maybe because you prefer to have
-    # more control over the instantiation process. Set `_recursive_` to false
-    # in order to prevent recursive instantiation of objects
-    obj = instantiate(cfg.my_complex_object_non_recursive)
-    print(obj.object)  # you'll see that it retains the config content
-    # now let's instantiate setting it's value `x`
-    obj.instantiate_child(9999)
-    print(
-        obj.object.x
-    )  # it should print now the value we instantiate the object of type `MyClass` with (i.e. =9999)
-
-    # finally, let's instantiate the PyTorch model set in our config
-    # (yes, you can instantiate any class, not just the ones you create)
-    model = instantiate(cfg.toy_model)
-    # print(model) #! print the model architecture (uncomment)
-    num_parameters = sum([p.numel() for p in model.state_dict().values()])
-    print(f"{cfg.toy_model} has: {num_parameters} parameters")
-
-
-if __name__ == "__main__":
-    main()
diff --git a/examples/flower-simulation-step-by-step-pytorch/README.md b/examples/flower-simulation-step-by-step-pytorch/README.md
index b00afedbe80b..0f269f62c143 100644
--- a/examples/flower-simulation-step-by-step-pytorch/README.md
+++ b/examples/flower-simulation-step-by-step-pytorch/README.md
@@ -1,50 +1,129 @@
 ---
-tags: [basic, vision, simulation]
-dataset: [MNIST]
+tags: [vision, simulation, video-tutorial]
+dataset: [Fashion-MNIST]
 framework: [torch]
 ---
 
 # Flower Simulation Step-by-Step
 
-> Since this tutorial (and its video series) was put together, Flower has been updated a few times. As a result, some of the steps to construct the environment (see below) have been updated. Some parts of the code have also been updated. Overall, the content of this tutorial and how things work remains the same as in the video tutorials.
+> \[!NOTE\]
+> While this tutorial shows how to extend the functionality of a Flower App that uses PyTorch, there is little specific about PyTorch in the changes described in this tutorial series. This means that you can make use of all the concepts presented even if you decide to use a different ML framework.
 
-This directory contains the code developed in the `Flower Simulation` tutorial series on Youtube. You can find all the videos [here](https://www.youtube.com/playlist?list=PLNG4feLHqCWlnj8a_E1A_n5zr2-8pafTB) or clicking on the video preview below.
+This directory contains the code to follow along the `Flower AI Simulation 2025` tutorial series on Youtube. You can find all the videos [here](https://www.youtube.com/playlist?list=PLNG4feLHqCWkdlSrEL2xbCtGa6QBxlUZb) or clicking on the video previews below.
 
-- In `Part-I` (7 videos) we developed from scratch a complete Federated Learning pipeline for simulation using PyTorch.
-- In `Part-II` (2 videos) we _enhanced_ the code in `Part-I` by making a better use of Hydra configs.
+| [![Image 1](https://img.youtube.com/vi/XK_dRVcSZqg/0.jpg)](https://youtu.be/XK_dRVcSZqg) | [![Image 1](https://img.youtube.com/vi/VwGq16DMx3Q/0.jpg)](https://youtu.be/VwGq16DMx3Q) | [![Image 2](https://img.youtube.com/vi/8Uwsa0x7VJw/0.jpg)](https://youtu.be/8Uwsa0x7VJw) | [![Image 3](https://img.youtube.com/vi/KsMP9dgcLw4/0.jpg)](https://youtu.be/KsMP9dgcLw4) | [![Image 4](https://img.youtube.com/vi/dZRDe1ldy5s/0.jpg)](https://youtu.be/dZRDe1ldy5s) |
+| ---------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
+| [![Image 5](https://img.youtube.com/vi/udDSIQyYzNM/0.jpg)](https://youtu.be/udDSIQyYzNM) | [![Image 6](https://img.youtube.com/vi/ppYemmT2mOs/0.jpg)](https://youtu.be/ppYemmT2mOs) | [![Image 7](https://img.youtube.com/vi/TAUxb9eEZ3w/0.jpg)](https://youtu.be/TAUxb9eEZ3w) | [![Image 8](https://img.youtube.com/vi/nUUkuqi4Lpo/0.jpg)](https://youtu.be/nUUkuqi4Lpo) |                                                                                          |
 
-<div align="center">
-      <a href="https://www.youtube.com/playlist?list=PLNG4feLHqCWlnj8a_E1A_n5zr2-8pafTB" target="_blank" rel="noopener noreferrer">
-         <img src="https://img.youtube.com/vi/cRebUIGB5RU/0.jpg" style="width:75%;">
-      </a>
-</div>
+> \[!TIP\]
+> 🙋 Got questions? Something isn't covered or could be improved? **We'd love to hear from you!** Join the [🌼 Flower Workspace](https://flower.ai/join-slack/) and the [Flower Discuss Forum](https://discuss.flower.ai/)!
 
-## Constructing your Python Environment
+## Complementary Resources
 
-As presented in the video, we first need to create a Python environment. You are free to choose the tool you are most familiar with, we'll be using `conda` in this tutorial. You can create the conda and setup the environment as follows:
+In this tutorial series, we make reference to several pages in the [Flower Documentation](https://flower.ai/docs/). In particular, these videos highlight pages for:
 
-```bash
-# I'm assuming you are running this on an Ubuntu 22.04 machine (GPU is not required)
+- [Visualizing Dataset Distributions using `flwr-datasets`](https://flower.ai/docs/datasets/tutorial-visualize-label-distribution.html)
+- [List of all Partitioners available in `flwr-datasets`](https://flower.ai/docs/datasets/ref-api/flwr_datasets.partitioner.html)
+- [How-to Run Simulations page](https://flower.ai/docs/framework/how-to-run-simulations.html)
+- [How-to Design Stateful ClientApps](https://flower.ai/docs/framework/how-to-design-stateful-clients.html)
+- [Quickstart Pytorch Tutorial](https://flower.ai/docs/framework/tutorial-quickstart-pytorch.html)
+- [Advanced PyTorch Example](https://github.com/adap/flower/tree/main/examples/advanced-pytorch)
 
-# create the environment
-conda create -n flower_tutorial python=3.9 -y
+## Getting Started
 
-# activate your environment (depending on how you installed conda you might need to use `conda activate ...` instead)
-source activate flower_tutorial
+> \[!TIP\]
+> If you are developing on Windows, it is recommended to make use of the Windows Subsystem for Linux (WSL). Check the guide on [how to setup WSL for development on Windows](https://code.visualstudio.com/docs/remote/wsl).
 
-# install PyToch (other versions would likely work)
-conda install pytorch==1.13.1 torchvision==0.14.1 torchaudio==0.13.1 pytorch-cuda=11.6 -c pytorch -c nvidia -y
-# conda install pytorch==1.13.1 torchvision==0.14.1 torchaudio==0.13.1 -c pytorch -y # If you don't have a GPU
+As presented in the video, we start from a new Python 3.11 environment. You only need to activate it and install `flwr`.
 
-# Install Flower and other dependencies
-pip install -r requirements.txt
+```bash
+# Install Flower
+pip install -U flwr
 ```
 
-If you are running this on macOS with Apple Silicon (i.e. M1, M2), you'll need a different `grpcio` package if you see an error when running the code. To fix this do:
+Then, use the `flwr new` command to construct a new Flower App using the PyTorch template:
 
-```bash
-# with your conda environment activated
-pip uninstall grpcio
+```shell
+flwr new my-awesome-app
+```
+
+The vast majority of the content added to the App (as described in the video tutorials) isn't specific to PyTorch. This means you are welcome to choose another template such as `TF`, `NumPy`, `MLX` or `JAX` if you prefer. Just keep in mind you might need to do additional edits to your App (e.g. save the model differently, in the recommended way by your chosen ML framework) If you are undecided, `PyTorch` is a great framework.
+
+> \[!NOTE\]
+> These steps represent the very first commands shown on the first video. They `flwr new` command will create a Flower App you can run directly. In videos 2-7 you'll learn how to modify the App and add, step by step, new functionality. You can check the `my-awesome-app` directory, which contains the completed code presented in the tutorial videos.
+
+## Running the App
+
+Just like all other Flower Apps, you can run the one in this directory by means of `flwr run`. More info about this command in the videos!
+
+```shell
+flwr run my-awesome-app
+# Alternatively, if you cd into the `my-awesome-app` directory
+# you can run the app by simply doing `flwr run .`
+```
+
+The output you should expect without making changes to the code is as follows:
 
-conda install grpcio -y
+```shell
+Loading project configuration...
+Success
+wandb: Using wandb-core as the SDK backend.  Please refer to https://wandb.me/wandb-core for more information.
+wandb: Currently logged in as: <your-user>. Use `wandb login --relogin` to force relogin
+wandb: Tracking run with wandb version 0.18.7
+wandb: Run `wandb offline` to turn off syncing.
+wandb: Syncing run custom-strategy-2024-12-10_07:32:03
+wandb: ⭐️ View project at https://wandb.ai/<your-user>/flower-simulation-tutorial
+wandb: 🚀 View run at https://wandb.ai/<your-user>/flower-simulation-tutorial/runs/reyoryuu
+INFO :      Starting Flower ServerApp, config: num_rounds=3, no round_timeout
+INFO :
+INFO :      [INIT]
+INFO :      Using initial global parameters provided by strategy
+INFO :      Starting evaluation of initial global parameters
+INFO :      initial parameters (loss, other metrics): 2.3028839167695456, {'cen_accuracy': 0.0937}
+INFO :
+INFO :      [ROUND 1]
+INFO :      configure_fit: strategy sampled 5 clients (out of 10)
+INFO :      aggregate_fit: received 5 results and 0 failures
+INFO :      fit progress: (1, 2.0274660648248446, {'cen_accuracy': 0.3238}, 5.769022958003916)
+INFO :      configure_evaluate: strategy sampled 10 clients (out of 10)
+INFO :      aggregate_evaluate: received 10 results and 0 failures
+INFO :
+INFO :      [ROUND 2]
+INFO :      configure_fit: strategy sampled 5 clients (out of 10)
+INFO :      aggregate_fit: received 5 results and 0 failures
+INFO :      fit progress: (2, 0.7511614774362728, {'cen_accuracy': 0.6926}, 11.233382292004535)
+INFO :      configure_evaluate: strategy sampled 10 clients (out of 10)
+INFO :      aggregate_evaluate: received 10 results and 0 failures
+INFO :
+INFO :      [ROUND 3]
+INFO :      configure_fit: strategy sampled 5 clients (out of 10)
+INFO :      aggregate_fit: received 5 results and 0 failures
+INFO :      fit progress: (3, 0.5243101176172019, {'cen_accuracy': 0.8035}, 13.289899208000861)
+INFO :      configure_evaluate: strategy sampled 10 clients (out of 10)
+INFO :      aggregate_evaluate: received 10 results and 0 failures
+INFO :
+INFO :      [SUMMARY]
+INFO :      Run finished 3 round(s) in 13.60s
+INFO :          History (loss, distributed):
+INFO :                  round 1: 2.0251417029128924
+INFO :                  round 2: 0.7533456925429649
+INFO :                  round 3: 0.5141592433326874
+INFO :          History (loss, centralized):
+INFO :                  round 0: 2.3028839167695456
+INFO :                  round 1: 2.0274660648248446
+INFO :                  round 2: 0.7511614774362728
+INFO :                  round 3: 0.5243101176172019
+INFO :          History (metrics, distributed, fit):
+INFO :          {'max_b': [(1, 0.8776450829832974),
+INFO :                     (2, 0.8755706409526767),
+INFO :                     (3, 0.880116537616749)]}
+INFO :          History (metrics, distributed, evaluate):
+INFO :          {'accuracy': [(1, 0.3237817576009996),
+INFO :                        (2, 0.6909620991253644),
+INFO :                        (3, 0.8046647230320699)]}
+INFO :          History (metrics, centralized):
+INFO :          {'cen_accuracy': [(0, 0.0937), (1, 0.3238), (2, 0.6926), (3, 0.8035)]}
+INFO :
+wandb: 🚀 View run custom-strategy-2024-12-10_07:32:03 at: https://wandb.ai/<your-user>/flower-simulation...
+wandb: Find logs at: wandb/run-20241210_073204-reyoryuu/logs
 ```
diff --git a/examples/flower-simulation-step-by-step-pytorch/my-awesome-app/.gitignore b/examples/flower-simulation-step-by-step-pytorch/my-awesome-app/.gitignore
new file mode 100644
index 000000000000..68bc17f9ff21
--- /dev/null
+++ b/examples/flower-simulation-step-by-step-pytorch/my-awesome-app/.gitignore
@@ -0,0 +1,160 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#pdm.lock
+#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
+#   in version control.
+#   https://pdm.fming.dev/#use-with-ide
+.pdm.toml
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+#.idea/
diff --git a/examples/flower-simulation-step-by-step-pytorch/my-awesome-app/README.md b/examples/flower-simulation-step-by-step-pytorch/my-awesome-app/README.md
new file mode 100644
index 000000000000..011866bac52b
--- /dev/null
+++ b/examples/flower-simulation-step-by-step-pytorch/my-awesome-app/README.md
@@ -0,0 +1,34 @@
+> \[!TIP\]
+> This readme is auto-generated by `flwr new`.
+
+# my-awesome-app: A Flower / PyTorch app
+
+## Install dependencies and project
+
+```bash
+pip install -e .
+```
+
+## Run with the Simulation Engine
+
+In the `my-awesome-app` directory, use `flwr run` to run a local simulation:
+
+```bash
+flwr run .
+```
+
+Refer to the [How to Run Simulations](https://flower.ai/docs/framework/how-to-run-simulations.html) guide in the documentation for advice on how to optimize your simulations.
+
+## Run with the Deployment Engine
+
+> \[!NOTE\]
+> An update to this example will show how to run this Flower application with the Deployment Engine and TLS certificates, or with Docker.
+
+## Resources
+
+- Flower website: [flower.ai](https://flower.ai/)
+- Check the documentation: [flower.ai/docs](https://flower.ai/docs/)
+- Give Flower a ⭐️ on GitHub: [GitHub](https://github.com/adap/flower)
+- Join the Flower community!
+  - [Flower Slack](https://flower.ai/join-slack/)
+  - [Flower Discuss](https://discuss.flower.ai/)
diff --git a/examples/flower-simulation-step-by-step-pytorch/my-awesome-app/my_awesome_app/__init__.py b/examples/flower-simulation-step-by-step-pytorch/my-awesome-app/my_awesome_app/__init__.py
new file mode 100644
index 000000000000..22b2ae07363a
--- /dev/null
+++ b/examples/flower-simulation-step-by-step-pytorch/my-awesome-app/my_awesome_app/__init__.py
@@ -0,0 +1 @@
+"""my-awesome-app: A Flower / PyTorch app."""
diff --git a/examples/flower-simulation-step-by-step-pytorch/my-awesome-app/my_awesome_app/client_app.py b/examples/flower-simulation-step-by-step-pytorch/my-awesome-app/my_awesome_app/client_app.py
new file mode 100644
index 000000000000..fa1b589d0cdc
--- /dev/null
+++ b/examples/flower-simulation-step-by-step-pytorch/my-awesome-app/my_awesome_app/client_app.py
@@ -0,0 +1,96 @@
+"""my-awesome-app: A Flower / PyTorch app."""
+
+import torch
+from random import random
+from flwr.client import ClientApp, NumPyClient
+from flwr.common import Context, ConfigsRecord
+from my_awesome_app.task import Net, get_weights, load_data, set_weights, test, train
+
+import json
+
+
+class FlowerClient(NumPyClient):
+    def __init__(self, net, trainloader, valloader, local_epochs, context: Context):
+        self.client_state = context.state
+        self.net = net
+        self.trainloader = trainloader
+        self.valloader = valloader
+        self.local_epochs = local_epochs
+        self.device = torch.device("cuda:0" if torch.cuda.is_available() else "cpu")
+        self.net.to(self.device)
+
+        if "fit_metrics" not in self.client_state.configs_records:
+            self.client_state.configs_records["fit_metrics"] = ConfigsRecord()
+
+    def fit(self, parameters, config):
+        """Train a model using as starting point the parameters sent by the ServerApp.
+
+        Then, communicate the weights of the locally-updated model back to the
+        ServerApp.
+        """
+        # Apply parameters to local model
+        set_weights(self.net, parameters)
+        train_loss = train(
+            self.net,
+            self.trainloader,
+            self.local_epochs,
+            config["lr"],
+            self.device,
+        )
+
+        # Append to persistent state the `train_loss` just obtained
+        fit_metrics = self.client_state.configs_records["fit_metrics"]
+        if "train_loss_hist" not in fit_metrics:
+            # If first entry, create the list
+            fit_metrics["train_loss_hist"] = [train_loss]
+        else:
+            # If it's not the first entry, append to the existing list
+            fit_metrics["train_loss_hist"].append(train_loss)
+
+        # A complex metric strcuture can be returned by a ClientApp if it is first
+        # converted to a supported type by `flwr.common.Scalar`. Here we serialize it with
+        # JSON and therefore representing it as a string (one of the supported types)
+        complex_metric = {"a": 123, "b": random(), "mylist": [1, 2, 3, 4]}
+        complex_metric_str = json.dumps(complex_metric)
+
+        return (
+            get_weights(self.net),  # Return parameters of the locally-updated model
+            len(
+                self.trainloader.dataset
+            ),  # Training examples used (needed sometimes for aggregation)
+            {
+                "train_loss": train_loss,
+                "my_metric": complex_metric_str,
+            },  # Communicate metrics
+        )
+
+    def evaluate(self, parameters, config):
+        """Evaluate the global model weights using the local validation set."""
+        # Apply weights from global model
+        set_weights(self.net, parameters)
+        # Run the test evaluation function
+        loss, accuracy = test(self.net, self.valloader, self.device)
+        # Report results. Note the last argument is of type `Metrics` so you could communicate
+        # other values that are relevant to your use case.
+        return loss, len(self.valloader.dataset), {"accuracy": accuracy}
+
+
+def client_fn(context: Context):
+    """A function that returns a Client."""
+
+    # Instantiate the model
+    net = Net()
+    # Read node config and fetch data for the ClientApp that is being constructed
+    partition_id = context.node_config["partition-id"]
+    num_partitions = context.node_config["num-partitions"]
+    trainloader, valloader = load_data(partition_id, num_partitions)
+
+    # Read the run config (defined in the `pyproject.toml`)
+    local_epochs = context.run_config["local-epochs"]
+
+    # Return Client instance
+    return FlowerClient(net, trainloader, valloader, local_epochs, context).to_client()
+
+
+# Flower ClientApp
+app = ClientApp(client_fn=client_fn)
diff --git a/examples/flower-simulation-step-by-step-pytorch/my-awesome-app/my_awesome_app/my_strategy.py b/examples/flower-simulation-step-by-step-pytorch/my-awesome-app/my_awesome_app/my_strategy.py
new file mode 100644
index 000000000000..61225bf152c3
--- /dev/null
+++ b/examples/flower-simulation-step-by-step-pytorch/my-awesome-app/my_awesome_app/my_strategy.py
@@ -0,0 +1,75 @@
+from flwr.common import FitRes, Parameters, parameters_to_ndarrays
+from flwr.server.client_proxy import ClientProxy
+from flwr.server.strategy import FedAvg
+
+import torch
+import json
+import wandb
+from datetime import datetime
+
+from .task import Net, set_weights
+
+
+class CustomFedAvg(FedAvg):
+    """A strategy that keeps the core functionality of FedAvg unchanged but enables
+    additional features such as: Saving global checkpoints, saving metrics to the local
+    file system as a JSON, pushing metrics to Weight & Biases.
+    """
+
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+
+        # A dictionary that will store the metrics generated on each round
+        self.results_to_save = {}
+
+        # Log those same metrics to W&B
+        name = datetime.now().strftime("%Y-%m-%d_%H:%M:%S")
+        wandb.init(project="flower-simulation-tutorial", name=f"custom-strategy-{name}")
+
+    def aggregate_fit(
+        self,
+        server_round: int,
+        results: list[tuple[ClientProxy, FitRes]],
+        failures: list[tuple[ClientProxy, FitRes] | BaseException],
+    ) -> tuple[Parameters | None, dict[str, bool | bytes | float | int | str]]:
+        """Aggregate received model updates and metrics, ave global model checkpoint."""
+
+        # Call the default aggregate_fit method from FedAvg
+        parameters_aggregated, metrics_aggregated = super().aggregate_fit(
+            server_round, results, failures
+        )
+
+        ## Save new Global Model as a PyTorch checkpoint
+        # Convert parameters to ndarrays
+        ndarrays = parameters_to_ndarrays(parameters_aggregated)
+        # Instantiate model
+        model = Net()
+        # Apply paramters to model
+        set_weights(model, ndarrays)
+        # Save global model in the standard PyTorch way
+        torch.save(model.state_dict(), f"global_model_round_{server_round}")
+
+        # Return the expected outputs for `aggregate_fit`
+        return parameters_aggregated, metrics_aggregated
+
+    def evaluate(
+        self, server_round: int, parameters: Parameters
+    ) -> tuple[float, dict[str, bool | bytes | float | int | str]] | None:
+        """Evaluate global model, then save metrics to local JSON and to W&B."""
+        # Call the default behaviour from FedAvg
+        loss, metrics = super().evaluate(server_round, parameters)
+
+        # Store metrics as dictionary
+        my_results = {"loss": loss, **metrics}
+        # Insert into local dictionary
+        self.results_to_save[server_round] = my_results
+
+        # Save metrics as json
+        with open("results.json", "w") as json_file:
+            json.dump(self.results_to_save, json_file, indent=4)
+
+        # Log metrics to W&B
+        wandb.log(my_results, step=server_round)
+
+        # Return the expected outputs for `evaluate`
+        return loss, metrics
diff --git a/examples/flower-simulation-step-by-step-pytorch/my-awesome-app/my_awesome_app/server_app.py b/examples/flower-simulation-step-by-step-pytorch/my-awesome-app/my_awesome_app/server_app.py
new file mode 100644
index 000000000000..7a4a64383ada
--- /dev/null
+++ b/examples/flower-simulation-step-by-step-pytorch/my-awesome-app/my_awesome_app/server_app.py
@@ -0,0 +1,99 @@
+"""my-awesome-app: A Flower / PyTorch app."""
+
+import json
+from typing import List, Tuple
+from flwr.common import Context, ndarrays_to_parameters, Metrics
+from flwr.server import ServerApp, ServerAppComponents, ServerConfig
+from datasets import load_dataset
+from torch.utils.data import DataLoader
+
+from my_awesome_app.task import Net, get_weights, set_weights, test, get_transforms
+from my_awesome_app.my_strategy import CustomFedAvg
+
+
+def get_evaluate_fn(testloader, device):
+    """Return a callback that evaluates the global model."""
+
+    def evaluate(server_round, parameters_ndarrays, config):
+        """Evaluate global model using provided centralised testset."""
+        # Instantiate model
+        net = Net()
+        # Apply global_model parameters
+        set_weights(net, parameters_ndarrays)
+        net.to(device)
+        # Run test
+        loss, accuracy = test(net, testloader, device)
+
+        return loss, {"cen_accuracy": accuracy}
+
+    return evaluate
+
+
+def weighted_average(metrics: List[Tuple[int, Metrics]]) -> Metrics:
+    """Aggregates metrics from an evaluate round."""
+    # Loop trough all metrics received compute accuracies x examples
+    accuracies = [num_examples * m["accuracy"] for num_examples, m in metrics]
+    total_examples = sum(num_examples for num_examples, _ in metrics)
+    # Return weighted average accuracy
+    return {"accuracy": sum(accuracies) / total_examples}
+
+
+def handle_fit_metrics(metrics: List[Tuple[int, Metrics]]) -> Metrics:
+    """Aggregate metrics from a fit round.
+
+    This function showed a mechanism to communicate almost arbitrary metrics by
+    converting them into a JSON on the ClientApp side. Here that JSON string is
+    deserialized and reinterpreted as a dictionary we can use.
+    """
+    b_values = []
+    for _, m in metrics:
+        my_metric_str = m["my_metric"]
+        # Deserialize JSON and return dict
+        my_metric = json.loads(my_metric_str)
+        b_values.append(my_metric["b"])
+    # Return maximum value from deserialized metrics
+    return {"max_b": max(b_values)}
+
+
+def on_fit_config(server_round: int) -> Metrics:
+    """Adjusts learning rate based on current round."""
+    lr = 0.01
+    # Appply a simple learning rate decay
+    if server_round > 2:
+        lr = 0.005
+    return {"lr": lr}
+
+
+def server_fn(context: Context):
+    """A function that creates the components for a ServerApp."""
+    # Read from Run config
+    num_rounds = context.run_config["num-server-rounds"]
+    fraction_fit = context.run_config["fraction-fit"]
+
+    # Initialize model parameters
+    ndarrays = get_weights(Net())
+    parameters = ndarrays_to_parameters(ndarrays)
+
+    # Load global test set
+    testset = load_dataset("zalando-datasets/fashion_mnist")["test"]
+    # Construct dataloader
+    testloader = DataLoader(testset.with_transform(get_transforms()), batch_size=32)
+
+    # Define strategy
+    strategy = CustomFedAvg(
+        fraction_fit=fraction_fit,
+        fraction_evaluate=1.0,  # All nodes are sampled for evaluation
+        min_available_clients=2,
+        initial_parameters=parameters,
+        evaluate_metrics_aggregation_fn=weighted_average,
+        fit_metrics_aggregation_fn=handle_fit_metrics,
+        on_fit_config_fn=on_fit_config,
+        evaluate_fn=get_evaluate_fn(testloader, device="cpu"),
+    )
+    config = ServerConfig(num_rounds=num_rounds)
+
+    return ServerAppComponents(strategy=strategy, config=config)
+
+
+# Create ServerApp
+app = ServerApp(server_fn=server_fn)
diff --git a/examples/flower-simulation-step-by-step-pytorch/my-awesome-app/my_awesome_app/task.py b/examples/flower-simulation-step-by-step-pytorch/my-awesome-app/my_awesome_app/task.py
new file mode 100644
index 000000000000..026f8c86f295
--- /dev/null
+++ b/examples/flower-simulation-step-by-step-pytorch/my-awesome-app/my_awesome_app/task.py
@@ -0,0 +1,138 @@
+"""my-awesome-app: A Flower / PyTorch app."""
+
+from collections import OrderedDict
+
+import torch
+import torch.nn as nn
+import torch.nn.functional as F
+from flwr_datasets import FederatedDataset
+from flwr_datasets.partitioner import DirichletPartitioner
+from torch.utils.data import DataLoader
+from torchvision.transforms import Compose, Normalize, ToTensor
+
+
+class Net(nn.Module):
+    """Model (simple CNN adapted from 'PyTorch: A 60 Minute Blitz')"""
+
+    def __init__(self):
+        super(Net, self).__init__()
+        self.conv1 = nn.Conv2d(1, 6, 5)
+        self.pool = nn.MaxPool2d(2, 2)
+        self.conv2 = nn.Conv2d(6, 16, 5)
+        self.fc1 = nn.Linear(16 * 4 * 4, 120)
+        self.fc2 = nn.Linear(120, 84)
+        self.fc3 = nn.Linear(84, 10)
+
+    def forward(self, x):
+        x = self.pool(F.relu(self.conv1(x)))
+        x = self.pool(F.relu(self.conv2(x)))
+        x = x.view(-1, 16 * 4 * 4)
+        x = F.relu(self.fc1(x))
+        x = F.relu(self.fc2(x))
+        return self.fc3(x)
+
+
+def get_transforms():
+    """Return a function that apply standard transformations to images."""
+
+    pytorch_transforms = Compose([ToTensor(), Normalize((0.5,), (0.5,))])
+
+    def apply_transforms(batch):
+        """Apply transforms to the partition from FederatedDataset."""
+        batch["image"] = [pytorch_transforms(img) for img in batch["image"]]
+        return batch
+
+    return apply_transforms
+
+
+fds = None  # Cache FederatedDataset
+
+
+def load_data(partition_id: int, num_partitions: int):
+    """Load partition FashionMNIST data."""
+    # Only initialize `FederatedDataset` once
+    global fds
+    if fds is None:
+        partitioner = DirichletPartitioner(
+            num_partitions=num_partitions, partition_by="label", alpha=1.0
+        )
+        fds = FederatedDataset(
+            dataset="zalando-datasets/fashion_mnist",
+            partitioners={"train": partitioner},
+        )
+    partition = fds.load_partition(partition_id)
+    # Divide data on each node: 80% train, 20% test
+    partition_train_test = partition.train_test_split(test_size=0.2, seed=42)
+
+    partition_train_test = partition_train_test.with_transform(get_transforms())
+    trainloader = DataLoader(partition_train_test["train"], batch_size=32, shuffle=True)
+    testloader = DataLoader(partition_train_test["test"], batch_size=32)
+    return trainloader, testloader
+
+
+def train(net, trainloader, epochs, lr, device):
+    """Train the model on the training set.
+
+    This is a fairly standard training loop for PyTorch. Note there is nothing specific
+    about Flower or Federated AI here.
+    """
+    net.to(device)  # move model to GPU if available
+    criterion = torch.nn.CrossEntropyLoss().to(device)
+    optimizer = torch.optim.Adam(net.parameters(), lr=lr)
+    net.train()
+    running_loss = 0.0
+    for _ in range(epochs):
+        for batch in trainloader:
+            images = batch["image"]
+            labels = batch["label"]
+            optimizer.zero_grad()
+            loss = criterion(net(images.to(device)), labels.to(device))
+            loss.backward()
+            optimizer.step()
+            running_loss += loss.item()
+
+    avg_trainloss = running_loss / len(trainloader)
+    return avg_trainloss
+
+
+def test(net, testloader, device):
+    """Validate the model on the test set.
+
+    This is a fairly standard training loop for PyTorch. Note there is nothing specific
+    about Flower or Federated AI here.
+    """
+    net.to(device)
+    criterion = torch.nn.CrossEntropyLoss()
+    correct, loss = 0, 0.0
+    with torch.no_grad():
+        for batch in testloader:
+            images = batch["image"].to(device)
+            labels = batch["label"].to(device)
+            outputs = net(images)
+            loss += criterion(outputs, labels).item()
+            correct += (torch.max(outputs.data, 1)[1] == labels).sum().item()
+    accuracy = correct / len(testloader.dataset)
+    loss = loss / len(testloader)
+    return loss, accuracy
+
+
+def get_weights(net):
+    """Extract parameters from a model.
+
+    Note this is specific to PyTorch. You might want to update this function if you use
+    a more exotic model architecture or if you don't want to extrac all elements in
+    state_dict.
+    """
+    return [val.cpu().numpy() for _, val in net.state_dict().items()]
+
+
+def set_weights(net, parameters):
+    """Copy paramteres onto the model.
+
+    Note this is specific to PyTorch. You might want to update this function if you use
+    a more exotic model architecture or if you don't want to replace the entire
+    state_dict.
+    """
+    params_dict = zip(net.state_dict().keys(), parameters)
+    state_dict = OrderedDict({k: torch.from_numpy(v) for k, v in params_dict})
+    net.load_state_dict(state_dict, strict=True)
diff --git a/examples/flower-simulation-step-by-step-pytorch/my-awesome-app/pyproject.toml b/examples/flower-simulation-step-by-step-pytorch/my-awesome-app/pyproject.toml
new file mode 100644
index 000000000000..f4c4de26c50e
--- /dev/null
+++ b/examples/flower-simulation-step-by-step-pytorch/my-awesome-app/pyproject.toml
@@ -0,0 +1,42 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "my-awesome-app"
+version = "1.0.0"
+description = ""
+license = "Apache-2.0"
+dependencies = [
+    "flwr[simulation]>=1.13.1",
+    "flwr-datasets[vision]>=0.4.0",
+    "torch==2.2.1",
+    "torchvision==0.17.1",
+    "wandb",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["."]
+
+[tool.flwr.app]
+publisher = "javier"
+
+[tool.flwr.app.components]
+serverapp = "my_awesome_app.server_app:app"
+clientapp = "my_awesome_app.client_app:app"
+
+[tool.flwr.app.config]
+num-server-rounds = 3
+fraction-fit = 0.5
+local-epochs = 1
+
+[tool.flwr.federations]
+default = "local-simulation"
+
+[tool.flwr.federations.local-simulation]
+options.num-supernodes = 10
+
+[tool.flwr.federations.gpu-sim]
+options.num-supernodes = 100
+options.backend.client-resources.num-cpus = 2
+options.backend.client-resources.num-gpus = 0.0
diff --git a/examples/flower-simulation-step-by-step-pytorch/requirements.txt b/examples/flower-simulation-step-by-step-pytorch/requirements.txt
deleted file mode 100644
index a322192ca711..000000000000
--- a/examples/flower-simulation-step-by-step-pytorch/requirements.txt
+++ /dev/null
@@ -1,2 +0,0 @@
-flwr[simulation]>=1.0, <2.0
-hydra-core==1.3.2
\ No newline at end of file

From 59809ec9c63cc48e3c4252f02e32dbd68426a734 Mon Sep 17 00:00:00 2001
From: Daniel Nata Nugraha <daniel.nata@flower.dev>
Date: Wed, 11 Dec 2024 14:33:12 +0000
Subject: [PATCH 040/104] feat(framework) Add user auth CLI integration (#4602)

Co-authored-by: Heng Pan <pan@flower.ai>
Co-authored-by: Chong Shen Ng <chong.shen@flower.ai>
Co-authored-by: Daniel J. Beutel <daniel@flower.ai>
---
 pyproject.toml                               |   1 +
 src/py/flwr/cli/app.py                       |   2 +
 src/py/flwr/cli/cli_user_auth_interceptor.py |  86 +++++++++++++++
 src/py/flwr/cli/log.py                       |  26 +----
 src/py/flwr/cli/login/__init__.py            |  21 ++++
 src/py/flwr/cli/login/login.py               |  90 +++++++++++++++
 src/py/flwr/cli/ls.py                        |  35 +-----
 src/py/flwr/cli/run/run.py                   |  35 ++----
 src/py/flwr/cli/stop.py                      |  33 +-----
 src/py/flwr/cli/utils.py                     | 109 ++++++++++++++++++-
 src/py/flwr/common/config.py                 |   3 +-
 src/py/flwr/common/constant.py               |   5 +-
 src/py/flwr/common/telemetry.py              |   3 +-
 13 files changed, 345 insertions(+), 104 deletions(-)
 create mode 100644 src/py/flwr/cli/cli_user_auth_interceptor.py
 create mode 100644 src/py/flwr/cli/login/__init__.py
 create mode 100644 src/py/flwr/cli/login/login.py

diff --git a/pyproject.toml b/pyproject.toml
index b4a5fa13031f..973767e3e6a3 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -82,6 +82,7 @@ pyyaml = "^6.0.2"
 requests = "^2.31.0"
 # Optional dependencies (Simulation Engine)
 ray = { version = "==2.10.0", optional = true, python = ">=3.9,<3.12" }
+# Optional dependencies (REST transport layer)
 starlette = { version = "^0.31.0", optional = true }
 uvicorn = { version = "^0.23.0", extras = ["standard"], optional = true }
 
diff --git a/src/py/flwr/cli/app.py b/src/py/flwr/cli/app.py
index 553ac56fcaf2..f85772e79c5c 100644
--- a/src/py/flwr/cli/app.py
+++ b/src/py/flwr/cli/app.py
@@ -20,6 +20,7 @@
 from .build import build
 from .install import install
 from .log import log
+from .login import login
 from .ls import ls
 from .new import new
 from .run import run
@@ -41,6 +42,7 @@
 app.command()(log)
 app.command()(ls)
 app.command()(stop)
+app.command()(login)
 
 typer_click_object = get_command(app)
 
diff --git a/src/py/flwr/cli/cli_user_auth_interceptor.py b/src/py/flwr/cli/cli_user_auth_interceptor.py
new file mode 100644
index 000000000000..7aa529bc3dd0
--- /dev/null
+++ b/src/py/flwr/cli/cli_user_auth_interceptor.py
@@ -0,0 +1,86 @@
+# Copyright 2024 Flower Labs GmbH. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# ==============================================================================
+"""Flower run interceptor."""
+
+
+from typing import Any, Callable, Union
+
+import grpc
+
+from flwr.common.auth_plugin import CliAuthPlugin
+from flwr.proto.exec_pb2 import (  # pylint: disable=E0611
+    StartRunRequest,
+    StreamLogsRequest,
+)
+
+Request = Union[
+    StartRunRequest,
+    StreamLogsRequest,
+]
+
+
+class CliUserAuthInterceptor(
+    grpc.UnaryUnaryClientInterceptor, grpc.UnaryStreamClientInterceptor  # type: ignore
+):
+    """CLI interceptor for user authentication."""
+
+    def __init__(self, auth_plugin: CliAuthPlugin):
+        self.auth_plugin = auth_plugin
+
+    def _authenticated_call(
+        self,
+        continuation: Callable[[Any, Any], Any],
+        client_call_details: grpc.ClientCallDetails,
+        request: Request,
+    ) -> grpc.Call:
+        """Send and receive tokens via metadata."""
+        new_metadata = self.auth_plugin.write_tokens_to_metadata(
+            client_call_details.metadata or []
+        )
+
+        details = client_call_details._replace(metadata=new_metadata)
+
+        response = continuation(details, request)
+        if response.initial_metadata():
+            retrieved_metadata = dict(response.initial_metadata())
+            self.auth_plugin.store_tokens(retrieved_metadata)
+
+        return response
+
+    def intercept_unary_unary(
+        self,
+        continuation: Callable[[Any, Any], Any],
+        client_call_details: grpc.ClientCallDetails,
+        request: Request,
+    ) -> grpc.Call:
+        """Intercept a unary-unary call for user authentication.
+
+        This method intercepts a unary-unary RPC call initiated from the CLI and adds
+        the required authentication tokens to the RPC metadata.
+        """
+        return self._authenticated_call(continuation, client_call_details, request)
+
+    def intercept_unary_stream(
+        self,
+        continuation: Callable[[Any, Any], Any],
+        client_call_details: grpc.ClientCallDetails,
+        request: Request,
+    ) -> grpc.Call:
+        """Intercept a unary-stream call for user authentication.
+
+        This method intercepts a unary-stream RPC call initiated from the CLI and adds
+        the required authentication tokens to the RPC metadata.
+        """
+        return self._authenticated_call(continuation, client_call_details, request)
diff --git a/src/py/flwr/cli/log.py b/src/py/flwr/cli/log.py
index 5ce3559236e0..c0bd5c8726e9 100644
--- a/src/py/flwr/cli/log.py
+++ b/src/py/flwr/cli/log.py
@@ -24,16 +24,16 @@
 
 from flwr.cli.config_utils import (
     load_and_validate,
-    validate_certificate_in_federation_config,
     validate_federation_in_project_config,
     validate_project_config,
 )
 from flwr.common.constant import CONN_RECONNECT_INTERVAL, CONN_REFRESH_PERIOD
-from flwr.common.grpc import GRPC_MAX_MESSAGE_LENGTH, create_channel
 from flwr.common.logger import log as logger
 from flwr.proto.exec_pb2 import StreamLogsRequest  # pylint: disable=E0611
 from flwr.proto.exec_pb2_grpc import ExecStub
 
+from .utils import init_channel, try_obtain_cli_auth_plugin
+
 
 def start_stream(
     run_id: int, channel: grpc.Channel, refresh_period: int = CONN_REFRESH_PERIOD
@@ -126,11 +126,6 @@ def print_logs(run_id: int, channel: grpc.Channel, timeout: int) -> None:
         logger(DEBUG, "Channel closed")
 
 
-def on_channel_state_change(channel_connectivity: str) -> None:
-    """Log channel connectivity."""
-    logger(DEBUG, channel_connectivity)
-
-
 def log(
     run_id: Annotated[
         int,
@@ -171,27 +166,18 @@ def log(
         )
         raise typer.Exit(code=1)
 
-    _log_with_exec_api(app, federation_config, run_id, stream)
+    _log_with_exec_api(app, federation, federation_config, run_id, stream)
 
 
 def _log_with_exec_api(
     app: Path,
+    federation: str,
     federation_config: dict[str, Any],
     run_id: int,
     stream: bool,
 ) -> None:
-
-    insecure, root_certificates_bytes = validate_certificate_in_federation_config(
-        app, federation_config
-    )
-    channel = create_channel(
-        server_address=federation_config["address"],
-        insecure=insecure,
-        root_certificates=root_certificates_bytes,
-        max_message_length=GRPC_MAX_MESSAGE_LENGTH,
-        interceptors=None,
-    )
-    channel.subscribe(on_channel_state_change)
+    auth_plugin = try_obtain_cli_auth_plugin(app, federation, federation_config)
+    channel = init_channel(app, federation_config, auth_plugin)
 
     if stream:
         start_stream(run_id, channel, CONN_REFRESH_PERIOD)
diff --git a/src/py/flwr/cli/login/__init__.py b/src/py/flwr/cli/login/__init__.py
new file mode 100644
index 000000000000..2755b5f6d5de
--- /dev/null
+++ b/src/py/flwr/cli/login/__init__.py
@@ -0,0 +1,21 @@
+# Copyright 2024 Flower Labs GmbH. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# ==============================================================================
+"""Flower command line interface `login` command."""
+
+from .login import login as login
+
+__all__ = [
+    "login",
+]
diff --git a/src/py/flwr/cli/login/login.py b/src/py/flwr/cli/login/login.py
new file mode 100644
index 000000000000..83448c42d662
--- /dev/null
+++ b/src/py/flwr/cli/login/login.py
@@ -0,0 +1,90 @@
+# Copyright 2024 Flower Labs GmbH. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# ==============================================================================
+"""Flower command line interface `login` command."""
+
+from pathlib import Path
+from typing import Annotated, Optional
+
+import typer
+
+from flwr.cli.config_utils import (
+    load_and_validate,
+    validate_federation_in_project_config,
+    validate_project_config,
+)
+from flwr.common.constant import AUTH_TYPE
+from flwr.proto.exec_pb2 import (  # pylint: disable=E0611
+    GetLoginDetailsRequest,
+    GetLoginDetailsResponse,
+)
+from flwr.proto.exec_pb2_grpc import ExecStub
+
+from ..utils import init_channel, try_obtain_cli_auth_plugin
+
+
+def login(  # pylint: disable=R0914
+    app: Annotated[
+        Path,
+        typer.Argument(help="Path of the Flower App to run."),
+    ] = Path("."),
+    federation: Annotated[
+        Optional[str],
+        typer.Argument(help="Name of the federation to login into."),
+    ] = None,
+) -> None:
+    """Login to Flower SuperLink."""
+    typer.secho("Loading project configuration... ", fg=typer.colors.BLUE)
+
+    pyproject_path = app / "pyproject.toml" if app else None
+    config, errors, warnings = load_and_validate(path=pyproject_path)
+
+    config = validate_project_config(config, errors, warnings)
+    federation, federation_config = validate_federation_in_project_config(
+        federation, config
+    )
+
+    if "address" not in federation_config:
+        typer.secho(
+            "❌ `flwr login` currently works with a SuperLink. Ensure that the correct"
+            "SuperLink (Exec API) address is provided in `pyproject.toml`.",
+            fg=typer.colors.RED,
+            bold=True,
+        )
+        raise typer.Exit(code=1)
+
+    channel = init_channel(app, federation_config, None)
+    stub = ExecStub(channel)
+
+    login_request = GetLoginDetailsRequest()
+    login_response: GetLoginDetailsResponse = stub.GetLoginDetails(login_request)
+
+    # Get the auth plugin
+    auth_type = login_response.login_details.get(AUTH_TYPE)
+    auth_plugin = try_obtain_cli_auth_plugin(
+        app, federation, federation_config, auth_type
+    )
+    if auth_plugin is None:
+        typer.secho(
+            f'❌ Authentication type "{auth_type}" not found',
+            fg=typer.colors.RED,
+            bold=True,
+        )
+        raise typer.Exit(code=1)
+
+    # Login
+    auth_config = auth_plugin.login(dict(login_response.login_details), stub)
+
+    # Store the tokens
+    auth_plugin.store_tokens(auth_config)
diff --git a/src/py/flwr/cli/ls.py b/src/py/flwr/cli/ls.py
index 45956bae0dc2..e5d2b2380cbc 100644
--- a/src/py/flwr/cli/ls.py
+++ b/src/py/flwr/cli/ls.py
@@ -18,11 +18,9 @@
 import io
 import json
 from datetime import datetime, timedelta
-from logging import DEBUG
 from pathlib import Path
-from typing import Annotated, Any, Optional, Union
+from typing import Annotated, Optional, Union
 
-import grpc
 import typer
 from rich.console import Console
 from rich.table import Table
@@ -31,14 +29,12 @@
 
 from flwr.cli.config_utils import (
     load_and_validate,
-    validate_certificate_in_federation_config,
     validate_federation_in_project_config,
     validate_project_config,
 )
 from flwr.common.constant import FAB_CONFIG_FILE, CliOutputFormat, SubStatus
 from flwr.common.date import format_timedelta, isoformat8601_utc
-from flwr.common.grpc import GRPC_MAX_MESSAGE_LENGTH, create_channel
-from flwr.common.logger import log, redirect_output, remove_emojis, restore_output
+from flwr.common.logger import redirect_output, remove_emojis, restore_output
 from flwr.common.serde import run_from_proto
 from flwr.common.typing import Run
 from flwr.proto.exec_pb2 import (  # pylint: disable=E0611
@@ -47,6 +43,8 @@
 )
 from flwr.proto.exec_pb2_grpc import ExecStub
 
+from .utils import init_channel, try_obtain_cli_auth_plugin
+
 _RunListType = tuple[int, str, str, str, str, str, str, str, str]
 
 
@@ -113,8 +111,8 @@ def ls(  # pylint: disable=too-many-locals, too-many-branches
                 raise ValueError(
                     "The options '--runs' and '--run-id' are mutually exclusive."
                 )
-
-            channel = _init_channel(app, federation_config)
+            auth_plugin = try_obtain_cli_auth_plugin(app, federation, federation_config)
+            channel = init_channel(app, federation_config, auth_plugin)
             stub = ExecStub(channel)
 
             # Display information about a specific run ID
@@ -154,27 +152,6 @@ def ls(  # pylint: disable=too-many-locals, too-many-branches
         captured_output.close()
 
 
-def on_channel_state_change(channel_connectivity: str) -> None:
-    """Log channel connectivity."""
-    log(DEBUG, channel_connectivity)
-
-
-def _init_channel(app: Path, federation_config: dict[str, Any]) -> grpc.Channel:
-    """Initialize gRPC channel to the Exec API."""
-    insecure, root_certificates_bytes = validate_certificate_in_federation_config(
-        app, federation_config
-    )
-    channel = create_channel(
-        server_address=federation_config["address"],
-        insecure=insecure,
-        root_certificates=root_certificates_bytes,
-        max_message_length=GRPC_MAX_MESSAGE_LENGTH,
-        interceptors=None,
-    )
-    channel.subscribe(on_channel_state_change)
-    return channel
-
-
 def _format_runs(run_dict: dict[int, Run], now_isoformat: str) -> list[_RunListType]:
     """Format runs to a list."""
 
diff --git a/src/py/flwr/cli/run/run.py b/src/py/flwr/cli/run/run.py
index 5696533a8f14..d85d56401491 100644
--- a/src/py/flwr/cli/run/run.py
+++ b/src/py/flwr/cli/run/run.py
@@ -17,7 +17,6 @@
 import io
 import json
 import subprocess
-from logging import DEBUG
 from pathlib import Path
 from typing import Annotated, Any, Optional, Union
 
@@ -28,7 +27,6 @@
 from flwr.cli.config_utils import (
     get_fab_metadata,
     load_and_validate,
-    validate_certificate_in_federation_config,
     validate_federation_in_project_config,
     validate_project_config,
 )
@@ -38,8 +36,7 @@
     user_config_to_configsrecord,
 )
 from flwr.common.constant import CliOutputFormat
-from flwr.common.grpc import GRPC_MAX_MESSAGE_LENGTH, create_channel
-from flwr.common.logger import log, redirect_output, remove_emojis, restore_output
+from flwr.common.logger import redirect_output, remove_emojis, restore_output
 from flwr.common.serde import (
     configs_record_to_proto,
     fab_to_proto,
@@ -50,15 +47,11 @@
 from flwr.proto.exec_pb2_grpc import ExecStub
 
 from ..log import start_stream
+from ..utils import init_channel, try_obtain_cli_auth_plugin
 
 CONN_REFRESH_PERIOD = 60  # Connection refresh period for log streaming (seconds)
 
 
-def on_channel_state_change(channel_connectivity: str) -> None:
-    """Log channel connectivity."""
-    log(DEBUG, channel_connectivity)
-
-
 # pylint: disable-next=too-many-locals
 def run(
     app: Annotated[
@@ -115,7 +108,12 @@ def run(
 
         if "address" in federation_config:
             _run_with_exec_api(
-                app, federation_config, config_overrides, stream, output_format
+                app,
+                federation,
+                federation_config,
+                config_overrides,
+                stream,
+                output_format,
             )
         else:
             _run_without_exec_api(app, federation_config, config_overrides, federation)
@@ -136,26 +134,17 @@ def run(
         captured_output.close()
 
 
-# pylint: disable-next=too-many-locals
+# pylint: disable-next=R0913, R0914, R0917
 def _run_with_exec_api(
     app: Path,
+    federation: str,
     federation_config: dict[str, Any],
     config_overrides: Optional[list[str]],
     stream: bool,
     output_format: str,
 ) -> None:
-
-    insecure, root_certificates_bytes = validate_certificate_in_federation_config(
-        app, federation_config
-    )
-    channel = create_channel(
-        server_address=federation_config["address"],
-        insecure=insecure,
-        root_certificates=root_certificates_bytes,
-        max_message_length=GRPC_MAX_MESSAGE_LENGTH,
-        interceptors=None,
-    )
-    channel.subscribe(on_channel_state_change)
+    auth_plugin = try_obtain_cli_auth_plugin(app, federation, federation_config)
+    channel = init_channel(app, federation_config, auth_plugin)
     stub = ExecStub(channel)
 
     fab_path, fab_hash = build(app)
diff --git a/src/py/flwr/cli/stop.py b/src/py/flwr/cli/stop.py
index 83c08fc86dc8..6274372d05b3 100644
--- a/src/py/flwr/cli/stop.py
+++ b/src/py/flwr/cli/stop.py
@@ -15,25 +15,22 @@
 """Flower command line interface `stop` command."""
 
 
-from logging import DEBUG
 from pathlib import Path
-from typing import Annotated, Any, Optional
+from typing import Annotated, Optional
 
-import grpc
 import typer
 
 from flwr.cli.config_utils import (
     load_and_validate,
-    validate_certificate_in_federation_config,
     validate_federation_in_project_config,
     validate_project_config,
 )
 from flwr.common.constant import FAB_CONFIG_FILE
-from flwr.common.grpc import GRPC_MAX_MESSAGE_LENGTH, create_channel
-from flwr.common.logger import log
 from flwr.proto.exec_pb2 import StopRunRequest, StopRunResponse  # pylint: disable=E0611
 from flwr.proto.exec_pb2_grpc import ExecStub
 
+from .utils import init_channel, try_obtain_cli_auth_plugin
+
 
 def stop(
     run_id: Annotated[  # pylint: disable=unused-argument
@@ -70,7 +67,8 @@ def stop(
         raise typer.Exit(code=1)
 
     try:
-        channel = _init_channel(app, federation_config)
+        auth_plugin = try_obtain_cli_auth_plugin(app, federation, federation_config)
+        channel = init_channel(app, federation_config, auth_plugin)
         stub = ExecStub(channel)  # pylint: disable=unused-variable # noqa: F841
 
         typer.secho(f"✋ Stopping run ID {run_id}...", fg=typer.colors.GREEN)
@@ -87,27 +85,6 @@ def stop(
         channel.close()
 
 
-def on_channel_state_change(channel_connectivity: str) -> None:
-    """Log channel connectivity."""
-    log(DEBUG, channel_connectivity)
-
-
-def _init_channel(app: Path, federation_config: dict[str, Any]) -> grpc.Channel:
-    """Initialize gRPC channel to the Exec API."""
-    insecure, root_certificates_bytes = validate_certificate_in_federation_config(
-        app, federation_config
-    )
-    channel = create_channel(
-        server_address=federation_config["address"],
-        insecure=insecure,
-        root_certificates=root_certificates_bytes,
-        max_message_length=GRPC_MAX_MESSAGE_LENGTH,
-        interceptors=None,
-    )
-    channel.subscribe(on_channel_state_change)
-    return channel
-
-
 def _stop_run(
     stub: ExecStub,  # pylint: disable=unused-argument
     run_id: int,  # pylint: disable=unused-argument
diff --git a/src/py/flwr/cli/utils.py b/src/py/flwr/cli/utils.py
index e725fdd3f951..aaaf8246c399 100644
--- a/src/py/flwr/cli/utils.py
+++ b/src/py/flwr/cli/utils.py
@@ -15,12 +15,32 @@
 """Flower command line interface utils."""
 
 import hashlib
+import json
 import re
+from logging import DEBUG
 from pathlib import Path
-from typing import Callable, Optional, cast
+from typing import Any, Callable, Optional, cast
 
+import grpc
 import typer
 
+from flwr.cli.cli_user_auth_interceptor import CliUserAuthInterceptor
+from flwr.common.address import parse_address
+from flwr.common.auth_plugin import CliAuthPlugin
+from flwr.common.constant import AUTH_TYPE, CREDENTIALS_DIR, FLWR_DIR
+from flwr.common.grpc import GRPC_MAX_MESSAGE_LENGTH, create_channel
+from flwr.common.logger import log
+
+from .config_utils import validate_certificate_in_federation_config
+
+try:
+    from flwr.ee import get_cli_auth_plugins
+except ImportError:
+
+    def get_cli_auth_plugins() -> dict[str, type[CliAuthPlugin]]:
+        """Return all CLI authentication plugins."""
+        raise NotImplementedError("No authentication plugins are currently supported.")
+
 
 def prompt_text(
     text: str,
@@ -136,3 +156,90 @@ def get_sha256_hash(file_path: Path) -> str:
                 break
             sha256.update(data)
     return sha256.hexdigest()
+
+
+def get_user_auth_config_path(
+    root_dir: Path, federation: str, server_address: str
+) -> Path:
+    """Return the path to the user auth config file."""
+    # Parse the server address
+    parsed_addr = parse_address(server_address)
+    if parsed_addr is None:
+        raise ValueError(f"Invalid server address: {server_address}")
+    host, port, is_v6 = parsed_addr
+    formatted_addr = f"[{host}]_{port}" if is_v6 else f"{host}_{port}"
+
+    # Locate the credentials directory
+    credentials_dir = root_dir.absolute() / FLWR_DIR / CREDENTIALS_DIR
+    credentials_dir.mkdir(parents=True, exist_ok=True)
+    return credentials_dir / f"{federation}_{formatted_addr}.json"
+
+
+def try_obtain_cli_auth_plugin(
+    root_dir: Path,
+    federation: str,
+    federation_config: dict[str, Any],
+    auth_type: Optional[str] = None,
+) -> Optional[CliAuthPlugin]:
+    """Load the CLI-side user auth plugin for the given auth type."""
+    config_path = get_user_auth_config_path(
+        root_dir, federation, federation_config["address"]
+    )
+
+    # Load the config file if it exists
+    config: dict[str, Any] = {}
+    if config_path.exists():
+        with config_path.open("r", encoding="utf-8") as file:
+            config = json.load(file)
+    # This is the case when the user auth is not enabled
+    elif auth_type is None:
+        return None
+
+    # Get the auth type from the config if not provided
+    if auth_type is None:
+        if AUTH_TYPE not in config:
+            return None
+        auth_type = config[AUTH_TYPE]
+
+    # Retrieve auth plugin class and instantiate it
+    try:
+        all_plugins: dict[str, type[CliAuthPlugin]] = get_cli_auth_plugins()
+        auth_plugin_class = all_plugins[auth_type]
+        return auth_plugin_class(config_path)
+    except KeyError:
+        typer.echo(f"❌ Unknown user authentication type: {auth_type}")
+        raise typer.Exit(code=1) from None
+    except ImportError:
+        typer.echo("❌ No authentication plugins are currently supported.")
+        raise typer.Exit(code=1) from None
+
+
+def init_channel(
+    app: Path, federation_config: dict[str, Any], auth_plugin: Optional[CliAuthPlugin]
+) -> grpc.Channel:
+    """Initialize gRPC channel to the Exec API."""
+
+    def on_channel_state_change(channel_connectivity: str) -> None:
+        """Log channel connectivity."""
+        log(DEBUG, channel_connectivity)
+
+    insecure, root_certificates_bytes = validate_certificate_in_federation_config(
+        app, federation_config
+    )
+
+    # Initialize the CLI-side user auth interceptor
+    interceptors: list[grpc.UnaryUnaryClientInterceptor] = []
+    if auth_plugin is not None:
+        auth_plugin.load_tokens()
+        interceptors = CliUserAuthInterceptor(auth_plugin)
+
+    # Create the gRPC channel
+    channel = create_channel(
+        server_address=federation_config["address"],
+        insecure=insecure,
+        root_certificates=root_certificates_bytes,
+        max_message_length=GRPC_MAX_MESSAGE_LENGTH,
+        interceptors=interceptors or None,
+    )
+    channel.subscribe(on_channel_state_change)
+    return channel
diff --git a/src/py/flwr/common/config.py b/src/py/flwr/common/config.py
index e7f71a40951c..0433d82d3ed1 100644
--- a/src/py/flwr/common/config.py
+++ b/src/py/flwr/common/config.py
@@ -27,6 +27,7 @@
     APP_DIR,
     FAB_CONFIG_FILE,
     FAB_HASH_TRUNCATION,
+    FLWR_DIR,
     FLWR_HOME,
 )
 from flwr.common.typing import Run, UserConfig, UserConfigValue
@@ -38,7 +39,7 @@ def get_flwr_dir(provided_path: Optional[str] = None) -> Path:
         return Path(
             os.getenv(
                 FLWR_HOME,
-                Path(f"{os.getenv('XDG_DATA_HOME', os.getenv('HOME'))}") / ".flwr",
+                Path(f"{os.getenv('XDG_DATA_HOME', os.getenv('HOME'))}") / FLWR_DIR,
             )
         )
     return Path(provided_path).absolute()
diff --git a/src/py/flwr/common/constant.py b/src/py/flwr/common/constant.py
index 3dd0657c12bb..9ea23e78c009 100644
--- a/src/py/flwr/common/constant.py
+++ b/src/py/flwr/common/constant.py
@@ -80,7 +80,8 @@
 FAB_CONFIG_FILE = "pyproject.toml"
 FAB_DATE = (2024, 10, 1, 0, 0, 0)
 FAB_HASH_TRUNCATION = 8
-FLWR_HOME = "FLWR_HOME"
+FLWR_DIR = ".flwr"  # The default Flower directory: ~/.flwr/
+FLWR_HOME = "FLWR_HOME"  # If set, override the default Flower directory
 
 # Constants entries in Node config for Simulation
 PARTITION_ID_KEY = "partition-id"
@@ -110,6 +111,8 @@
 # Retry configurations
 MAX_RETRY_DELAY = 20  # Maximum delay duration between two consecutive retries.
 
+# Constants for user authentication
+CREDENTIALS_DIR = ".credentials"
 AUTH_TYPE = "auth_type"
 
 
diff --git a/src/py/flwr/common/telemetry.py b/src/py/flwr/common/telemetry.py
index e4487e839e8f..9f6a51901f54 100644
--- a/src/py/flwr/common/telemetry.py
+++ b/src/py/flwr/common/telemetry.py
@@ -27,6 +27,7 @@
 from pathlib import Path
 from typing import Any, Optional, Union, cast
 
+from flwr.common.constant import FLWR_DIR
 from flwr.common.version import package_name, package_version
 
 FLWR_TELEMETRY_ENABLED = os.getenv("FLWR_TELEMETRY_ENABLED", "1")
@@ -86,7 +87,7 @@ def _get_source_id() -> str:
         # If the home directory can’t be resolved, RuntimeError is raised.
         return source_id
 
-    flwr_dir = home.joinpath(".flwr")
+    flwr_dir = home.joinpath(FLWR_DIR)
     # Create .flwr directory if it does not exist yet.
     try:
         flwr_dir.mkdir(parents=True, exist_ok=True)

From 17629af2c5afbc57328ace6554acea18d611c000 Mon Sep 17 00:00:00 2001
From: Charles Beauville <charles@flower.ai>
Date: Wed, 11 Dec 2024 06:58:18 -0800
Subject: [PATCH 041/104] ci(framework) Fix docs deployment (#4675)

Co-authored-by: Taner Topal <taner@flower.ai>
---
 framework/docs/build-versioned-docs.sh | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/framework/docs/build-versioned-docs.sh b/framework/docs/build-versioned-docs.sh
index 2ff8db5a6312..3c4ef6ba76a5 100755
--- a/framework/docs/build-versioned-docs.sh
+++ b/framework/docs/build-versioned-docs.sh
@@ -16,7 +16,7 @@ cp -r framework/docs/locales ${tmp_dir}/locales
 cp -r framework/docs/source/_templates ${tmp_dir}/_templates
 
 # Get a list of languages based on the folders in locales
-languages="en `find locales/ -mindepth 1 -maxdepth 1 -type d -exec basename '{}' \;`"
+languages="en `find framework/docs/locales/ -mindepth 1 -maxdepth 1 -type d -exec basename '{}' \;`"
 # Get a list of tags, excluding those before v1.0.0
 versions="`git for-each-ref '--format=%(refname:lstrip=-1)' refs/tags/ | grep -iE '^v((([1-9]|[0-9]{2,}).*\.([8-9]|[0-9]{2,}).*)|([2-9]|[0-9]{2,}).*)$'`"
 

From c3e83a3a22ed68a91ac83d2dd7c2a26df30c9695 Mon Sep 17 00:00:00 2001
From: Heng Pan <pan@flower.ai>
Date: Wed, 11 Dec 2024 23:09:33 +0800
Subject: [PATCH 042/104] refactor(framework) Fix dtype to `np.int64` in
 `pseudo_rand_gen` function (#4674)

---
 src/py/flwr/common/secure_aggregation/secaggplus_utils.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/py/flwr/common/secure_aggregation/secaggplus_utils.py b/src/py/flwr/common/secure_aggregation/secaggplus_utils.py
index 919894d5388f..d49d2262c611 100644
--- a/src/py/flwr/common/secure_aggregation/secaggplus_utils.py
+++ b/src/py/flwr/common/secure_aggregation/secaggplus_utils.py
@@ -93,8 +93,8 @@ def pseudo_rand_gen(
     output = []
     for dimension in dimensions_list:
         if len(dimension) == 0:
-            arr = np.array(gen.randint(0, num_range - 1), dtype=int)
+            arr = np.array(gen.randint(0, num_range - 1), dtype=np.int64)
         else:
-            arr = gen.randint(0, num_range - 1, dimension)
+            arr = gen.randint(0, num_range - 1, dimension, dtype=np.int64)
         output.append(arr)
     return output

From a4e579a5b03a4385c1927cb7afef896a6f1eadf9 Mon Sep 17 00:00:00 2001
From: Charles Beauville <charles@flower.ai>
Date: Wed, 11 Dec 2024 07:31:58 -0800
Subject: [PATCH 043/104] ci(framework) Fix multi version docs (#4676)

---
 framework/docs/build-versioned-docs.sh | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/framework/docs/build-versioned-docs.sh b/framework/docs/build-versioned-docs.sh
index 3c4ef6ba76a5..f993860fdd3e 100755
--- a/framework/docs/build-versioned-docs.sh
+++ b/framework/docs/build-versioned-docs.sh
@@ -95,6 +95,8 @@ END
     # Actually building the docs for a given language and version
     sphinx-build -b html source/ build/html/${current_version}/${current_language} -A lang=True -D language=${current_language}
 
+    cd $(git rev-parse --show-toplevel)
+
     # Clean the history of the checked-out branch to remove conflicts
     git clean -fd
 

From 9a05a343b33c3f04ec0ba606956c1cb6172204de Mon Sep 17 00:00:00 2001
From: Chong Shen Ng <chong.shen@flower.ai>
Date: Wed, 11 Dec 2024 15:47:44 +0000
Subject: [PATCH 044/104] feat(framework) Update `ServerAppIoServicer` RPCs for
 `flwr stop` (#4629)

---
 src/proto/flwr/proto/serverappio.proto        |  9 ++++-
 src/py/flwr/proto/serverappio_pb2.py          | 36 +++++++++----------
 src/py/flwr/proto/serverappio_pb2.pyi         | 10 ++++--
 src/py/flwr/proto/serverappio_pb2_grpc.py     | 34 ++++++++++++++++++
 src/py/flwr/proto/serverappio_pb2_grpc.pyi    | 13 +++++++
 src/py/flwr/server/driver/grpc_driver.py      |  8 +++--
 .../superlink/driver/serverappio_servicer.py  | 18 ++++++++++
 7 files changed, 105 insertions(+), 23 deletions(-)

diff --git a/src/proto/flwr/proto/serverappio.proto b/src/proto/flwr/proto/serverappio.proto
index 3d8d3d6aa0d6..76352866a891 100644
--- a/src/proto/flwr/proto/serverappio.proto
+++ b/src/proto/flwr/proto/serverappio.proto
@@ -55,6 +55,9 @@ service ServerAppIo {
   rpc UpdateRunStatus(UpdateRunStatusRequest)
       returns (UpdateRunStatusResponse) {}
 
+  // Get the status of a given run
+  rpc GetRunStatus(GetRunStatusRequest) returns (GetRunStatusResponse) {}
+
   // Push ServerApp logs
   rpc PushLogs(PushLogsRequest) returns (PushLogsResponse) {}
 }
@@ -64,13 +67,17 @@ message GetNodesRequest { uint64 run_id = 1; }
 message GetNodesResponse { repeated Node nodes = 1; }
 
 // PushTaskIns messages
-message PushTaskInsRequest { repeated TaskIns task_ins_list = 1; }
+message PushTaskInsRequest {
+  repeated TaskIns task_ins_list = 1;
+  uint64 run_id = 2;
+}
 message PushTaskInsResponse { repeated string task_ids = 2; }
 
 // PullTaskRes messages
 message PullTaskResRequest {
   Node node = 1;
   repeated string task_ids = 2;
+  uint64 run_id = 3;
 }
 message PullTaskResResponse { repeated TaskRes task_res_list = 1; }
 
diff --git a/src/py/flwr/proto/serverappio_pb2.py b/src/py/flwr/proto/serverappio_pb2.py
index 2bbd33b5c42b..f97d8362e8df 100644
--- a/src/py/flwr/proto/serverappio_pb2.py
+++ b/src/py/flwr/proto/serverappio_pb2.py
@@ -20,7 +20,7 @@
 from flwr.proto import fab_pb2 as flwr_dot_proto_dot_fab__pb2
 
 
-DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x1c\x66lwr/proto/serverappio.proto\x12\nflwr.proto\x1a\x14\x66lwr/proto/log.proto\x1a\x15\x66lwr/proto/node.proto\x1a\x18\x66lwr/proto/message.proto\x1a\x15\x66lwr/proto/task.proto\x1a\x14\x66lwr/proto/run.proto\x1a\x14\x66lwr/proto/fab.proto\"!\n\x0fGetNodesRequest\x12\x0e\n\x06run_id\x18\x01 \x01(\x04\"3\n\x10GetNodesResponse\x12\x1f\n\x05nodes\x18\x01 \x03(\x0b\x32\x10.flwr.proto.Node\"@\n\x12PushTaskInsRequest\x12*\n\rtask_ins_list\x18\x01 \x03(\x0b\x32\x13.flwr.proto.TaskIns\"\'\n\x13PushTaskInsResponse\x12\x10\n\x08task_ids\x18\x02 \x03(\t\"F\n\x12PullTaskResRequest\x12\x1e\n\x04node\x18\x01 \x01(\x0b\x32\x10.flwr.proto.Node\x12\x10\n\x08task_ids\x18\x02 \x03(\t\"A\n\x13PullTaskResResponse\x12*\n\rtask_res_list\x18\x01 \x03(\x0b\x32\x13.flwr.proto.TaskRes\"\x1c\n\x1aPullServerAppInputsRequest\"\x7f\n\x1bPullServerAppInputsResponse\x12$\n\x07\x63ontext\x18\x01 \x01(\x0b\x32\x13.flwr.proto.Context\x12\x1c\n\x03run\x18\x02 \x01(\x0b\x32\x0f.flwr.proto.Run\x12\x1c\n\x03\x66\x61\x62\x18\x03 \x01(\x0b\x32\x0f.flwr.proto.Fab\"S\n\x1bPushServerAppOutputsRequest\x12\x0e\n\x06run_id\x18\x01 \x01(\x04\x12$\n\x07\x63ontext\x18\x02 \x01(\x0b\x32\x13.flwr.proto.Context\"\x1e\n\x1cPushServerAppOutputsResponse2\xca\x06\n\x0bServerAppIo\x12J\n\tCreateRun\x12\x1c.flwr.proto.CreateRunRequest\x1a\x1d.flwr.proto.CreateRunResponse\"\x00\x12G\n\x08GetNodes\x12\x1b.flwr.proto.GetNodesRequest\x1a\x1c.flwr.proto.GetNodesResponse\"\x00\x12P\n\x0bPushTaskIns\x12\x1e.flwr.proto.PushTaskInsRequest\x1a\x1f.flwr.proto.PushTaskInsResponse\"\x00\x12P\n\x0bPullTaskRes\x12\x1e.flwr.proto.PullTaskResRequest\x1a\x1f.flwr.proto.PullTaskResResponse\"\x00\x12\x41\n\x06GetRun\x12\x19.flwr.proto.GetRunRequest\x1a\x1a.flwr.proto.GetRunResponse\"\x00\x12\x41\n\x06GetFab\x12\x19.flwr.proto.GetFabRequest\x1a\x1a.flwr.proto.GetFabResponse\"\x00\x12h\n\x13PullServerAppInputs\x12&.flwr.proto.PullServerAppInputsRequest\x1a\'.flwr.proto.PullServerAppInputsResponse\"\x00\x12k\n\x14PushServerAppOutputs\x12\'.flwr.proto.PushServerAppOutputsRequest\x1a(.flwr.proto.PushServerAppOutputsResponse\"\x00\x12\\\n\x0fUpdateRunStatus\x12\".flwr.proto.UpdateRunStatusRequest\x1a#.flwr.proto.UpdateRunStatusResponse\"\x00\x12G\n\x08PushLogs\x12\x1b.flwr.proto.PushLogsRequest\x1a\x1c.flwr.proto.PushLogsResponse\"\x00\x62\x06proto3')
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x1c\x66lwr/proto/serverappio.proto\x12\nflwr.proto\x1a\x14\x66lwr/proto/log.proto\x1a\x15\x66lwr/proto/node.proto\x1a\x18\x66lwr/proto/message.proto\x1a\x15\x66lwr/proto/task.proto\x1a\x14\x66lwr/proto/run.proto\x1a\x14\x66lwr/proto/fab.proto\"!\n\x0fGetNodesRequest\x12\x0e\n\x06run_id\x18\x01 \x01(\x04\"3\n\x10GetNodesResponse\x12\x1f\n\x05nodes\x18\x01 \x03(\x0b\x32\x10.flwr.proto.Node\"P\n\x12PushTaskInsRequest\x12*\n\rtask_ins_list\x18\x01 \x03(\x0b\x32\x13.flwr.proto.TaskIns\x12\x0e\n\x06run_id\x18\x02 \x01(\x04\"\'\n\x13PushTaskInsResponse\x12\x10\n\x08task_ids\x18\x02 \x03(\t\"V\n\x12PullTaskResRequest\x12\x1e\n\x04node\x18\x01 \x01(\x0b\x32\x10.flwr.proto.Node\x12\x10\n\x08task_ids\x18\x02 \x03(\t\x12\x0e\n\x06run_id\x18\x03 \x01(\x04\"A\n\x13PullTaskResResponse\x12*\n\rtask_res_list\x18\x01 \x03(\x0b\x32\x13.flwr.proto.TaskRes\"\x1c\n\x1aPullServerAppInputsRequest\"\x7f\n\x1bPullServerAppInputsResponse\x12$\n\x07\x63ontext\x18\x01 \x01(\x0b\x32\x13.flwr.proto.Context\x12\x1c\n\x03run\x18\x02 \x01(\x0b\x32\x0f.flwr.proto.Run\x12\x1c\n\x03\x66\x61\x62\x18\x03 \x01(\x0b\x32\x0f.flwr.proto.Fab\"S\n\x1bPushServerAppOutputsRequest\x12\x0e\n\x06run_id\x18\x01 \x01(\x04\x12$\n\x07\x63ontext\x18\x02 \x01(\x0b\x32\x13.flwr.proto.Context\"\x1e\n\x1cPushServerAppOutputsResponse2\x9f\x07\n\x0bServerAppIo\x12J\n\tCreateRun\x12\x1c.flwr.proto.CreateRunRequest\x1a\x1d.flwr.proto.CreateRunResponse\"\x00\x12G\n\x08GetNodes\x12\x1b.flwr.proto.GetNodesRequest\x1a\x1c.flwr.proto.GetNodesResponse\"\x00\x12P\n\x0bPushTaskIns\x12\x1e.flwr.proto.PushTaskInsRequest\x1a\x1f.flwr.proto.PushTaskInsResponse\"\x00\x12P\n\x0bPullTaskRes\x12\x1e.flwr.proto.PullTaskResRequest\x1a\x1f.flwr.proto.PullTaskResResponse\"\x00\x12\x41\n\x06GetRun\x12\x19.flwr.proto.GetRunRequest\x1a\x1a.flwr.proto.GetRunResponse\"\x00\x12\x41\n\x06GetFab\x12\x19.flwr.proto.GetFabRequest\x1a\x1a.flwr.proto.GetFabResponse\"\x00\x12h\n\x13PullServerAppInputs\x12&.flwr.proto.PullServerAppInputsRequest\x1a\'.flwr.proto.PullServerAppInputsResponse\"\x00\x12k\n\x14PushServerAppOutputs\x12\'.flwr.proto.PushServerAppOutputsRequest\x1a(.flwr.proto.PushServerAppOutputsResponse\"\x00\x12\\\n\x0fUpdateRunStatus\x12\".flwr.proto.UpdateRunStatusRequest\x1a#.flwr.proto.UpdateRunStatusResponse\"\x00\x12S\n\x0cGetRunStatus\x12\x1f.flwr.proto.GetRunStatusRequest\x1a .flwr.proto.GetRunStatusResponse\"\x00\x12G\n\x08PushLogs\x12\x1b.flwr.proto.PushLogsRequest\x1a\x1c.flwr.proto.PushLogsResponse\"\x00\x62\x06proto3')
 
 _globals = globals()
 _builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
@@ -32,21 +32,21 @@
   _globals['_GETNODESRESPONSE']._serialized_start=217
   _globals['_GETNODESRESPONSE']._serialized_end=268
   _globals['_PUSHTASKINSREQUEST']._serialized_start=270
-  _globals['_PUSHTASKINSREQUEST']._serialized_end=334
-  _globals['_PUSHTASKINSRESPONSE']._serialized_start=336
-  _globals['_PUSHTASKINSRESPONSE']._serialized_end=375
-  _globals['_PULLTASKRESREQUEST']._serialized_start=377
-  _globals['_PULLTASKRESREQUEST']._serialized_end=447
-  _globals['_PULLTASKRESRESPONSE']._serialized_start=449
-  _globals['_PULLTASKRESRESPONSE']._serialized_end=514
-  _globals['_PULLSERVERAPPINPUTSREQUEST']._serialized_start=516
-  _globals['_PULLSERVERAPPINPUTSREQUEST']._serialized_end=544
-  _globals['_PULLSERVERAPPINPUTSRESPONSE']._serialized_start=546
-  _globals['_PULLSERVERAPPINPUTSRESPONSE']._serialized_end=673
-  _globals['_PUSHSERVERAPPOUTPUTSREQUEST']._serialized_start=675
-  _globals['_PUSHSERVERAPPOUTPUTSREQUEST']._serialized_end=758
-  _globals['_PUSHSERVERAPPOUTPUTSRESPONSE']._serialized_start=760
-  _globals['_PUSHSERVERAPPOUTPUTSRESPONSE']._serialized_end=790
-  _globals['_SERVERAPPIO']._serialized_start=793
-  _globals['_SERVERAPPIO']._serialized_end=1635
+  _globals['_PUSHTASKINSREQUEST']._serialized_end=350
+  _globals['_PUSHTASKINSRESPONSE']._serialized_start=352
+  _globals['_PUSHTASKINSRESPONSE']._serialized_end=391
+  _globals['_PULLTASKRESREQUEST']._serialized_start=393
+  _globals['_PULLTASKRESREQUEST']._serialized_end=479
+  _globals['_PULLTASKRESRESPONSE']._serialized_start=481
+  _globals['_PULLTASKRESRESPONSE']._serialized_end=546
+  _globals['_PULLSERVERAPPINPUTSREQUEST']._serialized_start=548
+  _globals['_PULLSERVERAPPINPUTSREQUEST']._serialized_end=576
+  _globals['_PULLSERVERAPPINPUTSRESPONSE']._serialized_start=578
+  _globals['_PULLSERVERAPPINPUTSRESPONSE']._serialized_end=705
+  _globals['_PUSHSERVERAPPOUTPUTSREQUEST']._serialized_start=707
+  _globals['_PUSHSERVERAPPOUTPUTSREQUEST']._serialized_end=790
+  _globals['_PUSHSERVERAPPOUTPUTSRESPONSE']._serialized_start=792
+  _globals['_PUSHSERVERAPPOUTPUTSRESPONSE']._serialized_end=822
+  _globals['_SERVERAPPIO']._serialized_start=825
+  _globals['_SERVERAPPIO']._serialized_end=1752
 # @@protoc_insertion_point(module_scope)
diff --git a/src/py/flwr/proto/serverappio_pb2.pyi b/src/py/flwr/proto/serverappio_pb2.pyi
index 8191ec663442..38eff6456c03 100644
--- a/src/py/flwr/proto/serverappio_pb2.pyi
+++ b/src/py/flwr/proto/serverappio_pb2.pyi
@@ -44,13 +44,16 @@ class PushTaskInsRequest(google.protobuf.message.Message):
     """PushTaskIns messages"""
     DESCRIPTOR: google.protobuf.descriptor.Descriptor
     TASK_INS_LIST_FIELD_NUMBER: builtins.int
+    RUN_ID_FIELD_NUMBER: builtins.int
     @property
     def task_ins_list(self) -> google.protobuf.internal.containers.RepeatedCompositeFieldContainer[flwr.proto.task_pb2.TaskIns]: ...
+    run_id: builtins.int
     def __init__(self,
         *,
         task_ins_list: typing.Optional[typing.Iterable[flwr.proto.task_pb2.TaskIns]] = ...,
+        run_id: builtins.int = ...,
         ) -> None: ...
-    def ClearField(self, field_name: typing_extensions.Literal["task_ins_list",b"task_ins_list"]) -> None: ...
+    def ClearField(self, field_name: typing_extensions.Literal["run_id",b"run_id","task_ins_list",b"task_ins_list"]) -> None: ...
 global___PushTaskInsRequest = PushTaskInsRequest
 
 class PushTaskInsResponse(google.protobuf.message.Message):
@@ -70,17 +73,20 @@ class PullTaskResRequest(google.protobuf.message.Message):
     DESCRIPTOR: google.protobuf.descriptor.Descriptor
     NODE_FIELD_NUMBER: builtins.int
     TASK_IDS_FIELD_NUMBER: builtins.int
+    RUN_ID_FIELD_NUMBER: builtins.int
     @property
     def node(self) -> flwr.proto.node_pb2.Node: ...
     @property
     def task_ids(self) -> google.protobuf.internal.containers.RepeatedScalarFieldContainer[typing.Text]: ...
+    run_id: builtins.int
     def __init__(self,
         *,
         node: typing.Optional[flwr.proto.node_pb2.Node] = ...,
         task_ids: typing.Optional[typing.Iterable[typing.Text]] = ...,
+        run_id: builtins.int = ...,
         ) -> None: ...
     def HasField(self, field_name: typing_extensions.Literal["node",b"node"]) -> builtins.bool: ...
-    def ClearField(self, field_name: typing_extensions.Literal["node",b"node","task_ids",b"task_ids"]) -> None: ...
+    def ClearField(self, field_name: typing_extensions.Literal["node",b"node","run_id",b"run_id","task_ids",b"task_ids"]) -> None: ...
 global___PullTaskResRequest = PullTaskResRequest
 
 class PullTaskResResponse(google.protobuf.message.Message):
diff --git a/src/py/flwr/proto/serverappio_pb2_grpc.py b/src/py/flwr/proto/serverappio_pb2_grpc.py
index 1a7740db4271..ede888543883 100644
--- a/src/py/flwr/proto/serverappio_pb2_grpc.py
+++ b/src/py/flwr/proto/serverappio_pb2_grpc.py
@@ -62,6 +62,11 @@ def __init__(self, channel):
                 request_serializer=flwr_dot_proto_dot_run__pb2.UpdateRunStatusRequest.SerializeToString,
                 response_deserializer=flwr_dot_proto_dot_run__pb2.UpdateRunStatusResponse.FromString,
                 )
+        self.GetRunStatus = channel.unary_unary(
+                '/flwr.proto.ServerAppIo/GetRunStatus',
+                request_serializer=flwr_dot_proto_dot_run__pb2.GetRunStatusRequest.SerializeToString,
+                response_deserializer=flwr_dot_proto_dot_run__pb2.GetRunStatusResponse.FromString,
+                )
         self.PushLogs = channel.unary_unary(
                 '/flwr.proto.ServerAppIo/PushLogs',
                 request_serializer=flwr_dot_proto_dot_log__pb2.PushLogsRequest.SerializeToString,
@@ -135,6 +140,13 @@ def UpdateRunStatus(self, request, context):
         context.set_details('Method not implemented!')
         raise NotImplementedError('Method not implemented!')
 
+    def GetRunStatus(self, request, context):
+        """Get the status of a given run
+        """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details('Method not implemented!')
+        raise NotImplementedError('Method not implemented!')
+
     def PushLogs(self, request, context):
         """Push ServerApp logs
         """
@@ -190,6 +202,11 @@ def add_ServerAppIoServicer_to_server(servicer, server):
                     request_deserializer=flwr_dot_proto_dot_run__pb2.UpdateRunStatusRequest.FromString,
                     response_serializer=flwr_dot_proto_dot_run__pb2.UpdateRunStatusResponse.SerializeToString,
             ),
+            'GetRunStatus': grpc.unary_unary_rpc_method_handler(
+                    servicer.GetRunStatus,
+                    request_deserializer=flwr_dot_proto_dot_run__pb2.GetRunStatusRequest.FromString,
+                    response_serializer=flwr_dot_proto_dot_run__pb2.GetRunStatusResponse.SerializeToString,
+            ),
             'PushLogs': grpc.unary_unary_rpc_method_handler(
                     servicer.PushLogs,
                     request_deserializer=flwr_dot_proto_dot_log__pb2.PushLogsRequest.FromString,
@@ -358,6 +375,23 @@ def UpdateRunStatus(request,
             options, channel_credentials,
             insecure, call_credentials, compression, wait_for_ready, timeout, metadata)
 
+    @staticmethod
+    def GetRunStatus(request,
+            target,
+            options=(),
+            channel_credentials=None,
+            call_credentials=None,
+            insecure=False,
+            compression=None,
+            wait_for_ready=None,
+            timeout=None,
+            metadata=None):
+        return grpc.experimental.unary_unary(request, target, '/flwr.proto.ServerAppIo/GetRunStatus',
+            flwr_dot_proto_dot_run__pb2.GetRunStatusRequest.SerializeToString,
+            flwr_dot_proto_dot_run__pb2.GetRunStatusResponse.FromString,
+            options, channel_credentials,
+            insecure, call_credentials, compression, wait_for_ready, timeout, metadata)
+
     @staticmethod
     def PushLogs(request,
             target,
diff --git a/src/py/flwr/proto/serverappio_pb2_grpc.pyi b/src/py/flwr/proto/serverappio_pb2_grpc.pyi
index aa2d29473ae8..f4e3fdc208a8 100644
--- a/src/py/flwr/proto/serverappio_pb2_grpc.pyi
+++ b/src/py/flwr/proto/serverappio_pb2_grpc.pyi
@@ -56,6 +56,11 @@ class ServerAppIoStub:
         flwr.proto.run_pb2.UpdateRunStatusResponse]
     """Update the status of a given run"""
 
+    GetRunStatus: grpc.UnaryUnaryMultiCallable[
+        flwr.proto.run_pb2.GetRunStatusRequest,
+        flwr.proto.run_pb2.GetRunStatusResponse]
+    """Get the status of a given run"""
+
     PushLogs: grpc.UnaryUnaryMultiCallable[
         flwr.proto.log_pb2.PushLogsRequest,
         flwr.proto.log_pb2.PushLogsResponse]
@@ -135,6 +140,14 @@ class ServerAppIoServicer(metaclass=abc.ABCMeta):
         """Update the status of a given run"""
         pass
 
+    @abc.abstractmethod
+    def GetRunStatus(self,
+        request: flwr.proto.run_pb2.GetRunStatusRequest,
+        context: grpc.ServicerContext,
+    ) -> flwr.proto.run_pb2.GetRunStatusResponse:
+        """Get the status of a given run"""
+        pass
+
     @abc.abstractmethod
     def PushLogs(self,
         request: flwr.proto.log_pb2.PushLogsRequest,
diff --git a/src/py/flwr/server/driver/grpc_driver.py b/src/py/flwr/server/driver/grpc_driver.py
index 05b7ce4be8bc..09318c32b704 100644
--- a/src/py/flwr/server/driver/grpc_driver.py
+++ b/src/py/flwr/server/driver/grpc_driver.py
@@ -203,7 +203,9 @@ def push_messages(self, messages: Iterable[Message]) -> Iterable[str]:
             task_ins_list.append(taskins)
         # Call GrpcDriverStub method
         res: PushTaskInsResponse = self._stub.PushTaskIns(
-            PushTaskInsRequest(task_ins_list=task_ins_list)
+            PushTaskInsRequest(
+                task_ins_list=task_ins_list, run_id=cast(Run, self._run).run_id
+            )
         )
         return list(res.task_ids)
 
@@ -215,7 +217,9 @@ def pull_messages(self, message_ids: Iterable[str]) -> Iterable[Message]:
         """
         # Pull TaskRes
         res: PullTaskResResponse = self._stub.PullTaskRes(
-            PullTaskResRequest(node=self.node, task_ids=message_ids)
+            PullTaskResRequest(
+                node=self.node, task_ids=message_ids, run_id=cast(Run, self._run).run_id
+            )
         )
         # Convert TaskRes to Message
         msgs = [message_from_taskres(taskres) for taskres in res.task_res_list]
diff --git a/src/py/flwr/server/superlink/driver/serverappio_servicer.py b/src/py/flwr/server/superlink/driver/serverappio_servicer.py
index dddac1a93b1a..ca0b2ec0d8a5 100644
--- a/src/py/flwr/server/superlink/driver/serverappio_servicer.py
+++ b/src/py/flwr/server/superlink/driver/serverappio_servicer.py
@@ -32,6 +32,7 @@
     fab_from_proto,
     fab_to_proto,
     run_status_from_proto,
+    run_status_to_proto,
     run_to_proto,
     user_config_from_proto,
 )
@@ -48,6 +49,8 @@
     CreateRunResponse,
     GetRunRequest,
     GetRunResponse,
+    GetRunStatusRequest,
+    GetRunStatusResponse,
     UpdateRunStatusRequest,
     UpdateRunStatusResponse,
 )
@@ -284,6 +287,21 @@ def PushLogs(
         state.add_serverapp_log(request.run_id, merged_logs)
         return PushLogsResponse()
 
+    def GetRunStatus(
+        self, request: GetRunStatusRequest, context: grpc.ServicerContext
+    ) -> GetRunStatusResponse:
+        """Get the status of a run."""
+        log(DEBUG, "ServerAppIoServicer.GetRunStatus")
+        state = self.state_factory.state()
+
+        # Get run status from LinkState
+        run_statuses = state.get_run_status(set(request.run_ids))
+        run_status_dict = {
+            run_id: run_status_to_proto(run_status)
+            for run_id, run_status in run_statuses.items()
+        }
+        return GetRunStatusResponse(run_status_dict=run_status_dict)
+
 
 def _raise_if(validation_error: bool, detail: str) -> None:
     if validation_error:

From d67c38f3f51477828140a54ac4e55dc27117b777 Mon Sep 17 00:00:00 2001
From: Meng Yan <myan@redhat.com>
Date: Thu, 12 Dec 2024 00:24:28 +0800
Subject: [PATCH 045/104] fix(framework) Correct tutorial URLs in the README
 (#4671)

Signed-off-by: myan <myan@redhat.com>
Co-authored-by: Javier <jafermarq@users.noreply.github.com>
---
 README.md | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/README.md b/README.md
index b5c58c6838f0..30b54786244a 100644
--- a/README.md
+++ b/README.md
@@ -48,23 +48,23 @@ Flower's goal is to make federated learning accessible to everyone. This series
 
 0. **What is Federated Learning?**
 
-   [![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/adap/flower/blob/main/doc/source/tutorial-series-what-is-federated-learning.ipynb) (or open the [Jupyter Notebook](https://github.com/adap/flower/blob/main/doc/source/tutorial-series-what-is-federated-learning.ipynb))
+   [![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/adap/flower/blob/main/framework/docs/source/tutorial-series-what-is-federated-learning.ipynb) (or open the [Jupyter Notebook](https://github.com/adap/flower/blob/main/framework/docs/source/tutorial-series-what-is-federated-learning.ipynb))
 
 1. **An Introduction to Federated Learning**
 
-   [![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/adap/flower/blob/main/doc/source/tutorial-series-get-started-with-flower-pytorch.ipynb) (or open the [Jupyter Notebook](https://github.com/adap/flower/blob/main/doc/source/tutorial-series-get-started-with-flower-pytorch.ipynb))
+   [![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/adap/flower/blob/main/framework/docs/source/tutorial-series-get-started-with-flower-pytorch.ipynb) (or open the [Jupyter Notebook](https://github.com/adap/flower/blob/main/framework/docs/source/tutorial-series-get-started-with-flower-pytorch.ipynb))
 
 2. **Using Strategies in Federated Learning**
 
-   [![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/adap/flower/blob/main/doc/source/tutorial-series-use-a-federated-learning-strategy-pytorch.ipynb) (or open the [Jupyter Notebook](https://github.com/adap/flower/blob/main/doc/source/tutorial-series-use-a-federated-learning-strategy-pytorch.ipynb))
+   [![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/adap/flower/blob/main/framework/docs/source/tutorial-series-use-a-federated-learning-strategy-pytorch.ipynb) (or open the [Jupyter Notebook](https://github.com/adap/flower/blob/main/framework/docs/source/tutorial-series-use-a-federated-learning-strategy-pytorch.ipynb))
 
 3. **Building Strategies for Federated Learning**
 
-   [![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/adap/flower/blob/main/doc/source/tutorial-series-build-a-strategy-from-scratch-pytorch.ipynb) (or open the [Jupyter Notebook](https://github.com/adap/flower/blob/main/doc/source/tutorial-series-build-a-strategy-from-scratch-pytorch.ipynb))
+   [![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/adap/flower/blob/main/framework/docs/source/tutorial-series-build-a-strategy-from-scratch-pytorch.ipynb) (or open the [Jupyter Notebook](https://github.com/adap/flower/blob/main/framework/docs/source/tutorial-series-build-a-strategy-from-scratch-pytorch.ipynb))
 
 4. **Custom Clients for Federated Learning**
 
-   [![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/adap/flower/blob/main/doc/source/tutorial-series-customize-the-client-pytorch.ipynb) (or open the [Jupyter Notebook](https://github.com/adap/flower/blob/main/doc/source/tutorial-series-customize-the-client-pytorch.ipynb))
+   [![Open in Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/adap/flower/blob/main/doc/source/tutorial-series-customize-the-client-pytorch.ipynb) (or open the [Jupyter Notebook](https://github.com/adap/flower/blob/main/framework/docs/source/tutorial-series-customize-the-client-pytorch.ipynb))
 
 Stay tuned, more tutorials are coming soon. Topics include **Privacy and Security in Federated Learning**, and **Scaling Federated Learning**.
 

From 85b58551a980a34bf52ea064dd4bf09d714e1a08 Mon Sep 17 00:00:00 2001
From: Charles Beauville <charles@flower.ai>
Date: Wed, 11 Dec 2024 08:42:12 -0800
Subject: [PATCH 046/104] refactor(*:skip) Move docs from `doc` to `docs`
 (#4660)

Co-authored-by: Daniel J. Beutel <daniel@flower.ai>
Co-authored-by: Taner Topal <taner@flower.ai>
---
 .github/workflows/baselines.yml                 |   2 +-
 baselines/{doc => docs}/Makefile                |   0
 baselines/{doc => docs}/make.bat                |   0
 baselines/{doc => docs}/source/.gitignore       |   0
 .../{doc => docs}/source/_static/custom.css     |   0
 .../{doc => docs}/source/_static/favicon.ico    | Bin
 .../source/_static/flower-logo.png              | Bin
 .../{doc => docs}/source/_static/view-gh.png    | Bin
 .../{doc => docs}/source/_templates/base.html   |   0
 .../source/_templates/sidebar/search.html       |   0
 baselines/{doc => docs}/source/conf.py          |  11 ++++++++---
 .../source/how-to-contribute-baselines.rst      |   0
 .../source/how-to-use-baselines.rst             |   0
 baselines/{doc => docs}/source/index.rst        |   0
 datasets/dev/build-flwr-datasets-docs.sh        |   2 +-
 datasets/{doc => docs}/Makefile                 |   0
 datasets/{doc => docs}/make.bat                 |   0
 datasets/{doc => docs}/source/.gitignore        |   0
 .../{doc => docs}/source/_static/custom.css     |   0
 .../{doc => docs}/source/_static/favicon.ico    | Bin
 .../source/_static/flower-datasets-logo.png     | Bin
 .../comparison_of_partitioning_schemes.png      | Bin
 .../tutorial-quickstart/choose-hf-dataset.png   | Bin
 .../tutorial-quickstart/copy-dataset-name.png   | Bin
 .../partitioner-flexibility.png                 | Bin
 .../source/_templates/autosummary/base.rst      |   0
 .../source/_templates/autosummary/class.rst     |   0
 .../source/_templates/autosummary/module.rst    |   0
 .../{doc => docs}/source/_templates/base.html   |   0
 .../source/_templates/sidebar/search.html       |   0
 datasets/{doc => docs}/source/conf.py           |   5 +++--
 .../contributor-how-to-contribute-dataset.rst   |   0
 .../how-to-disable-enable-progress-bar.rst      |   0
 .../source/how-to-install-flwr-datasets.rst     |   0
 .../source/how-to-use-with-local-data.rst       |   0
 .../source/how-to-use-with-numpy.rst            |   0
 .../source/how-to-use-with-pytorch.rst          |   0
 .../source/how-to-use-with-tensorflow.rst       |   0
 datasets/{doc => docs}/source/index.rst         |   0
 .../source/recommended-fl-datasets-tables.rst   |   0
 .../source/recommended-fl-datasets.rst          |   0
 datasets/{doc => docs}/source/ref-telemetry.md  |   0
 .../source/tutorial-quickstart.ipynb            |   0
 .../source/tutorial-use-partitioners.ipynb      |   0
 .../tutorial-visualize-label-distribution.ipynb |   0
 dev/build-baseline-docs.sh                      |  16 ++++++++--------
 dev/build-example-docs.py                       |  14 +++++++-------
 dev/update_version.py                           |   8 ++++----
 examples/{doc => docs}/Makefile                 |   0
 examples/{doc => docs}/make.bat                 |   0
 examples/{doc => docs}/source/.gitignore        |   0
 .../{doc => docs}/source/_static/.gitignore     |   0
 .../{doc => docs}/source/_static/custom.css     |   0
 .../{doc => docs}/source/_static/favicon.ico    | Bin
 .../source/_static/flower-logo.png              | Bin
 .../source/_static/tmux_jtop_view.gif           | Bin
 .../{doc => docs}/source/_static/view-gh.png    | Bin
 .../{doc => docs}/source/_templates/base.html   |   0
 examples/{doc => docs}/source/conf.py           |   0
 59 files changed, 32 insertions(+), 26 deletions(-)
 rename baselines/{doc => docs}/Makefile (100%)
 rename baselines/{doc => docs}/make.bat (100%)
 rename baselines/{doc => docs}/source/.gitignore (100%)
 rename baselines/{doc => docs}/source/_static/custom.css (100%)
 rename baselines/{doc => docs}/source/_static/favicon.ico (100%)
 rename baselines/{doc => docs}/source/_static/flower-logo.png (100%)
 rename baselines/{doc => docs}/source/_static/view-gh.png (100%)
 rename baselines/{doc => docs}/source/_templates/base.html (100%)
 rename baselines/{doc => docs}/source/_templates/sidebar/search.html (100%)
 rename baselines/{doc => docs}/source/conf.py (95%)
 rename baselines/{doc => docs}/source/how-to-contribute-baselines.rst (100%)
 rename baselines/{doc => docs}/source/how-to-use-baselines.rst (100%)
 rename baselines/{doc => docs}/source/index.rst (100%)
 rename datasets/{doc => docs}/Makefile (100%)
 rename datasets/{doc => docs}/make.bat (100%)
 rename datasets/{doc => docs}/source/.gitignore (100%)
 rename datasets/{doc => docs}/source/_static/custom.css (100%)
 rename datasets/{doc => docs}/source/_static/favicon.ico (100%)
 rename datasets/{doc => docs}/source/_static/flower-datasets-logo.png (100%)
 rename datasets/{doc => docs}/source/_static/readme/comparison_of_partitioning_schemes.png (100%)
 rename datasets/{doc => docs}/source/_static/tutorial-quickstart/choose-hf-dataset.png (100%)
 rename datasets/{doc => docs}/source/_static/tutorial-quickstart/copy-dataset-name.png (100%)
 rename datasets/{doc => docs}/source/_static/tutorial-quickstart/partitioner-flexibility.png (100%)
 rename datasets/{doc => docs}/source/_templates/autosummary/base.rst (100%)
 rename datasets/{doc => docs}/source/_templates/autosummary/class.rst (100%)
 rename datasets/{doc => docs}/source/_templates/autosummary/module.rst (100%)
 rename datasets/{doc => docs}/source/_templates/base.html (100%)
 rename datasets/{doc => docs}/source/_templates/sidebar/search.html (100%)
 rename datasets/{doc => docs}/source/conf.py (98%)
 rename datasets/{doc => docs}/source/contributor-how-to-contribute-dataset.rst (100%)
 rename datasets/{doc => docs}/source/how-to-disable-enable-progress-bar.rst (100%)
 rename datasets/{doc => docs}/source/how-to-install-flwr-datasets.rst (100%)
 rename datasets/{doc => docs}/source/how-to-use-with-local-data.rst (100%)
 rename datasets/{doc => docs}/source/how-to-use-with-numpy.rst (100%)
 rename datasets/{doc => docs}/source/how-to-use-with-pytorch.rst (100%)
 rename datasets/{doc => docs}/source/how-to-use-with-tensorflow.rst (100%)
 rename datasets/{doc => docs}/source/index.rst (100%)
 rename datasets/{doc => docs}/source/recommended-fl-datasets-tables.rst (100%)
 rename datasets/{doc => docs}/source/recommended-fl-datasets.rst (100%)
 rename datasets/{doc => docs}/source/ref-telemetry.md (100%)
 rename datasets/{doc => docs}/source/tutorial-quickstart.ipynb (100%)
 rename datasets/{doc => docs}/source/tutorial-use-partitioners.ipynb (100%)
 rename datasets/{doc => docs}/source/tutorial-visualize-label-distribution.ipynb (100%)
 rename examples/{doc => docs}/Makefile (100%)
 rename examples/{doc => docs}/make.bat (100%)
 rename examples/{doc => docs}/source/.gitignore (100%)
 rename examples/{doc => docs}/source/_static/.gitignore (100%)
 rename examples/{doc => docs}/source/_static/custom.css (100%)
 rename examples/{doc => docs}/source/_static/favicon.ico (100%)
 rename examples/{doc => docs}/source/_static/flower-logo.png (100%)
 rename examples/{doc => docs}/source/_static/tmux_jtop_view.gif (100%)
 rename examples/{doc => docs}/source/_static/view-gh.png (100%)
 rename examples/{doc => docs}/source/_templates/base.html (100%)
 rename examples/{doc => docs}/source/conf.py (100%)

diff --git a/.github/workflows/baselines.yml b/.github/workflows/baselines.yml
index c4485fe72d10..c051b1f355c7 100644
--- a/.github/workflows/baselines.yml
+++ b/.github/workflows/baselines.yml
@@ -36,7 +36,7 @@ jobs:
                 FILTER+=$(echo "$DIR: ${BASELINES_PATH}/**\n")
             done < <(find baselines -maxdepth 1 \
                 -name ".*" -prune -o \
-                -path "baselines/doc" -prune -o \
+                -path "baselines/docs" -prune -o \
                 -path "baselines/dev" -prune -o \
                 -path "baselines/baseline_template" -prune -o \
                 -path "baselines/flwr_baselines" -prune -o \
diff --git a/baselines/doc/Makefile b/baselines/docs/Makefile
similarity index 100%
rename from baselines/doc/Makefile
rename to baselines/docs/Makefile
diff --git a/baselines/doc/make.bat b/baselines/docs/make.bat
similarity index 100%
rename from baselines/doc/make.bat
rename to baselines/docs/make.bat
diff --git a/baselines/doc/source/.gitignore b/baselines/docs/source/.gitignore
similarity index 100%
rename from baselines/doc/source/.gitignore
rename to baselines/docs/source/.gitignore
diff --git a/baselines/doc/source/_static/custom.css b/baselines/docs/source/_static/custom.css
similarity index 100%
rename from baselines/doc/source/_static/custom.css
rename to baselines/docs/source/_static/custom.css
diff --git a/baselines/doc/source/_static/favicon.ico b/baselines/docs/source/_static/favicon.ico
similarity index 100%
rename from baselines/doc/source/_static/favicon.ico
rename to baselines/docs/source/_static/favicon.ico
diff --git a/baselines/doc/source/_static/flower-logo.png b/baselines/docs/source/_static/flower-logo.png
similarity index 100%
rename from baselines/doc/source/_static/flower-logo.png
rename to baselines/docs/source/_static/flower-logo.png
diff --git a/baselines/doc/source/_static/view-gh.png b/baselines/docs/source/_static/view-gh.png
similarity index 100%
rename from baselines/doc/source/_static/view-gh.png
rename to baselines/docs/source/_static/view-gh.png
diff --git a/baselines/doc/source/_templates/base.html b/baselines/docs/source/_templates/base.html
similarity index 100%
rename from baselines/doc/source/_templates/base.html
rename to baselines/docs/source/_templates/base.html
diff --git a/baselines/doc/source/_templates/sidebar/search.html b/baselines/docs/source/_templates/sidebar/search.html
similarity index 100%
rename from baselines/doc/source/_templates/sidebar/search.html
rename to baselines/docs/source/_templates/sidebar/search.html
diff --git a/baselines/doc/source/conf.py b/baselines/docs/source/conf.py
similarity index 95%
rename from baselines/doc/source/conf.py
rename to baselines/docs/source/conf.py
index 9d5d4ea7fc92..574c4ccf0e81 100644
--- a/baselines/doc/source/conf.py
+++ b/baselines/docs/source/conf.py
@@ -12,12 +12,13 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 # ==============================================================================
+"""Config for Sphinx docs."""
 
 
 import datetime
 import os
 import sys
-from sphinx.application import ConfigError
+
 
 # Configuration file for the Sphinx documentation builder.
 #
@@ -120,11 +121,15 @@
 
 nbsphinx_execute = "never"
 
-_open_in_colab_button = """
+colab_link = (
+    "https://colab.research.google.com/github/adap/flower/blob/main/"
+    "doc/source/{{ env.doc2path(env.docname, base=None) }}"
+)
+_open_in_colab_button = f"""
 .. raw:: html
 
     <br/>
-    <a href="https://colab.research.google.com/github/adap/flower/blob/main/doc/source/{{ env.doc2path(env.docname, base=None) }}">
+    <a href="{colab_link}">
         <img alt="Open in Colab" src="https://colab.research.google.com/assets/colab-badge.svg"/>
     </a>
 """
diff --git a/baselines/doc/source/how-to-contribute-baselines.rst b/baselines/docs/source/how-to-contribute-baselines.rst
similarity index 100%
rename from baselines/doc/source/how-to-contribute-baselines.rst
rename to baselines/docs/source/how-to-contribute-baselines.rst
diff --git a/baselines/doc/source/how-to-use-baselines.rst b/baselines/docs/source/how-to-use-baselines.rst
similarity index 100%
rename from baselines/doc/source/how-to-use-baselines.rst
rename to baselines/docs/source/how-to-use-baselines.rst
diff --git a/baselines/doc/source/index.rst b/baselines/docs/source/index.rst
similarity index 100%
rename from baselines/doc/source/index.rst
rename to baselines/docs/source/index.rst
diff --git a/datasets/dev/build-flwr-datasets-docs.sh b/datasets/dev/build-flwr-datasets-docs.sh
index ed41a87a414b..9cb80dcfd5d2 100755
--- a/datasets/dev/build-flwr-datasets-docs.sh
+++ b/datasets/dev/build-flwr-datasets-docs.sh
@@ -22,7 +22,7 @@
 
 set -e
 
-cd "$( cd "$( dirname "${BASH_SOURCE[0]}" )"  >/dev/null 2>&1 && pwd )"/../doc
+cd "$( cd "$( dirname "${BASH_SOURCE[0]}" )"  >/dev/null 2>&1 && pwd )"/../docs
 
 # Remove the old docs from source/ref-api
 REF_API_DIR="source/ref-api"
diff --git a/datasets/doc/Makefile b/datasets/docs/Makefile
similarity index 100%
rename from datasets/doc/Makefile
rename to datasets/docs/Makefile
diff --git a/datasets/doc/make.bat b/datasets/docs/make.bat
similarity index 100%
rename from datasets/doc/make.bat
rename to datasets/docs/make.bat
diff --git a/datasets/doc/source/.gitignore b/datasets/docs/source/.gitignore
similarity index 100%
rename from datasets/doc/source/.gitignore
rename to datasets/docs/source/.gitignore
diff --git a/datasets/doc/source/_static/custom.css b/datasets/docs/source/_static/custom.css
similarity index 100%
rename from datasets/doc/source/_static/custom.css
rename to datasets/docs/source/_static/custom.css
diff --git a/datasets/doc/source/_static/favicon.ico b/datasets/docs/source/_static/favicon.ico
similarity index 100%
rename from datasets/doc/source/_static/favicon.ico
rename to datasets/docs/source/_static/favicon.ico
diff --git a/datasets/doc/source/_static/flower-datasets-logo.png b/datasets/docs/source/_static/flower-datasets-logo.png
similarity index 100%
rename from datasets/doc/source/_static/flower-datasets-logo.png
rename to datasets/docs/source/_static/flower-datasets-logo.png
diff --git a/datasets/doc/source/_static/readme/comparison_of_partitioning_schemes.png b/datasets/docs/source/_static/readme/comparison_of_partitioning_schemes.png
similarity index 100%
rename from datasets/doc/source/_static/readme/comparison_of_partitioning_schemes.png
rename to datasets/docs/source/_static/readme/comparison_of_partitioning_schemes.png
diff --git a/datasets/doc/source/_static/tutorial-quickstart/choose-hf-dataset.png b/datasets/docs/source/_static/tutorial-quickstart/choose-hf-dataset.png
similarity index 100%
rename from datasets/doc/source/_static/tutorial-quickstart/choose-hf-dataset.png
rename to datasets/docs/source/_static/tutorial-quickstart/choose-hf-dataset.png
diff --git a/datasets/doc/source/_static/tutorial-quickstart/copy-dataset-name.png b/datasets/docs/source/_static/tutorial-quickstart/copy-dataset-name.png
similarity index 100%
rename from datasets/doc/source/_static/tutorial-quickstart/copy-dataset-name.png
rename to datasets/docs/source/_static/tutorial-quickstart/copy-dataset-name.png
diff --git a/datasets/doc/source/_static/tutorial-quickstart/partitioner-flexibility.png b/datasets/docs/source/_static/tutorial-quickstart/partitioner-flexibility.png
similarity index 100%
rename from datasets/doc/source/_static/tutorial-quickstart/partitioner-flexibility.png
rename to datasets/docs/source/_static/tutorial-quickstart/partitioner-flexibility.png
diff --git a/datasets/doc/source/_templates/autosummary/base.rst b/datasets/docs/source/_templates/autosummary/base.rst
similarity index 100%
rename from datasets/doc/source/_templates/autosummary/base.rst
rename to datasets/docs/source/_templates/autosummary/base.rst
diff --git a/datasets/doc/source/_templates/autosummary/class.rst b/datasets/docs/source/_templates/autosummary/class.rst
similarity index 100%
rename from datasets/doc/source/_templates/autosummary/class.rst
rename to datasets/docs/source/_templates/autosummary/class.rst
diff --git a/datasets/doc/source/_templates/autosummary/module.rst b/datasets/docs/source/_templates/autosummary/module.rst
similarity index 100%
rename from datasets/doc/source/_templates/autosummary/module.rst
rename to datasets/docs/source/_templates/autosummary/module.rst
diff --git a/datasets/doc/source/_templates/base.html b/datasets/docs/source/_templates/base.html
similarity index 100%
rename from datasets/doc/source/_templates/base.html
rename to datasets/docs/source/_templates/base.html
diff --git a/datasets/doc/source/_templates/sidebar/search.html b/datasets/docs/source/_templates/sidebar/search.html
similarity index 100%
rename from datasets/doc/source/_templates/sidebar/search.html
rename to datasets/docs/source/_templates/sidebar/search.html
diff --git a/datasets/doc/source/conf.py b/datasets/docs/source/conf.py
similarity index 98%
rename from datasets/doc/source/conf.py
rename to datasets/docs/source/conf.py
index 92d59d7df370..e46a49f504d7 100644
--- a/datasets/doc/source/conf.py
+++ b/datasets/docs/source/conf.py
@@ -17,6 +17,7 @@
 import datetime
 import os
 import sys
+
 from sphinx.application import ConfigError
 
 # Configuration file for the Sphinx documentation builder.
@@ -162,7 +163,7 @@ def find_test_modules(package_path):
 .. raw:: html
 
     <br/>
-    <a href="https://colab.research.google.com/github/adap/flower/blob/main/datasets/doc/source/{{ env.doc2path(env.docname, base=None) }}">
+    <a href="https://colab.research.google.com/github/adap/flower/blob/main/datasets/docs/source/{{ env.doc2path(env.docname, base=None) }}">
         <img alt="Open in Colab" src="https://colab.research.google.com/assets/colab-badge.svg"/>
     </a>
 """
@@ -182,5 +183,5 @@ def find_test_modules(package_path):
 myst_heading_anchors = 3
 
 # -- Options for sphinx_copybutton -------------------------------------
-copybutton_exclude = '.linenos, .gp, .go'
+copybutton_exclude = ".linenos, .gp, .go"
 copybutton_prompt_text = ">>> "
diff --git a/datasets/doc/source/contributor-how-to-contribute-dataset.rst b/datasets/docs/source/contributor-how-to-contribute-dataset.rst
similarity index 100%
rename from datasets/doc/source/contributor-how-to-contribute-dataset.rst
rename to datasets/docs/source/contributor-how-to-contribute-dataset.rst
diff --git a/datasets/doc/source/how-to-disable-enable-progress-bar.rst b/datasets/docs/source/how-to-disable-enable-progress-bar.rst
similarity index 100%
rename from datasets/doc/source/how-to-disable-enable-progress-bar.rst
rename to datasets/docs/source/how-to-disable-enable-progress-bar.rst
diff --git a/datasets/doc/source/how-to-install-flwr-datasets.rst b/datasets/docs/source/how-to-install-flwr-datasets.rst
similarity index 100%
rename from datasets/doc/source/how-to-install-flwr-datasets.rst
rename to datasets/docs/source/how-to-install-flwr-datasets.rst
diff --git a/datasets/doc/source/how-to-use-with-local-data.rst b/datasets/docs/source/how-to-use-with-local-data.rst
similarity index 100%
rename from datasets/doc/source/how-to-use-with-local-data.rst
rename to datasets/docs/source/how-to-use-with-local-data.rst
diff --git a/datasets/doc/source/how-to-use-with-numpy.rst b/datasets/docs/source/how-to-use-with-numpy.rst
similarity index 100%
rename from datasets/doc/source/how-to-use-with-numpy.rst
rename to datasets/docs/source/how-to-use-with-numpy.rst
diff --git a/datasets/doc/source/how-to-use-with-pytorch.rst b/datasets/docs/source/how-to-use-with-pytorch.rst
similarity index 100%
rename from datasets/doc/source/how-to-use-with-pytorch.rst
rename to datasets/docs/source/how-to-use-with-pytorch.rst
diff --git a/datasets/doc/source/how-to-use-with-tensorflow.rst b/datasets/docs/source/how-to-use-with-tensorflow.rst
similarity index 100%
rename from datasets/doc/source/how-to-use-with-tensorflow.rst
rename to datasets/docs/source/how-to-use-with-tensorflow.rst
diff --git a/datasets/doc/source/index.rst b/datasets/docs/source/index.rst
similarity index 100%
rename from datasets/doc/source/index.rst
rename to datasets/docs/source/index.rst
diff --git a/datasets/doc/source/recommended-fl-datasets-tables.rst b/datasets/docs/source/recommended-fl-datasets-tables.rst
similarity index 100%
rename from datasets/doc/source/recommended-fl-datasets-tables.rst
rename to datasets/docs/source/recommended-fl-datasets-tables.rst
diff --git a/datasets/doc/source/recommended-fl-datasets.rst b/datasets/docs/source/recommended-fl-datasets.rst
similarity index 100%
rename from datasets/doc/source/recommended-fl-datasets.rst
rename to datasets/docs/source/recommended-fl-datasets.rst
diff --git a/datasets/doc/source/ref-telemetry.md b/datasets/docs/source/ref-telemetry.md
similarity index 100%
rename from datasets/doc/source/ref-telemetry.md
rename to datasets/docs/source/ref-telemetry.md
diff --git a/datasets/doc/source/tutorial-quickstart.ipynb b/datasets/docs/source/tutorial-quickstart.ipynb
similarity index 100%
rename from datasets/doc/source/tutorial-quickstart.ipynb
rename to datasets/docs/source/tutorial-quickstart.ipynb
diff --git a/datasets/doc/source/tutorial-use-partitioners.ipynb b/datasets/docs/source/tutorial-use-partitioners.ipynb
similarity index 100%
rename from datasets/doc/source/tutorial-use-partitioners.ipynb
rename to datasets/docs/source/tutorial-use-partitioners.ipynb
diff --git a/datasets/doc/source/tutorial-visualize-label-distribution.ipynb b/datasets/docs/source/tutorial-visualize-label-distribution.ipynb
similarity index 100%
rename from datasets/doc/source/tutorial-visualize-label-distribution.ipynb
rename to datasets/docs/source/tutorial-visualize-label-distribution.ipynb
diff --git a/dev/build-baseline-docs.sh b/dev/build-baseline-docs.sh
index 794cf2537c74..0d07e2da1046 100755
--- a/dev/build-baseline-docs.sh
+++ b/dev/build-baseline-docs.sh
@@ -3,7 +3,7 @@ set -e
 cd "$( cd "$( dirname "${BASH_SOURCE[0]}" )" >/dev/null 2>&1 && pwd )"/../
 
 ROOT=`pwd`
-INDEX=$ROOT/baselines/doc/source/index.rst
+INDEX=$ROOT/baselines/docs/source/index.rst
 
 initial_text=$(cat <<-END
 .. toctree::
@@ -56,7 +56,7 @@ function add_table_entry ()
 
 ! grep -q ":caption: References" $INDEX && echo "$initial_text" >> $INDEX && echo "" >> $INDEX
 
-rm -f "baselines/doc/source/*.md"
+rm -f "baselines/docs/source/*.md"
 
 cd $ROOT/baselines/
 
@@ -67,12 +67,12 @@ for d in $(printf '%s\n' */ | sort -V); do
   # Select directories
   baseline=${d%/}
 
-  if ! [[ "$baseline" =~ ^(baseline_template|dev|doc|flwr_baselines)$ ]]; then
+  if ! [[ "$baseline" =~ ^(baseline_template|dev|docs|flwr_baselines)$ ]]; then
     # For each baseline, copy the README into the source of the Baselines docs
-    cp $baseline/README.md $ROOT/baselines/doc/source/$baseline.md 2>&1 >/dev/null
+    cp $baseline/README.md $ROOT/baselines/docs/source/$baseline.md 2>&1 >/dev/null
 
     gh_text="[<img src=\"_static/view-gh.png\" alt=\"View on GitHub\" width=\"200\"/>](https://github.com/adap/flower/blob/main/baselines/$baseline)"
-    readme_file="$ROOT/baselines/doc/source/$baseline.md"
+    readme_file="$ROOT/baselines/docs/source/$baseline.md"
 
     if ! grep -Fq "$gh_text" "$readme_file"; then
       awk -v text="$gh_text" '
@@ -92,8 +92,8 @@ for d in $(printf '%s\n' */ | sort -V); do
     do
       image_dir=$(dirname $img)
 
-      mkdir -p $ROOT/baselines/doc/source/$image_dir && cp $baseline/$img $_
-      images_arr+=("$ROOT/baselines/doc/source/$img")
+      mkdir -p $ROOT/baselines/docs/source/$image_dir && cp $baseline/$img $_
+      images_arr+=("$ROOT/baselines/docs/source/$img")
     done
 
     if [[ $(grep -L "$baseline" $INDEX) ]]; then
@@ -109,7 +109,7 @@ for d in $(printf '%s\n' */ | sort -V); do
   fi
 done
 
-cd $ROOT/baselines/doc
+cd $ROOT/baselines/docs
 make html
 
 # Restore everything back to the initial state
diff --git a/dev/build-example-docs.py b/dev/build-example-docs.py
index 05656967bbbd..73ddeafc4e35 100644
--- a/dev/build-example-docs.py
+++ b/dev/build-example-docs.py
@@ -21,7 +21,7 @@
 from pathlib import Path
 
 ROOT = os.path.abspath(os.path.join(os.path.dirname(__file__), ".."))
-INDEX = os.path.join(ROOT, "examples", "doc", "source", "index.rst")
+INDEX = os.path.join(ROOT, "examples", "docs", "source", "index.rst")
 
 initial_text = """
 Flower Examples Documentation
@@ -180,14 +180,14 @@ def _copy_markdown_files(example):
         if file.endswith(".md"):
             src = os.path.join(example, file)
             dest = os.path.join(
-                ROOT, "examples", "doc", "source", os.path.basename(example) + ".md"
+                ROOT, "examples", "docs", "source", os.path.basename(example) + ".md"
             )
             shutil.copyfile(src, dest)
 
 
 def _add_gh_button(example):
     gh_text = f'[<img src="_static/view-gh.png" alt="View on GitHub" width="200"/>](https://github.com/adap/flower/blob/main/examples/{example})'
-    readme_file = os.path.join(ROOT, "examples", "doc", "source", example + ".md")
+    readme_file = os.path.join(ROOT, "examples", "docs", "source", example + ".md")
     with open(readme_file, "r+") as f:
         content = f.read()
         if gh_text not in content:
@@ -201,7 +201,7 @@ def _add_gh_button(example):
 
 def _copy_images(example):
     static_dir = os.path.join(example, "_static")
-    dest_dir = os.path.join(ROOT, "examples", "doc", "source", "_static")
+    dest_dir = os.path.join(ROOT, "examples", "docs", "source", "_static")
     if os.path.isdir(static_dir):
         for file in os.listdir(static_dir):
             if file.endswith((".jpg", ".png", ".jpeg")):
@@ -214,7 +214,7 @@ def _add_all_entries():
     examples_dir = os.path.join(ROOT, "examples")
     for example in sorted(os.listdir(examples_dir)):
         example_path = os.path.join(examples_dir, example)
-        if os.path.isdir(example_path) and example != "doc":
+        if os.path.isdir(example_path) and example != "docs":
             _copy_markdown_files(example_path)
             _add_gh_button(example)
             _copy_images(example)
@@ -230,7 +230,7 @@ def _main():
     examples_dir = os.path.join(ROOT, "examples")
     for example in sorted(os.listdir(examples_dir)):
         example_path = os.path.join(examples_dir, example)
-        if os.path.isdir(example_path) and example != "doc":
+        if os.path.isdir(example_path) and example != "docs":
             _copy_markdown_files(example_path)
             _add_gh_button(example)
             _copy_images(example_path)
@@ -280,4 +280,4 @@ def _main():
 
 if __name__ == "__main__":
     _main()
-    subprocess.call(f"cd {ROOT}/examples/doc && make html", shell=True)
+    subprocess.call(f"cd {ROOT}/examples/docs && make html", shell=True)
diff --git a/dev/update_version.py b/dev/update_version.py
index 0b2db3369a3d..adfb904833b2 100644
--- a/dev/update_version.py
+++ b/dev/update_version.py
@@ -7,7 +7,7 @@
 
 
 REPLACE_CURR_VERSION = {
-    "doc/source/conf.py": [
+    "framework/docs/source/conf.py": [
         ".. |stable_flwr_version| replace:: {version}",
     ],
     "src/py/flwr/cli/new/templates/app/pyproject.*.toml.tpl": [
@@ -17,11 +17,11 @@
 
 REPLACE_NEXT_VERSION = {
     "pyproject.toml": ['version = "{version}"'],
-    "doc/source/conf.py": [
+    "framework/docs/source/conf.py": [
         'release = "{version}"',
     ],
-    "examples/doc/source/conf.py": ['release = "{version}"'],
-    "baselines/doc/source/conf.py": ['release = "{version}"'],
+    "examples/docs/source/conf.py": ['release = "{version}"'],
+    "baselines/docs/source/conf.py": ['release = "{version}"'],
     "src/docker/complete/compose.yml": ["FLWR_VERSION:-{version}"],
     "src/docker/distributed/client/compose.yml": ["FLWR_VERSION:-{version}"],
     "src/docker/distributed/server/compose.yml": ["FLWR_VERSION:-{version}"],
diff --git a/examples/doc/Makefile b/examples/docs/Makefile
similarity index 100%
rename from examples/doc/Makefile
rename to examples/docs/Makefile
diff --git a/examples/doc/make.bat b/examples/docs/make.bat
similarity index 100%
rename from examples/doc/make.bat
rename to examples/docs/make.bat
diff --git a/examples/doc/source/.gitignore b/examples/docs/source/.gitignore
similarity index 100%
rename from examples/doc/source/.gitignore
rename to examples/docs/source/.gitignore
diff --git a/examples/doc/source/_static/.gitignore b/examples/docs/source/_static/.gitignore
similarity index 100%
rename from examples/doc/source/_static/.gitignore
rename to examples/docs/source/_static/.gitignore
diff --git a/examples/doc/source/_static/custom.css b/examples/docs/source/_static/custom.css
similarity index 100%
rename from examples/doc/source/_static/custom.css
rename to examples/docs/source/_static/custom.css
diff --git a/examples/doc/source/_static/favicon.ico b/examples/docs/source/_static/favicon.ico
similarity index 100%
rename from examples/doc/source/_static/favicon.ico
rename to examples/docs/source/_static/favicon.ico
diff --git a/examples/doc/source/_static/flower-logo.png b/examples/docs/source/_static/flower-logo.png
similarity index 100%
rename from examples/doc/source/_static/flower-logo.png
rename to examples/docs/source/_static/flower-logo.png
diff --git a/examples/doc/source/_static/tmux_jtop_view.gif b/examples/docs/source/_static/tmux_jtop_view.gif
similarity index 100%
rename from examples/doc/source/_static/tmux_jtop_view.gif
rename to examples/docs/source/_static/tmux_jtop_view.gif
diff --git a/examples/doc/source/_static/view-gh.png b/examples/docs/source/_static/view-gh.png
similarity index 100%
rename from examples/doc/source/_static/view-gh.png
rename to examples/docs/source/_static/view-gh.png
diff --git a/examples/doc/source/_templates/base.html b/examples/docs/source/_templates/base.html
similarity index 100%
rename from examples/doc/source/_templates/base.html
rename to examples/docs/source/_templates/base.html
diff --git a/examples/doc/source/conf.py b/examples/docs/source/conf.py
similarity index 100%
rename from examples/doc/source/conf.py
rename to examples/docs/source/conf.py

From 1e5cf1ebb3edd3deeb6ef548b1d2d8921c547c10 Mon Sep 17 00:00:00 2001
From: Heng Pan <pan@flower.ai>
Date: Thu, 12 Dec 2024 01:09:33 +0800
Subject: [PATCH 047/104] refactor(framework) Improve help message (#4672)

---
 src/py/flwr/cli/config_utils.py      | 20 ++++++++++++++++++--
 src/py/flwr/cli/config_utils_test.py |  4 ++--
 src/py/flwr/cli/log.py               | 15 ++++-----------
 src/py/flwr/cli/login/login.py       | 16 ++++------------
 src/py/flwr/cli/ls.py                | 15 ++++-----------
 src/py/flwr/cli/run/run.py           |  4 ++--
 src/py/flwr/cli/stop.py              | 15 ++++-----------
 7 files changed, 38 insertions(+), 51 deletions(-)

diff --git a/src/py/flwr/cli/config_utils.py b/src/py/flwr/cli/config_utils.py
index 40fa1e0d3b98..4a081985efc2 100644
--- a/src/py/flwr/cli/config_utils.py
+++ b/src/py/flwr/cli/config_utils.py
@@ -230,10 +230,14 @@ def load_from_string(toml_content: str) -> Optional[dict[str, Any]]:
         return None
 
 
-def validate_project_config(
+def process_loaded_project_config(
     config: Union[dict[str, Any], None], errors: list[str], warnings: list[str]
 ) -> dict[str, Any]:
-    """Validate and return the Flower project configuration."""
+    """Process and return the loaded project configuration.
+
+    This function handles errors and warnings from the `load_and_validate` function,
+    exits on critical issues, and returns the validated configuration.
+    """
     if config is None:
         typer.secho(
             "Project configuration could not be loaded.\n"
@@ -324,3 +328,15 @@ def validate_certificate_in_federation_config(
             raise typer.Exit(code=1)
 
     return insecure, root_certificates_bytes
+
+
+def exit_if_no_address(federation_config: dict[str, Any], cmd: str) -> None:
+    """Exit if the provided federation_config has no "address" key."""
+    if "address" not in federation_config:
+        typer.secho(
+            f"❌ `flwr {cmd}` currently works with a SuperLink. Ensure that the correct"
+            "SuperLink (Exec API) address is provided in `pyproject.toml`.",
+            fg=typer.colors.RED,
+            bold=True,
+        )
+        raise typer.Exit(code=1)
diff --git a/src/py/flwr/cli/config_utils_test.py b/src/py/flwr/cli/config_utils_test.py
index 01003b25abed..f58c1fd75082 100644
--- a/src/py/flwr/cli/config_utils_test.py
+++ b/src/py/flwr/cli/config_utils_test.py
@@ -24,11 +24,11 @@
 
 from .config_utils import (
     load,
+    process_loaded_project_config,
     validate,
     validate_certificate_in_federation_config,
     validate_federation_in_project_config,
     validate_fields,
-    validate_project_config,
 )
 
 
@@ -349,7 +349,7 @@ def test_validate_project_config_fail() -> None:
 
     # Execute
     with pytest.raises(click.exceptions.Exit) as excinfo:
-        _ = validate_project_config(config, errors, warnings)
+        _ = process_loaded_project_config(config, errors, warnings)
 
     # Assert
     assert excinfo.value.exit_code == 1
diff --git a/src/py/flwr/cli/log.py b/src/py/flwr/cli/log.py
index c0bd5c8726e9..f0ee02b05cc1 100644
--- a/src/py/flwr/cli/log.py
+++ b/src/py/flwr/cli/log.py
@@ -23,9 +23,10 @@
 import typer
 
 from flwr.cli.config_utils import (
+    exit_if_no_address,
     load_and_validate,
+    process_loaded_project_config,
     validate_federation_in_project_config,
-    validate_project_config,
 )
 from flwr.common.constant import CONN_RECONNECT_INTERVAL, CONN_REFRESH_PERIOD
 from flwr.common.logger import log as logger
@@ -152,19 +153,11 @@ def log(
 
     pyproject_path = app / "pyproject.toml" if app else None
     config, errors, warnings = load_and_validate(path=pyproject_path)
-    config = validate_project_config(config, errors, warnings)
+    config = process_loaded_project_config(config, errors, warnings)
     federation, federation_config = validate_federation_in_project_config(
         federation, config
     )
-
-    if "address" not in federation_config:
-        typer.secho(
-            "❌ `flwr log` currently works with Exec API. Ensure that the correct"
-            "Exec API address is provided in the `pyproject.toml`.",
-            fg=typer.colors.RED,
-            bold=True,
-        )
-        raise typer.Exit(code=1)
+    exit_if_no_address(federation_config, "log")
 
     _log_with_exec_api(app, federation, federation_config, run_id, stream)
 
diff --git a/src/py/flwr/cli/login/login.py b/src/py/flwr/cli/login/login.py
index 83448c42d662..83d4d2723e32 100644
--- a/src/py/flwr/cli/login/login.py
+++ b/src/py/flwr/cli/login/login.py
@@ -20,9 +20,10 @@
 import typer
 
 from flwr.cli.config_utils import (
+    exit_if_no_address,
     load_and_validate,
+    process_loaded_project_config,
     validate_federation_in_project_config,
-    validate_project_config,
 )
 from flwr.common.constant import AUTH_TYPE
 from flwr.proto.exec_pb2 import (  # pylint: disable=E0611
@@ -50,20 +51,11 @@ def login(  # pylint: disable=R0914
     pyproject_path = app / "pyproject.toml" if app else None
     config, errors, warnings = load_and_validate(path=pyproject_path)
 
-    config = validate_project_config(config, errors, warnings)
+    config = process_loaded_project_config(config, errors, warnings)
     federation, federation_config = validate_federation_in_project_config(
         federation, config
     )
-
-    if "address" not in federation_config:
-        typer.secho(
-            "❌ `flwr login` currently works with a SuperLink. Ensure that the correct"
-            "SuperLink (Exec API) address is provided in `pyproject.toml`.",
-            fg=typer.colors.RED,
-            bold=True,
-        )
-        raise typer.Exit(code=1)
-
+    exit_if_no_address(federation_config, "login")
     channel = init_channel(app, federation_config, None)
     stub = ExecStub(channel)
 
diff --git a/src/py/flwr/cli/ls.py b/src/py/flwr/cli/ls.py
index e5d2b2380cbc..cc9b87219abf 100644
--- a/src/py/flwr/cli/ls.py
+++ b/src/py/flwr/cli/ls.py
@@ -28,9 +28,10 @@
 from typer import Exit
 
 from flwr.cli.config_utils import (
+    exit_if_no_address,
     load_and_validate,
+    process_loaded_project_config,
     validate_federation_in_project_config,
-    validate_project_config,
 )
 from flwr.common.constant import FAB_CONFIG_FILE, CliOutputFormat, SubStatus
 from flwr.common.date import format_timedelta, isoformat8601_utc
@@ -92,19 +93,11 @@ def ls(  # pylint: disable=too-many-locals, too-many-branches
 
         pyproject_path = app / FAB_CONFIG_FILE if app else None
         config, errors, warnings = load_and_validate(path=pyproject_path)
-        config = validate_project_config(config, errors, warnings)
+        config = process_loaded_project_config(config, errors, warnings)
         federation, federation_config = validate_federation_in_project_config(
             federation, config
         )
-
-        if "address" not in federation_config:
-            typer.secho(
-                "❌ `flwr ls` currently works with Exec API. Ensure that the correct"
-                "Exec API address is provided in the `pyproject.toml`.",
-                fg=typer.colors.RED,
-                bold=True,
-            )
-            raise typer.Exit(code=1)
+        exit_if_no_address(federation_config, "ls")
 
         try:
             if runs and run_id is not None:
diff --git a/src/py/flwr/cli/run/run.py b/src/py/flwr/cli/run/run.py
index d85d56401491..aae7e88747c8 100644
--- a/src/py/flwr/cli/run/run.py
+++ b/src/py/flwr/cli/run/run.py
@@ -27,8 +27,8 @@
 from flwr.cli.config_utils import (
     get_fab_metadata,
     load_and_validate,
+    process_loaded_project_config,
     validate_federation_in_project_config,
-    validate_project_config,
 )
 from flwr.common.config import (
     flatten_dict,
@@ -101,7 +101,7 @@ def run(
 
         pyproject_path = app / "pyproject.toml" if app else None
         config, errors, warnings = load_and_validate(path=pyproject_path)
-        config = validate_project_config(config, errors, warnings)
+        config = process_loaded_project_config(config, errors, warnings)
         federation, federation_config = validate_federation_in_project_config(
             federation, config
         )
diff --git a/src/py/flwr/cli/stop.py b/src/py/flwr/cli/stop.py
index 6274372d05b3..bcf07f8a6156 100644
--- a/src/py/flwr/cli/stop.py
+++ b/src/py/flwr/cli/stop.py
@@ -21,9 +21,10 @@
 import typer
 
 from flwr.cli.config_utils import (
+    exit_if_no_address,
     load_and_validate,
+    process_loaded_project_config,
     validate_federation_in_project_config,
-    validate_project_config,
 )
 from flwr.common.constant import FAB_CONFIG_FILE
 from flwr.proto.exec_pb2 import StopRunRequest, StopRunResponse  # pylint: disable=E0611
@@ -52,19 +53,11 @@ def stop(
 
     pyproject_path = app / FAB_CONFIG_FILE if app else None
     config, errors, warnings = load_and_validate(path=pyproject_path)
-    config = validate_project_config(config, errors, warnings)
+    config = process_loaded_project_config(config, errors, warnings)
     federation, federation_config = validate_federation_in_project_config(
         federation, config
     )
-
-    if "address" not in federation_config:
-        typer.secho(
-            "❌ `flwr stop` currently works with Exec API. Ensure that the correct"
-            "Exec API address is provided in the `pyproject.toml`.",
-            fg=typer.colors.RED,
-            bold=True,
-        )
-        raise typer.Exit(code=1)
+    exit_if_no_address(federation_config, "stop")
 
     try:
         auth_plugin = try_obtain_cli_auth_plugin(app, federation, federation_config)

From 91b07b3907402ee48b637af1510425a5df5b4dbc Mon Sep 17 00:00:00 2001
From: Charles Beauville <charles@flower.ai>
Date: Wed, 11 Dec 2024 09:38:38 -0800
Subject: [PATCH 048/104] ci(framework) Fix multi version docs (#4679)

---
 framework/docs/build-versioned-docs.sh | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/framework/docs/build-versioned-docs.sh b/framework/docs/build-versioned-docs.sh
index f993860fdd3e..bea6dbfd8999 100755
--- a/framework/docs/build-versioned-docs.sh
+++ b/framework/docs/build-versioned-docs.sh
@@ -95,14 +95,16 @@ END
     # Actually building the docs for a given language and version
     sphinx-build -b html source/ build/html/${current_version}/${current_language} -A lang=True -D language=${current_language}
 
-    cd $(git rev-parse --show-toplevel)
-
     # Clean the history of the checked-out branch to remove conflicts
     git clean -fd
 
   done
+
+  cd $(git rev-parse --show-toplevel)
 done
-  
+
+cd framework/docs
+
 # Build the main version (main for GH CI, local branch for local) 
 if [ $GITHUB_ACTIONS ]
 then

From e3c97f021e4208c14890dde72b337769904156b7 Mon Sep 17 00:00:00 2001
From: Charles Beauville <charles@flower.ai>
Date: Wed, 11 Dec 2024 10:42:52 -0800
Subject: [PATCH 049/104] ci(framework) Fix CI docs deployment (#4680)

---
 framework/docs/build-versioned-docs.sh | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/framework/docs/build-versioned-docs.sh b/framework/docs/build-versioned-docs.sh
index bea6dbfd8999..452452fc63da 100755
--- a/framework/docs/build-versioned-docs.sh
+++ b/framework/docs/build-versioned-docs.sh
@@ -103,8 +103,6 @@ END
   cd $(git rev-parse --show-toplevel)
 done
 
-cd framework/docs
-
 # Build the main version (main for GH CI, local branch for local) 
 if [ $GITHUB_ACTIONS ]
 then
@@ -113,6 +111,8 @@ else
   git checkout --force $current_branch
 fi
 
+cd framework/docs
+
 current_version=main
 export current_version
 for current_language in ${languages}; do

From 18634ac56f9dd6be5621975bfe8a9286879afa55 Mon Sep 17 00:00:00 2001
From: Mohammad Naseri <mohammad@flower.ai>
Date: Thu, 12 Dec 2024 08:49:05 +0000
Subject: [PATCH 050/104] fix(framework) Fix local DP param noising (#4677)

---
 src/py/flwr/client/mod/localdp_mod.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/py/flwr/client/mod/localdp_mod.py b/src/py/flwr/client/mod/localdp_mod.py
index fe369ad1c7e6..73ede7747bdd 100644
--- a/src/py/flwr/client/mod/localdp_mod.py
+++ b/src/py/flwr/client/mod/localdp_mod.py
@@ -136,7 +136,7 @@ def __call__(
         fit_res.parameters = ndarrays_to_parameters(client_to_server_params)
 
         # Add noise to model params
-        add_localdp_gaussian_noise_to_params(
+        fit_res.parameters = add_localdp_gaussian_noise_to_params(
             fit_res.parameters, self.sensitivity, self.epsilon, self.delta
         )
 

From 4152c922797dc08ed65eba4ddde66f6a0fd486ac Mon Sep 17 00:00:00 2001
From: Charles Beauville <charles@flower.ai>
Date: Thu, 12 Dec 2024 01:35:54 -0800
Subject: [PATCH 051/104] ci(*:skip) Update deploy script for all docs (#4686)

---
 .github/workflows/docs.yml | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index a4b3455d8c6c..a0e4aea55a06 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -46,6 +46,6 @@ jobs:
           DOCS_BUCKET: flower.ai
         run: |
           aws s3 sync --delete --exclude ".*" --exclude "v/*" --cache-control "no-cache" ./framework/docs/build/html/ s3://${{ env.DOCS_BUCKET }}/docs/framework
-          aws s3 sync --delete --exclude ".*" --exclude "v/*" --cache-control "no-cache" ./baselines/doc/build/html/ s3://${{ env.DOCS_BUCKET }}/docs/baselines
-          aws s3 sync --delete --exclude ".*" --exclude "v/*" --cache-control "no-cache" ./examples/doc/build/html/ s3://${{ env.DOCS_BUCKET }}/docs/examples
-          aws s3 sync --delete --exclude ".*" --exclude "v/*" --cache-control "no-cache" ./datasets/doc/build/html/ s3://${{ env.DOCS_BUCKET }}/docs/datasets
+          aws s3 sync --delete --exclude ".*" --exclude "v/*" --cache-control "no-cache" ./baselines/docs/build/html/ s3://${{ env.DOCS_BUCKET }}/docs/baselines
+          aws s3 sync --delete --exclude ".*" --exclude "v/*" --cache-control "no-cache" ./examples/docs/build/html/ s3://${{ env.DOCS_BUCKET }}/docs/examples
+          aws s3 sync --delete --exclude ".*" --exclude "v/*" --cache-control "no-cache" ./datasets/docs/build/html/ s3://${{ env.DOCS_BUCKET }}/docs/datasets

From 3e6c0b48b66a71f4714ea58369c8f68ea2758ffa Mon Sep 17 00:00:00 2001
From: Javier <jafermarq@users.noreply.github.com>
Date: Thu, 12 Dec 2024 09:51:00 +0000
Subject: [PATCH 052/104] refactor(framework) Move gRPC stub wrapping with
 `RetryInvoker` to `flwr.common` (#4636)

---
 src/py/flwr/common/retry_invoker.py      | 67 ++++++++++++++++++++++++
 src/py/flwr/server/driver/grpc_driver.py | 65 ++---------------------
 2 files changed, 71 insertions(+), 61 deletions(-)

diff --git a/src/py/flwr/common/retry_invoker.py b/src/py/flwr/common/retry_invoker.py
index 9785b0fbd9b4..b942bb86a0ff 100644
--- a/src/py/flwr/common/retry_invoker.py
+++ b/src/py/flwr/common/retry_invoker.py
@@ -20,8 +20,16 @@
 import time
 from collections.abc import Generator, Iterable
 from dataclasses import dataclass
+from logging import INFO, WARN
 from typing import Any, Callable, Optional, Union, cast
 
+import grpc
+
+from flwr.common.constant import MAX_RETRY_DELAY
+from flwr.common.logger import log
+from flwr.proto.clientappio_pb2_grpc import ClientAppIoStub
+from flwr.proto.serverappio_pb2_grpc import ServerAppIoStub
+
 
 def exponential(
     base_delay: float = 1,
@@ -303,3 +311,62 @@ def giveup_check(_exception: Exception) -> bool:
                 # Trigger success event
                 try_call_event_handler(self.on_success)
                 return ret
+
+
+def _make_simple_grpc_retry_invoker() -> RetryInvoker:
+    """Create a simple gRPC retry invoker."""
+
+    def _on_sucess(retry_state: RetryState) -> None:
+        if retry_state.tries > 1:
+            log(
+                INFO,
+                "Connection successful after %.2f seconds and %s tries.",
+                retry_state.elapsed_time,
+                retry_state.tries,
+            )
+
+    def _on_backoff(retry_state: RetryState) -> None:
+        if retry_state.tries == 1:
+            log(WARN, "Connection attempt failed, retrying...")
+        else:
+            log(
+                WARN,
+                "Connection attempt failed, retrying in %.2f seconds",
+                retry_state.actual_wait,
+            )
+
+    def _on_giveup(retry_state: RetryState) -> None:
+        if retry_state.tries > 1:
+            log(
+                WARN,
+                "Giving up reconnection after %.2f seconds and %s tries.",
+                retry_state.elapsed_time,
+                retry_state.tries,
+            )
+
+    return RetryInvoker(
+        wait_gen_factory=lambda: exponential(max_delay=MAX_RETRY_DELAY),
+        recoverable_exceptions=grpc.RpcError,
+        max_tries=None,
+        max_time=None,
+        on_success=_on_sucess,
+        on_backoff=_on_backoff,
+        on_giveup=_on_giveup,
+        should_giveup=lambda e: e.code() != grpc.StatusCode.UNAVAILABLE,  # type: ignore
+    )
+
+
+def _wrap_stub(
+    stub: Union[ServerAppIoStub, ClientAppIoStub], retry_invoker: RetryInvoker
+) -> None:
+    """Wrap a gRPC stub with a retry invoker."""
+
+    def make_lambda(original_method: Any) -> Any:
+        return lambda *args, **kwargs: retry_invoker.invoke(
+            original_method, *args, **kwargs
+        )
+
+    for method_name in vars(stub):
+        method = getattr(stub, method_name)
+        if callable(method):
+            setattr(stub, method_name, make_lambda(method))
diff --git a/src/py/flwr/server/driver/grpc_driver.py b/src/py/flwr/server/driver/grpc_driver.py
index 09318c32b704..f844aee57191 100644
--- a/src/py/flwr/server/driver/grpc_driver.py
+++ b/src/py/flwr/server/driver/grpc_driver.py
@@ -17,16 +17,16 @@
 import time
 import warnings
 from collections.abc import Iterable
-from logging import DEBUG, INFO, WARN, WARNING
-from typing import Any, Optional, cast
+from logging import DEBUG, WARNING
+from typing import Optional, cast
 
 import grpc
 
 from flwr.common import DEFAULT_TTL, Message, Metadata, RecordSet
-from flwr.common.constant import MAX_RETRY_DELAY, SERVERAPPIO_API_DEFAULT_CLIENT_ADDRESS
+from flwr.common.constant import SERVERAPPIO_API_DEFAULT_CLIENT_ADDRESS
 from flwr.common.grpc import create_channel
 from flwr.common.logger import log
-from flwr.common.retry_invoker import RetryInvoker, RetryState, exponential
+from flwr.common.retry_invoker import _make_simple_grpc_retry_invoker, _wrap_stub
 from flwr.common.serde import message_from_taskres, message_to_taskins, run_from_proto
 from flwr.common.typing import Run
 from flwr.proto.node_pb2 import Node  # pylint: disable=E0611
@@ -262,60 +262,3 @@ def close(self) -> None:
             return
         # Disconnect
         self._disconnect()
-
-
-def _make_simple_grpc_retry_invoker() -> RetryInvoker:
-    """Create a simple gRPC retry invoker."""
-
-    def _on_sucess(retry_state: RetryState) -> None:
-        if retry_state.tries > 1:
-            log(
-                INFO,
-                "Connection successful after %.2f seconds and %s tries.",
-                retry_state.elapsed_time,
-                retry_state.tries,
-            )
-
-    def _on_backoff(retry_state: RetryState) -> None:
-        if retry_state.tries == 1:
-            log(WARN, "Connection attempt failed, retrying...")
-        else:
-            log(
-                WARN,
-                "Connection attempt failed, retrying in %.2f seconds",
-                retry_state.actual_wait,
-            )
-
-    def _on_giveup(retry_state: RetryState) -> None:
-        if retry_state.tries > 1:
-            log(
-                WARN,
-                "Giving up reconnection after %.2f seconds and %s tries.",
-                retry_state.elapsed_time,
-                retry_state.tries,
-            )
-
-    return RetryInvoker(
-        wait_gen_factory=lambda: exponential(max_delay=MAX_RETRY_DELAY),
-        recoverable_exceptions=grpc.RpcError,
-        max_tries=None,
-        max_time=None,
-        on_success=_on_sucess,
-        on_backoff=_on_backoff,
-        on_giveup=_on_giveup,
-        should_giveup=lambda e: e.code() != grpc.StatusCode.UNAVAILABLE,  # type: ignore
-    )
-
-
-def _wrap_stub(stub: ServerAppIoStub, retry_invoker: RetryInvoker) -> None:
-    """Wrap the gRPC stub with a retry invoker."""
-
-    def make_lambda(original_method: Any) -> Any:
-        return lambda *args, **kwargs: retry_invoker.invoke(
-            original_method, *args, **kwargs
-        )
-
-    for method_name in vars(stub):
-        method = getattr(stub, method_name)
-        if callable(method):
-            setattr(stub, method_name, make_lambda(method))

From 3966e8d1a734e41c6b1e2699477380a8a427a752 Mon Sep 17 00:00:00 2001
From: Chong Shen Ng <chong.shen@flower.ai>
Date: Thu, 12 Dec 2024 12:31:28 +0000
Subject: [PATCH 053/104] feat(framework) Add checks to `ServerAppIoServicer`
 to allow context abort via `flwr stop`  (#4646)

Co-authored-by: Heng Pan <pan@flower.ai>
Co-authored-by: Daniel J. Beutel <daniel@flower.ai>
---
 .../superlink/driver/serverappio_servicer.py  | 56 ++++++++++++++--
 src/py/flwr/server/superlink/utils.py         | 65 +++++++++++++++++++
 2 files changed, 115 insertions(+), 6 deletions(-)
 create mode 100644 src/py/flwr/server/superlink/utils.py

diff --git a/src/py/flwr/server/superlink/driver/serverappio_servicer.py b/src/py/flwr/server/superlink/driver/serverappio_servicer.py
index ca0b2ec0d8a5..a3d06ac222de 100644
--- a/src/py/flwr/server/superlink/driver/serverappio_servicer.py
+++ b/src/py/flwr/server/superlink/driver/serverappio_servicer.py
@@ -70,6 +70,7 @@
 from flwr.server.superlink.ffs.ffs import Ffs
 from flwr.server.superlink.ffs.ffs_factory import FfsFactory
 from flwr.server.superlink.linkstate import LinkState, LinkStateFactory
+from flwr.server.superlink.utils import abort_if
 from flwr.server.utils.validator import validate_task_ins_or_res
 
 
@@ -88,7 +89,18 @@ def GetNodes(
     ) -> GetNodesResponse:
         """Get available nodes."""
         log(DEBUG, "ServerAppIoServicer.GetNodes")
+
+        # Init state
         state: LinkState = self.state_factory.state()
+
+        # Abort if the run is not running
+        abort_if(
+            request.run_id,
+            [Status.PENDING, Status.STARTING, Status.FINISHED],
+            state,
+            context,
+        )
+
         all_ids: set[int] = state.get_nodes(request.run_id)
         nodes: list[Node] = [
             Node(node_id=node_id, anonymous=False) for node_id in all_ids
@@ -126,6 +138,17 @@ def PushTaskIns(
         """Push a set of TaskIns."""
         log(DEBUG, "ServerAppIoServicer.PushTaskIns")
 
+        # Init state
+        state: LinkState = self.state_factory.state()
+
+        # Abort if the run is not running
+        abort_if(
+            request.run_id,
+            [Status.PENDING, Status.STARTING, Status.FINISHED],
+            state,
+            context,
+        )
+
         # Set pushed_at (timestamp in seconds)
         pushed_at = time.time()
         for task_ins in request.task_ins_list:
@@ -137,9 +160,6 @@ def PushTaskIns(
             validation_errors = validate_task_ins_or_res(task_ins)
             _raise_if(bool(validation_errors), ", ".join(validation_errors))
 
-        # Init state
-        state: LinkState = self.state_factory.state()
-
         # Store each TaskIns
         task_ids: list[Optional[UUID]] = []
         for task_ins in request.task_ins_list:
@@ -156,12 +176,20 @@ def PullTaskRes(
         """Pull a set of TaskRes."""
         log(DEBUG, "ServerAppIoServicer.PullTaskRes")
 
-        # Convert each task_id str to UUID
-        task_ids: set[UUID] = {UUID(task_id) for task_id in request.task_ids}
-
         # Init state
         state: LinkState = self.state_factory.state()
 
+        # Abort if the run is not running
+        abort_if(
+            request.run_id,
+            [Status.PENDING, Status.STARTING, Status.FINISHED],
+            state,
+            context,
+        )
+
+        # Convert each task_id str to UUID
+        task_ids: set[UUID] = {UUID(task_id) for task_id in request.task_ids}
+
         # Register callback
         def on_rpc_done() -> None:
             log(
@@ -258,7 +286,18 @@ def PushServerAppOutputs(
     ) -> PushServerAppOutputsResponse:
         """Push ServerApp process outputs."""
         log(DEBUG, "ServerAppIoServicer.PushServerAppOutputs")
+
+        # Init state
         state = self.state_factory.state()
+
+        # Abort if the run is not running
+        abort_if(
+            request.run_id,
+            [Status.PENDING, Status.STARTING, Status.FINISHED],
+            state,
+            context,
+        )
+
         state.set_serverapp_context(request.run_id, context_from_proto(request.context))
         return PushServerAppOutputsResponse()
 
@@ -267,8 +306,13 @@ def UpdateRunStatus(
     ) -> UpdateRunStatusResponse:
         """Update the status of a run."""
         log(DEBUG, "ServerAppIoServicer.UpdateRunStatus")
+
+        # Init state
         state = self.state_factory.state()
 
+        # Abort if the run is finished
+        abort_if(request.run_id, [Status.FINISHED], state, context)
+
         # Update the run status
         state.update_run_status(
             run_id=request.run_id, new_status=run_status_from_proto(request.run_status)
diff --git a/src/py/flwr/server/superlink/utils.py b/src/py/flwr/server/superlink/utils.py
new file mode 100644
index 000000000000..09c7e5f3319e
--- /dev/null
+++ b/src/py/flwr/server/superlink/utils.py
@@ -0,0 +1,65 @@
+# Copyright 2024 Flower Labs GmbH. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# ==============================================================================
+"""SuperLink utilities."""
+
+
+from typing import Union
+
+import grpc
+
+from flwr.common.constant import Status, SubStatus
+from flwr.common.typing import RunStatus
+from flwr.server.superlink.linkstate import LinkState
+
+_STATUS_TO_MSG = {
+    Status.PENDING: "Run is pending.",
+    Status.STARTING: "Run is starting.",
+    Status.RUNNING: "Run is running.",
+    Status.FINISHED: "Run is finished.",
+}
+
+
+def check_abort(
+    run_id: int,
+    abort_status_list: list[str],
+    state: LinkState,
+) -> Union[str, None]:
+    """Check if the status of the provided `run_id` is in `abort_status_list`."""
+    run_status: RunStatus = state.get_run_status({run_id})[run_id]
+
+    if run_status.status in abort_status_list:
+        msg = _STATUS_TO_MSG[run_status.status]
+        if run_status.sub_status == SubStatus.STOPPED:
+            msg += " Stopped by user."
+        return msg
+
+    return None
+
+
+def abort_grpc_context(msg: Union[str, None], context: grpc.ServicerContext) -> None:
+    """Abort context with statuscode PERMISSION_DENIED if `msg` is not None."""
+    if msg is not None:
+        context.abort(grpc.StatusCode.PERMISSION_DENIED, msg)
+
+
+def abort_if(
+    run_id: int,
+    abort_status_list: list[str],
+    state: LinkState,
+    context: grpc.ServicerContext,
+) -> None:
+    """Abort context if status of the provided `run_id` is in `abort_status_list`."""
+    msg = check_abort(run_id, abort_status_list, state)
+    abort_grpc_context(msg, context)

From 89da49d18565448f7c66c1cf1b149b000c0f5c92 Mon Sep 17 00:00:00 2001
From: Chong Shen Ng <chong.shen@flower.ai>
Date: Thu, 12 Dec 2024 13:15:30 +0000
Subject: [PATCH 054/104] feat(framework) Add exception handling to `ServerApp`
 when stopped (#4658)

---
 src/py/flwr/common/retry_invoker.py    | 10 +++++++++-
 src/py/flwr/common/typing.py           |  4 ++++
 src/py/flwr/server/compat/app_utils.py |  8 +++++++-
 src/py/flwr/server/serverapp/app.py    | 10 ++++++++--
 4 files changed, 28 insertions(+), 4 deletions(-)

diff --git a/src/py/flwr/common/retry_invoker.py b/src/py/flwr/common/retry_invoker.py
index b942bb86a0ff..4b834fa17302 100644
--- a/src/py/flwr/common/retry_invoker.py
+++ b/src/py/flwr/common/retry_invoker.py
@@ -27,6 +27,7 @@
 
 from flwr.common.constant import MAX_RETRY_DELAY
 from flwr.common.logger import log
+from flwr.common.typing import RunNotRunningException
 from flwr.proto.clientappio_pb2_grpc import ClientAppIoStub
 from flwr.proto.serverappio_pb2_grpc import ServerAppIoStub
 
@@ -344,6 +345,13 @@ def _on_giveup(retry_state: RetryState) -> None:
                 retry_state.tries,
             )
 
+    def _should_giveup_fn(e: Exception) -> bool:
+        if e.code() == grpc.StatusCode.PERMISSION_DENIED:  # type: ignore
+            raise RunNotRunningException
+        if e.code() == grpc.StatusCode.UNAVAILABLE:  # type: ignore
+            return False
+        return True
+
     return RetryInvoker(
         wait_gen_factory=lambda: exponential(max_delay=MAX_RETRY_DELAY),
         recoverable_exceptions=grpc.RpcError,
@@ -352,7 +360,7 @@ def _on_giveup(retry_state: RetryState) -> None:
         on_success=_on_sucess,
         on_backoff=_on_backoff,
         on_giveup=_on_giveup,
-        should_giveup=lambda e: e.code() != grpc.StatusCode.UNAVAILABLE,  # type: ignore
+        should_giveup=_should_giveup_fn,
     )
 
 
diff --git a/src/py/flwr/common/typing.py b/src/py/flwr/common/typing.py
index 3c1ed7fafd85..42c7d9dab1ff 100644
--- a/src/py/flwr/common/typing.py
+++ b/src/py/flwr/common/typing.py
@@ -254,3 +254,7 @@ class Fab:
 
     hash_str: str
     content: bytes
+
+
+class RunNotRunningException(BaseException):
+    """Raised when a run is not running."""
diff --git a/src/py/flwr/server/compat/app_utils.py b/src/py/flwr/server/compat/app_utils.py
index 8d2479f47d40..42496216fc6e 100644
--- a/src/py/flwr/server/compat/app_utils.py
+++ b/src/py/flwr/server/compat/app_utils.py
@@ -17,6 +17,8 @@
 
 import threading
 
+from flwr.common.typing import RunNotRunningException
+
 from ..client_manager import ClientManager
 from ..compat.driver_client_proxy import DriverClientProxy
 from ..driver import Driver
@@ -74,7 +76,11 @@ def _update_client_manager(
     # Loop until the driver is disconnected
     registered_nodes: dict[int, DriverClientProxy] = {}
     while not f_stop.is_set():
-        all_node_ids = set(driver.get_node_ids())
+        try:
+            all_node_ids = set(driver.get_node_ids())
+        except RunNotRunningException:
+            f_stop.set()
+            break
         dead_nodes = set(registered_nodes).difference(all_node_ids)
         new_nodes = all_node_ids.difference(registered_nodes)
 
diff --git a/src/py/flwr/server/serverapp/app.py b/src/py/flwr/server/serverapp/app.py
index 0ed9cc4d0928..80577496e5a3 100644
--- a/src/py/flwr/server/serverapp/app.py
+++ b/src/py/flwr/server/serverapp/app.py
@@ -50,7 +50,7 @@
     run_from_proto,
     run_status_to_proto,
 )
-from flwr.common.typing import RunStatus
+from flwr.common.typing import RunNotRunningException, RunStatus
 from flwr.proto.run_pb2 import UpdateRunStatusRequest  # pylint: disable=E0611
 from flwr.proto.serverappio_pb2 import (  # pylint: disable=E0611
     PullServerAppInputsRequest,
@@ -96,7 +96,7 @@ def flwr_serverapp() -> None:
     restore_output()
 
 
-def run_serverapp(  # pylint: disable=R0914, disable=W0212
+def run_serverapp(  # pylint: disable=R0914, disable=W0212, disable=R0915
     serverappio_api_address: str,
     log_queue: Queue[Optional[str]],
     run_once: bool,
@@ -187,6 +187,12 @@ def run_serverapp(  # pylint: disable=R0914, disable=W0212
 
             run_status = RunStatus(Status.FINISHED, SubStatus.COMPLETED, "")
 
+        except RunNotRunningException:
+            log(INFO, "")
+            log(INFO, "Run ID %s stopped.", run.run_id)
+            log(INFO, "")
+            run_status = None
+
         except Exception as ex:  # pylint: disable=broad-exception-caught
             exc_entity = "ServerApp"
             log(ERROR, "%s raised an exception", exc_entity, exc_info=ex)

From 5d842596286f671558fb5310f53e57e89b1c7fef Mon Sep 17 00:00:00 2001
From: Chong Shen Ng <chong.shen@flower.ai>
Date: Thu, 12 Dec 2024 13:25:02 +0000
Subject: [PATCH 055/104] feat(framework) Add`run_id` to `fab.proto` (#4683)

---
 src/proto/flwr/proto/fab.proto | 1 +
 src/py/flwr/proto/fab_pb2.py   | 8 ++++----
 src/py/flwr/proto/fab_pb2.pyi  | 5 ++++-
 3 files changed, 9 insertions(+), 5 deletions(-)

diff --git a/src/proto/flwr/proto/fab.proto b/src/proto/flwr/proto/fab.proto
index 367b6e5b5c13..347d755530d7 100644
--- a/src/proto/flwr/proto/fab.proto
+++ b/src/proto/flwr/proto/fab.proto
@@ -31,5 +31,6 @@ message Fab {
 message GetFabRequest {
   Node node = 1;
   string hash_str = 2;
+  uint64 run_id = 3;
 }
 message GetFabResponse { Fab fab = 1; }
diff --git a/src/py/flwr/proto/fab_pb2.py b/src/py/flwr/proto/fab_pb2.py
index 3a5e50000c10..1c79d624031a 100644
--- a/src/py/flwr/proto/fab_pb2.py
+++ b/src/py/flwr/proto/fab_pb2.py
@@ -15,7 +15,7 @@
 from flwr.proto import node_pb2 as flwr_dot_proto_dot_node__pb2
 
 
-DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x14\x66lwr/proto/fab.proto\x12\nflwr.proto\x1a\x15\x66lwr/proto/node.proto\"(\n\x03\x46\x61\x62\x12\x10\n\x08hash_str\x18\x01 \x01(\t\x12\x0f\n\x07\x63ontent\x18\x02 \x01(\x0c\"A\n\rGetFabRequest\x12\x1e\n\x04node\x18\x01 \x01(\x0b\x32\x10.flwr.proto.Node\x12\x10\n\x08hash_str\x18\x02 \x01(\t\".\n\x0eGetFabResponse\x12\x1c\n\x03\x66\x61\x62\x18\x01 \x01(\x0b\x32\x0f.flwr.proto.Fabb\x06proto3')
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x14\x66lwr/proto/fab.proto\x12\nflwr.proto\x1a\x15\x66lwr/proto/node.proto\"(\n\x03\x46\x61\x62\x12\x10\n\x08hash_str\x18\x01 \x01(\t\x12\x0f\n\x07\x63ontent\x18\x02 \x01(\x0c\"Q\n\rGetFabRequest\x12\x1e\n\x04node\x18\x01 \x01(\x0b\x32\x10.flwr.proto.Node\x12\x10\n\x08hash_str\x18\x02 \x01(\t\x12\x0e\n\x06run_id\x18\x03 \x01(\x04\".\n\x0eGetFabResponse\x12\x1c\n\x03\x66\x61\x62\x18\x01 \x01(\x0b\x32\x0f.flwr.proto.Fabb\x06proto3')
 
 _globals = globals()
 _builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
@@ -25,7 +25,7 @@
   _globals['_FAB']._serialized_start=59
   _globals['_FAB']._serialized_end=99
   _globals['_GETFABREQUEST']._serialized_start=101
-  _globals['_GETFABREQUEST']._serialized_end=166
-  _globals['_GETFABRESPONSE']._serialized_start=168
-  _globals['_GETFABRESPONSE']._serialized_end=214
+  _globals['_GETFABREQUEST']._serialized_end=182
+  _globals['_GETFABRESPONSE']._serialized_start=184
+  _globals['_GETFABRESPONSE']._serialized_end=230
 # @@protoc_insertion_point(module_scope)
diff --git a/src/py/flwr/proto/fab_pb2.pyi b/src/py/flwr/proto/fab_pb2.pyi
index 8cfdcbaf76ad..dd5f5045a68e 100644
--- a/src/py/flwr/proto/fab_pb2.pyi
+++ b/src/py/flwr/proto/fab_pb2.pyi
@@ -36,16 +36,19 @@ class GetFabRequest(google.protobuf.message.Message):
     DESCRIPTOR: google.protobuf.descriptor.Descriptor
     NODE_FIELD_NUMBER: builtins.int
     HASH_STR_FIELD_NUMBER: builtins.int
+    RUN_ID_FIELD_NUMBER: builtins.int
     @property
     def node(self) -> flwr.proto.node_pb2.Node: ...
     hash_str: typing.Text
+    run_id: builtins.int
     def __init__(self,
         *,
         node: typing.Optional[flwr.proto.node_pb2.Node] = ...,
         hash_str: typing.Text = ...,
+        run_id: builtins.int = ...,
         ) -> None: ...
     def HasField(self, field_name: typing_extensions.Literal["node",b"node"]) -> builtins.bool: ...
-    def ClearField(self, field_name: typing_extensions.Literal["hash_str",b"hash_str","node",b"node"]) -> None: ...
+    def ClearField(self, field_name: typing_extensions.Literal["hash_str",b"hash_str","node",b"node","run_id",b"run_id"]) -> None: ...
 global___GetFabRequest = GetFabRequest
 
 class GetFabResponse(google.protobuf.message.Message):

From 9a849107df5f692069855e8662fa81cadf5caff9 Mon Sep 17 00:00:00 2001
From: Heng Pan <pan@flower.ai>
Date: Thu, 12 Dec 2024 21:46:18 +0800
Subject: [PATCH 056/104] refactor(examples) Upgrade the `mlx` version and
 remove `numpy` dependency in the MLX example (#4689)

---
 examples/quickstart-mlx/pyproject.toml | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/examples/quickstart-mlx/pyproject.toml b/examples/quickstart-mlx/pyproject.toml
index 1c8d2b0b811c..e1221bf2301e 100644
--- a/examples/quickstart-mlx/pyproject.toml
+++ b/examples/quickstart-mlx/pyproject.toml
@@ -10,8 +10,7 @@ license = "Apache-2.0"
 dependencies = [
     "flwr[simulation]>=1.13.1",
     "flwr-datasets[vision]>=0.3.0",
-    "mlx==0.16.0",
-    "numpy==1.26.4",
+    "mlx==0.21.1",
 ]
 
 [tool.hatch.build.targets.wheel]

From b3cf2118ed8fb18a6aed24fb602f17c671dbcfcf Mon Sep 17 00:00:00 2001
From: Heng Pan <pan@flower.ai>
Date: Thu, 12 Dec 2024 21:54:31 +0800
Subject: [PATCH 057/104] refactor(framework) Upgrade the mlx version and
 remove numpy dependency in the MLX template (#4690)

---
 src/py/flwr/cli/new/templates/app/pyproject.mlx.toml.tpl | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/src/py/flwr/cli/new/templates/app/pyproject.mlx.toml.tpl b/src/py/flwr/cli/new/templates/app/pyproject.mlx.toml.tpl
index 5d4cc9987fb5..8adcf5491616 100644
--- a/src/py/flwr/cli/new/templates/app/pyproject.mlx.toml.tpl
+++ b/src/py/flwr/cli/new/templates/app/pyproject.mlx.toml.tpl
@@ -10,8 +10,7 @@ license = "Apache-2.0"
 dependencies = [
     "flwr[simulation]>=1.13.1",
     "flwr-datasets[vision]>=0.3.0",
-    "mlx==0.16.1",
-    "numpy==1.24.4",
+    "mlx==0.21.1",
 ]
 
 [tool.hatch.build.targets.wheel]

From 879e8c74a50a1be29dcb4b7bed6cf23258cd8edb Mon Sep 17 00:00:00 2001
From: Javier <jafermarq@users.noreply.github.com>
Date: Thu, 12 Dec 2024 14:58:24 +0000
Subject: [PATCH 058/104] fix(framework) Make `load_app` thread safe (#4687)

---
 src/py/flwr/common/object_ref.py | 111 ++++++++++++++++---------------
 1 file changed, 57 insertions(+), 54 deletions(-)

diff --git a/src/py/flwr/common/object_ref.py b/src/py/flwr/common/object_ref.py
index 91414ef210f8..bf34bf5f639c 100644
--- a/src/py/flwr/common/object_ref.py
+++ b/src/py/flwr/common/object_ref.py
@@ -21,6 +21,7 @@
 from importlib.util import find_spec
 from logging import WARN
 from pathlib import Path
+from threading import Lock
 from typing import Any, Optional, Union
 
 from .logger import log
@@ -34,6 +35,7 @@
 
 
 _current_sys_path: Optional[str] = None
+_import_lock = Lock()
 
 
 def validate(
@@ -146,60 +148,61 @@ def load_app(  # pylint: disable= too-many-branches
     - This function will modify `sys.path` by inserting the provided `project_dir`
       and removing the previously inserted `project_dir`.
     """
-    valid, error_msg = validate(module_attribute_str, check_module=False)
-    if not valid and error_msg:
-        raise error_type(error_msg) from None
-
-    module_str, _, attributes_str = module_attribute_str.partition(":")
-
-    try:
-        # Initialize project path
-        if project_dir is None:
-            project_dir = Path.cwd()
-        project_dir = Path(project_dir).absolute()
-
-        # Unload modules if the project directory has changed
-        if _current_sys_path and _current_sys_path != str(project_dir):
-            _unload_modules(Path(_current_sys_path))
-
-        # Set the system path
-        _set_sys_path(project_dir)
-
-        # Import the module
-        if module_str not in sys.modules:
-            module = importlib.import_module(module_str)
-        # Hack: `tabnet` does not work with `importlib.reload`
-        elif "tabnet" in sys.modules:
-            log(
-                WARN,
-                "Cannot reload module `%s` from disk due to compatibility issues "
-                "with the `tabnet` library. The module will be loaded from the "
-                "cache instead. If you experience issues, consider restarting "
-                "the application.",
-                module_str,
-            )
-            module = sys.modules[module_str]
-        else:
-            module = sys.modules[module_str]
-            _reload_modules(project_dir)
-
-    except ModuleNotFoundError as err:
-        raise error_type(
-            f"Unable to load module {module_str}{OBJECT_REF_HELP_STR}",
-        ) from err
-
-    # Recursively load attribute
-    attribute = module
-    try:
-        for attribute_str in attributes_str.split("."):
-            attribute = getattr(attribute, attribute_str)
-    except AttributeError as err:
-        raise error_type(
-            f"Unable to load attribute {attributes_str} from module {module_str}"
-            f"{OBJECT_REF_HELP_STR}",
-        ) from err
-
-    return attribute
+    with _import_lock:
+        valid, error_msg = validate(module_attribute_str, check_module=False)
+        if not valid and error_msg:
+            raise error_type(error_msg) from None
+
+        module_str, _, attributes_str = module_attribute_str.partition(":")
+
+        try:
+            # Initialize project path
+            if project_dir is None:
+                project_dir = Path.cwd()
+            project_dir = Path(project_dir).absolute()
+
+            # Unload modules if the project directory has changed
+            if _current_sys_path and _current_sys_path != str(project_dir):
+                _unload_modules(Path(_current_sys_path))
+
+            # Set the system path
+            _set_sys_path(project_dir)
+
+            # Import the module
+            if module_str not in sys.modules:
+                module = importlib.import_module(module_str)
+            # Hack: `tabnet` does not work with `importlib.reload`
+            elif "tabnet" in sys.modules:
+                log(
+                    WARN,
+                    "Cannot reload module `%s` from disk due to compatibility issues "
+                    "with the `tabnet` library. The module will be loaded from the "
+                    "cache instead. If you experience issues, consider restarting "
+                    "the application.",
+                    module_str,
+                )
+                module = sys.modules[module_str]
+            else:
+                module = sys.modules[module_str]
+                _reload_modules(project_dir)
+
+        except ModuleNotFoundError as err:
+            raise error_type(
+                f"Unable to load module {module_str}{OBJECT_REF_HELP_STR}",
+            ) from err
+
+        # Recursively load attribute
+        attribute = module
+        try:
+            for attribute_str in attributes_str.split("."):
+                attribute = getattr(attribute, attribute_str)
+        except AttributeError as err:
+            raise error_type(
+                f"Unable to load attribute {attributes_str} from module {module_str}"
+                f"{OBJECT_REF_HELP_STR}",
+            ) from err
+
+        return attribute
 
 
 def _unload_modules(project_dir: Path) -> None:

From 9ee4bdeb64b194bfe67f0085b4b67bbd2ecf5b8e Mon Sep 17 00:00:00 2001
From: Javier <jafermarq@users.noreply.github.com>
Date: Thu, 12 Dec 2024 15:48:31 +0000
Subject: [PATCH 059/104] fix(framework) Set `UTF-8` during`flwr new` (#4653)

---
 src/py/flwr/cli/new/new.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/py/flwr/cli/new/new.py b/src/py/flwr/cli/new/new.py
index f96753a37cae..70b50a681b04 100644
--- a/src/py/flwr/cli/new/new.py
+++ b/src/py/flwr/cli/new/new.py
@@ -81,7 +81,7 @@ def render_template(template: str, data: dict[str, str]) -> str:
 def create_file(file_path: Path, content: str) -> None:
     """Create file including all nessecary directories and write content into file."""
     file_path.parent.mkdir(exist_ok=True)
-    file_path.write_text(content)
+    file_path.write_text(content, encoding="utf-8")
 
 
 def render_and_create(file_path: Path, template: str, context: dict[str, str]) -> None:

From 46c2372d90fb3ced67f9ab12fe62e0552226ae6d Mon Sep 17 00:00:00 2001
From: "github-actions[bot]"
 <41898282+github-actions[bot]@users.noreply.github.com>
Date: Fri, 13 Dec 2024 01:37:57 +0000
Subject: [PATCH 060/104] Update text and language files (#4695)

---
 .../locales/fr/LC_MESSAGES/framework-docs.po  | 93 ++++++++++++++-----
 .../locales/ko/LC_MESSAGES/framework-docs.po  | 93 ++++++++++++++-----
 .../pt_BR/LC_MESSAGES/framework-docs.po       | 93 ++++++++++++++-----
 .../zh_Hans/LC_MESSAGES/framework-docs.po     | 93 ++++++++++++++-----
 4 files changed, 288 insertions(+), 84 deletions(-)

diff --git a/framework/docs/locales/fr/LC_MESSAGES/framework-docs.po b/framework/docs/locales/fr/LC_MESSAGES/framework-docs.po
index 9950f5fc32e0..dd6cacab9cef 100644
--- a/framework/docs/locales/fr/LC_MESSAGES/framework-docs.po
+++ b/framework/docs/locales/fr/LC_MESSAGES/framework-docs.po
@@ -3,7 +3,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Flower Docs\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2024-12-09 00:34+0000\n"
+"POT-Creation-Date: 2024-12-13 00:33+0000\n"
 "PO-Revision-Date: 2023-09-05 17:54+0000\n"
 "Last-Translator: Charles Beauville <charles@flower.ai>\n"
 "Language: fr\n"
@@ -9144,7 +9144,7 @@ msgstr ""
 msgid "Arguments"
 msgstr "Amélioration de la documentation"
 
-#: ../../flwr install:1 log:1 ls:1 new:1 run:1 stop:1
+#: ../../flwr install:1 log:1 login:1 ls:1 new:1 run:1 stop:1
 #, fuzzy
 msgid "Optional argument"
 msgstr "Améliorations facultatives"
@@ -9188,6 +9188,20 @@ msgstr ""
 msgid "Name of the federation to run the app on"
 msgstr ""
 
+#: ../../flwr login:1
+#, fuzzy
+msgid "Login to Flower SuperLink."
+msgstr "flower-superlink"
+
+#: ../../flwr login:1 run:1
+#, fuzzy
+msgid "Path of the Flower App to run."
+msgstr "Chargement des données"
+
+#: ../../flwr login:1
+msgid "Name of the federation to login into."
+msgstr ""
+
 #: ../../flwr ls:1
 msgid "List runs."
 msgstr ""
@@ -9278,11 +9292,6 @@ msgid ""
 "default."
 msgstr ""
 
-#: ../../flwr run:1
-#, fuzzy
-msgid "Path of the Flower App to run."
-msgstr "Chargement des données"
-
 #: ../../flwr run:1
 msgid "Name of the federation to run the app on."
 msgstr ""
@@ -29221,7 +29230,7 @@ msgstr ""
 "chose d'autre, comme la régression linéaire classique."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:41
-msgid "|6102f514742c4211b093aae3a5a74e51|"
+msgid "|ae2337ba61dd4efc818e63933fd81666|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:109
@@ -29240,7 +29249,7 @@ msgstr ""
 " Go."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:53
-msgid "|24080db3b13d4b0c8546096de73ac82a|"
+msgid "|14a8d3feda794591a601daaaaa79d0b6|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:111
@@ -29272,7 +29281,7 @@ msgstr ""
 "chanson."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:67
-msgid "|9087a1f0e9ab41c083f5209a3f17e600|"
+msgid "|c67497f1afa84a30a3901418c6c0bb62|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:113
@@ -29293,7 +29302,7 @@ msgstr ""
 " données pour la même tâche."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:79
-msgid "|a5d1853a0b3c44d4bdd408d15a89e7ac|"
+msgid "|d4ce55da082146d7ad13ec4f73d427a2|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:115
@@ -29315,7 +29324,7 @@ msgstr ""
 "cloud."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:91
-msgid "|8e6e9164d7414c39bf37f67e2fda59bd|"
+msgid "|0a0c4ca9de6549c1b35225c6e1183bc0|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:117
@@ -29336,7 +29345,7 @@ msgstr ""
 "appuyés."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:103
-msgid "|e8b1d08849514de1b09fee325db970d0|"
+msgid "|f2f5e8cc5594472c842192ec38ab9bbe|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:119
@@ -29362,7 +29371,7 @@ msgstr ""
 " sur un serveur centralisé."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:138
-msgid "|ca0b3cb207164665b5bef1d869c37dff|"
+msgid "|4e7b0cd854064aab9895573a612a0f06|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:173
@@ -29381,7 +29390,7 @@ msgstr ""
 "suffisantes pour former un bon modèle."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:150
-msgid "|977cb114b97047329a7bb908afbac2cd|"
+msgid "|e121faa35b114a0da17cf4bc42e74ce9|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:175
@@ -29612,7 +29621,7 @@ msgstr ""
 "partir d'un point de contrôle précédemment sauvegardé."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:210
-msgid "|9f497b02d2634af2925a65244cc0eb1b|"
+msgid "|e7a57a83812c4dc8933fbb93cd0e46dc|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:307
@@ -29647,7 +29656,7 @@ msgstr ""
 "rendements décroissants."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:225
-msgid "|938ae2cd4fae49ce9292e6e2d9bd880d|"
+msgid "|a0283fe3cd0c4f3cb5d119f424c657fd|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:309
@@ -29680,7 +29689,7 @@ msgstr ""
 "données locales, ou même de quelques étapes (mini-batchs)."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:240
-msgid "|47cd7c6cb4094846833faff5b05e0d46|"
+msgid "|debbe320f2c741388902ebabfb6fc705|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:311
@@ -29711,7 +29720,7 @@ msgstr ""
 " l'entraînement local."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:255
-msgid "|c90d6613b0a34a42bf3023ca5a81c8e2|"
+msgid "|8be6ce669d3148f9af6272ca27a98197|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:313
@@ -29771,7 +29780,7 @@ msgstr ""
 "times as much as each of the 100 examples."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:273
-msgid "|91c29c3c9b1b411590de3983d94ed76a|"
+msgid "|47c4a06eafbb4e2fa1c62b5ca47d3411|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:315
@@ -29915,7 +29924,7 @@ msgstr ""
 "quel cadre de ML et n'importe quel langage de programmation."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:334
-msgid "|e4adf0f92ebf4c3d9e6e64355204f897|"
+msgid "|5e84b181879b4bcda37b672215325b30|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:340
@@ -43404,3 +43413,45 @@ msgstr ""
 #~ msgid "|dd729f8776d640ffb136545f3f26210f|"
 #~ msgstr ""
 
+#~ msgid "|6102f514742c4211b093aae3a5a74e51|"
+#~ msgstr ""
+
+#~ msgid "|24080db3b13d4b0c8546096de73ac82a|"
+#~ msgstr ""
+
+#~ msgid "|9087a1f0e9ab41c083f5209a3f17e600|"
+#~ msgstr ""
+
+#~ msgid "|a5d1853a0b3c44d4bdd408d15a89e7ac|"
+#~ msgstr ""
+
+#~ msgid "|8e6e9164d7414c39bf37f67e2fda59bd|"
+#~ msgstr ""
+
+#~ msgid "|e8b1d08849514de1b09fee325db970d0|"
+#~ msgstr ""
+
+#~ msgid "|ca0b3cb207164665b5bef1d869c37dff|"
+#~ msgstr ""
+
+#~ msgid "|977cb114b97047329a7bb908afbac2cd|"
+#~ msgstr ""
+
+#~ msgid "|9f497b02d2634af2925a65244cc0eb1b|"
+#~ msgstr ""
+
+#~ msgid "|938ae2cd4fae49ce9292e6e2d9bd880d|"
+#~ msgstr ""
+
+#~ msgid "|47cd7c6cb4094846833faff5b05e0d46|"
+#~ msgstr ""
+
+#~ msgid "|c90d6613b0a34a42bf3023ca5a81c8e2|"
+#~ msgstr ""
+
+#~ msgid "|91c29c3c9b1b411590de3983d94ed76a|"
+#~ msgstr ""
+
+#~ msgid "|e4adf0f92ebf4c3d9e6e64355204f897|"
+#~ msgstr ""
+
diff --git a/framework/docs/locales/ko/LC_MESSAGES/framework-docs.po b/framework/docs/locales/ko/LC_MESSAGES/framework-docs.po
index 79be78a61bbe..a37643eb8c0c 100644
--- a/framework/docs/locales/ko/LC_MESSAGES/framework-docs.po
+++ b/framework/docs/locales/ko/LC_MESSAGES/framework-docs.po
@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Flower main\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-09 00:34+0000\n"
+"POT-Creation-Date: 2024-12-13 00:33+0000\n"
 "PO-Revision-Date: 2024-08-23 13:09+0000\n"
 "Last-Translator: Seulki Yun <icstuckyi@gmail.com>\n"
 "Language: ko\n"
@@ -9048,7 +9048,7 @@ msgstr ""
 msgid "Arguments"
 msgstr "빌드 전달인자"
 
-#: ../../flwr install:1 log:1 ls:1 new:1 run:1 stop:1
+#: ../../flwr install:1 log:1 login:1 ls:1 new:1 run:1 stop:1
 #, fuzzy
 msgid "Optional argument"
 msgstr "선택적 개선 사항"
@@ -9092,6 +9092,20 @@ msgstr ""
 msgid "Name of the federation to run the app on"
 msgstr ""
 
+#: ../../flwr login:1
+#, fuzzy
+msgid "Login to Flower SuperLink."
+msgstr "flower 초연결"
+
+#: ../../flwr login:1 run:1
+#, fuzzy
+msgid "Path of the Flower App to run."
+msgstr "Flower 기본 이미지의 태그."
+
+#: ../../flwr login:1
+msgid "Name of the federation to login into."
+msgstr ""
+
 #: ../../flwr ls:1
 msgid "List runs."
 msgstr ""
@@ -9183,11 +9197,6 @@ msgid ""
 "default."
 msgstr ""
 
-#: ../../flwr run:1
-#, fuzzy
-msgid "Path of the Flower App to run."
-msgstr "Flower 기본 이미지의 태그."
-
 #: ../../flwr run:1
 msgid "Name of the federation to run the app on."
 msgstr ""
@@ -26303,7 +26312,7 @@ msgstr ""
 " 수도 있습니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:41
-msgid "|6102f514742c4211b093aae3a5a74e51|"
+msgid "|ae2337ba61dd4efc818e63933fd81666|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:109
@@ -26320,7 +26329,7 @@ msgstr ""
 " 바둑과 같은 게임을 하는 것일 수 있습니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:53
-msgid "|24080db3b13d4b0c8546096de73ac82a|"
+msgid "|14a8d3feda794591a601daaaaa79d0b6|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:111
@@ -26346,7 +26355,7 @@ msgstr ""
 "부르리는 것을 듣는 스마트 스피커에서 비롯됩니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:67
-msgid "|9087a1f0e9ab41c083f5209a3f17e600|"
+msgid "|c67497f1afa84a30a3901418c6c0bb62|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:113
@@ -26364,7 +26373,7 @@ msgstr ""
 "있습니다. 하지만 여러 조직이 모두 같은 작업을 위해 데이터를 생성하는 것일 수도 있습니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:79
-msgid "|a5d1853a0b3c44d4bdd408d15a89e7ac|"
+msgid "|d4ce55da082146d7ad13ec4f73d427a2|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:115
@@ -26383,7 +26392,7 @@ msgstr ""
 "서버는 데이터 센터 어딘가에 있을 수도 있고 클라우드 어딘가에 있을 수도 있습니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:91
-msgid "|8e6e9164d7414c39bf37f67e2fda59bd|"
+msgid "|0a0c4ca9de6549c1b35225c6e1183bc0|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:117
@@ -26400,7 +26409,7 @@ msgstr ""
 " 우리가 기본적으로 사용해 온 머신러닝 방법입니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:103
-msgid "|e8b1d08849514de1b09fee325db970d0|"
+msgid "|f2f5e8cc5594472c842192ec38ab9bbe|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:119
@@ -26423,7 +26432,7 @@ msgstr ""
 "트래픽을 분석하는 것이 있습니다. 이러한 사례에서 모든 데이터는 자연스럽게 중앙 서버에 존재합니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:138
-msgid "|ca0b3cb207164665b5bef1d869c37dff|"
+msgid "|4e7b0cd854064aab9895573a612a0f06|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:173
@@ -26440,7 +26449,7 @@ msgstr ""
 "좋은 모델을 훈련하기에 충분하지 않을 수 있습니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:150
-msgid "|977cb114b97047329a7bb908afbac2cd|"
+msgid "|e121faa35b114a0da17cf4bc42e74ce9|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:175
@@ -26619,7 +26628,7 @@ msgstr ""
 "체크포인트에서 모델 매개변수를 초기화합니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:210
-msgid "|9f497b02d2634af2925a65244cc0eb1b|"
+msgid "|e7a57a83812c4dc8933fbb93cd0e46dc|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:307
@@ -26647,7 +26656,7 @@ msgstr ""
 "개의 연결 노드만 사용합니다. 그 이유는 점점 더 많은 클라이언트 노드를 선택하면 학습의 효율성이 감소하기 때문입니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:225
-msgid "|938ae2cd4fae49ce9292e6e2d9bd880d|"
+msgid "|a0283fe3cd0c4f3cb5d119f424c657fd|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:309
@@ -26674,7 +26683,7 @@ msgstr ""
 "데이터에서 한 단계 정도로 짧거나 몇 단계(mini-batches)에 불과할 수 있습니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:240
-msgid "|47cd7c6cb4094846833faff5b05e0d46|"
+msgid "|debbe320f2c741388902ebabfb6fc705|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:311
@@ -26700,7 +26709,7 @@ msgstr ""
 "보냅니다. 보내는 모델 업데이트는 전체 모델 파라미터거나 로컬 교육 중에 누적된 그레디언트(gradient)일 수 있습니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:255
-msgid "|c90d6613b0a34a42bf3023ca5a81c8e2|"
+msgid "|8be6ce669d3148f9af6272ca27a98197|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:313
@@ -26750,7 +26759,7 @@ msgstr ""
 "많은 영향을 미칩니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:273
-msgid "|91c29c3c9b1b411590de3983d94ed76a|"
+msgid "|47c4a06eafbb4e2fa1c62b5ca47d3411|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:315
@@ -26870,7 +26879,7 @@ msgstr ""
 "사용자는 모든 워크로드, 머신러닝 프레임워크 및 모든 프로그래밍 언어를 통합할 수 있습니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:334
-msgid "|e4adf0f92ebf4c3d9e6e64355204f897|"
+msgid "|5e84b181879b4bcda37b672215325b30|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:340
@@ -33882,3 +33891,45 @@ msgstr ""
 #~ msgid "|dd729f8776d640ffb136545f3f26210f|"
 #~ msgstr ""
 
+#~ msgid "|6102f514742c4211b093aae3a5a74e51|"
+#~ msgstr ""
+
+#~ msgid "|24080db3b13d4b0c8546096de73ac82a|"
+#~ msgstr ""
+
+#~ msgid "|9087a1f0e9ab41c083f5209a3f17e600|"
+#~ msgstr ""
+
+#~ msgid "|a5d1853a0b3c44d4bdd408d15a89e7ac|"
+#~ msgstr ""
+
+#~ msgid "|8e6e9164d7414c39bf37f67e2fda59bd|"
+#~ msgstr ""
+
+#~ msgid "|e8b1d08849514de1b09fee325db970d0|"
+#~ msgstr ""
+
+#~ msgid "|ca0b3cb207164665b5bef1d869c37dff|"
+#~ msgstr ""
+
+#~ msgid "|977cb114b97047329a7bb908afbac2cd|"
+#~ msgstr ""
+
+#~ msgid "|9f497b02d2634af2925a65244cc0eb1b|"
+#~ msgstr ""
+
+#~ msgid "|938ae2cd4fae49ce9292e6e2d9bd880d|"
+#~ msgstr ""
+
+#~ msgid "|47cd7c6cb4094846833faff5b05e0d46|"
+#~ msgstr ""
+
+#~ msgid "|c90d6613b0a34a42bf3023ca5a81c8e2|"
+#~ msgstr ""
+
+#~ msgid "|91c29c3c9b1b411590de3983d94ed76a|"
+#~ msgstr ""
+
+#~ msgid "|e4adf0f92ebf4c3d9e6e64355204f897|"
+#~ msgstr ""
+
diff --git a/framework/docs/locales/pt_BR/LC_MESSAGES/framework-docs.po b/framework/docs/locales/pt_BR/LC_MESSAGES/framework-docs.po
index b6d01c0e97a4..4104ae260fc0 100644
--- a/framework/docs/locales/pt_BR/LC_MESSAGES/framework-docs.po
+++ b/framework/docs/locales/pt_BR/LC_MESSAGES/framework-docs.po
@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Flower main\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-09 00:34+0000\n"
+"POT-Creation-Date: 2024-12-13 00:33+0000\n"
 "PO-Revision-Date: 2024-05-25 11:09+0000\n"
 "Last-Translator: Gustavo Bertoli <gubertoli@gmail.com>\n"
 "Language: pt_BR\n"
@@ -8110,7 +8110,7 @@ msgstr ""
 msgid "Arguments"
 msgstr "Argumento de compilação"
 
-#: ../../flwr install:1 log:1 ls:1 new:1 run:1 stop:1
+#: ../../flwr install:1 log:1 login:1 ls:1 new:1 run:1 stop:1
 #, fuzzy
 msgid "Optional argument"
 msgstr "Argumento de compilação"
@@ -8152,6 +8152,20 @@ msgstr ""
 msgid "Name of the federation to run the app on"
 msgstr ""
 
+#: ../../flwr login:1
+#, fuzzy
+msgid "Login to Flower SuperLink."
+msgstr "``FLWR_VERSION``"
+
+#: ../../flwr login:1 run:1
+#, fuzzy
+msgid "Path of the Flower App to run."
+msgstr "O nome do repositório da imagem base."
+
+#: ../../flwr login:1
+msgid "Name of the federation to login into."
+msgstr ""
+
 #: ../../flwr ls:1
 msgid "List runs."
 msgstr ""
@@ -8240,11 +8254,6 @@ msgid ""
 "default."
 msgstr ""
 
-#: ../../flwr run:1
-#, fuzzy
-msgid "Path of the Flower App to run."
-msgstr "O nome do repositório da imagem base."
-
 #: ../../flwr run:1
 msgid "Name of the federation to run the app on."
 msgstr ""
@@ -24963,7 +24972,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:41
-msgid "|6102f514742c4211b093aae3a5a74e51|"
+msgid "|ae2337ba61dd4efc818e63933fd81666|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:109
@@ -24978,7 +24987,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:53
-msgid "|24080db3b13d4b0c8546096de73ac82a|"
+msgid "|14a8d3feda794591a601daaaaa79d0b6|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:111
@@ -25000,7 +25009,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:67
-msgid "|9087a1f0e9ab41c083f5209a3f17e600|"
+msgid "|c67497f1afa84a30a3901418c6c0bb62|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:113
@@ -25016,7 +25025,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:79
-msgid "|a5d1853a0b3c44d4bdd408d15a89e7ac|"
+msgid "|d4ce55da082146d7ad13ec4f73d427a2|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:115
@@ -25032,7 +25041,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:91
-msgid "|8e6e9164d7414c39bf37f67e2fda59bd|"
+msgid "|0a0c4ca9de6549c1b35225c6e1183bc0|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:117
@@ -25047,7 +25056,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:103
-msgid "|e8b1d08849514de1b09fee325db970d0|"
+msgid "|f2f5e8cc5594472c842192ec38ab9bbe|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:119
@@ -25067,7 +25076,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:138
-msgid "|ca0b3cb207164665b5bef1d869c37dff|"
+msgid "|4e7b0cd854064aab9895573a612a0f06|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:173
@@ -25082,7 +25091,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:150
-msgid "|977cb114b97047329a7bb908afbac2cd|"
+msgid "|e121faa35b114a0da17cf4bc42e74ce9|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:175
@@ -25222,7 +25231,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:210
-msgid "|9f497b02d2634af2925a65244cc0eb1b|"
+msgid "|e7a57a83812c4dc8933fbb93cd0e46dc|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:307
@@ -25246,7 +25255,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:225
-msgid "|938ae2cd4fae49ce9292e6e2d9bd880d|"
+msgid "|a0283fe3cd0c4f3cb5d119f424c657fd|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:309
@@ -25270,7 +25279,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:240
-msgid "|47cd7c6cb4094846833faff5b05e0d46|"
+msgid "|debbe320f2c741388902ebabfb6fc705|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:311
@@ -25293,7 +25302,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:255
-msgid "|c90d6613b0a34a42bf3023ca5a81c8e2|"
+msgid "|8be6ce669d3148f9af6272ca27a98197|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:313
@@ -25331,7 +25340,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:273
-msgid "|91c29c3c9b1b411590de3983d94ed76a|"
+msgid "|47c4a06eafbb4e2fa1c62b5ca47d3411|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:315
@@ -25425,7 +25434,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:334
-msgid "|e4adf0f92ebf4c3d9e6e64355204f897|"
+msgid "|5e84b181879b4bcda37b672215325b30|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:340
@@ -37893,3 +37902,45 @@ msgstr ""
 #~ msgid "|dd729f8776d640ffb136545f3f26210f|"
 #~ msgstr ""
 
+#~ msgid "|6102f514742c4211b093aae3a5a74e51|"
+#~ msgstr ""
+
+#~ msgid "|24080db3b13d4b0c8546096de73ac82a|"
+#~ msgstr ""
+
+#~ msgid "|9087a1f0e9ab41c083f5209a3f17e600|"
+#~ msgstr ""
+
+#~ msgid "|a5d1853a0b3c44d4bdd408d15a89e7ac|"
+#~ msgstr ""
+
+#~ msgid "|8e6e9164d7414c39bf37f67e2fda59bd|"
+#~ msgstr ""
+
+#~ msgid "|e8b1d08849514de1b09fee325db970d0|"
+#~ msgstr ""
+
+#~ msgid "|ca0b3cb207164665b5bef1d869c37dff|"
+#~ msgstr ""
+
+#~ msgid "|977cb114b97047329a7bb908afbac2cd|"
+#~ msgstr ""
+
+#~ msgid "|9f497b02d2634af2925a65244cc0eb1b|"
+#~ msgstr ""
+
+#~ msgid "|938ae2cd4fae49ce9292e6e2d9bd880d|"
+#~ msgstr ""
+
+#~ msgid "|47cd7c6cb4094846833faff5b05e0d46|"
+#~ msgstr ""
+
+#~ msgid "|c90d6613b0a34a42bf3023ca5a81c8e2|"
+#~ msgstr ""
+
+#~ msgid "|91c29c3c9b1b411590de3983d94ed76a|"
+#~ msgstr ""
+
+#~ msgid "|e4adf0f92ebf4c3d9e6e64355204f897|"
+#~ msgstr ""
+
diff --git a/framework/docs/locales/zh_Hans/LC_MESSAGES/framework-docs.po b/framework/docs/locales/zh_Hans/LC_MESSAGES/framework-docs.po
index 41918a42b1d3..5d5d94fcc8d9 100644
--- a/framework/docs/locales/zh_Hans/LC_MESSAGES/framework-docs.po
+++ b/framework/docs/locales/zh_Hans/LC_MESSAGES/framework-docs.po
@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Flower main\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-09 00:34+0000\n"
+"POT-Creation-Date: 2024-12-13 00:33+0000\n"
 "PO-Revision-Date: 2024-06-12 10:09+0000\n"
 "Last-Translator: Yan Gao <y.gaogy@gmail.com>\n"
 "Language: zh_Hans\n"
@@ -9026,7 +9026,7 @@ msgstr ""
 msgid "Arguments"
 msgstr "构建文档"
 
-#: ../../flwr install:1 log:1 ls:1 new:1 run:1 stop:1
+#: ../../flwr install:1 log:1 login:1 ls:1 new:1 run:1 stop:1
 #, fuzzy
 msgid "Optional argument"
 msgstr "可选的改进措施"
@@ -9070,6 +9070,20 @@ msgstr ""
 msgid "Name of the federation to run the app on"
 msgstr ""
 
+#: ../../flwr login:1
+#, fuzzy
+msgid "Login to Flower SuperLink."
+msgstr "flower-superlink"
+
+#: ../../flwr login:1 run:1
+#, fuzzy
+msgid "Path of the Flower App to run."
+msgstr "基础镜像的存储库名称。"
+
+#: ../../flwr login:1
+msgid "Name of the federation to login into."
+msgstr ""
+
 #: ../../flwr ls:1
 msgid "List runs."
 msgstr ""
@@ -9161,11 +9175,6 @@ msgid ""
 "default."
 msgstr ""
 
-#: ../../flwr run:1
-#, fuzzy
-msgid "Path of the Flower App to run."
-msgstr "基础镜像的存储库名称。"
-
 #: ../../flwr run:1
 msgid "Name of the federation to run the app on."
 msgstr ""
@@ -30122,7 +30131,7 @@ msgid ""
 msgstr "在机器学习中，我们有一个模型和数据。模型可以是一个神经网络（如图所示），也可以是其他东西，比如经典的线性回归。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:41
-msgid "|6102f514742c4211b093aae3a5a74e51|"
+msgid "|ae2337ba61dd4efc818e63933fd81666|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:109
@@ -30137,7 +30146,7 @@ msgid ""
 msgstr "我们使用数据来训练模型，以完成一项有用的任务。任务可以是检测图像中的物体、转录音频或玩围棋等游戏。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:53
-msgid "|24080db3b13d4b0c8546096de73ac82a|"
+msgid "|14a8d3feda794591a601daaaaa79d0b6|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:111
@@ -30161,7 +30170,7 @@ msgid ""
 msgstr "它源于智能手机上用户与应用程序的交互、汽车上传感器数据的收集、笔记本电脑上键盘输入的接收，或者智能扬声器上某人试着唱的歌。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:67
-msgid "|9087a1f0e9ab41c083f5209a3f17e600|"
+msgid "|c67497f1afa84a30a3901418c6c0bb62|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:113
@@ -30179,7 +30188,7 @@ msgstr ""
 "\"通常不只是一个地方，而是很多地方。它可能是多个运行同一应用程序的设备。但也可能是多个组织，都在为同一任务生成数据。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:79
-msgid "|a5d1853a0b3c44d4bdd408d15a89e7ac|"
+msgid "|d4ce55da082146d7ad13ec4f73d427a2|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:115
@@ -30196,7 +30205,7 @@ msgid ""
 msgstr "因此，要使用机器学习或任何类型的数据分析，过去使用的方法是在中央服务器上收集所有数据。这个服务器可以在数据中心的某个地方，也可以在云端的某个地方。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:91
-msgid "|8e6e9164d7414c39bf37f67e2fda59bd|"
+msgid "|0a0c4ca9de6549c1b35225c6e1183bc0|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:117
@@ -30211,7 +30220,7 @@ msgid ""
 msgstr "一旦所有数据都收集到一处，我们最终就可以使用机器学习算法在数据上训练我们的模型。这就是我们基本上一直依赖的机器学习方法。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:103
-msgid "|e8b1d08849514de1b09fee325db970d0|"
+msgid "|f2f5e8cc5594472c842192ec38ab9bbe|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:119
@@ -30232,7 +30241,7 @@ msgid ""
 msgstr "我们刚刚看到的经典机器学习方法可以在某些情况下使用。很好的例子包括对假日照片进行分类或分析网络流量。在这些案例中，所有数据自然都可以在中央服务器上获得。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:138
-msgid "|ca0b3cb207164665b5bef1d869c37dff|"
+msgid "|4e7b0cd854064aab9895573a612a0f06|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:173
@@ -30247,7 +30256,7 @@ msgid ""
 msgstr "但这种方法并不适用于许多其他情况。例如，集中服务器上没有数据，或者一台服务器上的数据不足以训练出一个好的模型。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:150
-msgid "|977cb114b97047329a7bb908afbac2cd|"
+msgid "|e121faa35b114a0da17cf4bc42e74ce9|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:175
@@ -30407,7 +30416,7 @@ msgid ""
 msgstr "我们首先在服务器上初始化模型。这与经典的集中式学习完全相同：我们随机或从先前保存的检查点初始化模型参数。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:210
-msgid "|9f497b02d2634af2925a65244cc0eb1b|"
+msgid "|e7a57a83812c4dc8933fbb93cd0e46dc|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:307
@@ -30432,7 +30441,7 @@ msgid ""
 msgstr "接下来，我们会将全局模型的参数发送到连接的客户端节点（如智能手机等边缘设备或企业的服务器）。这是为了确保每个参与节点都使用相同的模型参数开始本地训练。我们通常只使用几个连接节点，而不是所有节点。这样做的原因是，选择越来越多的客户端节点会导致收益递减。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:225
-msgid "|938ae2cd4fae49ce9292e6e2d9bd880d|"
+msgid "|a0283fe3cd0c4f3cb5d119f424c657fd|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:309
@@ -30458,7 +30467,7 @@ msgstr ""
 "（mini-batches）。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:240
-msgid "|47cd7c6cb4094846833faff5b05e0d46|"
+msgid "|debbe320f2c741388902ebabfb6fc705|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:311
@@ -30481,7 +30490,7 @@ msgid ""
 msgstr "经过本地训练后，每个客户节点最初收到的模型参数都会略有不同。参数之所以不同，是因为每个客户端节点的本地数据集中都有不同的数据。然后，客户端节点将这些模型更新发回服务器。它们发送的模型更新既可以是完整的模型参数，也可以只是本地训练过程中积累的梯度。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:255
-msgid "|c90d6613b0a34a42bf3023ca5a81c8e2|"
+msgid "|8be6ce669d3148f9af6272ca27a98197|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:313
@@ -30528,7 +30537,7 @@ msgstr ""
 " 100 个示例的 10 倍。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:273
-msgid "|91c29c3c9b1b411590de3983d94ed76a|"
+msgid "|47c4a06eafbb4e2fa1c62b5ca47d3411|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:315
@@ -30636,7 +30645,7 @@ msgstr ""
 "为联邦学习、分析和评估提供了一种统一的方法。它允许用户联邦化任何工作负载、任何 ML 框架和任何编程语言。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:334
-msgid "|e4adf0f92ebf4c3d9e6e64355204f897|"
+msgid "|5e84b181879b4bcda37b672215325b30|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:340
@@ -38225,3 +38234,45 @@ msgstr ""
 #~ msgid "|dd729f8776d640ffb136545f3f26210f|"
 #~ msgstr ""
 
+#~ msgid "|6102f514742c4211b093aae3a5a74e51|"
+#~ msgstr ""
+
+#~ msgid "|24080db3b13d4b0c8546096de73ac82a|"
+#~ msgstr ""
+
+#~ msgid "|9087a1f0e9ab41c083f5209a3f17e600|"
+#~ msgstr ""
+
+#~ msgid "|a5d1853a0b3c44d4bdd408d15a89e7ac|"
+#~ msgstr ""
+
+#~ msgid "|8e6e9164d7414c39bf37f67e2fda59bd|"
+#~ msgstr ""
+
+#~ msgid "|e8b1d08849514de1b09fee325db970d0|"
+#~ msgstr ""
+
+#~ msgid "|ca0b3cb207164665b5bef1d869c37dff|"
+#~ msgstr ""
+
+#~ msgid "|977cb114b97047329a7bb908afbac2cd|"
+#~ msgstr ""
+
+#~ msgid "|9f497b02d2634af2925a65244cc0eb1b|"
+#~ msgstr ""
+
+#~ msgid "|938ae2cd4fae49ce9292e6e2d9bd880d|"
+#~ msgstr ""
+
+#~ msgid "|47cd7c6cb4094846833faff5b05e0d46|"
+#~ msgstr ""
+
+#~ msgid "|c90d6613b0a34a42bf3023ca5a81c8e2|"
+#~ msgstr ""
+
+#~ msgid "|91c29c3c9b1b411590de3983d94ed76a|"
+#~ msgstr ""
+
+#~ msgid "|e4adf0f92ebf4c3d9e6e64355204f897|"
+#~ msgstr ""
+

From 331ed9b09326b83f6182dbe1284f1f1fc8e971e8 Mon Sep 17 00:00:00 2001
From: Chong Shen Ng <chong.shen@flower.ai>
Date: Fri, 13 Dec 2024 16:54:15 +0000
Subject: [PATCH 061/104] feat(framework) Add get `TaskIns` from `run_id` to
 `LinkState` (#4682)

Co-authored-by: Javier <jafermarq@users.noreply.github.com>
---
 .../linkstate/in_memory_linkstate.py          | 10 +++++
 .../server/superlink/linkstate/linkstate.py   |  4 ++
 .../superlink/linkstate/linkstate_test.py     | 37 +++++++++++++++++++
 .../superlink/linkstate/sqlite_linkstate.py   | 19 ++++++++++
 4 files changed, 70 insertions(+)

diff --git a/src/py/flwr/server/superlink/linkstate/in_memory_linkstate.py b/src/py/flwr/server/superlink/linkstate/in_memory_linkstate.py
index c2273a36a5db..6d719a7dd377 100644
--- a/src/py/flwr/server/superlink/linkstate/in_memory_linkstate.py
+++ b/src/py/flwr/server/superlink/linkstate/in_memory_linkstate.py
@@ -293,6 +293,16 @@ def delete_tasks(self, task_ids: set[UUID]) -> None:
             for task_id in task_res_to_be_deleted:
                 del self.task_res_store[task_id]
 
+    def get_task_ids_from_run_id(self, run_id: int) -> set[UUID]:
+        """Get all TaskIns IDs for the given run_id."""
+        task_id_list: set[UUID] = set()
+        with self.lock:
+            for task_id, task_ins in self.task_ins_store.items():
+                if task_ins.run_id == run_id:
+                    task_id_list.add(task_id)
+
+        return task_id_list
+
     def _force_delete_tasks_by_ids(self, task_ids: set[UUID]) -> None:
         """Delete tasks based on a set of TaskIns IDs."""
         if not task_ids:
diff --git a/src/py/flwr/server/superlink/linkstate/linkstate.py b/src/py/flwr/server/superlink/linkstate/linkstate.py
index 05fb3c2f0cc6..c5ab7efa8cf2 100644
--- a/src/py/flwr/server/superlink/linkstate/linkstate.py
+++ b/src/py/flwr/server/superlink/linkstate/linkstate.py
@@ -142,6 +142,10 @@ def num_task_res(self) -> int:
     def delete_tasks(self, task_ids: set[UUID]) -> None:
         """Delete all delivered TaskIns/TaskRes pairs."""
 
+    @abc.abstractmethod
+    def get_task_ids_from_run_id(self, run_id: int) -> set[UUID]:
+        """Get all TaskIns IDs for the given run_id."""
+
     @abc.abstractmethod
     def create_node(
         self, ping_interval: float, public_key: Optional[bytes] = None
diff --git a/src/py/flwr/server/superlink/linkstate/linkstate_test.py b/src/py/flwr/server/superlink/linkstate/linkstate_test.py
index 202fdf387277..15b97ee1a0a1 100644
--- a/src/py/flwr/server/superlink/linkstate/linkstate_test.py
+++ b/src/py/flwr/server/superlink/linkstate/linkstate_test.py
@@ -353,6 +353,43 @@ def test_store_and_delete_tasks(self) -> None:
         assert state.num_task_ins() == 2
         assert state.num_task_res() == 1
 
+    def test_get_task_ids_from_run_id(self) -> None:
+        """Test get_task_ids_from_run_id."""
+        # Prepare
+        state = self.state_factory()
+        node_id = state.create_node(1e3)
+        run_id_0 = state.create_run(None, None, "8g13kl7", {}, ConfigsRecord())
+        # Insert tasks with the same run_id
+        task_ins_0 = create_task_ins(
+            consumer_node_id=node_id, anonymous=False, run_id=run_id_0
+        )
+        task_ins_1 = create_task_ins(
+            consumer_node_id=node_id, anonymous=False, run_id=run_id_0
+        )
+        # Insert a task with a different run_id to ensure it does not appear in result
+        run_id_1 = state.create_run(None, None, "9f86d08", {}, ConfigsRecord())
+        task_ins_2 = create_task_ins(
+            consumer_node_id=node_id, anonymous=False, run_id=run_id_1
+        )
+
+        # Insert three TaskIns
+        task_id_0 = state.store_task_ins(task_ins=task_ins_0)
+        task_id_1 = state.store_task_ins(task_ins=task_ins_1)
+        task_id_2 = state.store_task_ins(task_ins=task_ins_2)
+
+        assert task_id_0
+        assert task_id_1
+        assert task_id_2
+
+        expected_task_ids = {task_id_0, task_id_1}
+
+        # Execute
+        result = state.get_task_ids_from_run_id(run_id_0)
+        bad_result = state.get_task_ids_from_run_id(15)
+
+        self.assertEqual(len(bad_result), 0)
+        self.assertSetEqual(result, expected_task_ids)
+
     # Init tests
     def test_init_state(self) -> None:
         """Test that state is initialized correctly."""
diff --git a/src/py/flwr/server/superlink/linkstate/sqlite_linkstate.py b/src/py/flwr/server/superlink/linkstate/sqlite_linkstate.py
index 54df4685bf9a..8e4043582d14 100644
--- a/src/py/flwr/server/superlink/linkstate/sqlite_linkstate.py
+++ b/src/py/flwr/server/superlink/linkstate/sqlite_linkstate.py
@@ -629,6 +629,25 @@ def delete_tasks(self, task_ids: set[UUID]) -> None:
 
         return None
 
+    def get_task_ids_from_run_id(self, run_id: int) -> set[UUID]:
+        """Get all TaskIns IDs for the given run_id."""
+        if self.conn is None:
+            raise AttributeError("LinkState not initialized")
+
+        query = """
+            SELECT task_id
+            FROM task_ins
+            WHERE run_id = :run_id;
+        """
+
+        sint64_run_id = convert_uint64_to_sint64(run_id)
+        data = {"run_id": sint64_run_id}
+
+        with self.conn:
+            rows = self.conn.execute(query, data).fetchall()
+
+        return {UUID(row["task_id"]) for row in rows}
+
     def _force_delete_tasks_by_ids(self, task_ids: set[UUID]) -> None:
         """Delete tasks based on a set of TaskIns IDs."""
         if not task_ids:

From 2619ef01985d90de23b97cdbda507f400ceedbe4 Mon Sep 17 00:00:00 2001
From: Chong Shen Ng <chong.shen@flower.ai>
Date: Fri, 13 Dec 2024 17:06:07 +0000
Subject: [PATCH 062/104] feat(framework) Update fleet connections to include
 `run_id` in `get_fab` (#4693)

---
 src/py/flwr/client/app.py                            | 4 ++--
 src/py/flwr/client/grpc_adapter_client/connection.py | 2 +-
 src/py/flwr/client/grpc_client/connection.py         | 2 +-
 src/py/flwr/client/grpc_rere_client/connection.py    | 6 +++---
 src/py/flwr/client/rest_client/connection.py         | 6 +++---
 5 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/src/py/flwr/client/app.py b/src/py/flwr/client/app.py
index 7046e3f2e4fc..c2f9e3985437 100644
--- a/src/py/flwr/client/app.py
+++ b/src/py/flwr/client/app.py
@@ -474,7 +474,7 @@ def _on_backoff(retry_state: RetryState) -> None:
 
                     run: Run = runs[run_id]
                     if get_fab is not None and run.fab_hash:
-                        fab = get_fab(run.fab_hash)
+                        fab = get_fab(run.fab_hash, run_id)
                         if not isolation:
                             # If `ClientApp` runs in the same process, install the FAB
                             install_from_fab(fab.content, flwr_path, True)
@@ -752,7 +752,7 @@ def _init_connection(transport: Optional[str], server_address: str) -> tuple[
                 Optional[Callable[[], Optional[int]]],
                 Optional[Callable[[], None]],
                 Optional[Callable[[int], Run]],
-                Optional[Callable[[str], Fab]],
+                Optional[Callable[[str, int], Fab]],
             ]
         ],
     ],
diff --git a/src/py/flwr/client/grpc_adapter_client/connection.py b/src/py/flwr/client/grpc_adapter_client/connection.py
index ab823112bbe1..c7e3f0bcacbe 100644
--- a/src/py/flwr/client/grpc_adapter_client/connection.py
+++ b/src/py/flwr/client/grpc_adapter_client/connection.py
@@ -48,7 +48,7 @@ def grpc_adapter(  # pylint: disable=R0913,too-many-positional-arguments
         Optional[Callable[[], Optional[int]]],
         Optional[Callable[[], None]],
         Optional[Callable[[int], Run]],
-        Optional[Callable[[str], Fab]],
+        Optional[Callable[[str, int], Fab]],
     ]
 ]:
     """Primitives for request/response-based interaction with a server via GrpcAdapter.
diff --git a/src/py/flwr/client/grpc_client/connection.py b/src/py/flwr/client/grpc_client/connection.py
index 75d2ebe15025..2c855a65ce12 100644
--- a/src/py/flwr/client/grpc_client/connection.py
+++ b/src/py/flwr/client/grpc_client/connection.py
@@ -76,7 +76,7 @@ def grpc_connection(  # pylint: disable=R0913,R0915,too-many-positional-argument
         Optional[Callable[[], Optional[int]]],
         Optional[Callable[[], None]],
         Optional[Callable[[int], Run]],
-        Optional[Callable[[str], Fab]],
+        Optional[Callable[[str, int], Fab]],
     ]
 ]:
     """Establish a gRPC connection to a gRPC server.
diff --git a/src/py/flwr/client/grpc_rere_client/connection.py b/src/py/flwr/client/grpc_rere_client/connection.py
index 6d6d24d54ea3..ed5745512186 100644
--- a/src/py/flwr/client/grpc_rere_client/connection.py
+++ b/src/py/flwr/client/grpc_rere_client/connection.py
@@ -84,7 +84,7 @@ def grpc_request_response(  # pylint: disable=R0913,R0914,R0915,R0917
         Optional[Callable[[], Optional[int]]],
         Optional[Callable[[], None]],
         Optional[Callable[[int], Run]],
-        Optional[Callable[[str], Fab]],
+        Optional[Callable[[str, int], Fab]],
     ]
 ]:
     """Primitives for request/response-based interaction with a server.
@@ -290,9 +290,9 @@ def get_run(run_id: int) -> Run:
         # Return fab_id and fab_version
         return run_from_proto(get_run_response.run)
 
-    def get_fab(fab_hash: str) -> Fab:
+    def get_fab(fab_hash: str, run_id: int) -> Fab:
         # Call FleetAPI
-        get_fab_request = GetFabRequest(node=node, hash_str=fab_hash)
+        get_fab_request = GetFabRequest(node=node, hash_str=fab_hash, run_id=run_id)
         get_fab_response: GetFabResponse = retry_invoker.invoke(
             stub.GetFab,
             request=get_fab_request,
diff --git a/src/py/flwr/client/rest_client/connection.py b/src/py/flwr/client/rest_client/connection.py
index 7f6c247d8907..6fda7ae2dda0 100644
--- a/src/py/flwr/client/rest_client/connection.py
+++ b/src/py/flwr/client/rest_client/connection.py
@@ -96,7 +96,7 @@ def http_request_response(  # pylint: disable=R0913,R0914,R0915,R0917
         Optional[Callable[[], Optional[int]]],
         Optional[Callable[[], None]],
         Optional[Callable[[int], Run]],
-        Optional[Callable[[str], Fab]],
+        Optional[Callable[[str, int], Fab]],
     ]
 ]:
     """Primitives for request/response-based interaction with a server.
@@ -361,9 +361,9 @@ def get_run(run_id: int) -> Run:
 
         return run_from_proto(res.run)
 
-    def get_fab(fab_hash: str) -> Fab:
+    def get_fab(fab_hash: str, run_id: int) -> Fab:
         # Construct the request
-        req = GetFabRequest(node=node, hash_str=fab_hash)
+        req = GetFabRequest(node=node, hash_str=fab_hash, run_id=run_id)
 
         # Send the request
         res = _request(req, GetFabResponse, PATH_GET_FAB)

From 22c1ca3340cb24713425dde95a2fbc26875ecced Mon Sep 17 00:00:00 2001
From: Chong Shen Ng <chong.shen@flower.ai>
Date: Fri, 13 Dec 2024 17:47:43 +0000
Subject: [PATCH 063/104] feat(framework) Delete `TaskIns`/`TaskRes` from
 `LinkState` for stopped runs (#4684)

---
 src/py/flwr/superexec/exec_servicer.py | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/src/py/flwr/superexec/exec_servicer.py b/src/py/flwr/superexec/exec_servicer.py
index 8ffe2702c386..c89f9ee47840 100644
--- a/src/py/flwr/superexec/exec_servicer.py
+++ b/src/py/flwr/superexec/exec_servicer.py
@@ -19,6 +19,7 @@
 from collections.abc import Generator
 from logging import ERROR, INFO
 from typing import Any, Optional
+from uuid import UUID
 
 import grpc
 
@@ -160,6 +161,13 @@ def StopRun(
             run_id=request.run_id,
             new_status=RunStatus(Status.FINISHED, SubStatus.STOPPED, ""),
         )
+
+        if update_success:
+            task_ids: set[UUID] = state.get_task_ids_from_run_id(request.run_id)
+
+            # Delete TaskIns and TaskRes for the `run_id`
+            state.delete_tasks(task_ids)
+
         return StopRunResponse(success=update_success)
 
     def GetLoginDetails(

From 5c27a00cb755f351d0a8cd7fa2e7e3aab15a150d Mon Sep 17 00:00:00 2001
From: Heng Pan <pan@flower.ai>
Date: Sat, 14 Dec 2024 02:43:22 +0800
Subject: [PATCH 064/104] refactor(framework) Make `LinkState.delete_tasks`
 method delete all provided tasks without conditions (#4691)

Co-authored-by: Chong Shen Ng <chong.shen@flower.ai>
---
 src/py/flwr/server/driver/inmemory_driver.py  |  6 +-
 .../superlink/driver/serverappio_servicer.py  | 24 ++-----
 .../linkstate/in_memory_linkstate.py          | 50 ++++-----------
 .../server/superlink/linkstate/linkstate.py   | 11 +++-
 .../superlink/linkstate/linkstate_test.py     | 14 +++-
 .../superlink/linkstate/sqlite_linkstate.py   | 64 ++++---------------
 6 files changed, 57 insertions(+), 112 deletions(-)

diff --git a/src/py/flwr/server/driver/inmemory_driver.py b/src/py/flwr/server/driver/inmemory_driver.py
index d9189002e5ad..bd534565049a 100644
--- a/src/py/flwr/server/driver/inmemory_driver.py
+++ b/src/py/flwr/server/driver/inmemory_driver.py
@@ -142,7 +142,11 @@ def pull_messages(self, message_ids: Iterable[str]) -> Iterable[Message]:
         # Pull TaskRes
         task_res_list = self.state.get_task_res(task_ids=msg_ids)
         # Delete tasks in state
-        self.state.delete_tasks(msg_ids)
+        # Delete the TaskIns/TaskRes pairs if TaskRes is found
+        task_ins_ids_to_delete = {
+            UUID(task_res.task.ancestry[0]) for task_res in task_res_list
+        }
+        self.state.delete_tasks(task_ins_ids=task_ins_ids_to_delete)
         # Convert TaskRes to Message
         msgs = [message_from_taskres(taskres) for taskres in task_res_list]
         return msgs
diff --git a/src/py/flwr/server/superlink/driver/serverappio_servicer.py b/src/py/flwr/server/superlink/driver/serverappio_servicer.py
index a3d06ac222de..f52129a2ba11 100644
--- a/src/py/flwr/server/superlink/driver/serverappio_servicer.py
+++ b/src/py/flwr/server/superlink/driver/serverappio_servicer.py
@@ -190,27 +190,15 @@ def PullTaskRes(
         # Convert each task_id str to UUID
         task_ids: set[UUID] = {UUID(task_id) for task_id in request.task_ids}
 
-        # Register callback
-        def on_rpc_done() -> None:
-            log(
-                DEBUG,
-                "ServerAppIoServicer.PullTaskRes callback: delete TaskIns/TaskRes",
-            )
-
-            if context.is_active():
-                return
-            if context.code() != grpc.StatusCode.OK:
-                return
-
-            # Delete delivered TaskIns and TaskRes
-            state.delete_tasks(task_ids=task_ids)
-
-        context.add_callback(on_rpc_done)
-
         # Read from state
         task_res_list: list[TaskRes] = state.get_task_res(task_ids=task_ids)
 
-        context.set_code(grpc.StatusCode.OK)
+        # Delete the TaskIns/TaskRes pairs if TaskRes is found
+        task_ins_ids_to_delete = {
+            UUID(task_res.task.ancestry[0]) for task_res in task_res_list
+        }
+        state.delete_tasks(task_ins_ids=task_ins_ids_to_delete)
+
         return PullTaskResResponse(task_res_list=task_res_list)
 
     def GetRun(
diff --git a/src/py/flwr/server/superlink/linkstate/in_memory_linkstate.py b/src/py/flwr/server/superlink/linkstate/in_memory_linkstate.py
index 6d719a7dd377..f26bb11a4bdb 100644
--- a/src/py/flwr/server/superlink/linkstate/in_memory_linkstate.py
+++ b/src/py/flwr/server/superlink/linkstate/in_memory_linkstate.py
@@ -265,33 +265,22 @@ def get_task_res(self, task_ids: set[UUID]) -> list[TaskRes]:
             for task_res in task_res_found:
                 task_res.task.delivered_at = delivered_at
 
-            # Cleanup
-            self._force_delete_tasks_by_ids(set(ret.keys()))
-
         return list(ret.values())
 
-    def delete_tasks(self, task_ids: set[UUID]) -> None:
-        """Delete all delivered TaskIns/TaskRes pairs."""
-        task_ins_to_be_deleted: set[UUID] = set()
-        task_res_to_be_deleted: set[UUID] = set()
+    def delete_tasks(self, task_ins_ids: set[UUID]) -> None:
+        """Delete TaskIns/TaskRes pairs based on provided TaskIns IDs."""
+        if not task_ins_ids:
+            return
 
         with self.lock:
-            for task_ins_id in task_ids:
-                # Find the task_id of the matching task_res
-                for task_res_id, task_res in self.task_res_store.items():
-                    if UUID(task_res.task.ancestry[0]) != task_ins_id:
-                        continue
-                    if task_res.task.delivered_at == "":
-                        continue
-
-                    task_ins_to_be_deleted.add(task_ins_id)
-                    task_res_to_be_deleted.add(task_res_id)
-
-            for task_id in task_ins_to_be_deleted:
-                del self.task_ins_store[task_id]
-                del self.task_ins_id_to_task_res_id[task_id]
-            for task_id in task_res_to_be_deleted:
-                del self.task_res_store[task_id]
+            for task_id in task_ins_ids:
+                # Delete TaskIns
+                if task_id in self.task_ins_store:
+                    del self.task_ins_store[task_id]
+                # Delete TaskRes
+                if task_id in self.task_ins_id_to_task_res_id:
+                    task_res_id = self.task_ins_id_to_task_res_id.pop(task_id)
+                    del self.task_res_store[task_res_id]
 
     def get_task_ids_from_run_id(self, run_id: int) -> set[UUID]:
         """Get all TaskIns IDs for the given run_id."""
@@ -303,21 +292,6 @@ def get_task_ids_from_run_id(self, run_id: int) -> set[UUID]:
 
         return task_id_list
 
-    def _force_delete_tasks_by_ids(self, task_ids: set[UUID]) -> None:
-        """Delete tasks based on a set of TaskIns IDs."""
-        if not task_ids:
-            return
-
-        with self.lock:
-            for task_id in task_ids:
-                # Delete TaskIns
-                if task_id in self.task_ins_store:
-                    del self.task_ins_store[task_id]
-                # Delete TaskRes
-                if task_id in self.task_ins_id_to_task_res_id:
-                    task_res_id = self.task_ins_id_to_task_res_id.pop(task_id)
-                    del self.task_res_store[task_res_id]
-
     def num_task_ins(self) -> int:
         """Calculate the number of task_ins in store.
 
diff --git a/src/py/flwr/server/superlink/linkstate/linkstate.py b/src/py/flwr/server/superlink/linkstate/linkstate.py
index c5ab7efa8cf2..ae9d1710f069 100644
--- a/src/py/flwr/server/superlink/linkstate/linkstate.py
+++ b/src/py/flwr/server/superlink/linkstate/linkstate.py
@@ -139,8 +139,15 @@ def num_task_res(self) -> int:
         """
 
     @abc.abstractmethod
-    def delete_tasks(self, task_ids: set[UUID]) -> None:
-        """Delete all delivered TaskIns/TaskRes pairs."""
+    def delete_tasks(self, task_ins_ids: set[UUID]) -> None:
+        """Delete TaskIns/TaskRes pairs based on provided TaskIns IDs.
+
+        Parameters
+        ----------
+        task_ins_ids : set[UUID]
+            A set of TaskIns IDs. For each ID in the set, the corresponding
+            TaskIns and its associated TaskRes will be deleted.
+        """
 
     @abc.abstractmethod
     def get_task_ids_from_run_id(self, run_id: int) -> set[UUID]:
diff --git a/src/py/flwr/server/superlink/linkstate/linkstate_test.py b/src/py/flwr/server/superlink/linkstate/linkstate_test.py
index 15b97ee1a0a1..93f5d94daef7 100644
--- a/src/py/flwr/server/superlink/linkstate/linkstate_test.py
+++ b/src/py/flwr/server/superlink/linkstate/linkstate_test.py
@@ -349,10 +349,21 @@ def test_store_and_delete_tasks(self) -> None:
         # Situation now:
         # - State has three TaskIns, all of them delivered
         # - State has two TaskRes, one of the delivered, the other not
+        assert state.num_task_ins() == 3
+        assert state.num_task_res() == 2
 
+        state.delete_tasks({task_id_0})
         assert state.num_task_ins() == 2
         assert state.num_task_res() == 1
 
+        state.delete_tasks({task_id_1})
+        assert state.num_task_ins() == 1
+        assert state.num_task_res() == 0
+
+        state.delete_tasks({task_id_2})
+        assert state.num_task_ins() == 0
+        assert state.num_task_res() == 0
+
     def test_get_task_ids_from_run_id(self) -> None:
         """Test get_task_ids_from_run_id."""
         # Prepare
@@ -993,7 +1004,8 @@ def test_get_task_res_expired_task_ins(self) -> None:
             # Assert
             assert len(task_res_list) == 1
             assert task_res_list[0].task.HasField("error")
-            assert state.num_task_ins() == state.num_task_res() == 0
+            assert state.num_task_ins() == 1
+            assert state.num_task_res() == 0
 
     def test_get_task_res_returns_empty_for_missing_taskins(self) -> None:
         """Test that get_task_res returns an empty result when the corresponding TaskIns
diff --git a/src/py/flwr/server/superlink/linkstate/sqlite_linkstate.py b/src/py/flwr/server/superlink/linkstate/sqlite_linkstate.py
index 8e4043582d14..bdb3bcf6c4db 100644
--- a/src/py/flwr/server/superlink/linkstate/sqlite_linkstate.py
+++ b/src/py/flwr/server/superlink/linkstate/sqlite_linkstate.py
@@ -566,9 +566,6 @@ def get_task_res(self, task_ids: set[UUID]) -> list[TaskRes]:
         data: list[Any] = [delivered_at] + task_res_ids
         self.query(query, data)
 
-        # Cleanup
-        self._force_delete_tasks_by_ids(set(ret.keys()))
-
         return list(ret.values())
 
     def num_task_ins(self) -> int:
@@ -592,43 +589,32 @@ def num_task_res(self) -> int:
         result: dict[str, int] = rows[0]
         return result["num"]
 
-    def delete_tasks(self, task_ids: set[UUID]) -> None:
-        """Delete all delivered TaskIns/TaskRes pairs."""
-        ids = list(task_ids)
-        if len(ids) == 0:
-            return None
+    def delete_tasks(self, task_ins_ids: set[UUID]) -> None:
+        """Delete TaskIns/TaskRes pairs based on provided TaskIns IDs."""
+        if not task_ins_ids:
+            return
+        if self.conn is None:
+            raise AttributeError("LinkState not initialized")
 
-        placeholders = ",".join([f":id_{index}" for index in range(len(task_ids))])
-        data = {f"id_{index}": str(task_id) for index, task_id in enumerate(task_ids)}
+        placeholders = ",".join(["?"] * len(task_ins_ids))
+        data = tuple(str(task_id) for task_id in task_ins_ids)
 
-        # 1. Query: Delete task_ins which have a delivered task_res
+        # Delete task_ins
         query_1 = f"""
             DELETE FROM task_ins
-            WHERE delivered_at != ''
-            AND task_id IN (
-                SELECT ancestry
-                FROM task_res
-                WHERE ancestry IN ({placeholders})
-                AND delivered_at != ''
-            );
+            WHERE task_id IN ({placeholders});
         """
 
-        # 2. Query: Delete delivered task_res to be run after 1. Query
+        # Delete task_res
         query_2 = f"""
             DELETE FROM task_res
-            WHERE ancestry IN ({placeholders})
-            AND delivered_at != '';
+            WHERE ancestry IN ({placeholders});
         """
 
-        if self.conn is None:
-            raise AttributeError("LinkState not intitialized")
-
         with self.conn:
             self.conn.execute(query_1, data)
             self.conn.execute(query_2, data)
 
-        return None
-
     def get_task_ids_from_run_id(self, run_id: int) -> set[UUID]:
         """Get all TaskIns IDs for the given run_id."""
         if self.conn is None:
@@ -648,32 +634,6 @@ def get_task_ids_from_run_id(self, run_id: int) -> set[UUID]:
 
         return {UUID(row["task_id"]) for row in rows}
 
-    def _force_delete_tasks_by_ids(self, task_ids: set[UUID]) -> None:
-        """Delete tasks based on a set of TaskIns IDs."""
-        if not task_ids:
-            return
-        if self.conn is None:
-            raise AttributeError("LinkState not initialized")
-
-        placeholders = ",".join([f":id_{index}" for index in range(len(task_ids))])
-        data = {f"id_{index}": str(task_id) for index, task_id in enumerate(task_ids)}
-
-        # Delete task_ins
-        query_1 = f"""
-            DELETE FROM task_ins
-            WHERE task_id IN ({placeholders});
-        """
-
-        # Delete task_res
-        query_2 = f"""
-            DELETE FROM task_res
-            WHERE ancestry IN ({placeholders});
-        """
-
-        with self.conn:
-            self.conn.execute(query_1, data)
-            self.conn.execute(query_2, data)
-
     def create_node(
         self, ping_interval: float, public_key: Optional[bytes] = None
     ) -> int:

From d7ebf97c6bb3dbce9dda46a25de8bbe194ed11f7 Mon Sep 17 00:00:00 2001
From: Heng Pan <pan@flower.ai>
Date: Sat, 14 Dec 2024 03:01:51 +0800
Subject: [PATCH 065/104] refactor(framework) Ensure two empty lines before the
 first import line (#4705)

---
 src/py/flwr/cli/app.py                                           | 1 +
 src/py/flwr/cli/build.py                                         | 1 +
 src/py/flwr/cli/config_utils.py                                  | 1 +
 src/py/flwr/cli/config_utils_test.py                             | 1 +
 src/py/flwr/cli/example.py                                       | 1 +
 src/py/flwr/cli/install.py                                       | 1 +
 src/py/flwr/cli/log.py                                           | 1 +
 src/py/flwr/cli/login/__init__.py                                | 1 +
 src/py/flwr/cli/login/login.py                                   | 1 +
 src/py/flwr/cli/new/__init__.py                                  | 1 +
 src/py/flwr/cli/new/new.py                                       | 1 +
 src/py/flwr/cli/new/new_test.py                                  | 1 +
 src/py/flwr/cli/run/__init__.py                                  | 1 +
 src/py/flwr/cli/run/run.py                                       | 1 +
 src/py/flwr/cli/utils.py                                         | 1 +
 src/py/flwr/client/app.py                                        | 1 +
 src/py/flwr/client/client.py                                     | 1 +
 src/py/flwr/client/clientapp/app.py                              | 1 +
 src/py/flwr/client/clientapp/clientappio_servicer_test.py        | 1 +
 src/py/flwr/client/clientapp/utils.py                            | 1 +
 src/py/flwr/client/message_handler/message_handler.py            | 1 +
 src/py/flwr/client/mod/comms_mods.py                             | 1 +
 src/py/flwr/client/mod/secure_aggregation/secaggplus_mod_test.py | 1 +
 src/py/flwr/client/nodestate/__init__.py                         | 1 +
 src/py/flwr/client/nodestate/nodestate.py                        | 1 +
 src/py/flwr/client/nodestate/nodestate_factory.py                | 1 +
 src/py/flwr/client/nodestate/nodestate_test.py                   | 1 +
 src/py/flwr/client/supernode/app.py                              | 1 +
 src/py/flwr/common/address.py                                    | 1 +
 src/py/flwr/common/args.py                                       | 1 +
 src/py/flwr/common/config.py                                     | 1 +
 src/py/flwr/common/config_test.py                                | 1 +
 src/py/flwr/common/logger.py                                     | 1 +
 src/py/flwr/common/message.py                                    | 1 +
 src/py/flwr/common/message_test.py                               | 1 +
 src/py/flwr/common/object_ref_test.py                            | 1 +
 src/py/flwr/common/pyproject.py                                  | 1 +
 src/py/flwr/common/pyproject_test.py                             | 1 +
 src/py/flwr/common/record/__init__.py                            | 1 +
 src/py/flwr/common/record/parametersrecord.py                    | 1 +
 src/py/flwr/common/record/parametersrecord_test.py               | 1 +
 src/py/flwr/common/record/recordset_test.py                      | 1 +
 src/py/flwr/common/recordset_compat_test.py                      | 1 +
 src/py/flwr/common/serde_test.py                                 | 1 +
 src/py/flwr/common/version.py                                    | 1 +
 src/py/flwr/server/app.py                                        | 1 +
 src/py/flwr/server/driver/grpc_driver.py                         | 1 +
 src/py/flwr/server/serverapp/app.py                              | 1 +
 src/py/flwr/server/strategy/dpfedavg_fixed.py                    | 1 +
 src/py/flwr/server/superlink/driver/serverappio_grpc.py          | 1 +
 src/py/flwr/server/superlink/ffs/disk_ffs.py                     | 1 +
 src/py/flwr/server/superlink/ffs/ffs_factory_test.py             | 1 +
 .../server/superlink/fleet/grpc_bidi/flower_service_servicer.py  | 1 +
 src/py/flwr/server/superlink/fleet/vce/__init__.py               | 1 +
 src/py/flwr/server/superlink/fleet/vce/backend/__init__.py       | 1 +
 src/py/flwr/server/superlink/fleet/vce/backend/raybackend.py     | 1 +
 .../flwr/server/superlink/fleet/vce/backend/raybackend_test.py   | 1 +
 src/py/flwr/server/superlink/linkstate/sqlite_linkstate.py       | 1 +
 src/py/flwr/server/superlink/linkstate/utils_test.py             | 1 +
 src/py/flwr/server/superlink/simulation/simulationio_servicer.py | 1 +
 src/py/flwr/simulation/app.py                                    | 1 +
 src/py/flwr/simulation/ray_transport/ray_actor.py                | 1 +
 src/py/flwr/simulation/ray_transport/utils.py                    | 1 +
 src/py/flwr/simulation/run_simulation.py                         | 1 +
 src/py/flwr/superexec/app.py                                     | 1 +
 src/py/flwr/superexec/deployment.py                              | 1 +
 src/py/flwr/superexec/exec_grpc.py                               | 1 +
 src/py/flwr/superexec/executor.py                                | 1 +
 68 files changed, 68 insertions(+)

diff --git a/src/py/flwr/cli/app.py b/src/py/flwr/cli/app.py
index f85772e79c5c..753fc82c0bbe 100644
--- a/src/py/flwr/cli/app.py
+++ b/src/py/flwr/cli/app.py
@@ -14,6 +14,7 @@
 # ==============================================================================
 """Flower command line interface."""
 
+
 import typer
 from typer.main import get_command
 
diff --git a/src/py/flwr/cli/build.py b/src/py/flwr/cli/build.py
index e86f4bb762b3..ac4aa4f7b673 100644
--- a/src/py/flwr/cli/build.py
+++ b/src/py/flwr/cli/build.py
@@ -14,6 +14,7 @@
 # ==============================================================================
 """Flower command line interface `build` command."""
 
+
 import hashlib
 import os
 import shutil
diff --git a/src/py/flwr/cli/config_utils.py b/src/py/flwr/cli/config_utils.py
index 4a081985efc2..ae649a44d062 100644
--- a/src/py/flwr/cli/config_utils.py
+++ b/src/py/flwr/cli/config_utils.py
@@ -14,6 +14,7 @@
 # ==============================================================================
 """Utility to validate the `pyproject.toml` file."""
 
+
 import zipfile
 from io import BytesIO
 from pathlib import Path
diff --git a/src/py/flwr/cli/config_utils_test.py b/src/py/flwr/cli/config_utils_test.py
index f58c1fd75082..c14a792f09b5 100644
--- a/src/py/flwr/cli/config_utils_test.py
+++ b/src/py/flwr/cli/config_utils_test.py
@@ -14,6 +14,7 @@
 # ==============================================================================
 """Test for Flower command line interface `run` command."""
 
+
 import os
 import textwrap
 from pathlib import Path
diff --git a/src/py/flwr/cli/example.py b/src/py/flwr/cli/example.py
index 4790e72d48bf..1ef236f2e0bc 100644
--- a/src/py/flwr/cli/example.py
+++ b/src/py/flwr/cli/example.py
@@ -14,6 +14,7 @@
 # ==============================================================================
 """Flower command line interface `example` command."""
 
+
 import json
 import os
 import subprocess
diff --git a/src/py/flwr/cli/install.py b/src/py/flwr/cli/install.py
index c2dd7b1585fd..df1f9ee1a478 100644
--- a/src/py/flwr/cli/install.py
+++ b/src/py/flwr/cli/install.py
@@ -14,6 +14,7 @@
 # ==============================================================================
 """Flower command line interface `install` command."""
 
+
 import hashlib
 import shutil
 import tempfile
diff --git a/src/py/flwr/cli/log.py b/src/py/flwr/cli/log.py
index f0ee02b05cc1..d30001dc7aaa 100644
--- a/src/py/flwr/cli/log.py
+++ b/src/py/flwr/cli/log.py
@@ -14,6 +14,7 @@
 # ==============================================================================
 """Flower command line interface `log` command."""
 
+
 import time
 from logging import DEBUG, ERROR, INFO
 from pathlib import Path
diff --git a/src/py/flwr/cli/login/__init__.py b/src/py/flwr/cli/login/__init__.py
index 2755b5f6d5de..aa77f1d4aa96 100644
--- a/src/py/flwr/cli/login/__init__.py
+++ b/src/py/flwr/cli/login/__init__.py
@@ -14,6 +14,7 @@
 # ==============================================================================
 """Flower command line interface `login` command."""
 
+
 from .login import login as login
 
 __all__ = [
diff --git a/src/py/flwr/cli/login/login.py b/src/py/flwr/cli/login/login.py
index 83d4d2723e32..5a2a39fff6e9 100644
--- a/src/py/flwr/cli/login/login.py
+++ b/src/py/flwr/cli/login/login.py
@@ -14,6 +14,7 @@
 # ==============================================================================
 """Flower command line interface `login` command."""
 
+
 from pathlib import Path
 from typing import Annotated, Optional
 
diff --git a/src/py/flwr/cli/new/__init__.py b/src/py/flwr/cli/new/__init__.py
index a973f47021c3..d05df667b3e6 100644
--- a/src/py/flwr/cli/new/__init__.py
+++ b/src/py/flwr/cli/new/__init__.py
@@ -14,6 +14,7 @@
 # ==============================================================================
 """Flower command line interface `new` command."""
 
+
 from .new import new as new
 
 __all__ = [
diff --git a/src/py/flwr/cli/new/new.py b/src/py/flwr/cli/new/new.py
index 70b50a681b04..a9d98e2b748c 100644
--- a/src/py/flwr/cli/new/new.py
+++ b/src/py/flwr/cli/new/new.py
@@ -14,6 +14,7 @@
 # ==============================================================================
 """Flower command line interface `new` command."""
 
+
 import re
 from enum import Enum
 from pathlib import Path
diff --git a/src/py/flwr/cli/new/new_test.py b/src/py/flwr/cli/new/new_test.py
index 8ebfb115e1f8..0ed646a50fac 100644
--- a/src/py/flwr/cli/new/new_test.py
+++ b/src/py/flwr/cli/new/new_test.py
@@ -14,6 +14,7 @@
 # ==============================================================================
 """Test for Flower command line interface `new` command."""
 
+
 import os
 from pathlib import Path
 
diff --git a/src/py/flwr/cli/run/__init__.py b/src/py/flwr/cli/run/__init__.py
index 43523c215d3e..4ff5e2f55042 100644
--- a/src/py/flwr/cli/run/__init__.py
+++ b/src/py/flwr/cli/run/__init__.py
@@ -14,6 +14,7 @@
 # ==============================================================================
 """Flower command line interface `run` command."""
 
+
 from .run import run as run
 
 __all__ = [
diff --git a/src/py/flwr/cli/run/run.py b/src/py/flwr/cli/run/run.py
index aae7e88747c8..eec0eec1f830 100644
--- a/src/py/flwr/cli/run/run.py
+++ b/src/py/flwr/cli/run/run.py
@@ -14,6 +14,7 @@
 # ==============================================================================
 """Flower command line interface `run` command."""
 
+
 import io
 import json
 import subprocess
diff --git a/src/py/flwr/cli/utils.py b/src/py/flwr/cli/utils.py
index aaaf8246c399..e3766cd6d20b 100644
--- a/src/py/flwr/cli/utils.py
+++ b/src/py/flwr/cli/utils.py
@@ -14,6 +14,7 @@
 # ==============================================================================
 """Flower command line interface utils."""
 
+
 import hashlib
 import json
 import re
diff --git a/src/py/flwr/client/app.py b/src/py/flwr/client/app.py
index c2f9e3985437..e245e5d96576 100644
--- a/src/py/flwr/client/app.py
+++ b/src/py/flwr/client/app.py
@@ -14,6 +14,7 @@
 # ==============================================================================
 """Flower client app."""
 
+
 import signal
 import subprocess
 import sys
diff --git a/src/py/flwr/client/client.py b/src/py/flwr/client/client.py
index dab9b6a26588..c7a7f01b38ba 100644
--- a/src/py/flwr/client/client.py
+++ b/src/py/flwr/client/client.py
@@ -14,6 +14,7 @@
 # ==============================================================================
 """Flower client (abstract base class)."""
 
+
 # Needed to `Client` class can return a type of `Client` (not needed in py3.11+)
 from __future__ import annotations
 
diff --git a/src/py/flwr/client/clientapp/app.py b/src/py/flwr/client/clientapp/app.py
index 66cc4d8277ee..e2588670de0a 100644
--- a/src/py/flwr/client/clientapp/app.py
+++ b/src/py/flwr/client/clientapp/app.py
@@ -14,6 +14,7 @@
 # ==============================================================================
 """Flower ClientApp process."""
 
+
 import argparse
 import sys
 import time
diff --git a/src/py/flwr/client/clientapp/clientappio_servicer_test.py b/src/py/flwr/client/clientapp/clientappio_servicer_test.py
index b32bd2133d74..f2f7693358e0 100644
--- a/src/py/flwr/client/clientapp/clientappio_servicer_test.py
+++ b/src/py/flwr/client/clientapp/clientappio_servicer_test.py
@@ -14,6 +14,7 @@
 # ==============================================================================
 """Test the ClientAppIo API servicer."""
 
+
 import unittest
 from unittest.mock import Mock, patch
 
diff --git a/src/py/flwr/client/clientapp/utils.py b/src/py/flwr/client/clientapp/utils.py
index f7261c015b14..5c9f80fdc7fb 100644
--- a/src/py/flwr/client/clientapp/utils.py
+++ b/src/py/flwr/client/clientapp/utils.py
@@ -14,6 +14,7 @@
 # ==============================================================================
 """Flower ClientApp loading utils."""
 
+
 from logging import DEBUG
 from pathlib import Path
 from typing import Callable, Optional
diff --git a/src/py/flwr/client/message_handler/message_handler.py b/src/py/flwr/client/message_handler/message_handler.py
index 765c6a6b2e91..cf4a4b006858 100644
--- a/src/py/flwr/client/message_handler/message_handler.py
+++ b/src/py/flwr/client/message_handler/message_handler.py
@@ -14,6 +14,7 @@
 # ==============================================================================
 """Client-side message handler."""
 
+
 from logging import WARN
 from typing import Optional, cast
 
diff --git a/src/py/flwr/client/mod/comms_mods.py b/src/py/flwr/client/mod/comms_mods.py
index 058fd6a70001..5e36d8883a15 100644
--- a/src/py/flwr/client/mod/comms_mods.py
+++ b/src/py/flwr/client/mod/comms_mods.py
@@ -14,6 +14,7 @@
 # ==============================================================================
 """Mods that report statistics about message communication."""
 
+
 from logging import INFO
 
 import numpy as np
diff --git a/src/py/flwr/client/mod/secure_aggregation/secaggplus_mod_test.py b/src/py/flwr/client/mod/secure_aggregation/secaggplus_mod_test.py
index 89729bca1b9c..c12beaa77800 100644
--- a/src/py/flwr/client/mod/secure_aggregation/secaggplus_mod_test.py
+++ b/src/py/flwr/client/mod/secure_aggregation/secaggplus_mod_test.py
@@ -14,6 +14,7 @@
 # ==============================================================================
 """The SecAgg+ protocol modifier tests."""
 
+
 import unittest
 from itertools import product
 from typing import Callable
diff --git a/src/py/flwr/client/nodestate/__init__.py b/src/py/flwr/client/nodestate/__init__.py
index a207e1d81948..ac59bed3749d 100644
--- a/src/py/flwr/client/nodestate/__init__.py
+++ b/src/py/flwr/client/nodestate/__init__.py
@@ -14,6 +14,7 @@
 # ==============================================================================
 """Flower NodeState."""
 
+
 from .in_memory_nodestate import InMemoryNodeState as InMemoryNodeState
 from .nodestate import NodeState as NodeState
 from .nodestate_factory import NodeStateFactory as NodeStateFactory
diff --git a/src/py/flwr/client/nodestate/nodestate.py b/src/py/flwr/client/nodestate/nodestate.py
index 6ae30f49fcc1..154390cc5ce7 100644
--- a/src/py/flwr/client/nodestate/nodestate.py
+++ b/src/py/flwr/client/nodestate/nodestate.py
@@ -14,6 +14,7 @@
 # ==============================================================================
 """Abstract base class NodeState."""
 
+
 import abc
 from typing import Optional
 
diff --git a/src/py/flwr/client/nodestate/nodestate_factory.py b/src/py/flwr/client/nodestate/nodestate_factory.py
index 3d52f0272bd4..970611b59c8b 100644
--- a/src/py/flwr/client/nodestate/nodestate_factory.py
+++ b/src/py/flwr/client/nodestate/nodestate_factory.py
@@ -14,6 +14,7 @@
 # ==============================================================================
 """Factory class that creates NodeState instances."""
 
+
 import threading
 from typing import Optional
 
diff --git a/src/py/flwr/client/nodestate/nodestate_test.py b/src/py/flwr/client/nodestate/nodestate_test.py
index f7088b1f8ac6..0920f2484e60 100644
--- a/src/py/flwr/client/nodestate/nodestate_test.py
+++ b/src/py/flwr/client/nodestate/nodestate_test.py
@@ -14,6 +14,7 @@
 # ==============================================================================
 """Tests all NodeState implementations have to conform to."""
 
+
 import unittest
 from abc import abstractmethod
 
diff --git a/src/py/flwr/client/supernode/app.py b/src/py/flwr/client/supernode/app.py
index e5b9f22ab122..0aad227695b9 100644
--- a/src/py/flwr/client/supernode/app.py
+++ b/src/py/flwr/client/supernode/app.py
@@ -14,6 +14,7 @@
 # ==============================================================================
 """Flower SuperNode."""
 
+
 import argparse
 import sys
 from logging import DEBUG, ERROR, INFO, WARN
diff --git a/src/py/flwr/common/address.py b/src/py/flwr/common/address.py
index 2b10097ccb71..3d10ab78638c 100644
--- a/src/py/flwr/common/address.py
+++ b/src/py/flwr/common/address.py
@@ -14,6 +14,7 @@
 # ==============================================================================
 """Flower IP address utils."""
 
+
 import socket
 from ipaddress import ip_address
 from typing import Optional
diff --git a/src/py/flwr/common/args.py b/src/py/flwr/common/args.py
index 3c27f3840632..241aed935a2d 100644
--- a/src/py/flwr/common/args.py
+++ b/src/py/flwr/common/args.py
@@ -14,6 +14,7 @@
 # ==============================================================================
 """Common Flower arguments."""
 
+
 import argparse
 import sys
 from logging import DEBUG, ERROR, WARN
diff --git a/src/py/flwr/common/config.py b/src/py/flwr/common/config.py
index 0433d82d3ed1..f65da35ca562 100644
--- a/src/py/flwr/common/config.py
+++ b/src/py/flwr/common/config.py
@@ -14,6 +14,7 @@
 # ==============================================================================
 """Provide functions for managing global Flower config."""
 
+
 import os
 import re
 from pathlib import Path
diff --git a/src/py/flwr/common/config_test.py b/src/py/flwr/common/config_test.py
index b2edd319e382..d7440333e964 100644
--- a/src/py/flwr/common/config_test.py
+++ b/src/py/flwr/common/config_test.py
@@ -14,6 +14,7 @@
 # ==============================================================================
 """Test util functions handling Flower config."""
 
+
 import os
 import tempfile
 import textwrap
diff --git a/src/py/flwr/common/logger.py b/src/py/flwr/common/logger.py
index 62d5fa92b02a..00395cacf2b8 100644
--- a/src/py/flwr/common/logger.py
+++ b/src/py/flwr/common/logger.py
@@ -14,6 +14,7 @@
 # ==============================================================================
 """Flower Logger."""
 
+
 import logging
 import re
 import sys
diff --git a/src/py/flwr/common/message.py b/src/py/flwr/common/message.py
index 3bb07ff3961a..ea1cf33ae615 100644
--- a/src/py/flwr/common/message.py
+++ b/src/py/flwr/common/message.py
@@ -14,6 +14,7 @@
 # ==============================================================================
 """Message."""
 
+
 from __future__ import annotations
 
 import time
diff --git a/src/py/flwr/common/message_test.py b/src/py/flwr/common/message_test.py
index d418f9fa8036..54e431b0d663 100644
--- a/src/py/flwr/common/message_test.py
+++ b/src/py/flwr/common/message_test.py
@@ -14,6 +14,7 @@
 # ==============================================================================
 """Message tests."""
 
+
 import time
 from collections import namedtuple
 from contextlib import ExitStack
diff --git a/src/py/flwr/common/object_ref_test.py b/src/py/flwr/common/object_ref_test.py
index f4513a4319ab..bb1f473b5191 100644
--- a/src/py/flwr/common/object_ref_test.py
+++ b/src/py/flwr/common/object_ref_test.py
@@ -14,6 +14,7 @@
 # ==============================================================================
 """Tests for the validation function of object refs."""
 
+
 from .object_ref import OBJECT_REF_HELP_STR, validate
 
 
diff --git a/src/py/flwr/common/pyproject.py b/src/py/flwr/common/pyproject.py
index 66585e422397..b6b5bf86980c 100644
--- a/src/py/flwr/common/pyproject.py
+++ b/src/py/flwr/common/pyproject.py
@@ -14,6 +14,7 @@
 # ==============================================================================
 """Validates the project's name property."""
 
+
 import re
 
 
diff --git a/src/py/flwr/common/pyproject_test.py b/src/py/flwr/common/pyproject_test.py
index 88a945054b83..665e3b9ff679 100644
--- a/src/py/flwr/common/pyproject_test.py
+++ b/src/py/flwr/common/pyproject_test.py
@@ -14,6 +14,7 @@
 # ==============================================================================
 """Tests for the function that validates name property."""
 
+
 from .pyproject import validate_project_name
 
 
diff --git a/src/py/flwr/common/record/__init__.py b/src/py/flwr/common/record/__init__.py
index 88eef5f7aea1..9c3aa1e5abe7 100644
--- a/src/py/flwr/common/record/__init__.py
+++ b/src/py/flwr/common/record/__init__.py
@@ -14,6 +14,7 @@
 # ==============================================================================
 """Record APIs."""
 
+
 from .configsrecord import ConfigsRecord
 from .conversion_utils import array_from_numpy
 from .metricsrecord import MetricsRecord
diff --git a/src/py/flwr/common/record/parametersrecord.py b/src/py/flwr/common/record/parametersrecord.py
index 10ec65ca0277..c0fc7fd44cf9 100644
--- a/src/py/flwr/common/record/parametersrecord.py
+++ b/src/py/flwr/common/record/parametersrecord.py
@@ -14,6 +14,7 @@
 # ==============================================================================
 """ParametersRecord and Array."""
 
+
 from collections import OrderedDict
 from dataclasses import dataclass
 from io import BytesIO
diff --git a/src/py/flwr/common/record/parametersrecord_test.py b/src/py/flwr/common/record/parametersrecord_test.py
index 9ac18a3ec854..9644fc0541d1 100644
--- a/src/py/flwr/common/record/parametersrecord_test.py
+++ b/src/py/flwr/common/record/parametersrecord_test.py
@@ -14,6 +14,7 @@
 # ==============================================================================
 """Unit tests for ParametersRecord and Array."""
 
+
 import unittest
 from collections import OrderedDict
 from io import BytesIO
diff --git a/src/py/flwr/common/record/recordset_test.py b/src/py/flwr/common/record/recordset_test.py
index 154e320e5f0b..09f227b92ba6 100644
--- a/src/py/flwr/common/record/recordset_test.py
+++ b/src/py/flwr/common/record/recordset_test.py
@@ -14,6 +14,7 @@
 # ==============================================================================
 """RecordSet tests."""
 
+
 import pickle
 from collections import OrderedDict, namedtuple
 from copy import deepcopy
diff --git a/src/py/flwr/common/recordset_compat_test.py b/src/py/flwr/common/recordset_compat_test.py
index 05d821e37e40..c08ab5a2d89d 100644
--- a/src/py/flwr/common/recordset_compat_test.py
+++ b/src/py/flwr/common/recordset_compat_test.py
@@ -14,6 +14,7 @@
 # ==============================================================================
 """RecordSet from legacy messages tests."""
 
+
 from copy import deepcopy
 from typing import Callable
 
diff --git a/src/py/flwr/common/serde_test.py b/src/py/flwr/common/serde_test.py
index f6e2789ef9c0..0357b92731f7 100644
--- a/src/py/flwr/common/serde_test.py
+++ b/src/py/flwr/common/serde_test.py
@@ -14,6 +14,7 @@
 # ==============================================================================
 """(De-)serialization tests."""
 
+
 import random
 import string
 from collections import OrderedDict
diff --git a/src/py/flwr/common/version.py b/src/py/flwr/common/version.py
index 141c16ac9367..e77c9daae816 100644
--- a/src/py/flwr/common/version.py
+++ b/src/py/flwr/common/version.py
@@ -14,6 +14,7 @@
 # ==============================================================================
 """Flower package version helper."""
 
+
 import importlib.metadata as importlib_metadata
 
 
diff --git a/src/py/flwr/server/app.py b/src/py/flwr/server/app.py
index 8b5cb316c7fc..7746a1cf5286 100644
--- a/src/py/flwr/server/app.py
+++ b/src/py/flwr/server/app.py
@@ -14,6 +14,7 @@
 # ==============================================================================
 """Flower server app."""
 
+
 import argparse
 import csv
 import importlib.util
diff --git a/src/py/flwr/server/driver/grpc_driver.py b/src/py/flwr/server/driver/grpc_driver.py
index f844aee57191..b8310bcd590d 100644
--- a/src/py/flwr/server/driver/grpc_driver.py
+++ b/src/py/flwr/server/driver/grpc_driver.py
@@ -14,6 +14,7 @@
 # ==============================================================================
 """Flower gRPC Driver."""
 
+
 import time
 import warnings
 from collections.abc import Iterable
diff --git a/src/py/flwr/server/serverapp/app.py b/src/py/flwr/server/serverapp/app.py
index 80577496e5a3..8fbfec00272d 100644
--- a/src/py/flwr/server/serverapp/app.py
+++ b/src/py/flwr/server/serverapp/app.py
@@ -14,6 +14,7 @@
 # ==============================================================================
 """Flower ServerApp process."""
 
+
 import argparse
 import sys
 from logging import DEBUG, ERROR, INFO
diff --git a/src/py/flwr/server/strategy/dpfedavg_fixed.py b/src/py/flwr/server/strategy/dpfedavg_fixed.py
index 60f8c16f8e6d..00d74eb31ebe 100644
--- a/src/py/flwr/server/strategy/dpfedavg_fixed.py
+++ b/src/py/flwr/server/strategy/dpfedavg_fixed.py
@@ -17,6 +17,7 @@
 Paper: arxiv.org/pdf/1710.06963.pdf
 """
 
+
 from typing import Optional, Union
 
 from flwr.common import EvaluateIns, EvaluateRes, FitIns, FitRes, Parameters, Scalar
diff --git a/src/py/flwr/server/superlink/driver/serverappio_grpc.py b/src/py/flwr/server/superlink/driver/serverappio_grpc.py
index 2dcb8dee4c9b..2d9f57bc3876 100644
--- a/src/py/flwr/server/superlink/driver/serverappio_grpc.py
+++ b/src/py/flwr/server/superlink/driver/serverappio_grpc.py
@@ -14,6 +14,7 @@
 # ==============================================================================
 """ServerAppIo gRPC API."""
 
+
 from logging import INFO
 from typing import Optional
 
diff --git a/src/py/flwr/server/superlink/ffs/disk_ffs.py b/src/py/flwr/server/superlink/ffs/disk_ffs.py
index 4f1ab05be9a2..3bacfeda3663 100644
--- a/src/py/flwr/server/superlink/ffs/disk_ffs.py
+++ b/src/py/flwr/server/superlink/ffs/disk_ffs.py
@@ -14,6 +14,7 @@
 # ==============================================================================
 """Disk based Flower File Storage."""
 
+
 import hashlib
 import json
 from pathlib import Path
diff --git a/src/py/flwr/server/superlink/ffs/ffs_factory_test.py b/src/py/flwr/server/superlink/ffs/ffs_factory_test.py
index 81fcb6454147..40928b8599cb 100644
--- a/src/py/flwr/server/superlink/ffs/ffs_factory_test.py
+++ b/src/py/flwr/server/superlink/ffs/ffs_factory_test.py
@@ -14,6 +14,7 @@
 # ==============================================================================
 """Test Ffs factory."""
 
+
 from .disk_ffs import DiskFfs
 from .ffs_factory import FfsFactory
 
diff --git a/src/py/flwr/server/superlink/fleet/grpc_bidi/flower_service_servicer.py b/src/py/flwr/server/superlink/fleet/grpc_bidi/flower_service_servicer.py
index 38f0dfdae299..b84b6cb573ac 100644
--- a/src/py/flwr/server/superlink/fleet/grpc_bidi/flower_service_servicer.py
+++ b/src/py/flwr/server/superlink/fleet/grpc_bidi/flower_service_servicer.py
@@ -18,6 +18,7 @@
 - https://github.com/grpc/grpc/blob/master/doc/statuscodes.md
 """
 
+
 import uuid
 from collections.abc import Iterator
 from typing import Callable
diff --git a/src/py/flwr/server/superlink/fleet/vce/__init__.py b/src/py/flwr/server/superlink/fleet/vce/__init__.py
index 57d39688b527..38ecd5e958df 100644
--- a/src/py/flwr/server/superlink/fleet/vce/__init__.py
+++ b/src/py/flwr/server/superlink/fleet/vce/__init__.py
@@ -14,6 +14,7 @@
 # ==============================================================================
 """Fleet Simulation Engine side."""
 
+
 from .vce_api import start_vce
 
 __all__ = [
diff --git a/src/py/flwr/server/superlink/fleet/vce/backend/__init__.py b/src/py/flwr/server/superlink/fleet/vce/backend/__init__.py
index 31129fce1b1b..c4d73bbb9add 100644
--- a/src/py/flwr/server/superlink/fleet/vce/backend/__init__.py
+++ b/src/py/flwr/server/superlink/fleet/vce/backend/__init__.py
@@ -14,6 +14,7 @@
 # ==============================================================================
 """Simulation Engine Backends."""
 
+
 import importlib
 
 from .backend import Backend, BackendConfig
diff --git a/src/py/flwr/server/superlink/fleet/vce/backend/raybackend.py b/src/py/flwr/server/superlink/fleet/vce/backend/raybackend.py
index dd79d2ef7f62..092077eb0309 100644
--- a/src/py/flwr/server/superlink/fleet/vce/backend/raybackend.py
+++ b/src/py/flwr/server/superlink/fleet/vce/backend/raybackend.py
@@ -14,6 +14,7 @@
 # ==============================================================================
 """Ray backend for the Fleet API using the Simulation Engine."""
 
+
 import sys
 from logging import DEBUG, ERROR
 from typing import Callable, Optional, Union
diff --git a/src/py/flwr/server/superlink/fleet/vce/backend/raybackend_test.py b/src/py/flwr/server/superlink/fleet/vce/backend/raybackend_test.py
index 753f450e835c..ec54ddf3b7dd 100644
--- a/src/py/flwr/server/superlink/fleet/vce/backend/raybackend_test.py
+++ b/src/py/flwr/server/superlink/fleet/vce/backend/raybackend_test.py
@@ -14,6 +14,7 @@
 # ==============================================================================
 """Test for Ray backend for the Fleet API using the Simulation Engine."""
 
+
 from math import pi
 from typing import Callable, Optional, Union
 from unittest import TestCase
diff --git a/src/py/flwr/server/superlink/linkstate/sqlite_linkstate.py b/src/py/flwr/server/superlink/linkstate/sqlite_linkstate.py
index bdb3bcf6c4db..6e4f2290ab62 100644
--- a/src/py/flwr/server/superlink/linkstate/sqlite_linkstate.py
+++ b/src/py/flwr/server/superlink/linkstate/sqlite_linkstate.py
@@ -14,6 +14,7 @@
 # ==============================================================================
 """SQLite based implemenation of the link state."""
 
+
 # pylint: disable=too-many-lines
 
 import json
diff --git a/src/py/flwr/server/superlink/linkstate/utils_test.py b/src/py/flwr/server/superlink/linkstate/utils_test.py
index d55e2ffd9aa3..803c5075a11b 100644
--- a/src/py/flwr/server/superlink/linkstate/utils_test.py
+++ b/src/py/flwr/server/superlink/linkstate/utils_test.py
@@ -14,6 +14,7 @@
 # ==============================================================================
 """Utils tests."""
 
+
 import unittest
 
 from parameterized import parameterized
diff --git a/src/py/flwr/server/superlink/simulation/simulationio_servicer.py b/src/py/flwr/server/superlink/simulation/simulationio_servicer.py
index cf3fee545d0a..9104d9cde875 100644
--- a/src/py/flwr/server/superlink/simulation/simulationio_servicer.py
+++ b/src/py/flwr/server/superlink/simulation/simulationio_servicer.py
@@ -14,6 +14,7 @@
 # ==============================================================================
 """SimulationIo API servicer."""
 
+
 import threading
 from logging import DEBUG, INFO
 
diff --git a/src/py/flwr/simulation/app.py b/src/py/flwr/simulation/app.py
index cecf24081458..ebcb275b6052 100644
--- a/src/py/flwr/simulation/app.py
+++ b/src/py/flwr/simulation/app.py
@@ -14,6 +14,7 @@
 # ==============================================================================
 """Flower Simulation process."""
 
+
 import argparse
 import sys
 from logging import DEBUG, ERROR, INFO
diff --git a/src/py/flwr/simulation/ray_transport/ray_actor.py b/src/py/flwr/simulation/ray_transport/ray_actor.py
index 4fb48a99b689..c12763300493 100644
--- a/src/py/flwr/simulation/ray_transport/ray_actor.py
+++ b/src/py/flwr/simulation/ray_transport/ray_actor.py
@@ -14,6 +14,7 @@
 # ==============================================================================
 """Ray-based Flower Actor and ActorPool implementation."""
 
+
 import threading
 from abc import ABC
 from logging import DEBUG, ERROR, WARNING
diff --git a/src/py/flwr/simulation/ray_transport/utils.py b/src/py/flwr/simulation/ray_transport/utils.py
index 3861164998a4..d11f74fc6937 100644
--- a/src/py/flwr/simulation/ray_transport/utils.py
+++ b/src/py/flwr/simulation/ray_transport/utils.py
@@ -14,6 +14,7 @@
 # ==============================================================================
 """Utilities for Actors in the Virtual Client Engine."""
 
+
 import traceback
 import warnings
 from logging import ERROR
diff --git a/src/py/flwr/simulation/run_simulation.py b/src/py/flwr/simulation/run_simulation.py
index c70f4b59a534..c59f4e22b219 100644
--- a/src/py/flwr/simulation/run_simulation.py
+++ b/src/py/flwr/simulation/run_simulation.py
@@ -14,6 +14,7 @@
 # ==============================================================================
 """Flower Simulation."""
 
+
 import argparse
 import asyncio
 import json
diff --git a/src/py/flwr/superexec/app.py b/src/py/flwr/superexec/app.py
index b9ef88e3c05d..688fc6ac0dec 100644
--- a/src/py/flwr/superexec/app.py
+++ b/src/py/flwr/superexec/app.py
@@ -14,6 +14,7 @@
 # ==============================================================================
 """Flower SuperExec app."""
 
+
 import argparse
 import sys
 from logging import INFO
diff --git a/src/py/flwr/superexec/deployment.py b/src/py/flwr/superexec/deployment.py
index 13c1034abc35..7941d0206b72 100644
--- a/src/py/flwr/superexec/deployment.py
+++ b/src/py/flwr/superexec/deployment.py
@@ -14,6 +14,7 @@
 # ==============================================================================
 """Deployment engine executor."""
 
+
 import hashlib
 from logging import ERROR, INFO
 from pathlib import Path
diff --git a/src/py/flwr/superexec/exec_grpc.py b/src/py/flwr/superexec/exec_grpc.py
index c6099f909dac..5e3b5ae9442a 100644
--- a/src/py/flwr/superexec/exec_grpc.py
+++ b/src/py/flwr/superexec/exec_grpc.py
@@ -14,6 +14,7 @@
 # ==============================================================================
 """SuperExec gRPC API."""
 
+
 from collections.abc import Sequence
 from logging import INFO
 from typing import Optional
diff --git a/src/py/flwr/superexec/executor.py b/src/py/flwr/superexec/executor.py
index a4c73a7b19fe..c5e55460ff48 100644
--- a/src/py/flwr/superexec/executor.py
+++ b/src/py/flwr/superexec/executor.py
@@ -14,6 +14,7 @@
 # ==============================================================================
 """Execute and monitor a Flower run."""
 
+
 from abc import ABC, abstractmethod
 from dataclasses import dataclass, field
 from subprocess import Popen

From 76809afe426527705d5a64495e526dd0308bf5ba Mon Sep 17 00:00:00 2001
From: Dimitris Stripelis <11239849+dstripelis@users.noreply.github.com>
Date: Fri, 13 Dec 2024 21:27:31 +0200
Subject: [PATCH 066/104] refactor(baselines) Update FedRep baseline (#4681)

Co-authored-by: jafermarq <javier@flower.ai>
---
 baselines/fedrep/README.md                    |  85 +++--
 baselines/fedrep/_static/cifar100_100_20.png  | Bin 51608 -> 51125 bytes
 baselines/fedrep/_static/cifar100_100_5.png   | Bin 54293 -> 50075 bytes
 baselines/fedrep/_static/cifar10_100_2.png    | Bin 57701 -> 54765 bytes
 baselines/fedrep/_static/cifar10_100_5.png    | Bin 58541 -> 54133 bytes
 baselines/fedrep/conf/cifar100_20.toml        |  11 +
 baselines/fedrep/conf/cifar100_5.toml         |  11 +
 baselines/fedrep/conf/cifar10_2.toml          |   8 +
 baselines/fedrep/conf/cifar10_5.toml          |   8 +
 baselines/fedrep/docs/make_plots.py           |  50 +++
 baselines/fedrep/fedrep/__init__.py           |   2 +-
 baselines/fedrep/fedrep/base_model.py         | 162 ++++-----
 baselines/fedrep/fedrep/client.py             | 319 ------------------
 baselines/fedrep/fedrep/client_app.py         | 186 ++++++++++
 baselines/fedrep/fedrep/conf/base.yaml        |  46 ---
 .../fedrep/fedrep/conf/cifar100_100_20.yaml   |  44 ---
 .../fedrep/fedrep/conf/cifar100_100_5.yaml    |  44 ---
 .../fedrep/fedrep/conf/cifar10_100_2.yaml     |  44 ---
 .../fedrep/fedrep/conf/cifar10_100_5.yaml     |  44 ---
 baselines/fedrep/fedrep/constants.py          |  21 +-
 baselines/fedrep/fedrep/dataset.py            | 108 +++++-
 .../fedrep/fedrep/dataset_preparation.py      |   1 -
 baselines/fedrep/fedrep/main.py               | 123 -------
 baselines/fedrep/fedrep/models.py             |  33 +-
 baselines/fedrep/fedrep/server.py             |   1 -
 baselines/fedrep/fedrep/server_app.py         |  80 +++++
 baselines/fedrep/fedrep/strategy.py           |   2 +-
 baselines/fedrep/fedrep/utils.py              | 241 ++++---------
 baselines/fedrep/pyproject.toml               | 154 +++++----
 29 files changed, 756 insertions(+), 1072 deletions(-)
 create mode 100644 baselines/fedrep/conf/cifar100_20.toml
 create mode 100644 baselines/fedrep/conf/cifar100_5.toml
 create mode 100644 baselines/fedrep/conf/cifar10_2.toml
 create mode 100644 baselines/fedrep/conf/cifar10_5.toml
 create mode 100644 baselines/fedrep/docs/make_plots.py
 delete mode 100644 baselines/fedrep/fedrep/client.py
 create mode 100644 baselines/fedrep/fedrep/client_app.py
 delete mode 100644 baselines/fedrep/fedrep/conf/base.yaml
 delete mode 100644 baselines/fedrep/fedrep/conf/cifar100_100_20.yaml
 delete mode 100644 baselines/fedrep/fedrep/conf/cifar100_100_5.yaml
 delete mode 100644 baselines/fedrep/fedrep/conf/cifar10_100_2.yaml
 delete mode 100644 baselines/fedrep/fedrep/conf/cifar10_100_5.yaml
 delete mode 100644 baselines/fedrep/fedrep/dataset_preparation.py
 delete mode 100644 baselines/fedrep/fedrep/main.py
 delete mode 100644 baselines/fedrep/fedrep/server.py
 create mode 100644 baselines/fedrep/fedrep/server_app.py

diff --git a/baselines/fedrep/README.md b/baselines/fedrep/README.md
index ece30edf0943..d67730e4065a 100644
--- a/baselines/fedrep/README.md
+++ b/baselines/fedrep/README.md
@@ -36,91 +36,90 @@ dataset: [CIFAR-10, CIFAR-100]
 
 These two models are modified from the [official repo](https://github.com/rahulv0205/fedrep_experiments)'s. To be clear that, in the official models, there is no BN layers. However, without BN layer helping, training will definitely collapse.
 
-Please see how models are implemented using a so called model_manager and model_split class since FedRep uses head and base layers in a neural network. These classes are defined in the `models.py` file and thereafter called when building new models in the directory `/implemented_models`. Please, extend and add new models as you wish. 
+Please see how models are implemented using a so called model_manager and model_split class since FedRep uses head and base layers in a neural network. These classes are defined in the `models.py` file. Please, extend and add new models as you wish. 
 
 **Dataset:** CIFAR10, CIFAR-100. CIFAR10/100 will be partitioned based on number of classes for data that each client shall receive e.g. 4 allocated classes could be [1, 3, 5, 9].
 
-**Training Hyperparameters:** The hyperparameters can be found in `conf/base.yaml` file which is the configuration file for the main script. 
-
-| Description           | Default Value                       |
-| --------------------- | ----------------------------------- |
-| `num_clients`         | `100`                               |
-| `num_rounds`          | `100`                               |
-| `num_local_epochs`    | `5`                                 |
-| `num_rep_epochs`      | `1`                                 |
-| `enable_finetune`     | `False`                             |
-| `num_finetune_epochs` | `5`                                 |
-| `use_cuda`            | `true`                              |
-| `specified_device`    | `null`                              |
-| `client resources`    | `{'num_cpus': 2, 'num_gpus': 0.5 }` |
-| `learning_rate`       | `0.01`                              |
-| `batch_size`          | `50`                                |
-| `model_name`          | `cnncifar10`                        |
-| `algorithm`           | `fedrep`                            |
+**Training Hyperparameters:** The hyperparameters can be found in `pyproject.toml` file under the `[tool.flwr.app.config]` section.
+
+| Description             | Default Value                       |
+|-------------------------|-------------------------------------|
+| `num-server-rounds`     | `100`                               |
+| `num-local-epochs`      | `5`                                 |
+| `num-rep-epochs`        | `1`                                 |
+| `enable-finetune`       | `False`                             |
+| `num-finetune-epochs`   | `5`                                 |
+| `use-cuda`              | `true`                              |
+| `specified-cuda-device` | `null`                              |
+| `client-resources`      | `{'num-cpus': 2, 'num-gpus': 0.5 }` |
+| `learning-rate`         | `0.01`                              |
+| `batch-size`            | `50`                                |
+| `model-name`            | `cnncifar10`                        |
+| `algorithm`             | `fedrep`                            |
 
 
 ## Environment Setup
 
-To construct the Python environment follow these steps:
+Create a new Python environment using [pyenv](https://github.com/pyenv/pyenv) and [virtualenv plugin](https://github.com/pyenv/pyenv-virtualenv), then install the baseline project:
 
 ```bash
-# Set Python 3.10
-pyenv local 3.10.12
-# Tell poetry to use python 3.10
-poetry env use 3.10.12
+# Create the environment
+pyenv virtualenv 3.10.12 fedrep-env
 
-# Install the base Poetry environment
-poetry install
+# Activate it
+pyenv activate fedrep-env
 
-# Activate the environment
-poetry shell
+# Then install the project
+pip install -e .
 ```
 
 ## Running the Experiments
 
 ```
-python -m fedrep.main # this will run using the default settings in the `conf/base.yaml` 
+flwr run . # this will run using the default settings in the `pyproject.toml` 
 ```
 
-While the config files contain a large number of settings, the ones below are the main ones you'd likely want to modify to .
+While the config files contain a large number of settings, the ones below are the main ones you'd likely want to modify.
 ```bash
-algorithm: fedavg, fedrep # these are currently supported
-dataset.name: cifar10, cifar100
-dataset.num_classes: 2, 5, 20 (only for CIFAR-100)
-model_name: cnncifar10, cnncifar100
+algorithm = "fedavg", "fedrep" # these are currently supported
+dataset-name = "cifar10", "cifar100"
+dataset-split-num-classes = 2, 5, 20 (only for CIFAR-100)
+model-name = "cnncifar10", "cnncifar100"
 ```
-
+See also for instance the configuration files for CIFAR10 and CIFAR100 under the `conf` directory. 
 
 ## Expected Results
+The default algorithm used by all configuration files is `fedrep`. To use `fedavg` please change the `algorithm` property in the respective configuration file. The default federated environment consists of 100 clients.
+
+When the execution completes, a new directory `results` will be created with a json file that contains the running configurations and the results per round. 
+
+> [!NOTE]
+> All plots shown below are generated using the `docs/make_plots.py` script. The script reads all json files generated by the baseline inside the `results` directory.
 
 ### CIFAR-10 (100, 2)
 
 ```
-python -m fedrep.main --config-name cifar10_100_2 algorithm=fedrep 
-python -m fedrep.main --config-name cifar10_100_2 algorithm=fedavg 
+flwr run . --run-config conf/cifar10_2.toml
 ```
 <img src="_static/cifar10_100_2.png" width="400"/> 
 
 ### CIFAR-10 (100, 5)
 
 ```
-python -m fedrep.main --config-name cifar10_100_5 algorithm=fedrep 
-python -m fedrep.main --config-name cifar10_100_5 algorithm=fedavg 
+flwr run . --run-config conf/cifar10_5.toml 
 ```
 <img src="_static/cifar10_100_5.png" width="400"/> 
 
 ### CIFAR-100 (100, 5)
 
 ```
-python -m fedrep.main --config-name cifar100_100_5 algorithm=fedrep 
-python -m fedrep.main --config-name cifar100_100_5 algorithm=fedavg 
+flwr run . --run-config conf/cifar100_5.toml
 ```
 <img src="_static/cifar100_100_5.png" width="400"/> 
 
 ### CIFAR-100 (100, 20)
 
 ```
-python -m fedrep.main --config-name cifar100_100_20 algorithm=fedrep 
-python -m fedrep.main --config-name cifar100_100_20 algorithm=fedavg 
+flwr run . --run-config conf/cifar100_20.toml 
 ```
-<img src="_static/cifar100_100_20.png" width="400"/> 
\ No newline at end of file
+<img src="_static/cifar100_100_20.png" width="400"/> 
diff --git a/baselines/fedrep/_static/cifar100_100_20.png b/baselines/fedrep/_static/cifar100_100_20.png
index 2421f15ac6c6a1c3105821d4d958ee79b1ac676a..3f97d08a4dff0220e11e5fa012cfabcc72aeadf9 100644
GIT binary patch
literal 51125
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

literal 51608
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
Kl)fmK1^!>=*UG8@

diff --git a/baselines/fedrep/_static/cifar100_100_5.png b/baselines/fedrep/_static/cifar100_100_5.png
index 17f25eb480c44f9f47ee851acded09262db25355..f22ddcedaf61be55c05bf6e57051efbbf02e94b8 100644
GIT binary patch
literal 50075
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
VZcG{)(<BIdDaonJmP?zw`d?aH%`5-_

literal 54293
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
Kx>V9M@V@~RAy1J2

diff --git a/baselines/fedrep/_static/cifar10_100_2.png b/baselines/fedrep/_static/cifar10_100_2.png
index 75ee48b2c9707cace4505758247bde1dca52fa91..1e7321f85e01d2786b2bc1807875657eefa5805c 100644
GIT binary patch
literal 54765
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%0DMA#)2YUO`4j3oBRzp&t=ZZC<#5x
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
Dpb5ZH

literal 57701
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
IbnS2d6V2DFng9R*

diff --git a/baselines/fedrep/_static/cifar10_100_5.png b/baselines/fedrep/_static/cifar10_100_5.png
index 1d20a953f9c4b49baf7d5ca6d2790554d1cf7ab4..54a9143d8fd9e728d59894b0c39e9aedd71109fd 100644
GIT binary patch
literal 54133
zcmeEuWmHsQ_wN~U0O^!2L8L{x8xbifX#oKN>CT}9X$1wPQ9uNwyM`7;Lg@}EVMyt^
z&-lLgf4|<f?$^7PEN21doG13P_b>M0rM9LjAwDfW1VM!N)s%E02m=8@umv~{_>S=K
z%y00YxTms_=OY(ePoF35PoalTJYAh!Je{6dF?&CC_ju;wEW{_ycbA9R-qX|7LxP|G
z`TzU^pNqR4KZ_>jB)AEltJ-4^2qJ!h{(^myEqn$+KbP(+$?N%MY-ReS>8(um><B&g
zsXaEI$VdH@48s?RiMA5ppy8ouOH(Kj6y(tPz(E#2Yh<mpbxS0vfZ`3&&nKZzQ&BCc
z8*Asw(mVa{=6q6T*L=)Og#uRl#dk7pdT+O6b42Ie4r7L+|IysNeHH-2k|zQGl;#yM
zlKy?$Dq8;kfBJu416DQ0puaj4l$7mO6@QO)J9?&S97)N^!+UyquFUb}NmvkA%<?1<
z;^$A@i~ZC#r6*5VSlQS}si~tp2BoRBWH0ae2LzO!6Vi#?h^6MQ4fw(g=evGtV>5vo
z9~*n|^{W~@3}M}y&|umdL&?3BKuSs)s`Ei*vGsgAT(j_Cqh@QWhM?{Ahl_yMAH7eb
z4)CxAw`)U-Aj<CU?&!F<uCK4y_O_}9&pa8S_4RcmTcT80(@rZLek989&-qSUqGMSL
z6`N{81T(yTA&g*#QL$`%dAn&x#lV27+L+gNAmb$%S^bR9bnSDoo#q1)O3KK%xEnM6
zo2Bc2{_Oj;B#4>2T$O$L^wqg7l7QN(E1J}(#z7ys#tOGu$oaE_O@cLiU1Hus3x*`j
z%F60`c{px8Q|~4~bK?X&X7_ylno%`@zWqCY+twb<!Rn9B!*L6jx`)N1Q<oQuQB1~>
zi_<P`@okqV7rsPFFn2?9KWu1dZZ2U^=KKb+^j{M72M_j+rd<Mpq#egf+PTY`!|=#C
za>~m|I5jg|n|2=Xw?tT6{xPio^SRh{Ez@TS+^)N{ZZ0M(i*Y9Cc-DOIaLTc)-RAD%
zd&e&o(^nk?{FXa&Eom}A67SQ~r5UZeV<=D7KP0-Iqw1`Ge|_b<94}gKKg{YhRgDL3
zm*v%Vd49aS6w9yT<|dfsyM(8wufJH)%h=hM%(*veXyIp8Ectspot%kjr+S`0<n+Oe
z*SMMQLMSc?9Ua~7DL9-^G?x60XPVhEygglA(aOroRu3P>|61nM%A&~j|HHL8czSxe
z^fcAXwvHHbTlx0Jd{EeKfZlE6XZ{j{&kPF{1x5YL+6y{ok`Es~plToUQ0--S43J{W
zlWhL^)0|cK<%{Ol#s;af4u#<tQ?ABy{qbMF*f=;jC0nvqzNf|x4-Z>Ccn~}8@i0w5
zzWHd%F|*cCPcPcG>M@0~4!xvziI~r}Y3ks7gGV7;?qW^$`q}K*^fWgSlZ<JGu;bg=
z)>L!<qO^DKxN7U_OzJMdep11rH^)j38VwBV8|St^m6cJyQO`g5Q(T7Q$rr|qLqvhW
z5zR92AyFpg%NM@pvp>aO`};lp13~1}qiUzaWVDo(v0E>XOn6LcZ+w5ttN8fw&D!VF
ztG_(3<&l1CnYcO>ZfAd=m7NzB7D_fGewnC#Mh<prFMa-^$NBu*8}8xR+4#|7!+^kG
za3v9=RP+PBhOUi@nHkfjq;g4_vvs!HZ`5Z34}Oe2fA#8B{YF80dC<AHo`C^|W$r2n
z_5~0R%BH3nUh|t}ZH$6~f+q{%#LZdX$!)7{GB7YO9^ZfPpfduGe0S0=8`}#^>5PdC
zfhE{=3W7k}$S8WU$`03yK2tNQpn#((#J^?k>;#;+*!6XL9`j}zA=`fB?qX*U{+j!@
z@84n2%a<?ZOCJpo%U(cGn#l9_vqwdb3Kep-jhK9JsmmV~Xy7>zeo%?8B=>>@tb1-i
zJX-`%6cIyMpN+e5vC4<`kN1<Czl@SgOG`(`#wrE|O1*yly4-z5z0NQ4QK9DH<9c!|
zL01--8i`_BLIRPVp`rD~$(}sZCJ0Ss2ZztIZ9els<7X%6Lw4)ITcgZ|?5n?p=owqy
zeP_y;82c6EEvc)M<&%@;L_y~nu{cI)iS-(H2S>+Ty*sbozO}70`!LKbE`C#3SeP+8
z<l@8)l9QL0*LHMWY2JSxNLW)-<2}uAd{}GXV`FQ(L>zL0X&!Rv)qK9)RKFC%y?b#m
zXua4G$v2<g(V=ipSU5K~mnG+b6iZMbhm|CZreinB;x^e?D$nDv`KzNk@9CZd1_DUT
zcbA!nLBhsR-v5X2_yWiiJ&j(Qu9HtwC#B1pn&^s(ioB->BzL5mPgm2;x&1G5>*}a!
z<9k-D!H#>64t}wBc7CCrub`o!q3swQ9qsBDd{uujHrqNk_J^qV^W4+#Z=Z~O(m6TE
zzK%<jIfH{RtP04GEPwd$p=QTB=IAP1^o~a?KIt787|2O{lbpPKmzoH=0@2SZAwe4%
z87b!VhXUd-enCk0qHaET`aYzhq5|Th6@t+DVOW((Sy3_E%-q7zFx4zgw@6RorHYGv
zjWNv)oYce(Pl@b(c(^jifsx-<*47fgyUe2KzSYdR^)l2S&jnPtEvs<CZpW}f5qi<&
zSi{Fj5PLL>hN&riWo4!7$?jr#rXqzhdWF}ww|mkAtuq*1?Cs^iqcUR)^zNX#eurTb
zXzS@kSX}L=o`4O2L5b2wG>pCruuU0|Y{sPIE&BTVBPN|xz#uczp9;_n&CJA=l<*`D
zYH4b|=(AC<v$I3;IoR5Ad@e4|tUXBLx4<O6+(#vx`<oQYf_boWa(>9q@7|~w8#939
z)Ya9$4yXd?p(u_%D36<c1wq!X2s%G1rw;*Z`|0!Nj&Nd`XmALIw&y`9hy%$v@NA=y
zG4a*AcP}Nk>oF|?_prUUCSVBtHs^`*_Orq4FtPy<`w$dxv{f<PYB$Je#6z{YyuI+_
z_4jYzE@bKg3DE`MGjbMWu36gNcskrS>MPX-;q3^JumjABWj(#U^NNc4@;?|G7`#YH
zp=g^m0O^V5a^}Sg=IG$nk)lUdo}SfWw*54z(np$^5|nyO$aLq%`*8^gQ~?12W->DF
zzt!A8?2cv69_BkbIFNnF%j*J%=w!dL#CH=jEhUAW&%AlU`MhS_oLfa%`Q?uvKNu6u
zjE(PL>`qY+K4L;LNP3GM!bUbcm!e78y50%dO`)1x7Zn7BgdT0Jua`Rqth_N)f|fw-
zTyZ1(vW`O4NK&mGw_Ue@RQx+xD}ymz%CFM*bS3pX2%TD~{*zikdf5ZPzfdT9$rTeD
zi{c1%nyw{e3O->mC@~@(syOtQmbp5y?oSsTG#**_N@-{sT9_R?#dTv-&E5U3bMu~x
z)b+)InD-V9xO#RQV9J~5#1FIdI6fJ9b#W1B>ND#F8GSm)jbiKo3D@m#)X=&;4EqF>
z;l26mE9#Kz^Z8dPDZlp)DXFNeK((K!cVi2_I>?@uuJzh9aGGtTgoY+2qPMr5H)&V<
z--U~NtU?ePYZRBY(jL!v5Yy7q3Rrc)(Z}~TKYuUywu4W9+x6v6nsk83>Of{}x=ZU#
zeSLl3i@jdKkgGr*)A}K23waU&P^_HhnkP|bp!f;+?c11o{17$}^_Xq+GODsAq~bG;
z1{*YinjacMgyRxhfpW@NMj%gO2fHkl!waLK$q;i>xaj5&W+9>z(HOD6XXWHn;=A3j
z76af$$){f%CFiHhP%wC^IYZ@-bkSI-3oM;6h4NrB7YJ$Pd|j?N*G@u4i|+*w)0H5;
z>jw8F^Wf8`ZhzN@^He^NMiDdd$(;U9&g-_?^CcP}*OFoZMc;@s(RI7+I=IfU{`%@1
zb%a8pD0dn+`2^Y66yu_!NeZ>H`M#Jnjjf!b>!RDy)})n<&BwI&@9%suZTQ*Oy}7kT
z0gDC)>7f1y9JoDDz$jJYXjsrO2k_$3M1^&C6jQL#J(?Su=WV+k1Xg-_DG$bzKq4cM
zr^tT|Vh7&gGBrJ|1Im{wQxJvdtmmT;eq1O$ve|dfieAi>nO&MuJegCg2b<ay!I>R+
z*QS>po)>~n(ah1z(TRz@Ojo<O7a(6obX#rgtU#7*+i!VIsC4)0yivv(QhsD$SGB$-
z+$T}GmL~#u7%-78l5l#te+(s>1qbi{^3y{MJdD`xu=nq2yLx&QNFuJxiT>S8hB<~+
zLQ?Y8n>W~zR`&i+*rD*8f&!d|hK9?Q8~+}HkyBYoCN3_1*%B8Vie*UxuE(%s%Biof
zM<iO`qpb+O^zYA>Wpb#I(EHA2DmUJ^ljAt+GgPxJxo&*Su-H5XYX8?CKWc&#iIvqL
z92oI=Pj@#qF9Z%f2{pB9n|8+yv(47<FJANV|GoBacMapW4HHG7-G}J;f`Wmr!~Z^Y
zG5^n}9D1YxTMVlP2YJ73)pSst3Y*>?N>7Q*-b?tk_MJD{MS6-7z2RuaW-5;%5C<y6
z$k<q3VPWrbaNcdeBrxB+dBbj?prNNnaaTwvci8?cfa~8gESX_696VG6-@bjz0i_zO
zOuWjn!3+S1o?c!o92~Y^MLymT&b!@VDUef9LHhLRQyOu1b~6+7Y9*nsy@7)XE_e6v
zAf=>SakGf+#sJ9^5E3#j7Nz1*g;Im%{&zxSn-Bg?i83^Tfz0!gz$^rPz3Yos2E2dE
z{(^=b!sArZ>G~l$ANTPiJ76;)|DFfMfzzW%f>m8p6B!tU9<MwW?g~VvSz^{i<<h)|
zBjPd_2N1!>k01XYzy8N!;VkGofm4RA2>@h8q38i33uD$!U_@X37xORb!9;~sH~x(K
zcivB*J|URlG$KwkU<wAM#*txR7@#g`WQdV61^s<BdoWh=I2`aO`Qp(f0Qr^t{2FGL
z(a$9#BilV)%eL-M69m9O4q(y0{?gmvFxuGJv4PqyWH->Y`XfCv>v*Fu+X@f@G|58O
z)5nh|aSg#fb!2_0VK~`}!(eFnM*y*~#SuZ#w`10YCA7}Ujd<3D({k^obu2|c8&%Jy
z(~!OV`-?^<Pz;?Vw&q&s)bq)T4N5ye3bklHS&Bt(Nv-p244S3^RFfv@!*_?9yTWrr
zx5Tu8Omsd_2xNos`O9q|&ED;ejdnD@LsO)_zCJYoQ(Z#NP3WclDRx?p838!h1u2x6
zfSRu>S20QeRIkm0tE=O-Wk83*0F-nIKA=N`?)i}GAhj}bd6EdxtQlYYbVmv!k9x-O
zAAIXOD<n$DBxp;~Ki)R3!Nn{)`*=N^fFyqpRhp2PsOsdzlcIj>?%lgN<C}ZCoy6A5
zJ@IM6j#Lnuj?D)hGno5t-0IJiq~>ql#dtx?l+eo*LJtY}|Fx%=@PsEy?MKg6#H+An
zg<SceHwx0$(Fq;52w|Y4r2P8r8wP}?PDV}Myl4O^b+OwywsyH`aoqu;5C*xlo^pV4
zRpB_!2eyvwgg}V|Ymx2Np&5jDp=l;t7Qq}Aj>WwA3V`C=!a`iYG^?ha1!&MU0zy_;
z_m(Whb#~{`$E$<``e+m)<GD`KZ!4q{Py4hk+q_KG-M#YA?u~ln#;-z?5WYKi6ciLN
z5*Q>^fPxY&^Wl-5(sN1j;2*OuauU2sYBB4Y&oQ^(%i<ICK7C>3hqXw}4xN*f8o&HN
z%;!4gTwydcIs9^>exf`Qftg<%ds)-uf9L?>Yg(F$lyq@kqT0Ag+tbjH8Z73~_AEjE
z&)|4KLttOhnBlBa8BXh!b1vKXnozLUC#pi)#$6<}s+*ge#EANQ$Z<L^YYP5*IxQ?*
zJfsX*g4A3iaBh=TUfzy(K<amYBS2TrP511jC9A-z(>3pD0IC)bCqQa{@el4{4#-{y
z)}6o8;Mkh1>iu){CM6}Ow3HBt3Bk=|AlEO5J)VEo!c>AeF_Di8jnr<IuWIwY)%bR_
zf5UR~rHWMJw%8pL|Gn&VTT2B^1#L&>7b2Jso|9lEOiUP|x37LVL2`FB-6gNOn&SKj
z)mb$t6APl49NI0mxWosXw`(WlIv^z_Wg*jNuAR=M84M24pN{>N?`}XkSWecGkq5NS
z8#NWFUu^K?@XzSj<%ol@bHfVN)=UF=!0|TV>)fsb;%nL`sbFhXl!Dgjkv*C%hgWTF
z(u6t`0MFDnGK{xYl8?955=0eC4$V1sJ>Nm8Cbm<I&_?GH;>mSzqjiPtmSgi0;~IQ0
zb)$M$7K1YL_%I9uSZZo&RHEz^O?L1Z7l&p>G_^(GurYEm9v!FPOFH<tY5obQ_VxSU
zxGMsVoqw;aJU)II6Voy4GasLQxn(B?Dj`}QI-U=a<tcju5(WdO!a5}K6>DMf50R7X
z>{hi_>RiP1{5dQ(`;urr(;>{5%d&gx$=A3<rN@s%8PE3Z|E((kdl~hYN7HUVnJ@{V
z!h+S!deb>Kp+xEi(FmK0-`uGV)kEh}J!es2g$<zJ;$Nv6<9J*~Ux-+07tt%sYt~5d
zAeHYB1w<P8h|uJ_xaEp=VeK}dDwJu79Sq2q;(KD+qX~wsyq#N%wM7r8VxuMJ=MxWA
zH(`*W=C_WW)kGC%U5eGjhrRoT-b=G)Z|W^QX{q9Vz?bw%6)D{zbOq=jK((lhc$MQ@
z!gx%l$#MwnE28aRyF)wXMp*JttN0w^5ur%bUL<e6QAjl-Z9c}%Y#>pVvB=Ga`#KO}
zvh$Ja!D%FfkPQwbA!HbN{bCnQwn4sM#O53Lxy(vZY&%^aeUMsf&K76O!CFZ8pyO8e
z281wd<HkhBNHdyPU_idEeMT9N(zZO~B-au<()z`!k7(S+RdJtG)DN=UGf|SNJQACm
zGG`p}f7y<QCub#B1&RnLOozvJfjqOci;?u|nV<oT#-5Rx_?kndC|8GTm!R**xvz!r
zkzwuP*l{r8HpcgYHLJ-usnp(RZLYn3;bf9rUG#xyt|*;BotjS>$54x;F0~FOSkAs`
zM2u<NkWqukz&s+TePLg}R?~ESdN(~bax)F{E4HNr&t|?vkP$1#YFDRa<pL-Fb5)Z>
zQgV-_y>adyf2o1!YNLzOyJJL~i^9F-#U<U(vaM?veBC?oHV1t|0!h436n8oPdv`-k
zV+N#smk|RJ!nUL)w={+D!w}cWrgGtZVZZGO&Fj7Ium;&Lh0Kbd8cDH`bHqklT>J2U
zp7t+Iys1GobJ`B0`N7J^r`}n=C02b%<JNnA{^W?{E|GBQEDn$VnTdv<J*KTpGwIsZ
zGM(w};6tOci{lB?pF?(=%v=8jJLU^S3vfTU7}6X;$nYAI#yY*gbEEzSMS+T9KFRKu
zaPq4+IfolYVayBJvRTm;kKOFIMHW`;j&jB=aUiLK!~68bC^@SX+Ut4;jI75ZH;rq^
zrnN+u^Gow#rP3s=5~fk0-r8@7<g_X#{;4%j5k0oFP^L3zZl!Cx-i4+D;)7}#!~Uyu
zOAXCgS0AD1UeSgdF=7yDL;EDI#-<;=($$NQoNZb04}HuKlWe*((xbPG<H`6fWC{C*
zY3YkLkUO#xh#<;R-{1o-2ss~ekFltN^tMKPJEpGD>B~dT^0rFeoWt|)W90D=B0Jjz
z!S5nYoc%?Ln(5Mk%2~>X1`BrL>O#3H+kib!U$&EcNOI%9Q5;IHi|uL<$Zo}^&jN=@
zN+O^nlKhHV|Gm^LEMD~X=;6aG7)!dn%C;huu|T5j$lH52cKIdiZTR<(NqeO`R|vi!
z-@=z^{ZxS#Q&>>Fl`d7!(_U*`XN&@H7A{j0yQA7NBEwSbM|{@z4n&U@%Ced8HvQpr
z08F8eC*~MN(qAJ8ZUz?<>G+;?CHR3EkC^8Pkwsm5+~0b*lyA3K6ToN4PFdPSFr+)i
z{vC6)t8)615?&l#j-xc$3_E{Ms-N69^4L5*={^OiWFh|f%7kx92C@|>--{8qW9k8m
z19T8XdwIxpa9d)9-+?VWOpezS9wxTAh|T=rr!|B$#-5?KWRly43L=dl4CMa1)00E&
z&R1mQp`5{Y@%D5a3WJtv94;=TM7|wF#ndL1$rBM@XNj_6t4A)lGnJ~ml(i7SY0D6z
zhg|3FqJ|l4?Op?nU2ln+szFP(yDO;{d9}4v0FfMAv4cV;A0vrdUi2N(`P=q>tb$PE
zQ$xTLQt!(RtBg&S)TAc2sN(6)N}Pc@&Ua9T(6<2d<>%CiN}738!YGNRF<~WNaC0#o
zW8;|qevSStX}X&?Z)z9W+uV~U*`5q2pu9fM{oIyHDxzt`Ajbh&f3$dsQ-z%wETQk8
zJZZc~%Lju)_@d5qb{YosSg=pe$FZe`yXZiobj<DZV|&!HT{e1qua5iO;_lS(Q!(9N
zq;I`QLBvEba2u2$dFy7vVq)+Ckbctn0+<e#qo4I}-@c77DDLihNxlcPrAcX*AMb@}
zgdHe=gwNN!tB{hKIxRg1G#tk-4LFmNlhL3ao$M{|0R`TeDFo;TXm$|WZFSrX*zp43
z`VEI`XvrNwNJRkZu6C}kh(j)xnFOEx{Fr2c8^#>i=|sBs{d%jNVTTDxOj&x_l9BXl
z>UlZ-$5+pIuu60=hDl3Qv)lX-Gnc<^Q$~+VMA@Ckq`@iib@N~mgV;0PpYf<jX|ibJ
zotUPlOa&weQ?>fTl(DY%Cw2ZlY3g7B=%rPO0;X8E8PdaeoQQosm`Kw7OG`E$mno10
zkho8!rQO@JO%)EKcbX5!Onmpcsoj2mC7nSlWI)5Nc>0|Rl6(5})>}Ta7@#N7pC9kk
z;R}gNWD)`V*ZpU-*zIKZ30ecL2hhG8U`7ZD1kw1_Ra>Cz_nl?DeM^NVBHvR132p{8
z_5>(<395{KSO8!so0~J5`z}UW&Qpdlhb`DYjH+SycJ%AVW%K)?&d#<;JYyx*i98mN
zIiRaG*tgEMu!YHd0@3A4BN{Q9!qVyrf-1wH_%)GCcYmkN`v#Yib}2r`S_3Vyv82>R
z9gFXYoJu$69q*;(PMBL*ZNV4^+^0%FRv0+AD#963I<IyFBCnOTHClds^$ONvo(QNt
z4V|cSSIOfl2m;#UKV#+R1O6x5GYw#z)B=Ggu4oAtLJWUUT^`C+^!@!xwWRmQz(9|g
z&+OC7)3+wh?La@>ZO3J@?1{UnrlHZ5pK2cCGv|j3;Ef=(0K|F)b#;7nC_zXxWCJ=F
zp6Hw}8?*p?sLr#)&Ee5e$_rsuIL7pY^u3`})xDuN)`G&aeT8d*KA-#iL)JE^E>^<?
zc=@`b^P+2_HU-4_NpJ4Gaz2(EwzPmc?k9}p<mHd=m?KP~f(XHjP44B&<=xXzTKdoU
zGq4LwpIZ)7UcOeHctDqbkryWhZJq67B#FyJgsgn*R#{3+rCQdymW&Xl#Ge`dqG+yu
z-H;!S1|W$U5?=T~8&4B;VYITcD!HEX-{ehsTdBF<o50WshyyCCx0|)sNn{zVWq~6B
z@>E1x8cm5w9T8w1V?l5EEfUah&tLi+`xNL~){~V_wQo=KR)7461*H6P$uG-;fVvKx
zH*vdG*J4`Ge>yxBpZ|`vFeg+h@Q#=9h*2ysI0vUKIDl#U>LjQ4Qd6CXdGLA}<OSIP
z*#3*33DVGcxLY&HM-Eq5{T_|uq*ZNn{mw78vAnd(0%yItLxm4|mbSSrAsSyFi%3&H
z+9%7YgZtVrP)0;xx<lt=UKAe7^k`bSzNKX9RHDBXanTIxn5_X02%Dtj^mauwd_E-f
z5-2lW=<`#U<&VGIo2csPdC$4+(wpW+ZCe(9+l4#W6>x?1+24(SDjpCQahkoum@k&?
zc?q!3j45)2-d7YiV?#N*@b#bRt|hhP%N`l$Erj=4#gM_&J3NjrhMhu<H_m*@tg!_+
z#b4kd3kHz%$m;qlYJ_z@iL1UN|CIj?wdkKGhZp+=&M6|^p!(<N;!o($g$*8!FMR8p
zJTbt()}(tIeLMbIS234lcZjmPel2rnFY1)-GFWDjfeaD!lDVF!+n5J2)z3%}1>Fb}
zwC-VMWyJtH1&HyN??He7?g8>X{d~H@I%;+h5LxNBz&SvZXNbH7=)p*!hL@Zxsi;^1
z`^*;rXSY8iT)@(x1x8DSj0|9+Xbui=e2dpK$S>i+@mTT#f`(HQgh&qE=89tt?i(Bg
z0Coy+2oa^L(^gcK_#p|9nwg{~S^}YYLdLGu1(@U><fhx36PQWK6gimd&iHB}BxU++
zvf}u5?*m-x8!^}7|GHq!j`z|*<v1f%QJl*ahn%~|!o99;ZtsOJ0$Q^dEyO`dbo*r=
zJLvHW@0!NQA)Lk)$W=>UnzlQD<rj)3O!@iw6Ll_3SwTmS(JCo~K%1Ome*5gfKz#iG
zq7#_4M038&giXtF^x|Z6B2Gx)qPcEO2>x@SgIYZ5j)DJY4H%R!s%E^Tn<>M@xdFSZ
z_3X}E;K4(*WEXNiJ@2}^&>pPykt4cY?!Fmkzi!{t4~ggimUL0NV@t(>33<P*iLeW0
z`JKK@DDYKbG+?0qi@Edm&kqgh;(=^Gx3Dc^*cUKLF^KF4XhIeunL{H&Pq*e`V}I?%
zibvACrH|~<1R&keiWe?1ucdSUF9U!jWm12K6#p3=AiYyiQ=|PMqZWT*e0(F$)8=NW
zKp?-K{QadR=(ePU)<}F$7NbxJd#P;~*kBuh5KZ9Pj!n%Bq%oj`<o{~mYg}h#zjZ4Y
zEQ;*;<lq*gNo$}u&~zEmgf#8$Q+%M1l>^AHq|&Ihzya?N^*y29orV2A4OxrV=!wI4
zyH?ZGj7=pQ;6tN9g+9%OZS{o7Or}gnt6h%7<1lE6^)ZQ4HXY1Y%~;i3H{}sc@)~qD
zt(dq5y|BhtW8RfQDms7h3rHM(TD1vcMN&(sBE(IHmQ_!ECIp*K@p$z}Xk9Sv71@XO
zwElX5(hT@pd0wcvxY!MB3@fnKj7zD&neEMz4k$^C&5H)c4)MEp?}i*|>VLm};JW|2
zFW7Vsxd5_L-R3eU90Sb(>1BiIal&DQgoJ3p1ZeEmvvzw+-RJ=Elwd$BN`PCF0s)bQ
z1qLO7qz4)iC^9oMfnD3HNGu(J4lzJ+i)I@r@v$8o9DuxvPe714<_(mjJfIeWU-bpD
zKhU*x;%Ed}=~F|QUr?w%EtLbXa6Qg8@x0EPt|V`9W|0dZL}DO))H1SZikuj{vzVTX
z?Hy0GJd$l~N2Ax-l~Q|@;8JqXXlNS=|6khv3Db^_<T~?y_wPp;&)m4&Yt^3gKYrcB
z)oXyYl#MxYZ-^f0#4(gmPl6~W9<y2s-`wjT=QD23un+5F%@Yu&?fe)VMxCJ9*(|s*
z7BoQjYN>`rcsS&SF>GRLDhAzh;ZQ?s5p+nIz$hJq)}Md@I~Ig);gCA$7eWJx3Xe5S
zB~?|lqcODMd0Fq?!2l|V@6t<7R{$~43yY@iBF;0>bk6m;ZK*0GcG9Z!3WzyVB&sl-
zC5A_okC%_kAs^$>!Q{?(=F_=z*cWNjD1xhon}fj~_z%teLCG@e?)<X9dq_Uxo(F4D
z5ppN1IhpL2`b2^8NAm9{2b9;GAz2J{ocDk=!AIhp+cB6TSf+C`;Y69kjb;?eQs;z1
zN?Fr^_@mE{#@8IVE&}emHO?NLQzgnr#N3ay+`o?A6|%=(K#PIE_HMp9+XQ(J2Ol3_
z0C*)gm<C=v1Yv|O1tF*3Ey`{B$TZRfU@k3(RA8qwOu4Kqnc)~{ffV>MmVZWyz!~G;
z-Rosqe*J)NV<(@q3$bMM9QUovwRG05Th`}E)+JwtVsHKX3GsDOa#`1$*`nV&k#qZy
z?1b6N`Q{dC|77gs1G3$j!GeWzS@Q_o)N+!g;rB$I-@4RppQ__u^U<e=-j2t&u1dqK
z9efgVU)h6LQ?vqq+{5g5#jX4L$Wm#QY?JxwW7^V&C@#z#I2J_qL3oUdLG|-<zTGUL
z(y_sacAIwc&F9&-s+6l6KT%WWPcra}a^Y+7r$;yr_H{lbzuVao$O^|Pg)V^KDfoQq
zo@vnGC|V)?-Iu%vB&X>!Umz>}`SWM13vHsKy(rXl-Er@0JboY>JI&OS0`m@Sr?v*2
zmwRsfyfUYfzj3=&OglV((516AMx?p9h5{$q$IZQ<fleAnh;<adn0bE{GCsJr!Eh~L
zhkV{N5EWq{V@=feq7sQaSTSTX-^LP$h!dnf{2F0gBxl=9)o|a~NC}YFbbfy7yxU8~
ziZw<769GF4Eq!q=2^HT)AN1NmP=VT)l`QuFSp6y1w2MP9>k?~bIti!!=)&+1DyB~4
z#rqz|(P%yHAb(8@fvjW9l*rKesbCyP;1)j&+U+CO7c=k0TDtmXQ0+-a0^nx#g_2mM
zt0~8o_sR+EkQUDl=Q&;4uR^WmNNRH=kl<d*UT$bjv;>Gcw;USS-=m!Y?$)Pb>k#aM
z!s+Spjg5`5Ui#t9!!eF-XlS_oN{A+2g(m(eq?9(E$8F52LhMJKSHyMR?{o6pPOAzz
z3T5zf(0#Fa{`(}DG&c&EB~R|rJ|PX&cT8BULA@D6NqoRQ|CU~o``Cy6v(1v7r+-O}
zSnik7UQ~eL<W#uO4{7Z?SQ>rtRokK>Y_tyf2v9yWN9(MODoassZpZj~UfyrsHxq{z
zRu7^Uzxc7S821YpJDtAxwNIu!`7@TGkXEpXxqZ1Yz47nKL80p2!~1L$80E`})Xc+*
z{7t;K;@3yglNjkj-EImB(8i}_kVlQfwzym>0$S$P2onaGUOCle&ex?qREztW(=d%_
ztYu_(Xo=075*f4Qyrm+Pb7etc*JX(!U9i;W22KvG<e`Cl(EL+n-)D|DTP1W8(er$>
zSzy`nJ8$6TyQRNZk*{5^h;FKlx3$q!V+;W@H&y*?%wYsH4=n>57oCnU2X30wI8dV9
z`9jp@c$unRN>J5PAVq^VEMVkJ3QHa-0Xtr9lXb=#81>WBv85(;9X59#*SSoT=Q0@z
zSLZk~1UJSb(>W<`KeJofS>hp}^$%4n#lNtdB^p`t{qpT{DGmdHG2CPDw;DoVOoxbt
zMHDFV9nYKdL)xtTQ(>hRWpx2O{OT`%YQoBbTPdr4o-)-Tqn_diS`3D1KG^?3<0uhX
z*6Pm37rk!TYkuANjN;}j^$LRn>8^PZh8c%#=VPUXOn#9(<}uWx-2tv63037oE7VjO
z1fg&s?L}WRT$xiVLe@8kVT`~Kbv!vl-WAPQiTJ8#3Fya>W2+2mo%+l0jjY*FX6Knr
z*~8qOuJ^)@&D-;ae`_nfP*OUv!j7NIzo;XIOS;NwNbQb7qPQF^GjqD$l0Wo4n=RY*
zdxwEQbj>-GJbpxZbQrnpqo$>$^)=D2R?r^X($==XEcppSm<Ld#L>P4QX8%=LS(&PB
z0k2kWYb#?i$3u6&{($WUT)>A457$5!&F|G!tE-FC=-4WLukp=8;5EqsJY8)(_>f0g
z2W$o>pl3yeX3-lcR3u>KGYuZVg@t_>js~-_oNM;eE`C;PBbE#7#gf1^+>~ljg<=EC
z(Zrs`%DtPuj;h#1r7{Ue(f4?a?~N`W$Ob#|BW!un1gU<Q;RIS(#6<K<fuHoOTy4(F
z!gGjX3kiGkVz-KSAKWY4y?Fa;sC(6NIByR^*tKzWA0Osx!;$l4^s!7@eco<*DsGQN
z=K{_G^p5Vh?KM9jStL=}5>DG2dcS;99-)t)sF@fFs%Uiuo%jdNC&TP(ew&cxJrmdK
zD_$tB-f#Fu1{<B$k^6>$Ud=|5ffV^#yjo8kXS(G~1M!9%=}8;YVAXjG&$VfrMF><=
zXd)1}#m@77U3$Ls=-ho_1doF7dq<u!IeO#zw|*{nFPjW~qITVmJlNfBtA!0Mzl|g>
zDJwShxZ$$%x$DoF(a6!=<KwYnet8AGlPi~~10Q(e0^w7T#HE0SuA{4KRfhtK$JfC@
zT!?~#0uA^qLN06ccfCA4E!PGzPY%mMQ2S|M?fH7Mi$)y^i9ur(a0NkCk52Fwyi~*?
zKF1Fu$<lFEq{-C8l_$v=b;#A5YE?6Bu~YH|r^X!EmYQ54sP2_y!Mf;6H^~5{JBVeT
zRLxvZ$v-!sgwcvx-enJRH;q5I6En{}Pg@`Ju+~0MX7o@gltc+RD&c3%yVEueR?7pc
zw8f0l*Ook;?rPz+TfMDqYwx(wT{cE8K~noaKbP%;5^KsMsvJ=F1MBN(!=Q_$3xx~k
ztJ^cj8>E0LefVs)b5vDZ)r|MNMTK42QNU5@j$Y-apqCNZXTY80ym0w=29S06TZd)>
zcL-_YH<K!jOI6f)Hsz<r9QQYb=6-hOk!-k4!45-M*>vLjPt<^M17gJ;Xo6_expaS0
zyLe*f$Mjl!&-KxGPRToQyGIA)uV|T0(sV-Ly*o*vo|osb^4!o){W1|+?gE`U0>S&q
z*_Pv9%+UQOd;8z{F)gh&0S4^_eOjVu%7KlIjRx^RT3V@;uV@2lpPijOCpYvKnX0mK
zgV!-IW`V;D&?p{~ge8X6-`{@-bY(<DU`g(&l7znmT5k36`y2|TrihE-jS97B-4CU`
z(Ve5Hw2U<g;_}=_Q6TqY!ES$xt~o05FvM~%`GUzii=*V2lJ?swa4Mx)={6+>P_p;3
zQ7b2#)T%J3t;H4Vi*#?*3FgGk>P_sIMjoGtn!cNCVOb`&M-U&E3mgl5=UCo<*^m1E
zz*ga7-ei!`4mVff^Q$yZ$vs@?*FO2)<Q47K8(M{fBYtWsKWFQXHQ4zSfoo0;;+2pH
zH)9P-0_goWpmHaFMpnJr`E;NX15Gs2_so&%ZQDfdS*qAMNb{~}mJRx3qR>f&SmuNo
z0JGhZM_QBd)aRW{R|wD+gO;Z39UVJCzhhL5<M<1wN-Sa_57Koa9g5Oib$nRVTd+=>
z=W-<Bq;p7dMFM+0ktZLt;b}5FcytM4)^?9$O<=wyZ&w(p3zXQ@KUBt$`(Pw#g{0{u
z{r;&Rm!SP5&|3=aUCa$8Kv1xhFm7AA?6<Y?dqGBIWAvXp2P&ybnulsHzhl;*3t}oo
z<oBLwg)gVCA*o+W=8*I2)iFMrwTp902O08rvU=6IB}LO?S5G6>1Z`{GTw4z@oYrlm
zZE^D;`c#If_})KHNMVuCg_CX8FPXNqN6|h$`Z@X2h*Rs0<3E!FIg|(}U9$o-n$#r{
zgdxxhA6OJiqXB+62Iy!2J%+0lOJ6}N4(KXP6S5<k{K=wJYLI-Odc!|K4MRY3ssaAQ
zHk2I#rhuVGRFj{K<E5aA1Kf!cVdfv5xBgf4nV(Rx4e!3dlB2CW8JIN;T1`;z{+z#j
zdA9tvDfoP#y2FVyH|4CfxuqBba{Un})r3dhJarOREut#nsWMV6w72q^)!$Qv$BI=C
zs2{ugW4fEc6?{`|Un}CnLHnFWEQ9Ydw;wkRlqSl-@EC8PVN;Ow&V|cLgZ-vp4s*AM
z1G(Vt%@GXO9MFg%jZd1di<jINf$pRLR@MnNHA0*ZYeD=cyh?iINI{**hvc;1VA}y0
zFrMog(c@FsnxB(QYn$1RPc2g8?)N@0(XzJEl*+P@>9)Sg<&L?#L_(LVP&gL>Tp*fM
zhD0`Dl$iD;PK_>d^q2eA(HhG_0Uu`LUyd%NiIAGi*DAmAdzI_AHVXCNX&I>q7cG&+
zPU(`*hhf8WiWyfD2uyJ-DNPQ@B~7>=6%52o$7TDatruhipa)~X%6Iq$H*UF@5K+Y|
z4YfYI%WvX$q(kCHAPL=4B~x~C?Jph3RycB_^L6>g7lPfzGFvu@j*x8mA`*e;G)&yR
z3IjV^Hrw+T6*n~>-CJTERZID-W3~dz`fP{cs$?8D?cr`WWb<Tvc=SY6)t4xTpD3r@
zM&6M)7K=~`mIh!M;XD2(ic?i-`f0x}@wy%pqq~Npt5U|C!@X1-YYC(aQuZO(_<>)*
z4UQDyit-Jb$7<tdj5*z`d7mRQ2a_Qz1TaFHGL%Bz@kNIEq}Jq^xOCW^J3`QRJF&F_
zm|PYG&KG+(BFt<D0NQQdpL2x%+JBzM$;L;fe3OwDUmf^p&Mnh@oEaQ_xAeHN+3j&H
zKNi;9U^A(+wCVMROFz79q0J-y*W2Uvwqv$wMv1rDIZi|->v`|9wbSNa2T7I~Ib)}Y
zOzvBQm?@9ui^AKTLe*KAg=CujoP^jH8-dP{jVhA|{x2A4KW)~Q`*q;`q%5~ZD67OS
zk}r!MdEXCjY}naDHUBK7>MMg>=5QEe_}ViXQ;kBfzbpJiG@p+rw~u|ZRy1x9{WAeG
z@+bC>XPWed@}-coE4<}KTV{89clkN>@94UELVmu&k~*6s>bFMX24AX1sE4jPV`g2Q
zVL=P;Z#FnbP6}`lm(RR`oOT&85?*RQQP9MI-gd4N=+IJD>wfrS%l~8{G~*f<`ZVX*
zG(Y_(Sk`Jt4*gQe5>K~r`(`eykEsED-aU0d-Q1c7f@eNj!{D6C?zI_MImD+SxvUCL
zH-(JmbE8y>kcow>jkEJ+@cLfM$`^gA{v-%!_qP`3;-n+T@@uR4fEhRHp<!OHkL|`V
z`j61PztF=0w!dKo4vDB>esP2%?4O^;QczGz-4<lWbhS6SSDqDR2vG;PLi*~FHOO{B
z;-MDIbqU-g0_2Pg2?D_zNC<)c3}&vWLp>t7F@m9XnAGe9p$-<=hY_`eJ)TzJRk)pY
z@w6F_v7Z~^(ci`0O}2op-{X%k;cbh#_p9U_Ay9VsFk-xa%N&suuew>W{?27@rQNu>
zKA(c~k7SE17v!lTq@KToqs3y093!$de20o{X)dC><)r~7{D`TWmKE;tBC@oQKp;v<
zuv}-;jEDwdCC@e^+ifbG*LW?ZC=pnSpJSgfTlomlinPHWXr+6ZSf`F)O~t|w)jI{f
z>C|CHAy@+6=N$jfNFZSDwgvf7Tpy1y0@Jos`dDVpg!1hHL)m78vdyBg%M<18kElD2
z^7@X%SD+c(^rDMuJ&wwzN7cBSyf+<l0-Q!8GT<UEh7A{aJLhogTC?Tob3Y+{LU@XS
z?87O7*k?UXM73XkKrzV0DtGl5UWZlx@L9g3W|C9HB@ZTKU~z}Mc(xMx2FVL96tb>y
zwc)<e|KfsG?a!1~{aHTBcSTY}^|0Uo6h19Z7<6^4D6C-{8)b)!GkDEC5O+XZnUR!?
zP!s0<ly*M&!`H><RzDRfkafCEWV09b-u%&o42~+GI6dyY72dVwcse`Zp!hImqw!nW
zpq~OsTJ(erLDT{<nOKA+sEk!<kL$)qYK6qQB#fKPj*M6qAfodgLf%pG(C3deI&fb#
zxnwzz-@<<9j;gxlR1)qP3o|zPv#!S9kD9YlQAnXB%=8ELYFxvIW>KmmTyx|iO{-U=
zO7}k0COdkgO1W!mvF~K|LTBt|eS#}&;%8}{CdtNFdI@V`nLBiO3uwQ$4l}*|5X~6A
zHudy!j{I_%bF=!PYoe)3^A4+Wt135#e?CDD&QD;zVXq8#hvKCX%Cy{5qckIps09qy
z2|r{}JOu_LYZ4~tA0)+6slql<pGe&+7S-sKDvDH#P=CqIVGDz6(VRr<Lycw7+k-;o
zZX+2X;++dCj=9rrap!I(WXF4aSb20wpCF`HdspWTNxnBNv8c8y50+pW&)E6mH`s5=
zUy`7R@@F&RKoqwsy(OuMV!H+hc_GVm0Wv*G0iSEckT{}|D5oM~mPs&i_BBLL23pVI
zVeqgZJLBPeQ5G)aa4x@>-ic<ykv~ezd_IC6ee16S&uXK^%-0&j#u==umiCUB;(NCi
zxy+CC?_jYjPe+CN5hGjiuW`bxxzqMnozr+(L6ucYB+vrt66VBE-^|ba<f>QX-E)rl
zx#Y)YGB{<WX)i$ULM3_iS9n2atts^44sN-(EJUjI6;oHG@;O+j|2-^T&a`u%tFIJ=
zrj2;wdo-`8FkAY<gmE1)WulhTDt^VA4c+98{&`!6`DK>&avJW$IIkr}yBqD-`;#{;
zLyVhFFb82+h{utAC%yXQ%<K8zT%^f2fVgCRE=_H{oavEER1oUzl8y@YiB>>1Ut1jM
zF{`^r_QC#VS$^oA9ES}LhzEx;TW+K{K}gQ?&zKTd(%JM~86nOcf<<;rmYeg288@kG
zE3CG$7UaAkKX`p!J}y<PJvX%X6Oy0-S?CqOUtsvYdyPd-R~4H6WuCRi8Xt7!igj>&
z?lzIQvRUHEyO9oFf6v0VZ-CfwU2p&AtjW<zcp3<LU#X2NGs?ctAe4u^-_#j(erg34
z(}|6RFlf|rLvc%%hOI`Y<1yxTRZuTXGDB75)!JNG>kp|$eEyX1S~fp~@Ls6Zkfm=o
zLfKcVrf=!EVhq*>{ps%f26_dC=ks=^<UwcvJUSofUkMNCS#X5^wH9F5Z1!<L$dfJK
zkM+-X({Gk_`>`3#&Gw#OaN`t#3}^1(Ff;QU2|9-sG(75Ru;a?GnL}MgBoKG<F(zLc
zLp(PE@AOk5>GKuJ#VdNuIR>CrNFrh<yhCRfI~{jI2h(#53M2cP0axn6z%LSqM~31`
z|M$Tjc;^`2lvi&$W94N|bMdKSACh>k$1w(AWxeJI`pxl7P(qsOkiq|AYhKc=T>U+4
zMioqjRA;oqIQ@nV3_dYtI5rah>tP9vjgo`!9fTRH&n1t_YC$A^1122H0<XWb?U^<7
z@E$Xq0*6sSn+Xj<AORDlKyGowoc{$cO?s$(JlPxGmint2GjwOl=NeoF338zEPWY~w
zDt*p8=v2Rj>u72q#b|n$NH*wMll}<cDk}L=S`(oCC#aAJGz;8`MD$yJHabUK{JtF+
zKz6dNM-Hqf)=?3|a;+gRvFj3|;nNjmX1QIW9N}x1nCIytukapx#$x>YpBw?<ex3rI
zZAwlb@sr)jrM8PlZ&&zYY~r2F7IDy*qU53yBJqli13*<iY+m@O!g2JXu!mV#1jFUp
zio-n_IH2#SmUZvF!1n`Yk6FLwhytYsr6W^PcGu^;I`wYxNG`##iol?-xy6<nPZ@KP
zF==dW2>=}X%W3)(neSIQbc?qVwEJiNK(*k6J?5(1_1^yL4<vL&3ZR8T{H0F)PF3fG
zTO)R_qoirf*I&ADUtd~s;dgt+%?BZC3+TQk8(o8S^EiUvL<^Hi*S(8xkeU7*<(-+=
zYY}tuAH^lY+L0d68&bq$rVLDbLCjIv^7F|@&!@Stq-@aet1HK5x`@Mb<6)Yt2pdoD
z+T}GL&70L<SABw{Mt+O%rsvC5%kQAS?Xcg!Ig}S89Sa+0WK%%qE)sg&TSWMq5s?uX
z)f&B60(rmuus{%nnWhK7$4J13TfV_=xsEk5Ea&j*xnvnu0m*KTon^o&Xl;QFISMSV
zxor3RxSovF?NcVW1;{9Ui329ok7w26qJzV|lyrQuTzyP4%wA*3rGc_0#boBw?e?F7
zO$5A%#2m!I9de6b+=8u>skT$=!X|p0PrDK<S78UcE@SL+EDvr)zs6#YMEobnX*{=z
z?IQ=ies*k=pg6%I@(B#6B+Y|UJng~}o+`ebOzB2nw(0r)NN1`m!coPP-HP>0#)u6b
zCQQ7Wq~{eV0+%aQc_!-Oqm*U~HFfKQ)S1954!n1qWoV4ivhHy*s?PB~L_~>(HiGLD
zevOm<A&0q*NlYQJDc5VIXXA8iKaD~a0?J6e7>-a1zSshT*PFz?G!x7<pT+60m@U6!
z0(`uADZ`dQWLd@zB`YpK-fGFu$f71)*2EDYMgK)t4y&Pxs{W%Dbj$2h-OUs^aESD3
zjuwC(c$D?58+21m`0J7(%+Id<*c9@+cJ(-R6UL|3V2$6dHyw4YQRyaYhc#*VNm4~*
zzDDkzu2nvmET%*`-B#quTpuQ$`zS8N7f9yI##u4A+Z5r0uvBISuUg&#kSzF<6DD%C
z`mM0na&c$P$q#HcDOsJPi*S9^g#K8Z*-GhzPXVQwu5wYv?Rc_Z`^jPEE;=gonj=1o
zMrJ^4siaKVo#_r`g~;<pqGR=rr;RUiwaG>ox02VX=5SQBp}bq3L^-XP2=*i0kAszy
z$c~OFtn0*a{Xu7IA<(U<i2Mx^dH-A7Phv)+L;$d*q`_yT3Q3Lw-QgAtpAYUsZ$-VV
z`#k19w2a$>SL}2_tV9BjWSI00P&iKds!bhVDG5+K?O8g&L<(}^x<YWdN#CZbTNeb7
zY}WhmZ*Lh*MY-E{v<9Y;UAC11j-Tk|%%QxW7_asa9B=jayhYFWA?4u~Of{AT7ECmc
z!l9J9b^!z#^lu_9WTfL1M^T^bxA$l}E<oyW+@{a%$j~VQ0t4wUg4fz9q|~*x9o@RO
zcHJJ|Dj#;L5V2r{izASe!x%4;8L3}}m<qQaXi^EeE|@Wgh&UE6arZEG9j7!Ax45@c
zr~bgQ{5Kr3n_xY3L*HtS5hPJZo~UaP&^^M1hKZiX{bsS$u~}Y>md69{1Yik%S~v|6
zB1lf6C~X&y+#)~~cg_`uYCZ7tk$smHyY^PAJ;sATK!jVSB$+)%=p7_AJ3^Q_d;=2u
zHG`R~tdyeiGOqrLu7!gdVV8`#PA+MIC1ZkDavE--^~kB2m^x(!ck#ExxTI@4b++}j
zN4YEP>#Pjl3`P;wcFGmMQa*Gi{?b|si|4(f2~y#P*uQPF7kJM*mgOZx@EQiCCRmGW
zIuZqx;qWCJm+jJ5wlYieVc_XF04$?<|4rNeZrM;GQ9sZ*IHb!_kG<QjqAj%aGfs&h
z=6jj0E#U+50K#DPuR-4#<e1CV7x+XMEf7C=4enRPa@~;ngzls4%30L*k_27%>`FzY
z<ji1?5DE~HUTyB@n%?CDtp}qW*jz!J5VpLW&WlneW@c){CG{2dmIrizn+!?qe))mD
zSpvI}B};8^V^+?C3vjh9f2Ly0G)FL9u@?vcIi=xph&!QCaC8Y>7X{E@ck;@ikmGA;
z<-t7<9@`ra!W8hQ3wl&6Rbb}|CY$Zp_tJPirP$6Lc`YixQe?Dzrg&Y4fDO#i%O$2g
zMEYn=x;XM4pc)QUnbqFZhe`Ux8N#BbVAc3YEN?nCJfz$z%wvykSp@<il=SZn`OBVJ
zCMI+zc5fqF?z6GxVvRcxmqzV$t9>&C&XEA+M>H%VjrLAsAEu_TYjlIo{o~$YzH+z~
z9IyyC_0g1ZC(AFlR3&r`jDMJv@tpoL1yANVS(0&oZB51zs=*8Q`EkJe3?|W=Q1Zx-
z<Zp4r^R2NzkUGo4Hl%>eY{rhGhD|6EEm*!lzpj57CS~EWd7s*%AQ*t9iAMtm*IVZY
zy!7cXdFV*LI=7&7d<86fUNN(9<KV$|36Z54u98mmm;5#cIjG*T-CoM`32Q_qKSmiJ
zlyw_tt_f%2BJs-n{k0JfvM#aeeC-0~D^2hALHQR^hZT&WNJ$Rr0Jq7lv5(dr0!H+)
za#lYlp9>HzK*TWaTIu-MggL_QZNoD!hHy$W&;3gP$Yri*1*x^9W>a6`e)tDr2B6b{
z@>*#y=KgbuRZx1~gQmX!{q^{9o}->W4;IY+&s~sKIVC(fZe#tuq!BU<bQjwFO=F2-
z3jM}Vi#m)tcX=4<?#?jensPXlz86w^#4jU>h$`{HHeA%<`#CZ!Qb<%D85!PQ1ZR(?
zNAfW-AcKiu1cy<i#bwwUGOPAv!RQ{_=-@@mH@p$PjTLl+L{+YrPYWroGG%!Bo=(3#
zwSH&a(OWOxVS=PMdIE#17VG3OzsvMFlwTbHMVLjmbnBpIBG(a@sC96AEen(90=N9{
z{MK5+`zsSe=IFd1m+8Ue<l^@`CkI>Ma#b&1swNbJ_x&KYWhg%ePaZi&FF}(LBWI(J
zyjmSHj+MJ>CMzTNUY_6~pqEzP)`QJ@EhEue%UI-qYG;y_v45^Xe}~ARX7aN615Z6a
z-Q2ay3&oREq31@gJ?Ferl{sf%Ti>Y!++#jUA^C~#J`pDAXtRG6!<P3bG<^)Vc0v2~
zT~Dpo2$oD#t?cb<qEAzVpIAd5b5Dwd&?5`T5%+O*+Itr9&NSDC`1ntvljzsKik+j{
z7rwx|MhIvc17#Be@!`a5l4O5K%5P&dT@mV`4ll*2goZRQ1TxUIv4ib;(hX+^^`+}`
zSwiIBdfYpc)W*(a+<X%^m1ricNGqC59UznnL}k~bP)afM^SPXUu?OSAvm#tei(161
z&I9QCDOOUjGYk`Hz>scaIZc(`?Hn&%+YwO}x|3~Hmt0o$ve2dvw)N>~4qpZTI_7cm
zlSPY6X`<}M0On3aSl-5$2a$MhSR`sVTT1Sfg2V?yV1#9X+%Z(xr=n-N^`|jWdr8z|
z?P=pbBrN|~+Gl@k_<BWq>4r*0BY&q!e7Je*kca<IfycXgI0x~rk|O7ne;nXjf_##5
zD>9^a^7U={ItRgDb8u98L>-WM$q8Abg8Asxh%8@gK%dz{Zx?+#bHc|oe6am1Wz%W8
z`lX2cN-1TW9*oCUBSQXGi>M}s_P0ZVV$9p;fxTGTc>U>es<$MyV2cqFSf-UPW<|2G
z`c($c-9M^KXTExe$jg4jg2RPQaJy<I#N;ZVEy03`n0avqTh&3rvNl@n<uJMrjRY$P
z7+{2%p(`+Fsc)~R3RgK5N<FU~pDPfZ?|a^m1%S-K3CoIY6jsV&L{DIdqXeILg9(S+
zUK321&(>|?QRq~^tolST?Jd76O$_9wzitAb*ekYgLtcxX5W{B#%tXjO1gHSm<>?o)
z%+)NGvDji2=8Y~GQ+EPEqcM1a-p<B**OA%u-(PA;tUj99&uEn*q3w+#D901W15I=}
zM((S=Y<3|hf3$hCCXh2>r`9tO)$AOr><~mGh9~z7%T%@@1WHQ&q^uF~?d$*nhc&rF
zFq7EigeoQIy{ASXBp1>0%i#y+-w}Kjic((7H0U=`jv@=3+W&$+*ByF@L*<T3PmhG|
zgtn|)!*U5>;|%2u3D8jBx4Jdqw-D6GS`}u2xk!diN4_6Rd#NfX1M^5TC72Y&7#CQK
zw!i-1u}Q!z`~3#I+DI$m#YZ42!r+1|-MNHf;TJZ>L~jTCkA3I%ex4E;`XH?;7zT}D
zGl_W*WXSkf)Z;(ei!L^_eyquuZS?qGgq?L%RA0Qs?*uudG}1~+iV{)-2q=OgAq@iv
z2Hh=#(v6^?ASt5K(o#c%v?86-(jXo44!?ijTkEamKj>O6?%X@~oU^}se>T+jma5q7
z(bY_6r$-6?PSALs0Y#b;!AJVWjMqUQtilp&+$N6Zltc}Pw5Hr-lon~#h(swzj0r?B
zDA?+l;hw8#s=*U{X*#?(0f`y8I2#118C@k3RnNZgj10HGq(rz9#mKlU-ARz~sB(hv
z6~~M=r)Rb%N2d}OUN2SgRo1G4GLnYlO|y$EM0#?t-aTG}_J(S!$3|qp<^c{FLs^tK
z2}D&fyASjOoK%{1td47$%4vAyXyma(L|b;$*w@f6a7qm=k~3Gr`N8izr_PALnym;E
z#f4(IlZ16SF?q#Nm3^V8HkjKmf~r^=yW>jqBfNa=ErZLQ0#jM8i0d%0QFHn)#!v~i
z6=S~d<|-dwI#KB!PeiJR_C9r=0BexqB_vGhcR%pd)wxfDHNor5mp(*RYc#}o`V8jE
zJ{c5HC=-MCb*22rgA(Sy-%g|OZu#3m`W0~Ep8NJEXKu89<Oj1i&GI>UjSHu&kitM$
znm^i@0E*Xp?~)ttS`mybXk{wtjXnBF8X}49O@^Qf7Mw#URk6<HWMHNY{9^#?F1dw$
zK@8RhWQMl2FL`57pv)@vJ^RQRlVqu}ISX!I00%VIOeN3TMl(yivKLP{A^(Ny^seZE
zlH+wEzo;0q?DF5^JMX+9Yyt24{47x_ihHxusken*Ta9#22JuCgD<y>nsyu8_HfIY~
zL0(+Pg*D%$j1XA!Wh=kX0{2ZX`@5F`XLjG(n<&+I?i60>Q!X=Td9exWsJ8Rt8JZR&
z@)Tl({QH2zFUDcskO963mf+^qd)FA{;lft3P?ZRLc8SEDI!p%k)Ez>Qz<hyTY{%wA
z1>gFpdm1lC*OA_{adO?`feSwF21{1PPOS*FD0r_}##vl9-a0(KBzST_AzLyVG(Pa8
z9*05$LF-~L15!ky$wDI>dXt1ru)EOCmdFxI8WCS`;4tf#c3>dy|4dtj-w~^_n&R`r
zw?}Su=*@|7^0Mu=eVof#{d6oRWM%14J9+D`jQjG<_nF$n9h!fq2W)|~r0bJ!{!+ru
z;2JhmTESx|7%L}*^(esnFjYvG!M>xQ$N(bI=W$%sSBMZSk1tLG))M!lx49tYha}y*
zcvYb?>4Fb8_od$zKDC6$F{4A1U|YsKvZr8t9?U`PfscrY$d6rhyLFK`1-a6&@bE@G
zebeCMV_d@^u_cGrbY^p(*=YEa25D>ejhG?i`NA&&I_%ZkB}06XyrN4_+^H-u#stN6
zDPpDAC76V=<Mp}OoB7-SdX^ZBf(<_!g{R-|YhG%Qqr}(0V9vU6UW1r`$r_ErUUgcM
zt1WS>kdw{c)N;~?kwMPdu)s|58*&>>(Y&yy!=!D&GQWSp%kCB2``KR7T)m25ER+z9
zam7kc!2XpJ-=?*;$N0HH2y)nEck~L6N5CMQhtC^-$5F`hBfY5Qj}Ba~=3z_5xxJ*v
zngK{v8{q*E$aAQD15CO7fc54OWLPhv1cN{_27ckQDx;UgF+#k|&MUvBE%gmiSvS=M
z<7}qc@=$(Ma+|PZ##RAskrZ70je5D!p#3yl6Rv`E23fQ2_p-e+L|C?>5J@K_cPBC$
zS0uv7*6%$bCMZqn94`P|rKz7c%jmKHJkO`G&8C!StY+rSmCoJ}S#<lpV2sxfM7~0|
z1I<nWMQQ=*$Oi<YZNOy#qJC4L#9kJ4^Hqou(LqZ!O1zTaWi{5f`*hRuQs<SCf=XGO
zDsYIu1YS}-0XmS%&BtqN8zB1k_dPDCJO3FP2UHj=fWglTL@P_|$0gQAO0v`SHL1>B
zYYP#Q_4O#AVMKLCH78Z3#ilHY&gyD2)FP7k%C9oT(?@1S86*pG4Y6)3luZogsJR=9
zARC8X2PZHVlvF4l9aL)gomyB>XI)WBK>&?d&yVf%^X8Sdb5@unW_uojKhftTPJeUF
zF_SCw;za+zwF8g9D3IKqO6!;uoYB&QxeoM%hgp|K!=_0U{ocWwNF<PU<apuYg*YRE
zjHI+kkf{v<*Y+SyHXNWyXaQ;BXlLQ`XN<)8RGlxdl{t5ECm9?FfvheFY*aW-Pnmad
zhhayxe-cL$ck|t8;%#^r4W?{SZ(DTzL)pNUil{kh+Ddvt_P@l0FZVSCn6rJ|JMoe|
zm65&KR=6S-s^16~yj|<&;$?(3;C-oE(M5_T#LY(szHH@Mg-Lbq$!|Y-$d-{yB|0+-
zbNdXwYtmSoSL-7-G_JJ}gFOcBIST`C7HXt1TZTw5hwSO95T24)7%3Qm4j(+X9#k6l
z$m`z+I?2uA;cI+$Co~oo{cnf6Q>AGxa_OqEY|&$5MzUKtgcP82T;x{<fB#kl>>W<d
z#tmuU#QU7*y7_#0&u4kBf}W0*b*<=D_5g9V*w)uO=M$J1#ltpC-4NJBny<L3UR5SR
zMX92=XweQ?^lu94q_lrO7y7mpx+pC1UPxHmy3PjG_VLd)Iq%ll7oIY={VLWEi+_#q
zP9gs9qWU7-kJvQ&V%sl|kDMt8u@IDwB3)-xx*eEOI$Nd!e>`%#JVLT_=}PZdpGt?q
zFzZdNlszf}ZjFab*vL5n%j+3Pj6*??HP&2G#ZksMPhf1pDEQFtGZfa7BPuOh_*D*q
zVfo$3Zm)RO8B)U@76fC~f=ja5w4Mh}J=(&PsOG#i6}P4xw^@Gqun6V#so+~K9Vuj^
zng8qf%>chvnLcjN3?<gQd%{un8%=<_lt59Mbf7^^P00=2^DG_q|L|0b(A}5dw%%2Z
z>e7OAcFs)fhlZ7p<5r~Zp`*U>ag^B|h5AzG=4l1^VdYM6X20ND?VSVOlc?*W#{AOK
z93a(ztQGlk@<mP`K`A>^=6`m)7ZyQU@8i@QLaxaEYAd?Yqrfvw7f#i$<IiII@ec`f
z2Md3rHItwzGvG4e{W?UF;;jJ0*KeQ~a?{ps<4&qkIK`E%={`x0=}2duh9Pryt9G3-
zJ&T_A>bd^pHW-sExby(}EPma<wPln0<aP=hq$~Asn#4m7nJQn5=xLXgx5v?Z?Q?e-
zc1|VAQ2P)Sy=ubls%y#+0n=rh3`dySD!EKKi5+!|&BLV39tG>j_1gYUzU9mhWtI}!
zHk{JZ6QE)R1PM)s4B#-_u-fHJ8Ean$ku0iUGrRFag0ZYn<vhn0KgdQg`sS(x970Bt
z=-)YUJlvsS)C<gE>i#OA!i+uRUikdH%p4yjO#Kd`*gPeCQtM{GWLQaH1tv~RB>~Y(
z2ZFf^WS`(q3uVLY&Gy~p`xqDz8S>9>csPvMO|p#}zlwyC|HjVd{m%O^j)L($oxqYn
ze+5ZKxc$?bw@<$3wrh5!bGCq+5(BJ67(i&cz$^h81JSESY(<5H3_~$6>@hKI6m0+B
zem&O&<39+1VYx^{)Ozn`JUZy(IL>Us)DGFpsorpW^4mk9Vdqkdt$oqz?G}EPF+b+7
z^A~2jp-rnIAT|Me5))0k<$$#J&^rFhXt3Oqu{eEMg2=X-bA>st0<b4R5J@6LEk{oc
zlM_>BcD(hE>(ueoD%AK}B?Qr?f-S5C4=qPud!H%zUqLIKRnt?H!FXZz`;3A{WgTbo
z<}Y5>deMEGToc#QdU43s52w{k4tc0!ny*L8nRZHpG?k(6WhDPdhk$~9rDRB90zYdu
zsoX0hKsNdmTuJzbJ+?`ed3K{Ee%G+1;~|>*%~Q{wmMig88n?Pr#A)tyxXM?GtOl&#
z&7et^n)B0$3)O}3=@$|0<FVTWD~!JNO9zT24%f6$^R$}EL&0eWboZZO#YH%|jaK%>
zXKwHE^LgMeM|}DXVFyRMO76U<i>{-J#S<{QQqr4x#S{n_)VGzV1PXB2cONBtp4S$i
z)h|-lW_HI>V@*v>`Gka8LD(Ynf^7!OZ~&~<2DT6c5FbCkB0y}|^t@l#X9PyQ3l`T{
z;iEj|omsNq&cvH!pKSeWGs&Sm2hH$O&#ZPEUI+pzEMRhsyW3Gbb+P+6xx4#1yJSh@
z^4IY_v)Ha8cQDj8`W_8NSW$hNFUR`M{WEPW9pDn`R_mlXRv80i*wGrrOW*p+2lsEs
zn-B-r%yEAkFpDTOIyfPtjmjs!&Gd#ir>2~Toap(!;^afv;|CaNe{(z?#1VByJs6Wt
z`30_T{gi0%Ij)6;oAY|_xm;KnLgUuw9yz-PbX>$8T`~UN_PDWXKHrqd28sKUw(g%a
zI`-=w1-pc3eT?e@KK-aCsE|XYCia~5yrWq7XuH;z{irnFX`N21G6}IQeC}mull>=g
z#VUV^ynS=Eapy#Vk<gyH10?l=g^VjQYHL{lim^HN#lH)T-38w0g1)0EIT<9gSxb{5
zVc!H+KWC75wFCx!sijocW8W13pr|eQ;T2jT0OjkIgHg1o@hK&&5;*Jc4(yx1IJzsC
zs5h|Y%eYWyDmX90bFFuCv1b-N6%rzVW!)Nthqy}U!FJo4HzLrGA!it^+T<B&zf%yM
zvdKS&r8Dn0f{p}pg}*iUj2f%1!C{Z<Apg(s3W>n|pK!wBn;-Tc5rFBdmutz@b0lUk
z2e+4wkhCw>Q|#J)M9j4Z-4@V;LQ@o1p+|s=1`v#juCC(RIy%l%-b)rBqjyKsI-pz*
z5R<g{XfF_sfGkpiX@p+@s?KVkzuaQCwOX)S5(zz>e|q~X9T?{V&39dQ<#|ci=VzNL
z_p?@6h8~5=V^eD%zg6@7)EYWv1zq^wf`!&1_w-$fRISr%soeu&v8ea^>W?ed30v;f
zZLXrGjBpSzvVHg9DW10)@-YtVdx6q8<QH8e9q!w_SE~m@>=$6ZGh;Oao+y~R6=|+@
zQh6V~?n8Lk!J0`b=%V<(ZvqL$2X?GW(A|!+_L)v<u(6WF{6q*WEi*tfq4;m()Jag1
z{NFkkNpGZ+Pl7FM<d>x{D}Q!vQ9N-3Fj`LgZps0o3V_B{FQqku*vhclHLkENr;fkS
ztpI60I=ixw#;+cUgYLITaP5+bGu4_oUiPgwOmrV_l7cMXki*Gcj#SxBSiarL-go&A
z15wld#q2hbVcZGdil5d}n#=p+FfPy=+ZUls*3&q*MJ~*|N+Wwe1Cb~feOMULzx8}N
zjjwAcUwjR2TV!;<R0aBB+-P@tjmGXBP2iVnCYwcXkQv#C<z*j&aniOCgn`CSX_{2_
zC5N<1XQ!;EU?;x%3c*O-XH*hK&(r<K<h0@DKAiWXhlneF*?64(K~KgJ+03EIJ`sW5
z-;g(omjM$p6K$2t2F`HAa8Zdacg{<c2$}mxG2`2{4JpCa2Z=JF-aceDjNSB*Fbn$G
z4P#ATk$*gW{zh!mPM30`Coi_u2>nCzuuH<Pvu-jbFcIY_;k+0&Rz`zx1eY7gL#8B*
zNBY3tn!*#t+KhWr|D@8MuCa)h)_@=*^tHP@MWK&KG2Y%IV8Cj_xUz~ICgb-ue-}G`
zW-J~W8>sUcDo5p}p-N+nPCgCZZ+~X(kAh7r;YfoEw##ZnomM3CJ3UM&;>3GS#9)0r
z8T_Z?xffKv(&XmfYxi<QxyS4k>a)o93EXOj<dNkdNBI7uz{r@#hhMv1hx*yTH(-V5
zPQH|_n5atf5c$=3vIfgLPEcF&AsnmrLKa5y5Rupa=QrK2t%m9DjTD}K_fRa}%sNGo
zTHVKhQG1J<viq{hZPi?FdJU`w^y9r^B$rmnWQFi6_H_x52Dq$51RY%vY2@fo#^~f#
zD%>K(oU?cTJAKE8Sr1RK2+g<ONYU-mI2K`Ia8&AQZYcaZXq9t-8(ft(kChCJQTJf)
zb#J*v-l8eKoSj}WE~Z~)mU3-A(<8F=yyO$j+FKs%KN4{K{Ug{mX<{m^@~#^uyD<as
zG$Rt7*%gz9E!*(8Aii=PUs^?~eBqgQ^uy*`ram-N{MHSYh411cQEIu~KKy4&Hnl@@
z<tTn%Got(U$e|iOK4QWIHn?ZicV!O9zY{-KbqTA<yY^(hLgv8Nt*ahithJciK=Hzd
zQ0)cF1J0SxS4WYtUNf&7eB=v_iTX7uFc~Tw8*Mn}!T1UffwWKGwoVnyKVh9@dk_*U
zfv<~3&cyEdDcC5nWoRL6<oX|4;~4>|i4@Gjq#~ttCkb)&8I9B%(4(?{8OD7s;lK<2
zy}9Cxq&pi6x}6k5!GL|^fSgenPDe+Yp}|x;px!PjN&h<XX;S^#j|wQ7SIN`FEC@>_
zgH7APOBD(PdLJgu*)ooNB>J1vJH7q}7jok7n<iNW={}d0F@Fhtytn&8<XD_4;qP{F
z){rK3*f<LgO@K*pGogG&S{PJyWe83cfaG8&T52+st$SDZDVdC;y-w$EkkT_(W7b{B
zn*#GZezW}w{9=HS+B(95J}{@aJHY(0^_xij>*M>YyC6cXb*IhDzJ?-8`CQ93b`?$)
z^Bd+iK-y+Wy?q4R58j=jYZYEPr;r}Ac4$u<1{dJHw}f_r`s_-lbJwFBmkJc%22oh;
zOV51G$Tj&!W|UEky|14H=1n7QCf5ATH@>fo8T8?t$^*A`Vcpv~+z<32c)t#@0o%FW
zAwRdt0&Kr*WGG#o4(AU8AM^4Pw>DhJ<dElbfB%<IC8+JOkFX`*k9lwK3>V5Z)suNG
z6iq!Y3GtJ*cQC>^?IgT|@||Y?yCL@+U#e3%-w(u#hY@k_I1QhBLa!W!+-kWzA^&Ft
zf1-z6JT8YJ_#)8N^U$Zeg^nq)oHOtJ*E~kND}Idk1zbLL-^qa|C+HGK)%~pWldy+F
z&l;wNw#ox%;r)6bz-&j6kwR76iThd$!*su?XOEp5L21zjia1yu=%|jSs&VCCe7j%F
zm!AFR`|c?uKdQgr|AeUOL{dPG-Y7anT_yYvSsKv@>>+IlNHv>@@uT>~G-iHF&BH3(
z#9_;YPFM6@Ak&+#<h7gY*S=*z<u1TkxMGhm@^}0EQgPVgge$hora*@xfaSf_!3Z+r
zK@YZWHWtCS$pMY`LLYACTe`1lKl|^h*hlP#9%H6nt=%eri<my0T*|3w`5?|9Ncu)I
zaqq@x&?g}NWKeJv!S}h56HI?t&{L1UKaQ>=799T}-#73KOof|iSirkIfI@0tx{JJa
zhX5a|hHQb(do-wCr4QFznODf%m-HR|^-ftE@zmTXIcgDJTtUP8w?=DdkUUyFFf!t2
z95p)$PMR`K=4H5<5)OzQ_h;vtZ)&W~w;U??e|+HW$+R^=ma<AGT!oI%fNaiRPfnjj
zELE`9bGe=&tt##Rs&FL#t0+I7ht!+0E8pmy>;TgPtua?a5xm&w5_VK4dBpIP_Qbn=
z7rh`n9WzTR+<k+S9t&|4A@_#}dHS>Hfv#F&;R5jrTeUmLx1JX<<|tf>eeuH~Qp9tb
zr=7+H=4EracvgOYw@I(QGJ*5u#h2tC&4T8n6i2n!g#B(PLVh0aoL_+Xdn^BUgRAN%
z4j!f8ZZC=7%_VeEHT)c@sV#iO@P6AH*(LWJ4;UREB+$rV2{4}Gw)&PoVGGm22PW&U
zKS%Ugtg9qaqt{^>KIU8P9%Lszw!~}UL*meFG!5c*uGh2zSIj!9SmKHawAg3!I}Pio
zhYMlL*k-Irzxi%5<~^lGZAih=uCakk5_*dlxh5h@S)5x<IflDhHO*_nIWs~w^Zh~c
zVg3Y(-#=H}=Y-&Zv(LciL;&=)t=VYoQ^K}0#^m#WK-O4dVj#^AJn-}G-|u>VFt<ww
zu*sjt&d4xoA-O6bd*7caKKtQAcf6tKTYu`uV4PY<7x+|{^zq$456wsfBeHHHWitpc
z3-`zU*<O$_m>^r1pn*=@2zyETK`rxXiM2EqdWk}GUBmi!zM?^%*z^}7G5U2q(k^O~
zoD$AlJk1`mkinKHjeK;wA>(zbV<pH#G6Zl|QruX~BhVAXXz-!FAVx!Xt`Qb`$DR#n
ze<SqTby+-A<whJW9eWDi*I=%>pA}qit(>^(^x3p8$tBLf|L&PNOYz?9?l3IhVO8Z`
zB}^a~^WooYIPsfH%{eyhz^4hEREyCT1RS!+wPmQn`xyc;5*jG&&Uy<Z9y4@_J6z-}
z4Ln|x&h)DV*2pw!RX2MmtbsAoc2u85<;05AX~`;^?fDEJ^y&+;Vi8ZidnRpCthb3U
zQil<vH#FXM^i4K;h)5UKLP0eFsh_W6jy2cL4;~QFUmresNU$a{@EV%${gSuaF^-dx
zkl!ark3e6yUvlEUarOcJ=gzs^OncF{0Vh3esro|~G!w?Xfn$VJ@rD@g!TDU>iWIdA
za2MQG(9#}$X5R@v6oHOTrw5oy!gNpGz7jX$p?yNfV;m`Sy#U@nl{3qUdGJfdr2M6{
zNl!gi^`olt`nqH{LnVTJx+SFf;3nO5n1N@qo<s;LO~3ua`_yOXHZS@YQ~3K%?QfNE
zHi|CKUpYhG+VY#f7Ez}+S<k~JZKA9!RjBNQGb$g6?!c+kY))TSKhUdLpB6VK(WfTH
zxI)#gU$tP*3(n++b|Wg@-Z-DRM@^jGMK;3oqGNVg;nwd1evTMg^Ip|C!vG4Gw%rbb
zHGk6`mU90U-v6!(*W4f;QX+ve^+_0h_uYl!(McM<o&QHv>zjy8(T7sO!E<&N8BtRE
z!3(;`pX=4cNNC5T?B(oHfYn4dPet~9=E$L8ajWQCDa%@)M|9z7ujnbj*h9F64w-_g
zTKbJk<&2q!JXF<{1d~~C-<8)S{8KmkW+^xV3S|YK(qYYZAaCKv`?O2#mcIh;4i}$H
zE3BV<ml~ofrc750m{s8rTBvZ93K9Elw9kZqcOm|96Hz%SBrz55jn7qk23|konTZI1
zxt>F`W{eXh!nH()b4)`Xq00;x7sn1JT>yrGoY`^R$$0%;>|_qkR`v+uJv>eQGDawy
z<IRTuDI0lYWp9z8VMv^;zsn5r9qKyD6Lf*lH>%?93*La0c%77RT|osr!~vg|@hZzh
z0Tr&2`)!M!YD%<N53(7rh;Dc<%^{TQ@A!6&bcNaDDYrAzXQ<2od)&PCq76Bn&X8n}
z7jH-dE2t0EA+YKmU9H*tabaSugs8AI=A)lf4kPrS5YCq6W#|@ogKAI_{vvI2ge`MX
z7T^6|-$;svl3iF+68|{vKGB!@o^w0>VnlNcwy~^yjvI;}jRNmQ{EFvW7`b_3K&%aH
zlB~IgQzL_Z)0aQpkFquos#d!4Q&*xApbz$$dzP22vx*9m3RI}DQU$(5{d(fdSF};d
zV(-jYl6XcLKc~slV`USQWfIB-VNJY{5PizEW>*M?rXjz&Sb7pjidL4ySZ1D36u7OS
zm2pD3hGE({1lp>{=dx<BWXUd%beXg?Bxe1^vuW9bH|_jauvuLrXZC%E^%5D55$OD1
zsuO;T2zvr6vC_17>=Mvr4I!7n^}Z8zGN1qM*lsZGd0mwhD=<}Ey$A2tC))ZF%?k#>
zRZebSP0i9JxyZj+zTz1d9J^Eg(`fnOcw-B46UJDir~Jjq{9QXMF66$P54p_^&y|AK
ztF6HKa-M@6krdxRc@a2GNlOg#o4|`};;R8RFs!F6K+u`7hP;e2bN)R1>m4_>JB1El
zRc5eUu{v8_=P4S~WP4`IMs_$v+V&nV*}3c8`-Vq_<rG?WieFlcaUw;VA)B0ef5JZy
z2~JPvLH|T4djCSNp{sTm`w;mSuz||~*J8<a@<(Gw8G1YD{>OFY2!y)E8WOrx-YPQ+
zUAa$+s1(~C5-8yAR6b<D5O6ui3pRZDmUCI{<7q=v;?vFD0Bf$Y2dwCaWh6Kgu+>ud
z;et>mXNNH)!1!1v1~UjU{-vqrpmWtR2Q_dOqV`=eae%0W@58m&&I$ZbFkb;EK0)SH
zb)*fVcvoe5c$k5LqrCvZ7cR-xyGK{waEnyS`@CU!2u7=7Ou-?I4Z2{U4TP>0JXO)G
zp(vpi=w^LGisOM&{Hd_9MIwQG@W{3&m{dv{^jcgc>Y1#=fz~JGYmAO^(84^onni>Y
z{EC@ykjwBcge|GhFSrZr!4=m@czbe_XLMEI?`YoL8Q_7@U+H(c`fthA4t9lCkrYOB
zE9U-p2TM27f6wpwx&0;@63%&a341<|hviR3s{dGUSwpoGV4eu2T>nG*fPf>WyZ+7O
zhIh|_-z{aSNHhyU#^w0V%9B;-SR2;uJd7$Xr5E);y!^TEeTDeH8xhP9(9ND=VLxq&
zg4G<oOawu!5Wq{!q{7N95%fzaZa_aKCD9TTF`-zw2e9~rblPa{ADfxQj1T=5?IEr<
z@c#-jVEtF1ozsSV{%$?$pskQVQ#!1Z5-nU+m-L^&-Kz#s`M5Ur+hR^cT2v#0G0AS2
zme&1P6>jkZQm08&ac=8de6n=sNwumFQd?DwbFVqT-`HG=6|G5jZGN^&01ktTz_+c*
zSV9lrZe*}s{FCtJ+M2MIxR+pcmD)PrAf4Dgf3X~uX@5Uo@?FUyRhQ{^zbqjJLH_st
zfnF$>LPc7zeNk#^H1#u>-@DFh_WmAFU4R8}@K}6*N%G^W4x){8fiY=e0o7$^sX~;R
zw%Fg@x<?=k?b?i01cP(}A2b`J4yoqivb2=v-(;QBzjPZcK0s^1pIM!mw?CMIZ^$m1
zv{($I`c)W{C9(IJH>wB3)G~{EwB=`%@wXq66+yH}Uxt2L>aYfijKs>-0ytxFdY52&
ztr7u8&}Hz&4kCL<yB%8;GZ&zsYXxwNacn0GLb(Hj)*yO?>}9n$$<m0}HY2FrbrT1J
zI^-KA+&Tl%$PK*>s6wxpRGUPeva0YE3ZUqGC}FW-;@NkK{j2-*H@3mQf3Ud!M(I}l
z-6xf7GGuZZWx>ylh|{6hzA^SGde8=CkMz7jJ8t2YLR%iz*BEX~-K31GWoH$^Iq4Dq
z`~^?+Tll`j;fdFdgxo*kSD^`p7%y6^{35=SsV33i;V(r=t>%MdH*Bz8g>mldAm(a_
ztQ_HWNaK<6Xx@Li1DP@|K#ACWexg-|<s_s7CvGKG`<mXrFYM*0zt@&UEV7;2(wwNA
zE_Fp@J{mh;_0EISs|@@-KXdabEI;}-?IuG@)S*;70Rl!=y)Y5@-G8ElF*<g_fl9^I
zo{_(O>l9+sWy-@A{=hbxanrKM+6qW&N1@1eTir9keoSS9Y}`W_%^V}v$fVAai|q&x
zD<=s<8#OvT6k%14vhmKjzj+g~tD^MsWGX(mxzzp~L54qmnfpleH;fnuHcEqV5B$tY
z+QFMjQ<5YoYQG)!FPmJ$mEUO%<q@!0RJZ9UnPkWVb;7PrT;vxXZ}HPZ#e0vl%f(zo
zfuwb!pg;!F8?I_sjq?Jer;s!IKW)~89aTVP%~+W9Pm&ZRY}YX3oB9k{s7=2K^5iul
z`Ik2Y6%WWV@jMKiwG1x!+s`UXBxW6?302z?{NkvVCFe{YY|IPLQ5ENG4DW(x{elMU
zY(rQCWWkc$7#!$*nNj#O3(V5>d`H$BDO1_=tT!{K2{`I!zR;0@gC;)|FFwn=w%;F`
zmiyVMF(;f{bIwv9aMq4#;8W);P<*t;ZYvCFf<ixsDOX+WUOQ%V1fh%)omi{#7ZMKc
zjmO!0Bf39{K~(eAy*5QBM!GlM$~d4Z)RVsLZ*VdR(ffQ9eb+HBWd6;2&0ctMJ4Q8k
z>gqN4HVEU{W19ZhcG0dC)0Rea+sZ0*{#B29O@gBzKJieu{B#Y;>8*bhfIcKu)bL4R
zL}f$sS2}Nda$*u1J$kNr-eP!+G=l!1Hh}Zd9sPuSHFg>JR;#f+_3NJrd;OMPG&n8d
zo!4BT$@zNKV<z~91AM=sXQQva^`Km8AAV!Se)xkDE(me)2ok1SHu|zV$}wRc+ze-X
zMMCM<YZQ6v((6R_z@0*Qn=5Yr0?qnFGFw%kyW;_==s(oRSU#Vw-7x`X2~vHg8<xcL
zVz7KQUm9x`iSAbA`+5L}Jd9PX>a3Z^U-*?TEg9~<RvoKHPnN%&Z7LGS5w^R`pW#_Z
zLZSKlQ35}!t%-U0U{7rk2q<i^CxaE_E7k3*ogk-w;^Sv&^eHk)VpI5=Uau<IoN2M#
z<|X50CFilvbkyKhNyR5=O*nrp$U0cWVI1c~)ZZ?TtuePaiZo0Jv{*W-r&l8?Ubq3p
ze=wiQNa476Cf5MVG;2Fw-E%d3200^co~{H|F6nS15SHFEpCK_S*K=~2<qln1u;xaJ
zN$R9sdn<4=ZXX!acmuDh`Z`0ll<-exZv2)H1#B!{8D7HD$(Sr<I_GoF#8>=ys4tD>
zsVm62TTGGh@Cl8lxBpdWVb+{zX&7wSj^6<>!y`HaMoE!jb$Hs5TX8aRc8_JzxQ065
zZk!7w^E{cRbM%0|=ELDHT#SqbQ;pnlwg2zDRC#LbH{F*&x?uFdnu?U3lsY=&tDS?h
zp~OCDe@Uw4Kkx0GEioGa9eBRs1mV(l9{pp~FiTr`pRo7AYr%Nv?|k63Hl;jgQ|>QX
z#6u=B`rcShYV42)=a>8~IAru=?fvc#l;W6=e>W^q;CY^9n{p7mEm<(^T>=zFb-&Q{
zEEU`Z4ox--S1pqT=tr<dF$LJNNvLq$qPrvD_98Ww%T^Hf&$RJFWHUiV9+0HUncS)a
z+K0+Z)t}=Qg?CKQYD967XYsq>{PkNnL(}C9ZV#<r8~CD~8T%BaImBusgrR+&61SUF
zYnYF_J#FDi!&*X$69uXAOh<(4jOl*6mJ*v*ZA(MBR0#G96to2a?I~_%!(7qjMw?A5
zC+|bltI?ONxd>bB)6+$5;AsH4zxLMF6}E%&m{+a?q#?0Sy3~n9@s!1M*xTHQ5~j6C
z^&8`KwvX==VATKKvZyHj!%&of7N|gg9Q3<gNnsfZrEN<Ho7JMpn5;kBW?d>`V@r_{
zxhlxuKN+1LfXQ%rBJw1}R`RL@BCH3_VH?3B=tq{CM=#29vBYef^v@7`;%}5--`9C&
zl@qrpLM}wbTY&Zq88b?y9tB`m&9Dlmp_4K7v|)G2*Q!VfM9-glOzT;oFf=B>Vz^L8
z>F*55(Y-b7#_b1`oGj%d6V2NAZ~d8verO93H(g|9Ih_rD;4i1JQi9G5HRj*+cVrkr
zjB)YOKKE(lu4$DfMb%}Z;Y{%?oxa<Yo4*;TCQKvmTbOsqk_lcz&Qi>j813gU6+Glp
zTKH6X8CT!&F)QNXFOkM?E7etJufgn*2CFps=ySKQlIu<}Eygx`U|k6s3-(v(v#@q7
zODr*d;Be<NKtu^(VLU-}0*m)OhK^s@9r^y4<(x_5IjIi^6i9lQRY1!I`&r`T4k^Z*
z#~B$>OBeN!h{Y@ROm-n;CPqe)ls$cH=6Ki29cl&(Su-9>O}k;-<7C12UakhqZEG-P
z_82aDWP~3EiO>zgFI#Gtu>87^l9V#|CSR>Wbfhr$F?AAT;Irm{x8BG%DlA&pLf!1;
z@R>Jvu@!N0Xuw6fBWCLtdE8vwwGi4gqGc13Zi0+qc--4x8gcwL?=Z^KTu_O57I;MC
z<8_G}^VOcWb6&i#@E=2l*jUk_wG9|><P3Ww<4`yQkL$}Nr(dO|qU6NnsPn{~b|4Zp
zVI`N|GzEn{EvZ}Lsk8s9ZX^a~OvR#G4*Tb>ifn~cqL@vH4S%V>9Of*I+d{pPaWJAz
zS+Wy@smVLPs1<R65=cjFJ5$!>`|i_Nq4r$2SHt+=({imF5AY4RrlE(OSncD0aYI`a
zOou>p7XIIjzx@~1(VpDH7EcByBrAY1S#dbb;&qSY#6{lmHmUBnPkkf1%ucxK=K~)Q
zPkZpFwlhTPWR~s|SO+VPg4LC!jvm|b<nNDMHDb7y8<UJp4T{s+o%<?p?=TCRqe>Pn
zTzL48Tz~%llgeC4gpJkA(x1aW(2wEy2W%O#MG4tjV}-m89-6%Gc4?U?K{Q3n^W1KK
z<WmEJ%FwaHpzj%}BIhPSN2CIeh^K;F3wsr6`784X$AU|U4)nDgSD*k%`pv#zSA=@&
z-b~`ppPg7T-tT12@S)832^V*uuoHTTo3g@cs?QSW-fc$6u!;SbpMY+;t0qc{$Ad##
z)t&O+b>n|>QB?~_6uy_0`^07A8LYk*acGy5P*vQ67#g=PB2hVK$E1T99;u=UF*;@#
zPQ{P!`;yBB(V9{~9m^w|f*-*HWJ>bD9;37XMPxZrV9u*G(0eyvxs^x{Vd)_*Do41M
zQGz+VUxk=4F8Wmhcn)B9o|p7wehUc%Nqnd80a#5aZIm$49>xJBybWC(nR`K&m%YMB
zxPc;~f^?ZTqd)PQqFNpo!=qnO2xp8U?fkHl>3b<NEmD+-Bzx=1?P@Gf7`=8&#)bD9
zk`f3GDE)I~y)BvG5~0JY7$(5_vTwZ!<f7JQ`Is*C`h+He<Sv2e%o=@;`t0yx!cbEL
z8Bx-JEphU};G7D9i_0g)sQa(RCJ?iq?SfK9`MO#YhHwN?g+0|Bugt}54X&Yyiu2O;
z^k`_)P}dWmr%2uUXMtJzvpi<sQz;jW4V*z@5--C>gh>7a!0|j33=Wi@6@X?9lyR?7
z#$JI>c!$_6f7!QE$`1CdT!Ss6{@%gtJC2@hrj_CI*}Xy+=AP38x;mmZWKWF}?*`xi
zzTfF0mxL9>i;UM(GBY@htEZSsJo9M101kl;#1*mqCQbR3tjeAZ=^-j7{bXc@6|t0j
zZ1DST!qp@fjUdvJ_zGF&SRM5D6ubLog(xDe%pmJqC@cO-`R6F_@-z#$K~A|e-Pmn|
z);mSbH>d!5I@+SLP&M@kzFESM)O<UQw+){>31l1p0BQ4?jdTf;{@cD&k{m!RL6VKA
zo^9J&3qkx9>oh42Da43>9}peyT>PKLZf+cJzeM!_y#*58Q{DG=l(xUtB=!$Vc~o-Z
z`hwk0L{%87-n}P;A(jMZM&b?uZ0TAaLHm>TD<D2CTt@<UDo1XDY{K=JGUX+I@Ay}}
z=LQa}=x3y1R$fDn`J9-$kN|Ck2%(|!(<5)$5N!2HlF{R7V*L>7W04G<R^_MHh+f3)
z)aUzms*Whxkmg*4&zcZ7sc0<TK1n}oWj^0)bpP?L5&10>B~>C(ybJqwsvxq#PGune
zv=ZJghFog`a#4x?*hc6$Eb2ZYQLqO#cGWiKX~!KwOl5)f{y5QV1aWawjO(LsC)4u1
zW9Msr@zE`jeO9gPjeka5UmM}594>6upxnY6q&zaIoTi9*-usatBC~)5=K+?lx+-Tk
zXtEozNP+PXrO4>STvp`nV{nZp;-f_P0we`2?Ak$Wc6eKO)U}Z_A^hX}p*4;F3U?qO
zo0JYPpAqBj*FUAkf>qCfzb0Tg8`n$Jfy@Yv6A#r7^Y~q|I*;0LfePxN)pxHtl{Y3-
z7NQKBCO&;s;;=||Tq2_lZjzvW{O3BFj(Tja#vLL`22>EH28{hP=9q8&B1NZl%OaW8
z!V|Fht2!{^S>{XFmN>O1H|8EA^5|Jo)+a=wLIa1{zPwug5`GP9RsP}W+MsgYBg?Vk
z+b2Zes341+7_%ytu#hmmJy^cW6^HSG)R*WI^BWl3^|+l<yJ1nl;pYNd7QjDH_1+1l
zn%hk-9^HHGieik(b9Mr|gAd^u5HPda2j0RCk<M7uulHRhOE=lPIy5keJUwW~eOK^x
z&{*%HrHYZD4vRZKbV_}<N}=x$!3>G36u(b#xlWo$2RBSnOq4bH!j$=vi=)DO-ZhY&
zl_XpxDsCNst-TV!1Pt(uq}KO2S_Gu##8&z*zHHszRprDqkza+vIVscq;#mq5Ra0F*
zyPuD^fwbX;rF`>&cN*z8!>{Kb<YY&y!>>Db&Ump`IOXwu<GKU^gjMrnY9Mlyjc}yG
zHnLQ>#{&jxl1WlIfeIo7r&clEota=_dmtpBE816`a<(<8Q$g4jW3E1AhP_S{SK~kM
zMM6J2Z)*1{fhRz$z^C^guy?U&mj*7tT?FZ85>gE3X4mm>`PxQ@)HGH<mZVC0Q7Er>
zFPAQ=)sChsO$kT-(>LYO+IKZmzlu^U8G~y;-&oF}K-1Z*9f&<(hSc8@T~qgNO**~l
z#$~breJz{1)*sG^0$mRs&Aa%v$E}J^+uTeHU)o}GznNzh1(+}Xt6~9xppB;ta|N<e
zSOD|fHllY~@W%euK9sy7{IfnOqoK+*!i%_S<)b_DUF~GlI8|{yLiAo%yV%4$+<78)
zwA#%ceP&THPyi*;1v*uV@Juc~e@A}*&nT~#gXzoIH@Pn{*9hbF5djBMTE{n2?DL{9
zf3_yA3!5wI_o4X?wI=WE%HKR}^QBK=CtOr%_@uvac*&8Orux#hM^#p0h&Bfgh13Kz
zobwhzvd5Jgg*87Q1ZB#2XfV5;!06A{QJzUs*D@avip|f`;pV<g>Q7IK`Z7W@DX$3=
zCEaT#a&?}xOo?lxnurSYcoR`dUl2%wmS7=;1X0SA==+wi46Ra;yU%P2{3$Xn6U8-9
zxF@<37O2sxzn#9?UUD-yj|C_sZ8pX7wqsXM*6S^Qj!#GhOyoN2myCZa$UoCK^2B`#
z9j)kMBYGQvD^y&O#04bXD&JT1<*wN?gpOySomJX*GbX>gS<$AKwMx?`A6#q8;1TG2
zw9=)#JaLAAr+lS$5U!^*_{X?4H$3@(iUb+_bBOFcc)zfL_Y0Z#A(9Hr;iZGWhylG;
z;5N0Fm2q{Ke?0(lfXt_&ItZMb-Z0zaf)ZE+0&R16`rl<bz?vU^wKJ!R7L*kEC5&8a
zgRRB0NU15VglDy)_jNrKgvYCeBEW@#0F)>v@!>St_kv4U;?LP<C{G?b_~@_XUlps?
zGubI4XW<G~u0|*ksPH6lVMEW3$jrQD2QDd(3$j!rmx%$w)B||GCV?n!hlK8@Z@cSF
zq8gxDaXe$J>Dz^>!N_09-0c$SpwT0$OLKqZ$mln^b<Wvm!N$BLuI*{Xi~;LOmJ<k{
z&$qc6Ca+}I=`9aR$C9`jpLNBDO0p{9u)9)K&+`zBb|^+k@>eipHjGeLPuIN&CD4-r
zD55P@DRSK^?^E_ggsG93Ddn}Uk>98K4?w{C(3x}DQGB_=#Umwov*A}0&2EE#6iMG8
z*UYzeyV#{3<Rib%Li;m|w+x4qG`P2FBYsBK$dvOLROTh@ON=W_Q(NkWdmIXlJ31yG
zJZ-4wu)S2%BbRHQq)2A>GFh12=c4d39e=uH04is8c6MqN0y$oO1ju{B1OkA>n&<Xr
zOL7B1j;K44jbB29{i<?F6%_g&X>mkkm1{<U&rFY4N|l*t*qR+q@s)s#!xb{k&)b3z
z#Z^2O5?wj~VAJirO<}A$e^qzr<91gX?ftf5*TCsFRlV&IF0<gp%9xK>?jn}*1ZKVB
z4YtM8FWK0<X*UlMabBq5@O_V$gj>loUK@n1m)t4WV%hP_@}x<oN6UZi=6|<^HHY6V
z4X(@934E$BomWcTZiZDhgoM2qleg~y0mthxS{e(wJY_(CAI*i^9Dp3X01Y`~xaLdo
zl`tyY2|l_r>Xp*$C@YBJT>EH(ldMcK9xn&({!{xsvHwW!+B2z24CWO!*#!*jGe2Qv
zH(%ML9~n)-dE|jzLzvzq-}WCD1i!2_{Sbwfj(3h{^MQ7ru^K6`pzrIxwpDDIynQ4%
zTu3F2t%a^q!5CA7O|L+a>2406y6>_Onm9>{;yGu227teU3cZFT9`!Q(afJ~J^8Wg5
z@>qJK>6qn30k#p)_QCQ?u517a{LUZs;d4cWE4E{4u%IHL9h3}enV3XffWQG@`f%Mb
zAQF^x?j7ueDc;e$<~mBMT^sfHwZSd!%OJLp`fQ`|(;PVni8uZhacIt)78{<eh*VR`
zdw5IX;l??P%@tw=G0bKrc#I~I%cqhPZd*SYvkZz1UJ$;m?Ljg4$ObWk+XZrPSMHe;
zI*hh6GltT<X&Y+pF=iamA!Y<Sh``2le7o}+0f^xc84!pnl2H*RLh~B$t`qdh?vepo
zu@nC6VD62+S>wNzU!a}h>P3UGS<3dMprS!{(IlbC_J_8BRaN+|@h8nAe|NGZxm_U&
z-SR7Dd2J0v=^<|zzJK}dn(Dmz0~S?67YM-Bc~oSk#3RwhE$uFQxzPNd!Tcu{x)00f
z0$bD_9^oi3(qM*zPv!Z(sr0OV5#~dK9Z=SSevB_02rA1UHK^o8IS4Wap0)sp9rjvb
z6};hOa#Ix0hHF6^)P;R<3v_alfL4jkP3}vtf_(V9|9*v)$rPr%p$vvDK#w|(O^LP0
z{OWbT?#l@q=XYbW!j~dC<Mb~m5Q(bK)+rf9(^$}0y=6FVMF?Bie6n4YvhsjBO!CIV
z{AWVAq48f$F3V8LR_T7_ZY61QC>G%cIs)>-_z!B+_vGBKG_5P)ly5_AOW)2td00=P
zoM4}suwW-@35jL^+0p-Gt*IWAjknG=hi-$ys##DU)lzpb6&Zb5@(-w_OE+&nYgagj
zDN<e3VH;P1rrQ4%3WC}-sGkU#Jhg5)nd0H%6(jAknOCI3n)k5A90W*r)!b_*$nd)q
ztUN8{O+3PU9v$mu9yN=y$?matTY^4CJudYYQk9r(x;zUqSAt{{mNedDw~bMhY;YhL
zui2NIE`d>?KM4c2Cs%HBcs;Y2$cY$68P9^w8Iy3VDo+KKl3PvKOIW}#ZojDD2IYPk
z-@h|o6x>EctOa<}(b8f@uTQ%=du&cc18+ZQd($W$f6>nBIRol>aiB{h?80UXx+6g~
z7J26?M=#r7nJUDxdGem)y|&qYbA}nvHleuQl}I5BS^cz=zDwba?HtfpF7vpoHOZXC
z({GYbLdx@LqOlp*?oW&ey#me(Nb3g)`EY|FrQjMPP*Tm)kT#P!nC!NAox<%p@3--Y
z^|XUsdiY{>P>EsM^g$ybL%)zU&{msJ2z4k;-k;faxUd!UlaQB>xsO}}C4@x{=ieW+
zgNoCOUbG8*_2uyJ3iFqsH}nF^zTHCeU?wY4xCvC)ZXd4}SpmZ^r~p;F1A-A-11Wai
z9!&C!kP9toqkp=reursk2hwAjlTuXdz5k*nJ#~A|RFL8l-Z?Wv(~<^0(MT}UxrgnX
zIZ6h25N(1r62LiZKUKhLy3WkXnwz2n)Np%}N2LagrRCic15MO2`oqyscN%H;*%hZ&
zaSOvmZ0i{5Cy>krRbb$9ByQZeV6)yI_uQBWm-F2}^sjw$P5;lgF5zbGBooU@e^9;-
z(90g<kr5GbplfY?yzX>ClZ=`9mO%|&wEFCe4g1f<q`1fEYd2FplAm49)aH70=}l<P
z%GGy`71-@ZP*Z1G8!6F0R`gNj#sQ6rvEn^|$s3iD(x>3SC@c*zycB{~Y`HA$X>@*6
ze4h$MIXx&WRDzj!QHr{lEe}h@mCz4dAate}wW2dXV|uv4=`3ZkwCktI{l9;o%kFes
z5eB=gDPYfC8?U6S@!a(A$uBIVV2&mvAtCV?|MlzFL;WTBMw6o9@jdRfWemwK$Q!6;
z?>;6rpY0=GWDIibC~|kd#{h8%Nx*p$`16<aJS3H1I2LM3PA)c5=u;t27{#WyWf}7a
zADWm!QNTUSqxkE}={BfLfXmW+Iojn+n@z8D)NCxueg=PgDqZOL(;aPZG5q6m41p}m
zuj#&Wr4(Xr$W{Le=4Z*tz?b5Vw4$iHud;GzKkYxywO!gt7P4NG+OGC!XX@bF=?ne#
zoIx-r#e(fXXNh&pHj|J;mAm<|1j0uAj3S=u&+f=lT@G281_s}!`%vEhkzX)ic2oD-
zYHm(LG+4D*w$?;`ozw~t!eRnH>>WvgHqwh4_hO4?!rQ8Zqsp3XU-j}pXo*tF-n`+3
zTvpc0K9RBF#!#dm*HycbV%W)hB&7aSL(ZVIt(~3^=F<Ca?hcXDmhR1;<L(`BC$~+B
zM7@y!2U<dI2sTM54rP3s=NKAfB|fYrh&C33q3uJdeQRsm%Jy};;TWlZ{6ofz*F!r4
z`TXS;VWRvu3`#8$9@uW}xypSlWNL-Js_!dX4{%<_4Mf<azAf;59!ek$#jKA7{aTnp
zdD?s!dvyaMx;FNZdhtL?_oLfaXJM#$o7^DRXnn9-vV2a|2C;lY4U^Dp%lx-N`H!!F
zGYqowC;85GJ&p`B9Z&PQfa1(oVX(;E{8EhV<gZ^eJ637-WPC6XZ3sL*_5r(wG5ex|
zf?)N96YYbI$;glpLK(4V5-BC175Vg{$`Z8jU;xB>Xvk&>J~TXh<x2C}MDPEdWkJdI
zwE!q8NF0H3o3!x>HLe@r$(k&DJ~K~3yY$3zAd6%wodx-0I30cqyDct){S!nXRZL_R
z`Xu|XR>kAQe`p8s;~sN?0{-c_$viL7d3&&B7c7IcgHfI>l3sYHwseIn>_I(oK_*?2
zX79`7h12$AtvX7nAE{L;k+ST4;6W=cqW*kFT;2H)+Y6P!TE&HL4=|2<(_XG8@>p+4
zu6;~vdQ~Rii4bj#*-M~J*bx9(t8bbTVpLdiiRw}qUS%dkev0IfKd0r=v^TinN}Kod
zZRX)VpB8D$JgxCG;+T~ya}`qGP!9S+^ZqG4Te?fHNmwvL&>F2<!AXphnJru6<sabF
zl>(&(6Tl*WxK`Rn#oo8`acpetzlC;p@hGj!1q3-SN{>9oFPg1s>F8!b>y@g5gD|L#
ztUo`tHF5u~2Vq~ozND+GivgJlhuF*DZiNv)83x$q(D`PjuX9vUA97PJu>F6EK%ZK$
z$}^8xfRn!AQ9^}&lqGRGZ2BWbr}dMu+Bbgk4_dcUCAo*rci$wiAj-#-w?kr=^x8g3
zf9N79XJ!<mlse|u%^iXriGMf{EAB6&`mnZpbN9%VwQK5%ieqHCmkM2a&rmBEM&gwI
zdK5ibRluG(DjSwERBc~dd~eu|_N9}#|Cjh=j_mQ^a}G})tqOv_KQ;rq#VXowQ%n70
zgV18<?OIZ`pE&U{w?A}8B={I}l$CNZ>$zDPOr3BB6r994nb`Vl5*ko<SjEbP{P>}M
z5orU9WD5ZPhk=q@5GtGnRSyS8QY9rNjFJwilMTzuPeGr%73lH)f1)N$hos^4kLOB!
zF1ChGPV!9U9f0Xgjb<4euMe}O8Szh=o3Vq7a;v`Tz_hT>_)-(Mk5Sl^r_2R^0ek&b
z#K_e=xQElcY4j`c%l4}UBNQy>$&;I(E$YbWo^wcu|63*JCD5j@8Kpm2ryDo4h~%N?
ztFP@#a(@)3i@}T21yTjw1KY!H&}-HBifDT|JJu3Z!6x5w7f5??{OqD)7Sus=$_;}K
z(eTzthPkhKg-xl_u5t14fe+-5u6|tNI8J)&u(<W+W=-$j=goda#FbB#ez39{`fz!x
z63BNN>a}xy(ft_nyBwmq?=Xgg(BB5hn28lB(a`d~PBD2y@}vYC5!qyK>@Mky7Qo@y
z+1eGsqkj6*&xxA0{+6oxR<J+pa#n|}zbAo^>T^Y<2Ht5j@i5*OI<a$p;gvEOQ};Uh
z^OaQR{6ij~pb0Z+abmE0M>U||NBPABC`=wdV_{+nUrO_(=#x7z>F84-BOCKEP^j7A
zVNfFMhSh46AZP--V501>xAiQCo%O!(!$nRGVWO(tursUL$;b?dYpzZTD*;PhdE%&)
zbhrwsa+jF-h6pcaNYAGS|Av+IBHkWTJ-0O2RFE!Y!C9FXkCSvID-U@P9_~AjpH7up
zAXBdxCcNv)wMG1;EFl~?7M=;aLGbKSbhFz%E@>=s7KOME!Sk7`va;ZWul$wAz%Do|
z{n72z=(0QT;=19m3O2;0EW1DIv?_y@tMNj2;Ng;F6d=zQ2(mN>GG7hwVn<0a<<2f#
zu312Mxhs|l>?KiTuD7WSs8w`G`X5eK!nIN$G{o^Oopn;-sAB37?jsScz|3Ki-FQ%5
zpqM_ic}6yJE|Otz?C)Ih4@%6|g*EpQ+|Rcbe=p8^J=1p02F@F+tv6wL@B)Q>pQ`=R
zsTFJ&LB)F8MW*WFDS63(rX6K~r3XKkNI7x!ZZT9fjxFfZ0o|)SOQS7%_hP95pYN`~
z7ehPG?73h5*>%i^%RK1B;1#2;z^LttbXJuFA|fr&FX=-XHu~6=JsV`uVH{?cu!T*3
zhK4VNP!%h6#&q?~CgX`jsSBc@ZlAZjBab?#YC60yBP<e>9)~JuAeYR>j=1)!!ibAy
zaWuAuVJ8#DfoIx>o<Ci3heU(OyeTqxLT<K#x}tE{p2A$kxP!8yB8-`tnTn1s_=;K#
z=7N?jVgFu-IEkZnV9d%jt}A7|88^g)d(J;BNCkU(9bzxUSPVsNqrYE0Ho8B)xg>Qf
zS_VszfQH(soZ{fcl?2_IG^aFnwbAOK*I*q4){KDbwki1C1tMsar`#G@T037>!Kyd2
znIBRvlDYK06?2N&Qi>BF$9~fJ8AK0DUOo~0#~E(2r30FHCqV9ZW`BKrd*&4-7dJNn
zX)ql8S^D6~c2Ul4>{wUckffHX@*mn_fg;17^G@9jLSapA5@mlP%;1sdYw`oQUJW+P
zYlasO`x!B^|MvRH8H-x(_O@x8!=pxlD~68<Qr}QLrT`VKJN>0aPB6Z5t&%IL0J}T&
z#cctCR~+F!lvkWKSQ`4=`TG>JSY)S=UO<5vGw}EjJ&Ai?Gg8r1jaGV!`a{TCVhE;Y
z$`N3yQe}-ML6?q3jTr2+OMu_{=FOWB_Vm;b^b`ME`WaRl1-uO($>30LFoy}mgZfYr
zU5jaA0AwGaiBIAOA_dnHuig}Obf?0`Sp4en8n>dbz<{bs(4)zvOG^6@`L1T(5fG85
z0F`XUCglB75sC~y-%fqI==Y5D`)|Y#DA9gwG>I|ZQBP1n?q2(!%Dw`q%CGD9Ifrgg
zBm_wnlx~m|5e&dUk(3gU?vgr)fJ%u<r-Fh40@5KI1wk4_N?P!c(p~4S<Ny8M@4a`v
zxp%HJ&L}*wpS{;!d&O`4mY*lSMA9SVsd7!`^#LOj$mUJNp<;<-9fxJvWt|Zq+y_JT
zG@+LfbZV*DUv1UyIZyuOsL;qJiCPr5=_rvXhd64W7ipN@_I!9kq;P1k9DVV-8s%O8
z8AedN$gwM2JW-WVRnlCIwJMXrChe-_qxbHV9HBpC!Z-s;;rQO4*E0)Np~rVzMhI+y
zs{w($(?qsp<&xqY+Z$ejGHdpZ@i#@u;E=24WFTV{TI~OwB6ac@($04oU|D3KocCKz
z4j(Q$ZeBb9K`<wDq=HJmn3R+V=&4kfen;aG$qnKtKlDBAkEMUeQNYTjiU{%upcyRV
zxV#XHwvR3<BLT7)t>?Uohqgn~X?~+O9qS5mzdZRyd>S!kd`N7(KjD5?`Rj4!&ruh-
zc4@KZ&!bpBu&X2*&UT=tzI3&XUWjn%Iia#xl9vBXBO&sDA%h|SxBUzgc0d@RA&k(d
z&@^b{@G%3g^ZvF=Nl6Kpm{_*~g(kH)<o7ub*uN#x?vFJ-I}s<3Av9^L`EWG#+);xn
zn#bX$`g9v7&gGarY!q}O^%o+Zbu2sP{OzIuR9fEo$aL!Lne@(X6fxqU&_x@cZ>mZf
zsCXEPdE;W&RX$W+GV$={36h)(CvTouX@ZMxpJX$U(Yt(>_<1Oi&>QT_`8{7LYdZZG
zgZY!U=pS<BQ75pgKy^QKfvFFp8*;dI<qFS=Ou|IZaod39I`Vp=8WK$_zmp%cLR(fv
zoq^qe0?0-XcbRR^W!#GeY2hZN8kW?v8|+7e$|#3C?`X4&5Cg?{DD~p~-5xZl=|d4!
z*Ul;7j8e3$=7b6MZr%ex<(f8}>S%vWcJv`4h^N;pBK?-wH<l~so3N}i-dKty*;?Pa
zLT-)~Hzm%1-V?yMu(8W#>wfult2ug(He{g?Mr8hyv_8w6(&v;jP@G<Vn2D^55f7iF
zz`kVI93uIQL$?S78B?gxwP##V&$!5inOA-043Y3<3jtnxo<W96QFh8T=NDncZ@V5X
z@xN3#%v+Z0B^D!R5k=D@hx^mYlh*=wj~W;l?E0QjGvTJI?pvT5G}~c()^I-=QQ(!s
zkV*j2lq(a)IN%(nS@`|c7onG_o*jF*OkY^z+IK->=2`cd$g5OpNYxw(%OaB~MoT3-
z!gXvxmYeQ+j{dgSk1xylK!;*ZFOdPoI>3!G0q!-lrB@9IP<oyDCwFV}4^^rP7b&?b
zO7BF~R(XDM2<B+!k8jtD=$#XPP`=eVORuf-bBlCc4p>APt37(}KDvWm(-l2UWcuvU
zTMGtqdL^<hbJX0M#0DFS{XiuzWXPBtYN;@&1f*s~AQ|zvc<ab=@s?giDwPePbFT;p
zD<Q75=S!hxa@2}Ul>18Xy6hf1)|1FBZZ-1(N)d@=65ZJ4K$o4v@TPFO0ot?d%)>9I
zcQNB9uu#ZX(;U9&F)~&8ThesKTsTo6`#YP<%~Q@{d93aghEQ*1?K@`OaB9Ms=sbM`
zm$eE7c5kV!t}b3>UCJ2Li2IQ)4<yFrJZD^a(B-Fn8C)Ty9sEvnLHtke$FpPEBTpha
z8mLk-KLNB@vi+})SfYffE~@K`NzK;JAFz;3$M#8JoA6`_G%ANa*h|djIg3cO7AF}$
z(Y8|u$blSYf(fXl=+y>TughT?=o{t`N<{5+gDT=g^n(5kq3<{`3VJbg4MWpeth*AK
z?Cs+deIpI3*=hIXiS#1cq$1q9C6mH1P%gz(y!VA-5g|Q-KHNQj`Vf(R+HtIuY|sG*
zl$><mfHJN<WA8QjBQElXGe==gZ}Br;KO5_aX9%Va|9Tqn2@j_yU;z`d?$bcWzI$Jb
zZLzC3j*`pVrt>TnFK;a9O8PS2t3k{9RD8;8deUh|LTN=Lkm1}*ME?vhZ5`8>dhd=e
zYkW-isveD|nvFn6GNg!&Xy!E)?bujAg`cOlmM1z(ykCbu=v=ghCPAD5+bE~nozooN
z<3Rxi#~7sD9W>oh_9=II7oRac)Dz_S`M`&PoGn}T*^x+Sl5!dOc#!9hSV$yr^^_J}
zF};Rvf?NW2b>+xf5Kc$%)`GD8aY88^c2~K0PhTfN@59g5M<qrPPkF8b8sbSUrwJ_`
zimeJUmNyg$!B7AZC=G;Zg!Ml**bGGn?ps8hkY`$|!z(#f&AtuLgW-4&#eO5^@*=I~
zM3WWjSU(*6VwC%cUkWkRyTVv2PXe}o5mQiuUY3~ijpn>3#UHd>PlgY34*w+Tx?pzE
z9CZ|vZz)dJb^aFVFMzf@*V4XW0|kUgT5|JS56N`mn;Ju#^Ep=LTGvT+QPhPo7C+VE
zG6!xrh#>X)B%08uew_klYaz<5Lyio({dfe51d~fC?6bXSv_cWtKMb{y`oND4Q$n8|
znW~n<0wJ8;%g5J?egv5{=e@b^;}$JNcHPe2!m9##S<rl<{U#O5wb;_WE8{(7E&3YW
z4aw|m)u`g`H91tDwpG3V!r{W0c)XY|<=&teHBcpee~R+R+OnvIR)$CQ823I<CV<e8
z%M;y2Ha9naC0eJQ_bdymHEkHAD5#3mwxm5um)o~*S~vEtASl`it+d*XiYv!VFzRIo
zxo2KDg0T&L+4EKlZSKd2S$vE6R-}veB}ZvA4lVBeLNEG6QnbuSjt>tFNT<on@*_Um
zGF|(?8hHG1ZLpRdik}SHESS@aW~gGJgQ2He;6I(GUcY|546S9#Iq#?ws~Se5qVt44
zLmLp$Q=MP+L>AXwwuI~`-3H!op?IeUH-|Q<s~rju%?B#SCN^pi0c2v?hKuib6_={Y
zBh!apy1sHmT!AtFC>>JEy+&)wN-q#8<i?1hJe6FY>ty}PT3E%ndx+G2hpakqB7Gq5
zF7hq0!!dVrV5yTz1)Y!JzGVkFbLU3AUNHbE55}NQA?bdrm*r78*ZH3%B|S})u;vl#
zZa2Daj$MVuIyKd~XgEM?%FL_QXpP0m=uNrXFK`Y_qxv|ATgnCk7V|77uF;iT(NXa}
z<V2=UtDomaZrXB%YOo<k?P-$y88E=Crdc(8H)Pd@tA;E+x9}Zc`$yTaOKGN+-tR7A
zr+`DS_!L>;1b@a-2}S)+E-DpSxODM-B1rw?;^#2FJ9&EDV^_IU$<u3Y41S+{Kqg!^
zMazX{SGjSo*tA^P8lTc(umogbL^(IkJbS?sLTMvZpXs3@uP2<QYG!yLo(wf(Lt2;u
zOeyHxjNh-jZx2X{qf|nsuZ(ZnnoeI`I6Or+Amb6$O8m<$X!8n_v`7MxyUfsAudL{`
z8f_=YeV^U>DhQL+px=yXLHPkK)5=5`=Q#&FFj1}GlASi|pFTDn|58wu&&;!Qim%Cl
znCD4B#7drPX?2hkmt#TMMost?v+~u(2FG!<=#4m_CERJg(YNPgkm_#K+`Zb2TIa^o
znR3s0zr%bvM+Urw30Ox(Euz61O3_(N%^)_1q$64$hgzlJx?CTeo@0ItBLxHyAZgFU
zz<`HP-m~Y=f0ZZ-3DH0cC}-uo$K;_B?V89YOIu%Ko2TqKOcKB0(DNjJ?1y;0iSvh*
zZ6oLeqM495$2|@V`(1K0BFFGtpqWHVGpXb>-Q>8R2Y5y<2?w13aH*g}$*`0C#Tolz
z<X%U~;!vdWD77eK@&w5F0&(+cP|kVKYwi5`pq@>z!XaR@4)dYHaIyQiBS`|)%%j`L
z+rcu+YgXl!hCzx>g?q&Tc6OQz!9?G}RgPr#dJYj<^n4q)7_Z0xnmSsc`%}x#AF_e$
z`{dxX-ZM%i_LV;B-FY%pH=0qXY~!+f!&$_uxX`EYsLB+egMZlB1zsQ!n>S>b!eLla
zBFV1c-DR^EL`3#1MbkvV`e<b8gBh)|%BtJ>!o*yi<>7IawffJI;kDxe&n|JGA`Hj@
z?)FDX4%6XaiujU=UgXY2;tD=@k+2v|2^t8hTs>30<Vg9L{VoOdz$*0#Aj#5QK(6Q(
z^TdWPc?G6LP}r{<dGRJIvo8?S%e^O07R5E4f-nKG7(dH(^fGW~e9kW)eX5l#{n=i+
z9$H!_JJo)6C?5&6Y>k5y9=URkGylG`D?&4pM<H%XRfjH9r5|;3?7MP0?bk`vz=Sbk
zFpbEQW6i`-3H-8CxQh*_EAKu<<SJk{uf&CCUninS3%@=<agR1bzI&<zs(4H%O$HB|
z`%&*QhtoAq*idc71z5Pvsd6Kz<TZo9mm@bB$p34y!Z;p~OIUX_d}TJF&ex^N*A3rU
zo1TOm#cOtKF*OtczVmcPD!<*lh)!Y|+FUP^=4OhehFaK>=-5Y>vX?G$txAg$=qy7F
znpbCj<ynlMJkLv>R*zM{i@fWqJ<@-|m8>fjfdo>To*mnc=V#7O=>i&*bW1*|BaN0r
z)$c!Jvx5?{wxYqO`@4LlLEZNyy&-qFQeJmJ1F6q2=+j4N|DC=RJgG{}UqO^}lU!6^
z?N+(mqucpf89fW(Y%gsg+kL(AXu=_tVUJlQ(Ko|}3g~DV4~waie`~xm{OR(aQQl2p
zpX)x8_xp(eSy%eLG8T-w)cdZ05#(t-Ai}r>IJk`~#7NK#Jn7OxV(O{R%QB)*lRso(
zggE9mRyo&`>QU<};c+a_mYGDMk#ymfX099gz)#|zAv&eb$AH_|VT#qX6(u>ZKg1~W
z`u&h;Xm^`IhpaBJysolVUa~(&{G;-|{ldE=0|uyt3t$H%iEF$;6txyfG6cw$+obyj
z^iMe8cNIUwn_uN1xCS|LmG}P|K@R;gf!7b(+&9?lLCg22xdpXVoVsenEv%Q3j<fgB
ztqy>SHU53?8i{aid}+u;4v)Qg`-M}^xwnub?{uLbMb*f)8Q=vm>hhi=8Cb{${Nxv`
zqZ{&OR@#-!dCYLZbN{w<SQi_G&t~k8S1ov=6cVTdBb*HnLHCwJQ{s!^OmYr&>))?J
zM7%FRkAZ<-fmp##_9!*9fCX53*@=o)oDJy*-aZADtq`uoBo+DY`7fv`$1DJCK!)%Q
z85duE!bszERlx91@~U=E-*p|&z!sX?bPf6iV{Bn42C7S7wy9yZ2YP!+A{%$Y4fAy~
z;Sb?ERSP~xKvOxy)Lxg}oLB#CP%72^cGUU>=;Dfu$YT}_u-_O2Pm@2mOCsonoMO&z
z<tDbDDT}<b)`Y5A?!^A?9H7)^pWrsNkTDfU!j$gCHriMuP|eZ#@jRApmJT_|2$?94
zmqL6mz-o}qWxb9D7juOmg{ftA&?%2a!b+2%Q6IJF;ts!FeE*F8&3RAsQJUMU3MzKA
zrb&}MBa;_IRP3l&!cKR&N?N@m%g88vB8v4Vuh5^vXKSr?qQbSv-j14bw!|GhV@I2B
zR~!<UJv?6a?W<6xh-Gij#rPe((X|Fk)Uzm!2@^Q;&evnkqATImMeegVU&h7#f*pxQ
z2*-{$gl3kzH8?lc<{)t;WV)I)SPg{^&{aS!(g=Cbf^rX|>rt^6G98x39Di{VIl(5`
zRKb9e+8Yp}n+>H5k>pkzqfHt8^4>d^0sAO@J20=re0+;9@hbBb*hi;N%)HNB7J<FU
zWe%u{c#{A*rGs^ylye@Gbvx}&%hh8Cw7tE(+i>EEnm>x}jaRD!oYv~|1eWIK>?(Wo
zqDS@3-OmE+Ldf?<;U%&-Im{`KRPW{R%)VzLVa!3Y(m`>VVser}xC%Gqnt!_^74Csa
zX5IZ$03z*KDBE7ehUnf?IBNeYl*-8!=z#w*dC^$Qc;iqobvZ^xMr8eWB?%1<#|b^x
z8=i3I*`NG!<;`v6V>6oqvC*F|sNtc!FR7gDSWab64%Ez}lWLj{y?QIV!Zn-ztfSkt
zZI1D}XNXf+esdE8WZdHFQDMY42^F3=B9ojTPloUcZ`P^@PH@jak+NsY#w%rw!ev!@
zK$(Cxzt7@~rZ?@y$_zUbef;=w8M=}ZH07756Y{&h`j4VhY^-=kD~J+OXU35vEfu=l
zFC!yZgHnJG_$n7pA)C^7UX>X)rJ0P{mS3eRKt}=KaFty}Lqp)odo+_!-^Qy4B2?YB
zM;+XrUU*W|d-a#7>A((Q01eYchJjx;2-XM23K|sjK_(zlW)urr;3+gc-Jjx94!T>=
zl${=Mg@ntR6#`0pWQEzR7;+VC)Pu5j(9rL0@Sw$#5}?8ielnb4d3CgRz+{j#a}Ztn
z{6MG&cY!T|JdJ3E#rF35gx21nFYGM|w=!-~;+gJZT{l%DYsf8EJvQZ@5QW&td@NJc
zxkCsjfQ-_Man(8q*X_GTa3~%pqvL4MxuzJBlyqESZ=v|$lOPWw$ixu)yk~j_0U{A-
zR+^`Xe9gJHP%u}b)Nf<(m`KCmSXa1U$=>+IGtjExRsa3QA_K$lj6O#uv}X#DU{f5?
z3{Tc<0@=4Ud}tW=J{2Hw&Z9I9IMUpRueMwoe}4y4^7`;D#d&DF#6$WB*`LcTaPHBP
znZOTKuWjed`Qj%F5}WURT)M|gh0?#raEy^RF8pJruE53}-%oM69Lm0iM$Zlldv$Y1
z=P%9{Y}^%KcJjY&Q(!os|9aK!>iJi<RG4nuAb#n8nf#Ici+keDDPx@0Rv)!g$(!$q
zuLUS^C|E&G^o3LHM37V6*xG>~r_U6_hfkXZ_GL;eHZd9exi%R^&B5)q+%l&~F%jNm
z-8Xa<NMGtoZP&-jpALTipd4RpOrnyV`=t8r=;e22i)k)v<N`-2+qZ`Nda&7>3`+{c
z?!#miQuwpuD&fcXhd#$9_h4&}Ve3E4?vgE?F=0)aC^nd5fBN|GdeJj-44aH&*4wwC
z0Gkj6xD6q(qMb@v$QJylrhfE@Xt0j?lU40jgZ#KS1B~_D!NrW+yk-X_-<oh_yH!TX
zI<WEuW%5o++8Z44(Xa$w?;+aT3Dx%%<Rg!LAS>+o@te`v-Hk67^Qza8>vtiZXw3(E
zp4oGlA+ubw=7cbwyKT0D<n`mnmrN+0Al_e(-C2f=pX;v%ih%8U&Q)kZ`XV_wylL`P
zR@S4Wq@?08HC5HUX}sT01+p0-wDHfBAGjpiJrdtPA_cz#%Q(N<2JNdZ9ai=7{ft14
zYbc@b9Ak|;ODXim7z$+jQPh$o!?wg-Tl*#^d50U9IjG&@&)b@f`O`5l#CWRmAiE7s
zO>TgKDR!AuSK3>UAZQE1UVV|6*enBD?9egIJ-Cio^8p`fS@TmM<+f?CPkV@*75#!e
zrMFY!jxsVy%J(8hqCr8=?cs{g88v;OlsuOkpPVxByEn=v8@!4VvRcoWj!9rj`6hBb
zaC@~$hsPKgX8E{}A%<*VDYV83P0n;@*1&0bFv33j_CjhTvU}z8t-c+i@lk`dfzrv3
z?QW?N2*<j%0A2HAr((8C_9c;G!R<CvjYP@&{n1Z^>%V{Xyr0VSFf{JWcre>5oUGbc
zm5JEY(W`1|_qZqrkr|8P!HSheHXq=V+pRwHohDTaHC>j5-Xz6}U*kFB;`ub}O?e8{
z`1qM(byKqkeqjd~KBl+knTb<R<5a)%I;1)s({SVUjNaNKHXvCrBzA2yG_7(LAFz<G
zOMm?M8^XAXD$Lf+)BAjp*;wu7%_EmDUuI-xUV|>Odz~_pl7-F_s^5EhE?>Gt=$ia8
zHg>}zyuLoBSdqy4?Qd4Bj=K2d+RblQr3!@d9W&ky_DrOa)u0Obc|X(#VB={n|5k0~
zeyvDzI3FI7nJQB_Y9wZ_mxt@K`BN(5IUL`Ke*z-?qL2pT<Kv?My`SyJYEvDC%3Ru|
z`k~3W%<|53I*~H~{8r%<f-qY_VZgzIC{E=L;M)7qna?p`Ypj*>UW!VrJdjkhQ=Y`H
z<~^#unsU1&reS*@;0m&ZLxPgN)Gf9~Cl-Cb$&d_N5f?I22UCRDXcjIKWr$02Vm`NP
zeC`pugcg$bYj{g4ys(gr-ki<d4dmhBIpDV^8sF$Q>4fIdtV({eyy_9-MNJ&M+}uHs
z2h_QJ`)f<A034M8^-}#t^}tT*y;wO-;43cu4Gq!Emh12pk@6<PL1rwecc<A7u0AP#
z!Prwq@8;=BtxF{-Ewx8=K3)8IrK~b*Zm+7gYxSRBHFIpqXY!>rwtf<0t(bq@7Ul2$
z{4${c<=wwZW2Da59ZL0{mdrl$&0)#TX=$ltx(P!P>SvNHq>&5j(;%0uIbWoavcBQr
zwpNk4h@RQ3ii(6kL*<j6)rm^}RrsVEnd&#LU&p@HO0KHVxpx*8Y${y5&+ow(e1r*C
zsv@2Yx(+p8dCDF0K(HOhKVkEnB|RQpqRCKRK;oVACFM{nsx<kH@$1)yn+y43*+C+u
z3nb$kEj+ZxaSxBQY>_%<IZ?_=W6|`O8SlrdN^3F;$7jsNV1>V_9256NZH06y?M3|h
zWey3lOP4N<m-gSaSfA-$7_NK)+3lM*Z~in&kBz-(V`G!O<yL7_VI-vUvbPt<bkDJz
zt$b)?u&JYEYjCYn!{pq9sy=+cTL15<(<C2?yb6bnjFZ!kuq|6RYel_!T}6p8;0=xV
z!T6kAci2%zu9+60P5<DqHdt__T}fEeuG0FJIc;2(j%2FbL$hlqOJ`4Ng~q0)nJq|=
zN<7b$jQ0=9o|&U{5VdXV*0`og*`B)YbxV~gt|eIVnATVF?y+VS`nkY@`X{^Rynpn6
z?uqx$A2UfH!^ZGxd~}=Ee*gacb~=8C6W5vExw|p%>sR;YYCHgzqTOW=0kFit-0$*Z
z-YE9v%akp}-7kFELYSSJ;kn3k2De`?F#QJ(b;k;SopVbmAEhj$&+NEz&I(bmJSp*Q
zZVKE=G*;g+z;i9z_l$eMEdJY13*1&&_1S}d?f2!+X%=>u6^F~}Tv!W-_%otdYNgvw
z$VV+2HFZ3FO{>Lnqbimv$l}<>!un{zr{S0Lmx`BuuN^Q&5Cs*)EK>E>^-o;#KcO%;
zKRz2?`yqGUPg>ySBM&4ZDhl_IN*FQy@`%EIq$(D_9gQECAKRggjEuact6RoOA}Aoh
zD=%N&vo{imKM=fIGl2K-@Q~Ws*#XMr7g<?Z+R9$ij^)XK?67J}2pVxz-XnXsu#T%Q
z?5DQ;t<D1zM(aIda#(SqMcZwop{Ol2p?_k3@wq?ya7B9!-{rPidqy`tIuy3@fMto}
zfZgyr7p^099N#u}Cy+KQ`i8<L8mBE07~fZZNXZ%arGlHa>pBV9gw8xaQoEXv`)JK#
zzByIC+=6#(gq)9S>!Hh32e~r`vgUn0{u7V&(f@rN|0I77zh`y=8CvsJs4x;ft(kxs
zakT#Pv$QQ)h7JQTIcMN|ei|Mwe^66Dft_%6mvt;3^8GDh?KF~I9xHFC)f^}9QbltU
zy-@1A9#N^6$uA)`-Wik5aV`IiCGqli?%Bh6N{J(g?2SLRYl9b#;Ut3UKN^fk3{uBS
zTeGH!&f{-e8&PUZ2rQ9jZ2aKJyK&=0+QeGL+4eOG)&bSRg8Cadho5LQV3BT^kX<ub
zFAeZAV@JSN4#2e~5)#jl8Lip=74EnEnXG1Su^R9q#X!@^Byv~Nz~DHj^<iLt1=a2b
zhxWQx&joFLj|<5K<(%j0OQ?!}vgZQuc?o^<B?ITO5||KYwn(v*&l8^~598PqaxpaZ
z%S%(;Z;2zWJ@-1bJX`Q;T>|+Psuh}fdqKukw9wQhM|_^<beThT0d)k!eNIz2pvf7^
zaxnl(Yu>8eQdEy(Z!WRv8L09QSgPF<mau9=#+&)lr>f>ZSirdgXyTBC1^c`H8@&OJ
z9`{#Cu*6|Ic&Z`V)LG~DpCf!Wn=BD6+UxP|Hcrl01ZNZK7uEN<%nkqaC#SL#seGzV
zl<>ekwg@{Ss`O;kyemv5sGIt7Fst0EDq^HId70HbO}RANf_Lr{bQ1W32GxFq`->;B
z^Y4~e<Fx1}Pt1U{T+pOe;gZntiYvKo^wJjYOa=aa5e{Sm=Zw}Cr*U($i5BMqLtUM1
z1zAVImnun-o;F{QCOvhIzre+1K~vFYrTfHH?Dn=gLgQ34z26E-J)}*Itf*T$FIZjW
zH;R9Z=%UU~KhE$1diM-}%tbXd9<_le<jRtqzC&DXqI?JS-E{W+FTFn&lugD4+Cu$t
zhqV$K)*dxMcZ}Q_^`(n%X+GE-r=2D%9~DW6Q^bUo4Bc)pq5jE-r-X6z9i+dj@z|0n
z+<q#PZhMESt7l;>Y+xpjz69(v;_JvuVL4;19~DVRf}~{R`u6?f$qEbS`aV9iJs5R8
zKFmRy-5`Fte7?79$8*h%H;nd=v!k<ZH8SISSa2W_QuL1gSkK(scp@C5M-A_L%dMzY
zk)eRa`K_Xg)CzlwXEz5d<>7n2B%(9io42U%`jtdxvB-mQ8&llZgI)4B)5dokfAPnp
zhT&OuVuY0&u`sWbcUVt8^Fx(Zaxhq`k^4m@5$K<jT)sv_Ypk`%fFrT<G!??GRei)h
zC|p1M@nbbKiOTGAC)A}lub9RL?onjMnEaRHW}#<!Wp!hoSn4%A`nnrByorX%uvIlm
z_oow?*K!Ff5-yHr9MoP72v{aAEH&&<zW->)z|gjjg4m6!LIlr=Xng-LSCtCVV5W__
zUNuFBd18g6T)+PzZ6siZ8qV+TAj<c1BUxWHBwW7f>-MF|-K#x49h5)0n;F%Kkn*D@
zU!*wI;;zkk3!kpEeAFdFSuub6zNgu}s8?rod+I>Q1{skzSKr*mq3KN$<BEb`IIHQu
zbC&*yf7w&F>$Mw_IFM(oiAUe!kT%gFA}j3cL_7`9jnggFroa9;@0<v#yA$fg*mZ}}
zYC0V87Or}8!R0<|t4o;(zwv4`ayk*!#b9aScbC#siEMjx+7bgiW%{=tXdv?Xn3(w!
zs62R8^$#P#@2_CjZt7JmHb;e|`5TB3pBW=+Dhv7=YTZ^-T&|<0cCzgZawXmXZQ9D@
zeYB<%^<j6J{!K4UgT_#T-}%NtCtNam@gA|LT%Y#q@`3fY1=omBSFrB!PQ-<N1%d0)
z6B69q#nxL#85k&dDKXzqjY-;j-n=>(+ggKi-lA}O={WaI(|n;Uiqo-E87-UDa}|7^
zK>QpdeFm|n7tL|Y+O%Ps^uuPqz!l}qg}a31P$w*h0QwJDH_kTahj>~fI?HzZrv-U2
zT_5Qi%3CTfP$Vp_YN76&2u(UlpG?YYwe{~C&;4FuIgy4UzVsyA%G(NPERsWVH9RZ~
zO5ZWOkM?ou@<G-W$p!}QIj%7k!uuQO9wxkuD`*;_zVZHmkB0|Mi7{KsBs%u8zv99A
zU{8m7k^(7H`1y|AJ=6A2rYtH~6|uj}SWkW(sIH29H%D%oAn)zI!k*?tIlwngIlfq^
zXP}NcPgs1Oe10Uf$hhhKwh6xUi7&pSSR;Ka@-Q+g_w()wr`gcb#QGgXu)>yqj3w>!
zHLHl3(RRO6rZ*|81nYkhOi&l(QCtXDq6L?=U*{4p2$K~fQa{iwVa5GhMEh3y?-r~d
z%Gt=Mwam%yKnY>KcY1k@>a>`W@*7_n`KuHx>3zJI)HuxS2bVGF^n>JGo!&!OAe)OQ
z(TH9tKo%P-X6MePC@&eJ6vTJkTR$HxZRLrL=pkqa4aC<7-Do{?YkL;O;$OcrqCt=l
z_!zNl83fI)s1w+cE|R;t*kC3<=(>y@%NX=ujGV=hk7p2*bxW@mSVmvP0)_acco?sq
zzeQ_Ky3@IBqnAEcu~Ww_g~-_K#s@atoHS)L5C}rcoxwew<cP-r?Rbpv8Nxeq;i$ay
zwUSI_jL|uC?~xBS#=bUSB-m!$F$zI5`e+=g-#eAEw?(+2_$ESav9Y+8Lhyweb~AB7
zD`R3Nof~pkbw1hF_AP5x6tVYmRrmhtZuiKLiJqF8T1O(<lqJ_rio`EVLkCN9^14Pz
z>u_u^g|etgv}17S`^B+uchHS7)J5-%O{l2ZUSjD^Gn<vq7Gx6~-mXBidcD-#X<iJ?
zqE*L_%I0!!jm2Nzx$PvgXoxadX&o01+YR~=Mi^Q^Hp0?4*I{w2(1~u`>_+XoA#U7!
zVQzcBn-6VaGL;Gp<)kc3P(pDpqx0=g$#bEL@lI!QR~FGnCWX*{s4y3@lM1F+*~jGs
z5yGd|{(YWdBrHJw%pt$&yK+*~Fa|957!uw)eB{IGr7cHKT*ej$B?ct#l?tq~+z<)Y
zO`rUiAu7dbg(*l|NZiCi$8?!^?ck8E%1a^=fndTTMiQ(jPJlQyb_(hEBd215wAl(v
z(ZMN(3Vo1Hw6G|-%(}!w|If9=glpMQ>@l(ADTZP*-))(76|y8BgsYU(VroOU_LPz6
z?0L4{bX0u#y$D?tsO?98Z}BB{&XPgWddN+06Un7CT1f`=(q66<;#(6Ao*~YWr?E`;
z@aG+)9N#`qpPxSh6Qdf0Hcb$xt~VinpjIY=q}5Acq-YrRK6T>XFk*V4x1LqlmuB4F
zh?A#3Z!clCDdb?&w)9SYwn$hqj7E-!y7YA(4?S;l`$8-FS;^}t=E$A6o!#;=Z2$bZ
zx<n=nNarJV_?q4-^7Z9BVg#JXTYagYm`rbfV!QJq42`E8=RP5FJdn!BJ-kxjTY4Sc
zZ(pJ@&5Idu%&A7f;9RTPW=%9+##YSmlb-SnJms7i$oxzP7o>vfG7oZ6BH4M-c9BEG
zpKR{zxx3j6DzJXfG7*-yb0au%(;Co``#<zDd`pq5pH7)Rwg2-}rJVUUW~l~gCb?e3
zdAP55-%;jE&VS$L$BQZQbX!rsYs=pCDTK>%)L4a-4P}dz#fy?3u2{O=UjAJ7IXN8b
z5WrD?A3E-!u7hyhf(?7dgd(Bhz665H_R&D9i%uBndk{VO5i|2nn$G<gg8JBqEf1vA
zGo4;r9-;uYxSTT~Zy&6Ay9Uq&9s!w~b+~abg3Pkj@^rb3o*6HWMEa_dwoN-Pj~>)S
zcvQFYuL~hhS`m$3gLM;+^_|zwdT*g}lqhopiJy%A47wc5eRj7dfP?TLMZ)sjArkEX
zV8Rj&M&qXt+C|3K+j&Fy?!h)oq?S<igNSQ6k4|?e?e_mnU~A{v?p_*qstZk;#JT*l
zz-I_gkRf4TT2>^wuZ`kV)Cn_V(Gz4sMn`YAw8EN0Gt|yJvB9?EFTQTqo79`gl_TV)
z(IL%S*f(Rrk$779LsQZVFcu2de?5uK;qa-Oj(L$@#^*m1w;VF-1lz(5+iq7Wr=5#9
zRjj@n%$?35Y0@bLA*Q!qA~f2RVP74&SwenNv)4BpGx;f8<#lG>J-)AqP$w$D<6~U=
zo<O0&c=`u^dx}8Bnl_<8k%q7pk9>qpehciJR*u@8!w@c<8%D(cUfli42lq}_o+)y0
za>ixs9KX*d3u9yLf@@#mS+O&5`iC{TUo+T-+xIP-ZXky)H>)omPs7FS`X5IT<XxWd
z5hmnSz3^PsXAee4Js!54lc{VL(>#$lxLM!ZgzX_NyML*T!XOz$_N46JVOJ)jg3Y81
zU!7%oPWB=mCq$xiqp9}eam2B*21)MyzFA*8JN6P?_>&&Qb@??xT#dB$yUIcb<?lY!
z`RcqUf5?DM4HJ0hB4t)=u-##a@|;;FQPIK^^vEeKRM<O)-sEkYAFViM4W)<b*?|m~
zBE24X|IE?+SR)WTl+#5?@ClsXA}mqbe<nY)@D&<Rui0g?M*ZR9lY86l?iBWwQ>jT=
z+N39J%jE(LJ4+cvI63sJ_iXh^7Hy@~h%6qbP@ny8Ot0;AU7xoz)YbgZdrQsvV`VK;
zTXx-R?V!-^;SVs77%1LCJP8WNenUMIub5a&Tbm}K>R@wWum_g})gDa3MwcEuI0vOd
z;Mhe&bU(n>MPymB-sDgwWmMw~>wbj`1C7sDTqQ3j3g_vBjD4y>?DoELB4pAkZoFBH
zs-fx#!Qj0yK#JX%?=OY`nY7cW=H<&2;OPRM;+OlmgZ^RPrB5}087F|l@=WT|CYz$&
zAY#2?k=xl5il^Ee4as3yG^5DA^wwwD5?7hY8PrsN;3j-;C4xb);{6MB=iaD<NmwUx
z6@%diIU>3{@BtkF`JkVEpKN>2ic3fg*80oqyw!a5{{2&^-CF$>F5=oQg}XHkH5g4$
zM(_<fvQ++hDzKY5IBh*mg_|EXSy?e5MRC|yPI8|mo$JKT7O<qsKkTl&9Hi{TQdrR7
zr|f5SJxLH=_L;d1Rru-s`?JXR@86LDcoBTqY)|%H0jrcPBOqMuf0mpvMcfH78ex1t
zB#DrU5yxRiujnD%-onl>(KU%1y-kJ4hR;|=(GC@|aKlqUj@d%-W8&LjPV+4HqEf>h
zj)mJAqV}{&s~<3HHrF1{#n#3-f?FH?pHY=Z#46EE^{+36Cn)%cLq#M>MoG!b{|Xf)
z{}U?0?g<)Ky@YgWR{aX((4s3UD%KpW!P$*gX6w=WEO_lGM_x^>86Q0jHq_&k(bN@d
zS!egPTt8QZ(jH%G0pIW<Y;#47z3@&(lLISxM|Q#Q;hchCjsFOS<j!yS(n>NgAk4x>
z-=H{mpu%O+XJq<tZ^;^<vxfz_xw*}qoz~!kpFHIup8u2PKjR%s-HL)uWuK=_FLSiT
z>SWiK(LjjVZ>_3QZ_{8r7O(N@&CAbj)1D9LhSutcxH7kyaCiH5Jc#t2)=S<0H5Zw+
zv}v^qc4O3cPg3n6gq+|<tM=p4_5&(+@226sJw2uWk7$hi_$PK+GTN}rdY9^vQGr0Y
z&UvL$KBVyE^rUp#S2plT*8)OtS4>;qDGnsta!X_RO)p5X4^m?srtIy_4(SY?4mze5
zAhrc>=GgF9UcYEE@5KykiZu1(9r8<4gt*;El?UUoQvXc{hzt$<@$CCxJg;14-N`}A
zsif)R;!>FGd-y&osi4{CM`aS~ar7n*+Jrrm{^1wsZaCh#ghv##o=H=G58H4sB<ysP
zkU!+(UqYySpiIaI5}%hfHP@B<<5N;J?d=7j+nu0ZAqI*?Uc|+zLx9?A#Dn?k*RMow
zB+m25z<tLJCT0gaxpZZUvzzrXLRL@WH*3GonSipn#8AeI5zx)cfIR|DZ=Sz+F^OM;
z;@{@Lb|^n-hG<9=G$2Y4x1<~#93-@3I~bT->pF*2wKHI4HRciT%AE)It~Pa+oxzKL
zn)D&476CJP^nI2_{Q|&y{a4h0TxibXwnkh3l;7O(8dTTlTz|51v!7zsiKJv~-<;8)
zaE=`6M$vWe+s}>@cGtlvdkutFJLAkanCQXkLA(^h+Oj)7L!G;xc$Qr{(`X7+i@)j*
z%;8{lz8`lImR_vo*sVt)WdWpJw!t+|aK1~m*nq>?F{G0ewC|;X8wfl9;ijG5Cwhgn
zsOk4ni3L&j9$&USh77eY@4XH3M|Fvghszk$)~fuq4URneBY`pdDr$Nle%}_;%7h)i
zI+V7hjJNKSqpqN2;aU=3+xW&LTS_-tOILf>nuBeX=917tZaTqgReg*eSLvFOtmjnO
ziARCUxE81a2C>gk6xA(`hj>BKXg2$9(H)KoTQS1%$I6J1J*?^xTDrEl=v{jOSpYxs
zG^@Bqa=40uBa0H1mB{T0Ygj7sOhlGG#SNh@ByX^8xn?@#cD;sPy<_%I9DLw6Bm;i?
z<911n2>#>bj;<7fO8KDu7K3W+kiZjMjfU@M$AdC9$W410oO??Y#~g_ZM@O0&3*mR<
zlo+B5^9cF%+U(z-nuvNw#YIOF(M<5l$Jy}E5;_cD-F=@W!7!Y9p&qwbQ%z0o891mI
zo_NEJLCT0hTl|asG@^Aa{At|w)>gh7*#M<B%tOOflrvY3yk)Ibw3JD!VLq|r9pd8#
z(a2eXU42P|aI@1f=ZV`myZM`<f0!^TtrD1(q`xmlU{28B-Au&d?Aj@E3M9wM4Uu0f
zEI+E-5tdwn-N!(o0#9Ei!Ir#wCOP1@luI`7fiy#8Kj<wXa&%IZ1bcmYr9>0e^rk-J
z2F`a((z*JKX|@-eY&ePeYevH1l*LQ9<~_Pz{ylR%Z6b5hk~{@wV{{sC{zp1b_o}Gj
zS;C?62yL3P7I`T5oa=1WDI{)*6xzL!(W4oIpv?tg6q+c}A3JII@T(FgWIO6e-J`il
z+};fF<I7?qPCulb;St}Z2=Af8%;M%VVsN=@CsPJ&YOi%jaPD3h!V)6?gCNCKo2afB
z<O~UJ&p%Mg#IP4}e@_mPsmCcH@P4-kUZ@okmHUaLhwm+rye&r}=A|x)zqV5X{Mt?#
zP5x|Fh-6a1rk0ci6;WzO4CbvGS_h%_I6RKA5o!|GDF4)G2$SD}z5n-j=fKvULqi_!
z>G{194%GSwbl*Q?WreXa^CMOf*bBKlo%!jg^?Y>SUny}{g)b!`#|Y;J^WH;^e|{K~
zFsVGvhKlI<-+n#6^|CnIM-<_UWYq30uQKu=O!br?BXU9C?Wp9fq@_vm{jjm^DOq0{
zx1U=TF&&4i26#C<4?PKCQD<Sg`E!*g{Vjq97?G3@rw^;DBj^+@knIMEh=SJC!)V!0
zC{bNsg6njNkMPjca&mY3vwH0epXwHcGr>^Rn}Z6_fjc|#Z-;(HA`hs}|1%rsULh<k
z(2r@Wv11bPbMq5s-C-X8+|r+q&Zwg=L1(~RyQ{7}dX;C4<mK7jtFLv%Qe(0qRk@(t
zD^6mxq{~gPn`V=4s`A@0BV&WNpH>f=-ty$BFFtblgAFo%>Ea3Scp=c3BJ9L{zn5Tx
z#%SNClzq8Flu=1D%$Dw*9VpU4VtV~ya6<yW0xA1BW3rO7#QA@B(%;WsTOvy7Xr3dL
z{v$&)vB3<XEAt{z_v>h6uhmYB;OZIZU<u+xSfV~#O7He;K2hq560VT_5?TDIdeW~%
z%N{;LA5PP8)GK_r$o20_&my%uHm!4GeW5!VNb2FNN!Q)K&yj=Y;Ak)(W^O6T-K4-S
z6v;UV+bE)Ek|6-|@rY$lf$m=+x<YQLErD=2KK^Q<qOK}A*evEC%=*)oxKR7A^j?wy
z6I6VOd^|1bKB8{P=TVU*sz{qlVr!&z7>jlJNlMTJRT&7&`{9joX)1+4&qiwZ%#TOq
zjc|`Y?l6b=dFD}Gr+~s^m|KwL)mTiC`bzU<H(Re;+D!~9_w~s?UL|N`wW{+d(OW**
zfsqyNwSp2`yEKw$a#6{8Bl7R!=$wCMF@^8|QtWAsv#}nI_PSKCHt4(O1bY<j-kn5C
zq6tQ#F>H$4qlli}Rnj(Bk*FN(=MEW?g-o6<!gR%gQ4B5j#(|4~Pez70{Ogyw-rS)S
z8R}rb1wKwmVK=w1fGpv;z0E)K>5Zhn{7IKf%tEVGpt(fo13T1igB>LyfKo+YhU%Ji
z7Z2F?juSEASl<6=+3G#_F54TIXg%=Jl4@mTr7cMcimF4o%1e$yto*yW#BgK_#r{60
z$^$>i<|0pg|6eC2=EI{u*Sn$gGeN>y8|wz))+PMm(*7^zy75ppM`Rpe@4Wi@`gwOh
zB>@%6sRS*WyhTPN?0DOkPG(Or^!*||mUH}R(R6pv^h?+O##}l=9FT<;K!QS}JImem
z*+UC39W;|9p8y)u<2Yh0%q$$=`Zqs?{F70f+}u_g+T|$w>6(WP$Yw>tEE_y`6rX;d
z+(&hp6{p<s{i2^y8&~`4A2SHd!fcT}gSt9$8qAwFZ;*SImZfrOv9Z6EnZJF1bJb@m
zM&lfNAmpkaLyBn06H<KJV<tZLID;{+*LYl{gHN#an-#eq4mS2MVcB=&w|hB8T?2eZ
z|4>-x?-}gI{bTt4HTGuatE#H*)=jG%je*qsA|!YqhqHi(A0`3f)~X}r^39vmIwjVS
z*FAIQj9Fs@>%bpevEPkOB~+<%s9NK(ESEo}@g6>Od(3?LZr*&zQ4x-&VG18b$7`}w
zKl;DR{D*C4X|iXv%%iVHiiPwG($doMt+{!HQ$#>u5<H5<bvN2DqOkhz39#>%V(U^I
z7ImCHpg)KnsTAbf$=l-WwvB(*pci&%b}oE$H??{2-G7?SeM`a-cTiq$a&jKSv;Ufi
zy2i%saYBat!orJ9aXze}fyb6vd1I)m^-v2s&zPdyZ95op2}z5`?gS&r&dzQJkUsk+
zoU+cCRC%xGVE;jyE1XH_mkEBugpiWIc=4jb_IU6V4(AH+h)t7B;OTf(3B+_qs`F4Y
zM^9K<4rF+5#`QjD;vDH0BIqrYASCt69EK_g_MXXJ+DNi;pb~Tu{Z+fSSU>CT3M3@g
z_4S(pg!vVk`CZV|)C`oW4Dnho7=7Gm=_1NAzrc$@>UKB1JvrV@{n~%2WS;`#rFJ)C
zL$b9~pF*xbtz1t~VRt5z@b|p^Z5baTQ<5i)Z<@TS3)cXZ&?vA^I2iTSrX(=joz*nM
zth`07CkVEc+5<R-80FfHRnA5<2zw!*HyCCqK$A@wqBMCjUH>`Rz2HR6!0Ga0GCxX@
z5Ddys0`|;7)c453hQC}`Y8o%eUOV_PaOfBX!+OLT2^Sl8s2wh{YTSYzm&OiI$_Ltj
zh!Vqnf9uI{Bp)HzLQ1dBjMKZ1T$Iad(vUcP=Wl#6Ym4wA$Xc+<%U0GUbHi<BSN>{g
z9tH@|!*EZ2;U`!-kJVWIo^J#rj-ZB)nEf578c)REljqW-8-(r2@I>@)aPt3o^XuJe
z6j7oX3v%nuo%DWxNZ~_D8UAen$<|Dp?-byX{D+6uTDy7RHMBLhaw!Y(<^VDx<XdOw
z(sUdQ>s#gfckj66<Y4gKB7*8Co5t3rR=i~c_GQ6%*AtB67|Z@=M@6yAsRH~!r0n`n
zoqxNa|8l$PMRVXGpfGc##M482$j5yO4f3ac|K9j{@cjAnb-F9h{(CTg)3O^LSyB5t
zYE}z?$6$D3`tNTRC6;BU4cKWl`Q<DNFdnmO|G1d{_IdrUhX0iTo`}EEh5yU!6{ZWB
z)TVG>2&F%Iv_9+di)|>f->tq(Gzwa%a^Yj^B~8tf5)v=ioN8hqX<btJ_SLJP5Gv;9
zX=&Q3s^~RbduCo<Ub+Fh5=Y>^iy#vf?59;u9h0pzaIsge;n%NaWoI8{V`~LJcc9E6
z8DC?@qOjg|VQOlM9)1cOPlM%7Cdy^r<F<~DxX)yqS+Kze2K0b+tg&vtwXS4PUiV-`
z;(s`6mbB}1Z{2d9&o6)e@}=69E0k1Bf*H^<_ObF;Y&J3weYl>jT;#oCPMD>S7EQE`
z(VU%m`o*$7tM>wB98?T}x`c{Z_#S)#)c%eGs09jbwX=Hy+kqXa6@d250tGc+0CXV-
zODr?uuA^M`V0;J?&Y&ysUjg0p16Q$I<poDhD3B6?IQal_YzNfbHWU(S+1kFxCjm--
z<%iC-l{SgaLg+dEYjQGC%8rSKhUQ>kHE8w;Uz+LHr^gfy)_WF4KPB^}c|RoFFf?}9
z7Z|x)ZJnac2Vov-NG78?y|PW5K5ghK;rHFHT)CoGY(+zukSO^@^1f(#4(eGMz}r?9
zLFfqI-`?I1R2Uxs{`)<^{`R(<&uSKmWxl^ahPqz#tbhPb^@t-OigaiPY)KACBcOM7
za}$XSw6r3{{I;Dlv$7ht!veR-CewTu#i%d%k0b}|_M{)bW9)G|ds>krIwm#MVSnyU
z-705pUY;a7ZP?29t0E+sPt1P*v@4KutUK70Zi2e9)02IMPEynt4n_=-NpSJk0!LB<
z4q$euv5>US#U}yn+EAgMU}KR*)5E^aAZ=dEK~_;w4B(3-{CC~)V!6F71lcIDfq56)
zzjgaI>RDVIDHiI@Aq?TL8vvbx85tRKmVEC|d<ik~{Zs0&%lM=J(=5PSO@B2!8TMOi
zzh`CT3Jt>vh{D}Yg3^chleB+oN=h4u`Hy}@=ijk+K6?H!*jyZ;!t$m2eQAtjgMb@t
z#^IvC$ZS8H^D)n#15)_tLBD3Y(g_$595xR}aY1L_*Rj#R(@s5i5jvZKRpAh2ZE3mk
zJKkhdC-+Nq)1+DV>x-Ic3W@M-z!+?B#ob*JPF9Bx?JX^@q5PQBK(6o;lyWZ&6b0uS
zmV3%(*DfkT!GbkN1Atx<$T++)@N-vaTz~Y$iT3@SwSxoJnK8zVjmo{j&H#0Q#AK>R
zez7X<251&gel!A@hY|+O3xodt{U${7hEk%RKIIV-(((_aWkgQp2^m#9Gp_b5a+z#A
zbiAT>&UK1>YuJtM)TvVq4GrsFZeNmM&@gNJLv;siNW76NMYZQ2Lh+l~;r`CSaMkkK
zv@$-C`L1^mvx#4fm<2HOO=~j=8K{Av?HYc0_!hHwSzVn}Iyt}I_S?sg;vb8P_uk!}
z_zm%$d+kY5HTc6lP;xub*4EZN0|S>VEiIGhd$*<?!8%M)@Oge!<kQQX9DXQt(}PWU
zO>u+q#*G_b5WOq#y{xTGo2e1)=(YfaCR583^~mAjkGeCTESjI6+F!6%o{TeeGy@uw
zVb384LXZ@~cZ}Bqw_+F9?L0j_!@fS(($a#WqMW5pNCPQ9iHfp<5L2FUbzflH<Vqnd
zJ|J-RiY$rJ%~*zgrc()Ab9sj4Q7{zgX}-UZ9jBfx-_3;yc=g<#n<Nmw5s;yti^H>c
z3721Lj<757z8fA(5L9#xb5-}<T6|MjNRN5_ng=FfXq|vxGAy&dVX~!SY<xo3ZV0dT
z(_UJEgYI8K2KY7Dln{Nb#wS62#Keksf~3vOt|0}}jjgjUFKq$>mW?*7Ua!<P7NS`u
zEMCJdVIY;}fb8G&>LD%RJebi?cXj=^0-BSBPdjB9|1LLo&19_;zuyVgO;C~J$T<R8
zn7WHg(G4S`;plu?&ip$lw$R<Ga=-O%4fR{MUakySM6<$DNZj?FAmJ4j?(ja`nLg-O
z005=>l`BsPd}D0s0lV*907A(ECX%|pzrS*spJ|eEV6B+<vZ)0uaU&SY5qC`dd%u1A
zCJJmkN_eTcrL=eN-iaw4Zd*)FMk`ArlYpU(TmdE;wlLZg;?$YG2j_e@?I)jK6&5SA
zA2hcguIOe_@~c=GSqdnx3&=uUMir(XY?jwaQBqPyK%jOKCPM~d<HKWG$CojfK+sTf
zc&UwzjYdLIE3cGPFWAZwwHx_PtS}QZb?RX;o2cvlBfg`4Yg!ht+d}InMAajYTkbD<
z)!Dg?POh-fDQ#!O#Ku~}VQTTS#HKM#(RcS<DUqRvN2v?&v9LgNT3u5!Ld<>U`Xp?D
z$_dxX{r;RfU);gg7~QthI_yoF`kA|R!07gKoA6X<V$K5L;zqiFWunZtZ{KnTBn7pa
zv*foVfg297wVuDRi2tY6@;{h7vqU=C+LoYM4o0XMVlZ&UJ?!q`R$cU0^Uvl*rsYFt
z&YmS$otdv*y{bz-&2!{C!SvzbnYMsbg#v7MFuKc}#yVigMPN|^qujxWB%~7GK!}L7
z3qrgQwFKfIH!ys~K?B1vgE&_j4f}76fF3;pwgJJ0?aMbjNH;FEJx0)Hi{%eCYz3LZ
z@$*2jmjG0I3E*<!t-d|u2CSG{t5ErM9i7R####5(PfPyMj~)@by1Eh$$B|d5_?>io
zGi)g^owx-A!kq&5hCU4+<>4902Aj{!qW^=j-}Xe9nuZ3E^O*nEN_^dZ2!XVXpfRb0
zD=_-SR-hqVw6_jGHuXO}kh1H`GXp6kq(+)J1BU|xKs^xt({B=(N{HjbI%7`Adv13+
zLBF-?rP^c-PXCu+&Mbq5618l3IlA-eqS^x$ut&u+^7V^DVXy!<hws<R*Chbr;Vg#8
zuW9f5+ii&wWEkso|2P04>V7bS_gt+yP=pN)Mn8|37z1X=u{yHUu74Fa)eS?#R>1W7
zz;;TMb~ug%0;c_2E5tYt;nN9N^AV5!n1qB&W@g-=b1#c*J_IWh%-a~$A8=Hx;5d*?
z)lP%@T2M#82*v@M@C>8_z}(m?C>{D^6tMFfEQh_6+NNjR7hrn0`1rzJ@LfaWW=t(C
zcwd~>T1~%p^{U0xx0u5M>$ZgR@SY1{w3Z+bZE1?hPX6<T4PU=*tT!<+$caEOF$N{1
zq?AUO-<8RxwY@QX8qg*dy8do)^zXARHD^&zws0)3uJ`b){?y*j6iyP|)bmIB^y$+C
z<Ld5%*;BB*-ZQVlSd;@4fHH2RHtg{wr<?FKg=VD&KI1`T+h0WjJ_C!~W59s|!C^JN
zX6TO<aM}>6KrrWnNpI-r1ozCYn-sfEcew4Q0S#KcV|g(cPWU1yG%WO58kOz`^&<w-
z2?uc_RIRiCDU^P>qcL5;6^59#YzS>o2*`~2NnDK+G=tgOpV3e@hZV|t^M(LahS)+*
zZmz}Wha?EWkFThZg?fC{V(p$IsGl!T2-`8cck1NHLO?mj3F@mtQV$qY_ko6@$<|>9
zKMz7y7>EyetC^^3YkL;VF(!`a>~_hb$CpIUAWtvpJ$d@{7vaDg{Afv_Zh>4ARBEbg
zY0(_z)1Ct6%~MiR$3)Y6eL))ZKi;DN^s*q7icdl@Fb)hk+3cmAT$6*RKYtp0s5^WB
z8*ZohT7c^9+p%~*ux$%!ch5q3t|%Cf)SOBwz;gKnj^XvWPGO$!#!Q(9M55p-@f_(}
przV8w{(qgM|3TgS4<6QjVDo0pTWfvZbOiofzNoGCLDlr({{lZ8_l^Jn

literal 58541
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
DxUX-f

diff --git a/baselines/fedrep/conf/cifar100_20.toml b/baselines/fedrep/conf/cifar100_20.toml
new file mode 100644
index 000000000000..2b6bb5f5e1eb
--- /dev/null
+++ b/baselines/fedrep/conf/cifar100_20.toml
@@ -0,0 +1,11 @@
+algorithm = "fedrep"
+
+# model specs
+model-name = "cnncifar100"
+
+# dataset specs
+dataset-name = "cifar100"
+dataset-split = "sample"
+dataset-split-num-classes = 20
+dataset-split-seed = 42
+dataset-split-fraction = 0.83
diff --git a/baselines/fedrep/conf/cifar100_5.toml b/baselines/fedrep/conf/cifar100_5.toml
new file mode 100644
index 000000000000..9903ea374028
--- /dev/null
+++ b/baselines/fedrep/conf/cifar100_5.toml
@@ -0,0 +1,11 @@
+algorithm = "fedrep"
+
+# model specs
+model-name = "cnncifar100"
+
+# dataset specs
+dataset-name = "cifar100"
+dataset-split = "sample"
+dataset-split-num-classes = 5
+dataset-split-seed = 42
+dataset-split-fraction = 0.83
diff --git a/baselines/fedrep/conf/cifar10_2.toml b/baselines/fedrep/conf/cifar10_2.toml
new file mode 100644
index 000000000000..307ba7101bd1
--- /dev/null
+++ b/baselines/fedrep/conf/cifar10_2.toml
@@ -0,0 +1,8 @@
+algorithm = "fedrep"
+
+# dataset specs
+dataset-name = "cifar10"
+dataset-split = "sample"
+dataset-split-num-classes = 2
+dataset-split-seed = 42
+dataset-split-fraction = 0.83
diff --git a/baselines/fedrep/conf/cifar10_5.toml b/baselines/fedrep/conf/cifar10_5.toml
new file mode 100644
index 000000000000..cd09c9e07ec2
--- /dev/null
+++ b/baselines/fedrep/conf/cifar10_5.toml
@@ -0,0 +1,8 @@
+algorithm = "fedrep"
+
+# dataset specs
+dataset-name = "cifar10"
+dataset-split = "sample"
+dataset-split-num-classes = 5
+dataset-split-seed = 42
+dataset-split-fraction = 0.83
diff --git a/baselines/fedrep/docs/make_plots.py b/baselines/fedrep/docs/make_plots.py
new file mode 100644
index 000000000000..9474e87a2471
--- /dev/null
+++ b/baselines/fedrep/docs/make_plots.py
@@ -0,0 +1,50 @@
+"""Generate plots from json files."""
+
+import json
+import os
+from typing import List, Tuple
+
+import matplotlib.pyplot as plt
+
+# Get the current working directory
+DIR = os.path.dirname(os.path.abspath(__file__))
+
+
+def read_from_results(path: str) -> Tuple[str, str, List[float], str, str]:
+    """Load the json file with recorded configurations and results."""
+    with open(path, "r", encoding="UTF-8") as fin:
+        data = json.load(fin)
+        algorithm = data["run_config"]["algorithm"]
+        model = data["run_config"]["model-name"]
+        accuracies = [res["accuracy"] * 100 for res in data["round_res"]]
+        dataset = data["run_config"]["dataset-name"]
+        num_classes = data["run_config"]["dataset-split-num-classes"]
+
+        return algorithm, model, accuracies, dataset, num_classes
+
+
+def make_plot(dir_path: str, plt_title: str) -> None:
+    """Given a directory with json files, generated a plot using the provided title."""
+    plt.figure()
+    with os.scandir(dir_path) as files:
+        for file in files:
+            file_name = os.path.join(dir_path, file.name)
+            print(file_name, flush=True)
+            algo, m, acc, d, n = read_from_results(file_name)
+            rounds = [i + 1 for i in range(len(acc))]
+            print(f"Max accuracy ({algo}): {max(acc):.2f}")
+            plt.plot(rounds, acc, label=f"{algo}-{d}-{n}classes")
+    plt.xlabel("Rounds")
+    plt.ylabel("Accuracy")
+    plt.title(plt_title)
+    plt.grid()
+    plt.legend()
+    plt.savefig(os.path.join(DIR, f"{plt_title}-{algo}"))
+
+
+if __name__ == "__main__":
+    # Plot results generated by the baseline.
+    # Combine them into a full file path.
+    res_dir = os.path.join(DIR, "../results/")
+    title = "Federated Accuracy over Rounds"
+    make_plot(res_dir, plt_title=title)
diff --git a/baselines/fedrep/fedrep/__init__.py b/baselines/fedrep/fedrep/__init__.py
index a5e567b59135..f2dbc04ee34e 100644
--- a/baselines/fedrep/fedrep/__init__.py
+++ b/baselines/fedrep/fedrep/__init__.py
@@ -1 +1 @@
-"""Template baseline package."""
+"""fedrep: A Flower Baseline."""
diff --git a/baselines/fedrep/fedrep/base_model.py b/baselines/fedrep/fedrep/base_model.py
index e6a74c01bf9b..82a18cec2622 100644
--- a/baselines/fedrep/fedrep/base_model.py
+++ b/baselines/fedrep/fedrep/base_model.py
@@ -1,61 +1,23 @@
-"""Abstract class for splitting a model into body and head."""
+"""fedrep: A Flower Baseline."""
 
-import os
+import collections
 from abc import ABC, abstractmethod
-from typing import Any, Dict, List, Optional, OrderedDict, Tuple, Union
+from typing import Any, Dict, List, OrderedDict, Tuple, Union
 
-import numpy as np
 import torch
-import torch.nn as nn
-from omegaconf import DictConfig
-from torch import Tensor
+from torch import Tensor, nn
 from torch.utils.data import DataLoader
 
-from fedrep.constants import (
+from flwr.common import Context, NDArrays, ParametersRecord, array_from_numpy
+
+from .constants import (
     DEFAULT_FINETUNE_EPOCHS,
     DEFAULT_LOCAL_TRAIN_EPOCHS,
     DEFAULT_REPRESENTATION_EPOCHS,
+    FEDREP_HEAD_STATE,
 )
 
 
-def get_device(
-    use_cuda: bool = True, specified_device: Optional[int] = None
-) -> torch.device:
-    """Get the tensor device.
-
-    Args:
-        use_cuda: Flag indicates whether to use CUDA or not. Defaults to True.
-        specified_device: Specified cuda device to use. Defaults to None.
-
-    Raises
-    ------
-        ValueError: Specified device not in CUDA_VISIBLE_DEVICES.
-
-    Returns
-    -------
-        The selected or fallbacked device.
-    """
-    device = torch.device("cpu")
-    if use_cuda and torch.cuda.is_available():
-        if specified_device is not None:
-            cuda_visible_devices = os.environ.get("CUDA_VISIBLE_DEVICES")
-            if cuda_visible_devices is not None:
-                devices = [int(d) for d in cuda_visible_devices.split(",")]
-                if specified_device in devices:
-                    device = torch.device(f"cuda:{specified_device}")
-                else:
-                    raise ValueError(
-                        f"Specified device {specified_device}"
-                        " not in CUDA_VISIBLE_DEVICES"
-                    )
-            else:
-                print("CUDA_VISIBLE_DEVICES not exists, using torch.device('cuda').")
-        else:
-            device = torch.device("cuda")
-
-    return device
-
-
 class ModelSplit(ABC, nn.Module):
     """Abstract class for splitting a model into body and head."""
 
@@ -110,7 +72,7 @@ def head(self, state_dict: OrderedDict[str, Tensor]) -> None:
         """
         self._head.load_state_dict(state_dict, strict=True)
 
-    def get_parameters(self) -> List[np.ndarray]:
+    def get_parameters(self) -> NDArrays:
         """Get model parameters.
 
         Returns
@@ -164,65 +126,86 @@ class ModelManager(ABC):
 
     def __init__(
         self,
-        client_id: int,
-        config: DictConfig,
+        context: Context,
         trainloader: DataLoader,
         testloader: DataLoader,
-        client_save_path: Optional[str],
         model_split_class: Any,  # ModelSplit
     ):
         """Initialize the attributes of the model manager.
 
         Args:
-            client_id: The id of the client.
-            config: Dict containing the configurations to be used by the manager.
+            context: The context of the current run.
             trainloader: Client train dataloader.
             testloader: Client test dataloader.
-            client_save_path: Path to save the client model head state.
             model_split_class: Class to be used to split the model into body and head \
                 (concrete implementation of ModelSplit).
         """
         super().__init__()
-        self.config = config
-        self.client_id = client_id
+        self.context = context
         self.trainloader = trainloader
         self.testloader = testloader
-        self.device = get_device(
-            use_cuda=getattr(self.config, "use_cuda", True),
-            specified_device=getattr(self.config, "specified_device", None),
-        )
-        self.client_save_path = client_save_path
-        self.learning_rate = config.get("learning_rate", 0.01)
-        self.momentum = config.get("momentum", 0.5)
+        self.learning_rate = self.context.run_config.get("learning-rate", 0.01)
+        self.momentum = self.context.run_config.get("momentum", 0.5)
         self._model: ModelSplit = model_split_class(self._create_model())
 
     @abstractmethod
     def _create_model(self) -> nn.Module:
-        """Return model to be splitted into head and body."""
+        """Return model to be split into head and body."""
 
     @property
     def model(self) -> ModelSplit:
         """Return model."""
         return self._model
 
-    def train(self) -> Dict[str, Union[List[Dict[str, float]], int, float]]:
+    def _load_client_state(self) -> None:
+        """Load client model head state from context state; used only by FedRep."""
+        # First, check if the fedrep head state is set in the context state.
+        if self.context.state.parameters_records.get(FEDREP_HEAD_STATE):
+            state_dict = collections.OrderedDict(
+                {
+                    k: torch.from_numpy(v.numpy())
+                    for k, v in self.context.state.parameters_records[
+                        FEDREP_HEAD_STATE
+                    ].items()
+                }
+            )
+            # Second, check if the parameters records have values stored and load
+            # the state; this check is useful for the first time the model is
+            # tested and the head state might be empty.
+            if state_dict:
+                self._model.head.load_state_dict(state_dict)
+
+    def _save_client_state(self) -> None:
+        """Save client model head state inside context state; used only by FedRep."""
+        # Check if the fedrep head state is set in the context state.
+        if FEDREP_HEAD_STATE in self.context.state.parameters_records:
+            head_state = self._model.head.state_dict()
+            head_state_np = {k: v.detach().cpu().numpy() for k, v in head_state.items()}
+            head_state_arr = collections.OrderedDict(
+                {k: array_from_numpy(v) for k, v in head_state_np.items()}
+            )
+            head_state_prec = ParametersRecord(head_state_arr)
+            self.context.state.parameters_records[FEDREP_HEAD_STATE] = head_state_prec
+
+    def train(
+        self, device: torch.device
+    ) -> Dict[str, Union[List[Dict[str, float]], int, float]]:
         """Train the model maintained in self.model.
 
         Returns
         -------
             Dict containing the train metrics.
         """
-        # Load client state (head) if client_save_path is not None and it is not empty
-        if self.client_save_path is not None and os.path.isfile(self.client_save_path):
-            self._model.head.load_state_dict(torch.load(self.client_save_path))
+        # Load state.
+        self._load_client_state()
 
         num_local_epochs = DEFAULT_LOCAL_TRAIN_EPOCHS
-        if hasattr(self.config, "num_local_epochs"):
-            num_local_epochs = int(self.config.num_local_epochs)
+        if "num-local-epochs" in self.context.run_config:
+            num_local_epochs = int(self.context.run_config["num-local-epochs"])
 
         num_rep_epochs = DEFAULT_REPRESENTATION_EPOCHS
-        if hasattr(self.config, "num_rep_epochs"):
-            num_rep_epochs = int(self.config.num_rep_epochs)
+        if self.context.run_config["num-rep-epochs"] in self.context.run_config:
+            num_rep_epochs = int(self.context.run_config["num-rep-epochs"])
 
         criterion = torch.nn.CrossEntropyLoss()
         weights = [v for k, v in self._model.named_parameters() if "weight" in k]
@@ -238,6 +221,7 @@ def train(self) -> Dict[str, Union[List[Dict[str, float]], int, float]]:
         correct, total = 0, 0
         loss: torch.Tensor = 0.0
 
+        self._model.to(device)
         self._model.train()
         for i in range(num_local_epochs + num_rep_epochs):
             if i < num_local_epochs:
@@ -247,10 +231,9 @@ def train(self) -> Dict[str, Union[List[Dict[str, float]], int, float]]:
                 self._model.enable_body()
                 self._model.disable_head()
             for batch in self.trainloader:
-                images = batch["img"]
-                labels = batch["label"]
-                outputs = self._model(images.to(self.device))
-                labels = labels.to(self.device)
+                images = batch["img"].to(device)
+                labels = batch["label"].to(device)
+                outputs = self._model(images)
                 loss = criterion(outputs, labels)
                 optimizer.zero_grad()
                 loss.backward()
@@ -258,35 +241,35 @@ def train(self) -> Dict[str, Union[List[Dict[str, float]], int, float]]:
                 total += labels.size(0)
                 correct += (torch.max(outputs.data, 1)[1] == labels).sum().item()
 
-        # Save client state (head)
-        if self.client_save_path is not None:
-            torch.save(self._model.head.state_dict(), self.client_save_path)
+        # Save state.
+        self._save_client_state()
 
         return {"loss": loss.item(), "accuracy": correct / total}
 
-    def test(self) -> Dict[str, float]:
+    def test(self, device: torch.device) -> Dict[str, float]:
         """Test the model maintained in self.model.
 
         Returns
         -------
             Dict containing the test metrics.
         """
-        # Load client state (head)
-        if self.client_save_path is not None and os.path.isfile(self.client_save_path):
-            self._model.head.load_state_dict(torch.load(self.client_save_path))
+        # Load state.
+        self._load_client_state()
 
         num_finetune_epochs = DEFAULT_FINETUNE_EPOCHS
-        if hasattr(self.config, "num_finetune_epochs"):
-            num_finetune_epochs = int(self.config.num_finetune_epochs)
+        if "num-finetune-epochs" in self.context.run_config:
+            num_finetune_epochs = int(self.context.run_config["num-finetune-epochs"])
 
-        if num_finetune_epochs > 0 and self.config.get("enable_finetune", False):
+        if num_finetune_epochs > 0 and self.context.run_config.get(
+            "enable-finetune", False
+        ):
             optimizer = torch.optim.SGD(self._model.parameters(), lr=self.learning_rate)
             criterion = torch.nn.CrossEntropyLoss()
             self._model.train()
             for _ in range(num_finetune_epochs):
                 for batch in self.trainloader:
-                    images = batch["img"].to(self.device)
-                    labels = batch["label"].to(self.device)
+                    images = batch["img"]
+                    labels = batch["label"]
                     outputs = self._model(images)
                     loss = criterion(outputs, labels)
                     optimizer.zero_grad()
@@ -296,11 +279,12 @@ def test(self) -> Dict[str, float]:
         criterion = torch.nn.CrossEntropyLoss()
         correct, total, loss = 0, 0, 0.0
 
+        self._model.to(device)
         self._model.eval()
         with torch.no_grad():
             for batch in self.testloader:
-                images = batch["img"].to(self.device)
-                labels = batch["label"].to(self.device)
+                images = batch["img"].to(device)
+                labels = batch["label"].to(device)
                 outputs = self._model(images)
                 loss += criterion(outputs, labels).item()
                 total += labels.size(0)
diff --git a/baselines/fedrep/fedrep/client.py b/baselines/fedrep/fedrep/client.py
deleted file mode 100644
index f857fd2cf82a..000000000000
--- a/baselines/fedrep/fedrep/client.py
+++ /dev/null
@@ -1,319 +0,0 @@
-"""Client implementation - can call FedPep and FedAvg clients."""
-
-from collections import OrderedDict
-from pathlib import Path
-from typing import Callable, Dict, List, Tuple, Type, Union
-
-import numpy as np
-import torch
-from flwr.client import Client, NumPyClient
-from flwr.common import NDArrays, Scalar
-from flwr_datasets import FederatedDataset
-from flwr_datasets.partitioner import PathologicalPartitioner
-from flwr_datasets.preprocessor import Merger
-from omegaconf import DictConfig
-from torch.utils.data import DataLoader
-from torchvision import transforms
-
-from fedrep.constants import MEAN, STD, Algorithm
-from fedrep.models import CNNCifar10ModelManager, CNNCifar100ModelManager
-
-PROJECT_DIR = Path(__file__).parent.parent.absolute()
-
-FEDERATED_DATASET = None
-
-
-class BaseClient(NumPyClient):
-    """Implementation of Federated Averaging (FedAvg) Client."""
-
-    # pylint: disable=R0913
-    def __init__(
-        self,
-        client_id: int,
-        trainloader: DataLoader,
-        testloader: DataLoader,
-        config: DictConfig,
-        model_manager_class: Union[
-            Type[CNNCifar10ModelManager], Type[CNNCifar100ModelManager]
-        ],
-        client_state_save_path: str = "",
-    ):
-        """Initialize client attributes.
-
-        Args:
-            client_id: The client ID.
-            trainloader: Client train data loader.
-            testloader: Client test data loader.
-            config: dictionary containing the client configurations.
-            model_manager_class: class to be used as the model manager.
-            client_state_save_path: Path for saving model head parameters.
-                (Just for FedRep). Defaults to "".
-        """
-        super().__init__()
-
-        self.client_id = client_id
-        self.client_state_save_path = (
-            (client_state_save_path + f"/client_{self.client_id}")
-            if client_state_save_path != ""
-            else None
-        )
-        self.model_manager = model_manager_class(
-            client_id=self.client_id,
-            config=config,
-            trainloader=trainloader,
-            testloader=testloader,
-            client_save_path=self.client_state_save_path,
-        )
-
-    def get_parameters(self, config: Dict[str, Scalar]) -> NDArrays:
-        """Return the current local model parameters."""
-        return self.model_manager.model.get_parameters()
-
-    def set_parameters(
-        self, parameters: List[np.ndarray], evaluate: bool = False
-    ) -> None:
-        """Set the local model parameters to the received parameters.
-
-        Args:
-            parameters: parameters to set the model to.
-        """
-        _ = evaluate
-        model_keys = [
-            k
-            for k in self.model_manager.model.state_dict().keys()
-            if k.startswith("_body") or k.startswith("_head")
-        ]
-        params_dict = zip(model_keys, parameters)
-
-        state_dict = OrderedDict({k: torch.tensor(v) for k, v in params_dict})
-
-        self.model_manager.model.set_parameters(state_dict)
-
-    def perform_train(self) -> Dict[str, Union[List[Dict[str, float]], int, float]]:
-        """Perform local training to the whole model.
-
-        Returns
-        -------
-            Dict with the train metrics.
-        """
-        self.model_manager.model.enable_body()
-        self.model_manager.model.enable_head()
-
-        return self.model_manager.train()
-
-    def fit(
-        self, parameters: NDArrays, config: Dict[str, Scalar]
-    ) -> Tuple[NDArrays, int, Dict[str, Union[bool, bytes, float, int, str]]]:
-        """Train the provided parameters using the locally held dataset.
-
-        Args:
-            parameters: The current (global) model parameters.
-            config: configuration parameters for training sent by the server.
-
-        Returns
-        -------
-            Tuple containing the locally updated model parameters, \
-                the number of examples used for training and \
-                the training metrics.
-        """
-        self.set_parameters(parameters)
-
-        train_results = self.perform_train()
-
-        # Update train history
-        print("<------- TRAIN RESULTS -------> :", train_results)
-
-        return self.get_parameters(config), self.model_manager.train_dataset_size(), {}
-
-    def evaluate(
-        self, parameters: NDArrays, config: Dict[str, Scalar]
-    ) -> Tuple[float, int, Dict[str, Union[bool, bytes, float, int, str]]]:
-        """Evaluate the provided global parameters using the locally held dataset.
-
-        Args:
-            parameters: The current (global) model parameters.
-            config: configuration parameters for training sent by the server.
-
-        Returns
-        -------
-        Tuple containing the test loss, \
-                the number of examples used for evaluation and \
-                the evaluation metrics.
-        """
-        self.set_parameters(parameters, evaluate=True)
-
-        # Test the model
-        test_results = self.model_manager.test()
-        print("<------- TEST RESULTS -------> :", test_results)
-
-        return (
-            test_results.get("loss", 0.0),
-            self.model_manager.test_dataset_size(),
-            {k: v for k, v in test_results.items() if not isinstance(v, (dict, list))},
-        )
-
-
-class FedRepClient(BaseClient):
-    """Implementation of Federated Personalization (FedRep) Client."""
-
-    def get_parameters(self, config: Dict[str, Scalar]) -> NDArrays:
-        """Return the current local body parameters."""
-        return [
-            val.cpu().numpy()
-            for val in self.model_manager.model.body.state_dict().values()
-        ]
-
-    def set_parameters(self, parameters: List[np.ndarray], evaluate=False) -> None:
-        """Set the local body parameters to the received parameters.
-
-        Args:
-            parameters: parameters to set the body to.
-            evaluate: whether the client is evaluating or not.
-        """
-        model_keys = [
-            k
-            for k in self.model_manager.model.state_dict().keys()
-            if k.startswith("_body")
-        ]
-
-        if not evaluate:
-            # Only update client's local head if it hasn't trained yet
-            model_keys.extend(
-                [
-                    k
-                    for k in self.model_manager.model.state_dict().keys()
-                    if k.startswith("_head")
-                ]
-            )
-
-        state_dict = OrderedDict(
-            (k, torch.from_numpy(v)) for k, v in zip(model_keys, parameters)
-        )
-
-        self.model_manager.model.set_parameters(state_dict)
-
-
-# pylint: disable=E1101, W0603
-def get_client_fn_simulation(
-    config: DictConfig, client_state_save_path: str = ""
-) -> Callable[[str], Client]:
-    """Generate the client function that creates the Flower Clients.
-
-    Parameters
-    ----------
-    model : DictConfig
-        The model configuration.
-    cleint_state_save_path : str
-        The path to save the client state.
-
-    Returns
-    -------
-    Tuple[Callable[[str], FlowerClient], DataLoader]
-        A tuple containing the client function that creates Flower Clients and
-        the DataLoader that will be used for testing
-    """
-    assert config.model_name.lower() in [
-        "cnncifar10",
-        "cnncifar100",
-    ], f"Model {config.model_name} not implemented"
-
-    # - you can define your own data transformation strategy here -
-    # These transformations are from the official repo
-    train_data_transform = transforms.Compose(
-        [
-            transforms.RandomCrop(32, padding=4),
-            transforms.RandomHorizontalFlip(),
-            transforms.ToTensor(),
-            transforms.Normalize(MEAN[config.dataset.name], STD[config.dataset.name]),
-        ]
-    )
-    test_data_transform = transforms.Compose(
-        [
-            transforms.ToTensor(),
-            transforms.Normalize(MEAN[config.dataset.name], STD[config.dataset.name]),
-        ]
-    )
-
-    use_fine_label = False
-    if config.dataset.name.lower() == "cifar100":
-        use_fine_label = True
-
-    partitioner = PathologicalPartitioner(
-        num_partitions=config.num_clients,
-        partition_by="fine_label" if use_fine_label else "label",
-        num_classes_per_partition=config.dataset.num_classes,
-        class_assignment_mode="random",
-        shuffle=True,
-        seed=config.dataset.seed,
-    )
-
-    global FEDERATED_DATASET
-    if FEDERATED_DATASET is None:
-        FEDERATED_DATASET = FederatedDataset(
-            dataset=config.dataset.name.lower(),
-            partitioners={"all": partitioner},
-            preprocessor=Merger({"all": ("train", "test")}),
-        )
-
-    def apply_train_transforms(batch):
-        """Apply transforms for train data to the partition from FederatedDataset."""
-        batch["img"] = [train_data_transform(img) for img in batch["img"]]
-        if use_fine_label:
-            batch["label"] = batch["fine_label"]
-        return batch
-
-    def apply_test_transforms(batch):
-        """Apply transforms for test data to the partition from FederatedDataset."""
-        batch["img"] = [test_data_transform(img) for img in batch["img"]]
-        if use_fine_label:
-            batch["label"] = batch["fine_label"]
-        return batch
-
-    # pylint: disable=E1101
-    def client_fn(cid: str) -> Client:
-        """Create a Flower client representing a single organization."""
-        cid_use = int(cid)
-
-        partition = FEDERATED_DATASET.load_partition(cid_use, split="all")
-
-        partition_train_test = partition.train_test_split(
-            train_size=config.dataset.fraction, shuffle=True, seed=config.dataset.seed
-        )
-
-        trainset = partition_train_test["train"].with_transform(apply_train_transforms)
-        testset = partition_train_test["test"].with_transform(apply_test_transforms)
-
-        trainloader = DataLoader(trainset, config.batch_size, shuffle=True)
-        testloader = DataLoader(testset, config.batch_size)
-
-        model_manager_class: Union[
-            Type[CNNCifar10ModelManager], Type[CNNCifar100ModelManager]
-        ]
-        if config.model_name.lower() == "cnncifar10":
-            model_manager_class = CNNCifar10ModelManager
-        elif config.model_name.lower() == "cnncifar100":
-            model_manager_class = CNNCifar100ModelManager
-        else:
-            raise NotImplementedError(
-                f"Model {config.model_name} not implemented, check name."
-            )
-
-        if config.algorithm.lower() == Algorithm.FEDREP.value:
-            return FedRepClient(  # type: ignore[attr-defined]
-                client_id=cid_use,
-                trainloader=trainloader,
-                testloader=testloader,
-                config=config,
-                model_manager_class=model_manager_class,
-                client_state_save_path=client_state_save_path,
-            ).to_client()
-        return BaseClient(  # type: ignore[attr-defined]
-            client_id=cid_use,
-            trainloader=trainloader,
-            testloader=testloader,
-            config=config,
-            model_manager_class=model_manager_class,
-            client_state_save_path=client_state_save_path,
-        ).to_client()
-
-    return client_fn
diff --git a/baselines/fedrep/fedrep/client_app.py b/baselines/fedrep/fedrep/client_app.py
new file mode 100644
index 000000000000..78755f4484aa
--- /dev/null
+++ b/baselines/fedrep/fedrep/client_app.py
@@ -0,0 +1,186 @@
+"""fedrep: A Flower Baseline."""
+
+from collections import OrderedDict
+from typing import Dict, List, Tuple, Union
+
+import torch
+
+from flwr.client import ClientApp, NumPyClient
+from flwr.client.client import Client
+from flwr.common import Context, NDArrays, ParametersRecord, Scalar
+
+from .constants import FEDREP_HEAD_STATE, Algorithm
+from .dataset import load_data
+from .models import CNNCifar10ModelManager, CNNCifar100ModelManager
+from .utils import get_model_manager_class
+
+
+class BaseClient(NumPyClient):
+    """Implementation of Federated Averaging (FedAvg) Client."""
+
+    # pylint: disable=R0913
+    def __init__(
+        self, model_manager: Union[CNNCifar10ModelManager, CNNCifar100ModelManager]
+    ):
+        """Initialize client attributes.
+
+        Args:
+            model_manager: the model manager object
+        """
+        super().__init__()
+        self.model_manager = model_manager
+
+        self.device = torch.device("cuda:0" if torch.cuda.is_available() else "cpu")
+
+    def get_parameters(self, config: Dict[str, Scalar]) -> NDArrays:
+        """Return the current local model parameters."""
+        return self.model_manager.model.get_parameters()
+
+    def set_parameters(self, parameters: NDArrays, evaluate: bool = False) -> None:
+        """Set the local model parameters to the received parameters.
+
+        Args:
+            parameters: parameters to set the model to.
+            evaluate: whether to evaluate or not.
+        """
+        _ = evaluate
+        model_keys = [
+            k
+            for k in self.model_manager.model.state_dict().keys()
+            if k.startswith("_body") or k.startswith("_head")
+        ]
+        params_dict = zip(model_keys, parameters)
+        state_dict = OrderedDict({k: torch.tensor(v) for k, v in params_dict})
+        self.model_manager.model.set_parameters(state_dict)
+
+    def perform_train(self) -> Dict[str, Union[List[Dict[str, float]], int, float]]:
+        """Perform local training to the whole model.
+
+        Returns
+        -------
+            Dict with the train metrics.
+        """
+        self.model_manager.model.enable_body()
+        self.model_manager.model.enable_head()
+
+        return self.model_manager.train(self.device)
+
+    def fit(
+        self, parameters: NDArrays, config: Dict[str, Scalar]
+    ) -> Tuple[NDArrays, int, Dict[str, Union[bool, bytes, float, int, str]]]:
+        """Train the provided parameters using the locally held dataset.
+
+        Args:
+            parameters: The current (global) model parameters.
+            config: configuration parameters for training sent by the server.
+
+        Returns
+        -------
+            Tuple containing the locally updated model parameters, \
+                the number of examples used for training and \
+                the training metrics.
+        """
+        self.set_parameters(parameters)
+        self.perform_train()
+
+        return self.get_parameters(config), self.model_manager.train_dataset_size(), {}
+
+    def evaluate(
+        self, parameters: NDArrays, config: Dict[str, Scalar]
+    ) -> Tuple[float, int, Dict[str, Union[bool, bytes, float, int, str]]]:
+        """Evaluate the provided global parameters using the locally held dataset.
+
+        Args:
+            parameters: The current (global) model parameters.
+            config: configuration parameters for training sent by the server.
+
+        Returns
+        -------
+        Tuple containing the test loss, \
+                the number of examples used for evaluation and \
+                the evaluation metrics.
+        """
+        self.set_parameters(parameters, evaluate=True)
+
+        # Test the model
+        test_results = self.model_manager.test(self.device)
+
+        return (
+            test_results.get("loss", 0.0),
+            self.model_manager.test_dataset_size(),
+            {k: v for k, v in test_results.items() if not isinstance(v, (dict, list))},
+        )
+
+
+class FedRepClient(BaseClient):
+    """Implementation of Federated Personalization (FedRep) Client."""
+
+    def get_parameters(self, config: Dict[str, Scalar]) -> NDArrays:
+        """Return the current local body parameters."""
+        return [
+            val.cpu().numpy()
+            for val in self.model_manager.model.body.state_dict().values()
+        ]
+
+    def set_parameters(self, parameters: NDArrays, evaluate: bool = False) -> None:
+        """Set the local body parameters to the received parameters.
+
+        Args:
+            parameters: parameters to set the body to.
+            evaluate: whether the client is evaluating or not.
+        """
+        model_keys = [
+            k
+            for k in self.model_manager.model.state_dict().keys()
+            if k.startswith("_body")
+        ]
+
+        if not evaluate:
+            # Only update client's local head if it hasn't trained yet
+            model_keys.extend(
+                [
+                    k
+                    for k in self.model_manager.model.state_dict().keys()
+                    if k.startswith("_head")
+                ]
+            )
+
+        state_dict = OrderedDict(
+            (k, torch.from_numpy(v)) for k, v in zip(model_keys, parameters)
+        )
+
+        self.model_manager.model.set_parameters(state_dict)
+
+
+def client_fn(context: Context) -> Client:
+    """Construct a Client that will be run in a ClientApp."""
+    model_manager_class = get_model_manager_class(context)
+    algorithm = str(context.run_config["algorithm"]).lower()
+    partition_id = int(context.node_config["partition-id"])
+    num_partitions = int(context.node_config["num-partitions"])
+    trainloader, valloader = load_data(
+        partition_id, num_partitions, context
+    )  # load the data
+    if algorithm == Algorithm.FEDAVG.value:
+        client_class = BaseClient
+    elif algorithm == Algorithm.FEDREP.value:
+        # This state variable will only be used by the FedRep algorithm.
+        # We only need to initialize once, since client_fn will be called
+        # again at every invocation of the ClientApp.
+        if FEDREP_HEAD_STATE not in context.state.parameters_records:
+            context.state.parameters_records[FEDREP_HEAD_STATE] = ParametersRecord()
+        client_class = FedRepClient
+    else:
+        raise RuntimeError(f"Unknown algorithm {algorithm}.")
+
+    model_manager_obj = model_manager_class(
+        context=context, trainloader=trainloader, testloader=valloader
+    )
+
+    # Return client object.
+    client = client_class(model_manager_obj).to_client()
+    return client
+
+
+# Flower ClientApp
+app = ClientApp(client_fn)
diff --git a/baselines/fedrep/fedrep/conf/base.yaml b/baselines/fedrep/fedrep/conf/base.yaml
deleted file mode 100644
index 0d74c4fe78b6..000000000000
--- a/baselines/fedrep/fedrep/conf/base.yaml
+++ /dev/null
@@ -1,46 +0,0 @@
----
-num_clients: 100 # total number of clients
-num_local_epochs: 5 # number of local epochs
-num_rep_epochs: 1 # number of representation epochs (only for FedRep)
-enable_finetune: false
-# num_finetune_epochs: 10
-batch_size: 50
-num_rounds: 100
-learning_rate: 0.01
-momentum: 0.5
-algorithm: fedrep
-model_name: cnncifar10
-
-client_resources:
-  num_cpus: 2
-  num_gpus: 0.5
-
-use_cuda: true
-specified_device: null # the ID of cuda device, if null, then use defaults torch.device("cuda")
-
-dataset:
-  name: cifar10
-  split: sample
-  num_classes: 2
-  seed: 42
-  num_clients: ${num_clients}
-  fraction: 0.83
-
-model:
-  _target_: fedrep.implemented_models.cnn_cifar100.CNNCifar10
-
-fit_config:
-  drop_client: false
-  epochs: ${num_local_epochs}
-  batch_size: ${batch_size}
-
-strategy:
-  _target_: fedrep.strategy.FedRep
-  fraction_fit: 0.1
-  fraction_evaluate: 0.1
-  min_fit_clients: 2
-  min_evaluate_clients: 2
-  min_available_clients: 2
-  evaluate_fn: null
-  on_fit_config_fn: null
-  on_evaluate_config_fn: null
diff --git a/baselines/fedrep/fedrep/conf/cifar100_100_20.yaml b/baselines/fedrep/fedrep/conf/cifar100_100_20.yaml
deleted file mode 100644
index 30f9fd209d58..000000000000
--- a/baselines/fedrep/fedrep/conf/cifar100_100_20.yaml
+++ /dev/null
@@ -1,44 +0,0 @@
----
-num_clients: 100 # total number of clients
-num_local_epochs: 5 # number of local epochs
-num_rep_epochs: 1 # number of representation epochs (only for FedRep)
-enable_finetune: false
-# num_finetune_epochs: 10
-batch_size: 50
-num_rounds: 100
-learning_rate: 0.01
-momentum: 0.5
-algorithm: fedrep
-model_name: cnncifar100
-
-client_resources:
-  num_cpus: 2
-  num_gpus: 0.5
-
-use_cuda: true
-specified_device: null
-
-dataset:
-  name: cifar100
-  num_classes: 20
-  seed: 42
-  fraction: 0.83
-
-model:
-  _target_: fedrep.implemented_models.cnn_cifar100.CNNCifar100
-
-fit_config:
-  drop_client: false
-  epochs: ${num_local_epochs}
-  batch_size: ${batch_size}
-
-strategy:
-  _target_: fedrep.strategy.FedRep
-  fraction_fit: 0.1
-  fraction_evaluate: 0.1
-  min_fit_clients: 2
-  min_evaluate_clients: 2
-  min_available_clients: 2
-  evaluate_fn: null
-  on_fit_config_fn: null
-  on_evaluate_config_fn: null
diff --git a/baselines/fedrep/fedrep/conf/cifar100_100_5.yaml b/baselines/fedrep/fedrep/conf/cifar100_100_5.yaml
deleted file mode 100644
index e0add8f03b45..000000000000
--- a/baselines/fedrep/fedrep/conf/cifar100_100_5.yaml
+++ /dev/null
@@ -1,44 +0,0 @@
----
-num_clients: 100 # total number of clients
-num_local_epochs: 5 # number of local epochs
-num_rep_epochs: 1 # number of representation epochs (only for FedRep)
-enable_finetune: false
-# num_finetune_epochs: 10
-batch_size: 50
-num_rounds: 100
-learning_rate: 0.01
-momentum: 0.5
-algorithm: fedrep
-model_name: cnncifar100
-
-client_resources:
-  num_cpus: 2
-  num_gpus: 0.5
-
-use_cuda: true
-specified_device: null
-
-dataset:
-  name: cifar100
-  num_classes: 5
-  seed: 42
-  fraction: 0.83
-
-model:
-  _target_: fedrep.implemented_models.cnn_cifar100.CNNCifar100
-
-fit_config:
-  drop_client: false
-  epochs: ${num_local_epochs}
-  batch_size: ${batch_size}
-
-strategy:
-  _target_: fedrep.strategy.FedRep
-  fraction_fit: 0.1
-  fraction_evaluate: 0.1
-  min_fit_clients: 2
-  min_evaluate_clients: 2
-  min_available_clients: 2
-  evaluate_fn: null
-  on_fit_config_fn: null
-  on_evaluate_config_fn: null
diff --git a/baselines/fedrep/fedrep/conf/cifar10_100_2.yaml b/baselines/fedrep/fedrep/conf/cifar10_100_2.yaml
deleted file mode 100644
index 83ee34a298ae..000000000000
--- a/baselines/fedrep/fedrep/conf/cifar10_100_2.yaml
+++ /dev/null
@@ -1,44 +0,0 @@
----
-num_clients: 100 # total number of clients
-num_local_epochs: 5 # number of local epochs
-num_rep_epochs: 1 # number of representation epochs (only for FedRep)
-enable_finetune: false
-# num_finetune_epochs: 10
-batch_size: 50
-num_rounds: 100
-learning_rate: 0.01
-momentum: 0.5
-algorithm: fedrep
-model_name: cnncifar10
-
-client_resources:
-  num_cpus: 2
-  num_gpus: 0.5
-
-use_cuda: true
-specified_device: null
-
-dataset:
-  name: cifar10
-  num_classes: 2
-  seed: 42
-  fraction: 0.83
-
-model:
-  _target_: fedrep.implemented_models.cnn_cifar10.CNNCifar10
-
-fit_config:
-  drop_client: false
-  epochs: ${num_local_epochs}
-  batch_size: ${batch_size}
-
-strategy:
-  _target_: fedrep.strategy.FedRep
-  fraction_fit: 0.1
-  fraction_evaluate: 0.1
-  min_fit_clients: 2
-  min_evaluate_clients: 2
-  min_available_clients: 2
-  evaluate_fn: null
-  on_fit_config_fn: null
-  on_evaluate_config_fn: null
diff --git a/baselines/fedrep/fedrep/conf/cifar10_100_5.yaml b/baselines/fedrep/fedrep/conf/cifar10_100_5.yaml
deleted file mode 100644
index 0cbd104406f0..000000000000
--- a/baselines/fedrep/fedrep/conf/cifar10_100_5.yaml
+++ /dev/null
@@ -1,44 +0,0 @@
----
-num_clients: 100 # total number of clients
-num_local_epochs: 5 # number of local epochs
-num_rep_epochs: 1 # number of representation epochs (only for FedRep)
-enable_finetune: false
-# num_finetune_epochs: 10
-batch_size: 50
-num_rounds: 100
-learning_rate: 0.01
-momentum: 0.5
-algorithm: fedrep
-model_name: cnncifar10
-
-client_resources:
-  num_cpus: 2
-  num_gpus: 0.5
-
-use_cuda: true
-specified_device: null
-
-dataset:
-  name: cifar10
-  num_classes: 5
-  seed: 42
-  fraction: 0.83
-
-model:
-  _target_: fedrep.implemented_models.cnn_cifar10.CNNCifar10
-
-fit_config:
-  drop_client: false
-  epochs: ${num_local_epochs}
-  batch_size: ${batch_size}
-
-strategy:
-  _target_: fedrep.strategy.FedRep
-  fraction_fit: 0.1
-  fraction_evaluate: 0.1
-  min_fit_clients: 2
-  min_evaluate_clients: 2
-  min_available_clients: 2
-  evaluate_fn: null
-  on_fit_config_fn: null
-  on_evaluate_config_fn: null
diff --git a/baselines/fedrep/fedrep/constants.py b/baselines/fedrep/fedrep/constants.py
index 27e68f2b786c..a4527e1f36d4 100644
--- a/baselines/fedrep/fedrep/constants.py
+++ b/baselines/fedrep/fedrep/constants.py
@@ -1,7 +1,16 @@
-"""Constants used in machine learning pipeline."""
+"""fedrep: A Flower Baseline."""
 
 from enum import Enum
 
+DEFAULT_LOCAL_TRAIN_EPOCHS: int = 10
+DEFAULT_FINETUNE_EPOCHS: int = 5
+DEFAULT_REPRESENTATION_EPOCHS: int = 1
+FEDREP_HEAD_STATE = "fedrep_head_state"
+
+MEAN = {"cifar10": [0.485, 0.456, 0.406], "cifar100": [0.507, 0.487, 0.441]}
+
+STD = {"cifar10": [0.229, 0.224, 0.225], "cifar100": [0.267, 0.256, 0.276]}
+
 
 class Algorithm(Enum):
     """Algorithm names."""
@@ -10,10 +19,8 @@ class Algorithm(Enum):
     FEDAVG = "fedavg"
 
 
-DEFAULT_LOCAL_TRAIN_EPOCHS: int = 10
-DEFAULT_FINETUNE_EPOCHS: int = 5
-DEFAULT_REPRESENTATION_EPOCHS: int = 1
+class ModelDatasetName(Enum):
+    """Dataset names."""
 
-MEAN = {"cifar10": [0.485, 0.456, 0.406], "cifar100": [0.507, 0.487, 0.441]}
-
-STD = {"cifar10": [0.229, 0.224, 0.225], "cifar100": [0.267, 0.256, 0.276]}
+    CNN_CIFAR_10 = "cnncifar10"
+    CNN_CIFAR_100 = "cnncifar100"
diff --git a/baselines/fedrep/fedrep/dataset.py b/baselines/fedrep/fedrep/dataset.py
index a616e38ae220..621baf98249a 100644
--- a/baselines/fedrep/fedrep/dataset.py
+++ b/baselines/fedrep/fedrep/dataset.py
@@ -1 +1,107 @@
-"""FedRep uses flwr-datasets."""
+"""fedrep: A Flower Baseline."""
+
+from typing import Tuple
+
+from flwr_datasets import FederatedDataset
+from flwr_datasets.partitioner import PathologicalPartitioner
+from flwr_datasets.preprocessor import Merger
+from torch.utils.data import DataLoader, Dataset
+from torchvision import transforms
+
+from flwr.common import Context
+
+from .constants import MEAN, STD
+
+FDS = None  # Cache FederatedDataset
+
+
+def load_data(
+    partition_id: int, num_partitions: int, context: Context
+) -> Tuple[DataLoader, DataLoader]:
+    """Split the data and return training and testing data for the specified partition.
+
+    Parameters
+    ----------
+    partition_id : int
+        Partition number for which to retrieve the corresponding data.
+    num_partitions : int
+        Total number of partitions.
+    context: Context
+        the context of the current run.
+
+    Returns
+    -------
+    data : Tuple[DataLoader, DataLoader]
+        A tuple with the training and testing data for the current partition_id.
+    """
+    batch_size = int(context.run_config["batch-size"])
+    dataset_name = str(context.run_config["dataset-name"]).lower()
+    dataset_split_num_classes = int(context.run_config["dataset-split-num-classes"])
+    dataset_split_seed = int(context.run_config["dataset-split-seed"])
+    dataset_split_fraction = float(context.run_config["dataset-split-fraction"])
+
+    # - you can define your own data transformation strategy here -
+    # These transformations are from the official repo
+    train_data_transform = transforms.Compose(
+        [
+            transforms.RandomCrop(32, padding=4),
+            transforms.RandomHorizontalFlip(),
+            transforms.ToTensor(),
+            transforms.Normalize(MEAN[dataset_name], STD[dataset_name]),
+        ]
+    )
+    test_data_transform = transforms.Compose(
+        [
+            transforms.ToTensor(),
+            transforms.Normalize(MEAN[dataset_name], STD[dataset_name]),
+        ]
+    )
+
+    use_fine_label = False
+    if dataset_name == "cifar100":
+        use_fine_label = True
+
+    partitioner = PathologicalPartitioner(
+        num_partitions=num_partitions,
+        partition_by="fine_label" if use_fine_label else "label",
+        num_classes_per_partition=dataset_split_num_classes,
+        class_assignment_mode="random",
+        shuffle=True,
+        seed=dataset_split_seed,
+    )
+
+    global FDS  # pylint: disable=global-statement
+    if FDS is None:
+        FDS = FederatedDataset(
+            dataset=dataset_name,
+            partitioners={"all": partitioner},
+            preprocessor=Merger({"all": ("train", "test")}),
+        )
+
+    def apply_train_transforms(batch: Dataset) -> Dataset:
+        """Apply transforms for train data to the partition from FederatedDataset."""
+        batch["img"] = [train_data_transform(img) for img in batch["img"]]
+        if use_fine_label:
+            batch["label"] = batch["fine_label"]
+        return batch
+
+    def apply_test_transforms(batch: Dataset) -> Dataset:
+        """Apply transforms for test data to the partition from FederatedDataset."""
+        batch["img"] = [test_data_transform(img) for img in batch["img"]]
+        if use_fine_label:
+            batch["label"] = batch["fine_label"]
+        return batch
+
+    partition = FDS.load_partition(partition_id, split="all")
+
+    partition_train_test = partition.train_test_split(
+        train_size=dataset_split_fraction, shuffle=True, seed=dataset_split_seed
+    )
+
+    trainset = partition_train_test["train"].with_transform(apply_train_transforms)
+    testset = partition_train_test["test"].with_transform(apply_test_transforms)
+
+    trainloader = DataLoader(trainset, batch_size, shuffle=True)
+    testloader = DataLoader(testset, batch_size)
+
+    return trainloader, testloader
diff --git a/baselines/fedrep/fedrep/dataset_preparation.py b/baselines/fedrep/fedrep/dataset_preparation.py
deleted file mode 100644
index a616e38ae220..000000000000
--- a/baselines/fedrep/fedrep/dataset_preparation.py
+++ /dev/null
@@ -1 +0,0 @@
-"""FedRep uses flwr-datasets."""
diff --git a/baselines/fedrep/fedrep/main.py b/baselines/fedrep/fedrep/main.py
deleted file mode 100644
index 223b98aa21fa..000000000000
--- a/baselines/fedrep/fedrep/main.py
+++ /dev/null
@@ -1,123 +0,0 @@
-"""Create and connect the building blocks for your experiments; start the simulation.
-
-It includes processioning the dataset, instantiate strategy, specify how the global
-model is going to be evaluated, etc. At the end, this script saves the results.
-"""
-
-from pathlib import Path
-from typing import List, Tuple
-
-import flwr as fl
-import hydra
-from flwr.common.parameter import ndarrays_to_parameters
-from flwr.common.typing import Metrics
-from hydra.core.hydra_config import HydraConfig
-from hydra.utils import instantiate
-from omegaconf import DictConfig, OmegaConf
-
-from fedrep.utils import (
-    get_client_fn,
-    get_create_model_fn,
-    plot_metric_from_history,
-    save_results_as_pickle,
-    set_client_state_save_path,
-    set_client_strategy,
-)
-
-
-@hydra.main(config_path="conf", config_name="base", version_base=None)
-def main(cfg: DictConfig) -> None:
-    """Run the baseline.
-
-    Parameterss
-    ----------
-    cfg : DictConfig
-        An omegaconf object that stores the hydra config.
-    """
-    # Print parsed config
-    print(OmegaConf.to_yaml(cfg))
-
-    # set client strategy
-    cfg = set_client_strategy(cfg)
-
-    # Create directory to store client states if it does not exist
-    # Client state has subdirectories with the name of current time
-    client_state_save_path = set_client_state_save_path()
-
-    # Define your clients
-    # Get client function
-    client_fn = get_client_fn(config=cfg, client_state_save_path=client_state_save_path)
-
-    # get a function that will be used to construct the config that the client's
-    # fit() method will received
-    def get_on_fit_config():
-        def fit_config_fn(server_round: int):
-            # resolve and convert to python dict
-            fit_config = OmegaConf.to_container(cfg.fit_config, resolve=True)
-            _ = server_round
-            return fit_config
-
-        return fit_config_fn
-
-    # get a function that will be used to construct the model
-    create_model, split = get_create_model_fn(cfg)
-
-    model = split(create_model())
-
-    def evaluate_metrics_aggregation_fn(
-        eval_metrics: List[Tuple[int, Metrics]]
-    ) -> Metrics:
-        weights, accuracies = [], []
-        for num_examples, metric in eval_metrics:
-            weights.append(num_examples)
-            accuracies.append(metric["accuracy"] * num_examples)
-        accuracy = sum(accuracies) / sum(weights)  # type: ignore[arg-type]
-        return {"accuracy": accuracy}
-
-    # Define your strategy
-    strategy = instantiate(
-        cfg.strategy,
-        initial_parameters=ndarrays_to_parameters(model.get_parameters()),
-        on_fit_config_fn=get_on_fit_config(),
-        evaluate_metrics_aggregation_fn=evaluate_metrics_aggregation_fn,
-    )
-
-    # Start Simulation
-    history = fl.simulation.start_simulation(
-        client_fn=client_fn,
-        num_clients=cfg.num_clients,
-        config=fl.server.ServerConfig(num_rounds=cfg.num_rounds),
-        client_resources={
-            "num_cpus": cfg.client_resources.num_cpus,
-            "num_gpus": cfg.client_resources.num_gpus,
-        },
-        strategy=strategy,
-    )
-
-    # Experiment completed. Now we save the results and
-    # generate plots using the `history`
-    print("................")
-    print(history)
-
-    # Save your results
-    save_path = Path(HydraConfig.get().runtime.output_dir)
-
-    # save results as a Python pickle using a file_path
-    # the directory created by Hydra for each run
-    save_results_as_pickle(history, file_path=save_path)
-    # plot results and include them in the readme
-    strategy_name = strategy.__class__.__name__
-    file_suffix: str = (
-        f"_{strategy_name}"
-        f"_C={cfg.num_clients}"
-        f"_B={cfg.batch_size}"
-        f"_E={cfg.num_local_epochs}"
-        f"_R={cfg.num_rounds}"
-        f"_lr={cfg.learning_rate}"
-    )
-
-    plot_metric_from_history(history, save_path, (file_suffix))
-
-
-if __name__ == "__main__":
-    main()
diff --git a/baselines/fedrep/fedrep/models.py b/baselines/fedrep/fedrep/models.py
index b230f4e49766..314d7cc91688 100644
--- a/baselines/fedrep/fedrep/models.py
+++ b/baselines/fedrep/fedrep/models.py
@@ -1,11 +1,11 @@
-"""Model, model manager and model split for CIFAR-10 and CIFAR-100."""
+"""fedrep: A Flower Baseline."""
 
 from typing import Tuple
 
 import torch
-import torch.nn as nn
+from torch import nn
 
-from fedrep.base_model import ModelManager, ModelSplit
+from .base_model import ModelManager, ModelSplit
 
 
 # pylint: disable=W0223
@@ -58,17 +58,12 @@ class CNNCifar10ModelManager(ModelManager):
     """Manager for models with Body/Head split."""
 
     def __init__(self, **kwargs):
-        """Initialize the attributes of the model manager.
-
-        Args:
-            client_id: The id of the client.
-            config: Dict containing the configurations to be used by the manager.
-        """
+        """Initialize the attributes of the model manager."""
         super().__init__(model_split_class=CNNCifar10ModelSplit, **kwargs)
 
     def _create_model(self) -> nn.Module:
-        """Return CNNCifar10 model to be splitted into head and body."""
-        return CNNCifar10().to(self.device)
+        """Return CNNCifar10 model to be split into head and body."""
+        return CNNCifar10()
 
 
 # pylint: disable=W0223
@@ -104,6 +99,11 @@ def __init__(self):
 
         self.head = nn.Sequential(nn.Linear(128, 100))
 
+    def forward(self, x: torch.Tensor) -> torch.Tensor:
+        """Forward pass of the model."""
+        x = self.body(x)
+        return self.head(x)
+
 
 class CNNCifar100ModelSplit(ModelSplit):
     """Split CNNCifar100 model into body and head."""
@@ -117,14 +117,9 @@ class CNNCifar100ModelManager(ModelManager):
     """Manager for models with Body/Head split."""
 
     def __init__(self, **kwargs):
-        """Initialize the attributes of the model manager.
-
-        Args:
-            client_id: The id of the client.
-            config: Dict containing the configurations to be used by the manager.
-        """
+        """Initialize the attributes of the model manager."""
         super().__init__(model_split_class=CNNCifar100ModelSplit, **kwargs)
 
     def _create_model(self) -> CNNCifar100:
-        """Return CNNCifar100 model to be splitted into head and body."""
-        return CNNCifar100().to(self.device)
+        """Return CNNCifar100 model to be split into head and body."""
+        return CNNCifar100()
diff --git a/baselines/fedrep/fedrep/server.py b/baselines/fedrep/fedrep/server.py
deleted file mode 100644
index 5b0c34035ae6..000000000000
--- a/baselines/fedrep/fedrep/server.py
+++ /dev/null
@@ -1 +0,0 @@
-"""Server strategies pipelines for FedRep."""
diff --git a/baselines/fedrep/fedrep/server_app.py b/baselines/fedrep/fedrep/server_app.py
new file mode 100644
index 000000000000..0f98a3bc8876
--- /dev/null
+++ b/baselines/fedrep/fedrep/server_app.py
@@ -0,0 +1,80 @@
+"""fedrep: A Flower Baseline."""
+
+import json
+import os
+import time
+from typing import Dict, List, Tuple
+
+from flwr.common import Context, Metrics, ndarrays_to_parameters
+from flwr.server import ServerApp, ServerAppComponents, ServerConfig
+
+from .utils import get_create_model_fn, get_server_strategy
+
+RESULTS_FILE = "result-{}.json"
+
+
+def config_json_file(context: Context) -> None:
+    """Initialize the json file and write the run configurations."""
+    # Initialize the execution results directory.
+    res_save_path = "./results"
+    if not os.path.exists(res_save_path):
+        os.makedirs(res_save_path)
+    res_save_name = time.strftime("%Y-%m-%d-%H-%M-%S")
+    # Set the date and full path of the file to save the results.
+    global RESULTS_FILE  # pylint: disable=global-statement
+    RESULTS_FILE = RESULTS_FILE.format(res_save_name)
+    RESULTS_FILE = f"{res_save_path}/{RESULTS_FILE}"
+    data = {
+        "run_config": dict(context.run_config.items()),
+        "round_res": [],
+    }
+    with open(RESULTS_FILE, "w+", encoding="UTF-8") as fout:
+        json.dump(data, fout, indent=4)
+
+
+def write_res(new_res: Dict[str, float]) -> None:
+    """Load the json file, append result and re-write json collection."""
+    with open(RESULTS_FILE, "r", encoding="UTF-8") as fin:
+        data = json.load(fin)
+    data["round_res"].append(new_res)
+
+    # Write the updated data back to the JSON file
+    with open(RESULTS_FILE, "w", encoding="UTF-8") as fout:
+        json.dump(data, fout, indent=4)
+
+
+def evaluate_metrics_aggregation_fn(eval_metrics: List[Tuple[int, Metrics]]) -> Metrics:
+    """Weighted metrics evaluation."""
+    weights, accuracies, losses = [], [], []
+    for num_examples, metric in eval_metrics:
+        weights.append(num_examples)
+        accuracies.append(float(metric["accuracy"]) * num_examples)
+        losses.append(float(metric["loss"]) * num_examples)
+    accuracy = sum(accuracies) / sum(weights)
+    loss = sum(losses) / sum(weights)
+    write_res({"accuracy": accuracy, "loss": loss})
+    return {"accuracy": accuracy}
+
+
+def server_fn(context: Context) -> ServerAppComponents:
+    """Construct components that set the ServerApp behaviour."""
+    config_json_file(context)
+    # Read from config
+    num_rounds = context.run_config["num-server-rounds"]
+
+    # Initialize model parameters
+    create_model_fn, split_class = get_create_model_fn(context)
+    net = split_class(create_model_fn())
+    parameters = ndarrays_to_parameters(net.get_parameters())
+
+    # Define strategy
+    strategy = get_server_strategy(
+        context=context, params=parameters, eval_fn=evaluate_metrics_aggregation_fn
+    )
+    config = ServerConfig(num_rounds=int(num_rounds))
+
+    return ServerAppComponents(strategy=strategy, config=config)
+
+
+# Create ServerApp
+app = ServerApp(server_fn=server_fn)
diff --git a/baselines/fedrep/fedrep/strategy.py b/baselines/fedrep/fedrep/strategy.py
index 3bee45326a6f..ba4d8b75724f 100644
--- a/baselines/fedrep/fedrep/strategy.py
+++ b/baselines/fedrep/fedrep/strategy.py
@@ -1,4 +1,4 @@
-"""FL server strategies."""
+"""fedrep: A Flower Baseline."""
 
 from flwr.server.strategy import FedAvg
 
diff --git a/baselines/fedrep/fedrep/utils.py b/baselines/fedrep/fedrep/utils.py
index b706ebf1e041..086abde2c46c 100644
--- a/baselines/fedrep/fedrep/utils.py
+++ b/baselines/fedrep/fedrep/utils.py
@@ -1,204 +1,87 @@
-"""Utility functions for FedRep."""
+"""fedrep: A Flower Baseline."""
 
-import logging
-import os
-import pickle
-import time
-from pathlib import Path
-from secrets import token_hex
-from typing import Callable, Optional, Type, Union
+from typing import Callable, Type, Union
 
-import matplotlib.pyplot as plt
-import numpy as np
-from flwr.client import Client
-from flwr.server.history import History
-from omegaconf import DictConfig
+from flwr.common import Context, Parameters
+from flwr.server.strategy import FedAvg
 
-from fedrep.base_model import get_device
-from fedrep.client import get_client_fn_simulation
-from fedrep.constants import Algorithm
-from fedrep.models import (
+from .constants import Algorithm, ModelDatasetName
+from .models import (
     CNNCifar10,
+    CNNCifar10ModelManager,
     CNNCifar10ModelSplit,
     CNNCifar100,
+    CNNCifar100ModelManager,
     CNNCifar100ModelSplit,
 )
-
-
-def set_client_state_save_path() -> str:
-    """Set the client state save path."""
-    client_state_save_path = time.strftime("%Y-%m-%d")
-    client_state_sub_path = time.strftime("%H-%M-%S")
-    client_state_save_path = (
-        f"./client_states/{client_state_save_path}/{client_state_sub_path}"
-    )
-    if not os.path.exists(client_state_save_path):
-        os.makedirs(client_state_save_path)
-    return client_state_save_path
-
-
-# pylint: disable=W1202
-def set_client_strategy(cfg: DictConfig) -> DictConfig:
-    """Set the client strategy."""
-    algorithm = cfg.algorithm.lower()
-    if algorithm == Algorithm.FEDREP.value:
-        cfg.strategy["_target_"] = "fedrep.strategy.FedRep"
-    elif algorithm == Algorithm.FEDAVG.value:
-        cfg.strategy["_target_"] = "flwr.server.strategy.FedAvg"
-    else:
-        logging.warning(
-            "Algorithm {} not implemented. Fallback to FedAvg.".format(algorithm)
-        )
-    return cfg
-
-
-def get_client_fn(
-    config: DictConfig, client_state_save_path: str = ""
-) -> Callable[[str], Client]:
-    """Get client function."""
-    # Get algorithm
-    algorithm = config.algorithm.lower()
-    # Get client fn
-    if algorithm == "fedrep":
-        client_fn = get_client_fn_simulation(
-            config=config, client_state_save_path=client_state_save_path
-        )
-    elif algorithm == "fedavg":
-        client_fn = get_client_fn_simulation(config=config)
-    else:
-        raise NotImplementedError
-    return client_fn
+from .strategy import FedRep
 
 
 def get_create_model_fn(
-    config: DictConfig,
+    context: Context,
 ) -> tuple[
-    Callable[[], Union[type[CNNCifar10], type[CNNCifar100]]],
-    Union[type[CNNCifar10ModelSplit], type[CNNCifar100ModelSplit]],
+    Union[Callable[[], CNNCifar10], Callable[[], CNNCifar100]],
+    Union[Type[CNNCifar10ModelSplit], Type[CNNCifar100ModelSplit]],
 ]:
     """Get create model function."""
-    device = get_device(
-        use_cuda=getattr(config, "use_cuda", True),
-        specified_device=getattr(config, "specified_device", None),
-    )
-    split: Union[Type[CNNCifar10ModelSplit], Type[CNNCifar100ModelSplit]] = (
-        CNNCifar10ModelSplit
-    )
-    if config.model_name.lower() == "cnncifar10":
+    model_name = str(context.run_config["model-name"])
+    if model_name == ModelDatasetName.CNN_CIFAR_10.value:
+        split = CNNCifar10ModelSplit
 
-        def create_model() -> Union[Type[CNNCifar10], Type[CNNCifar100]]:
+        def create_model() -> CNNCifar10:  # type: ignore
             """Create initial CNNCifar10 model."""
-            return CNNCifar10().to(device)
+            return CNNCifar10()
 
-    elif config.model_name.lower() == "cnncifar100":
+    elif model_name == ModelDatasetName.CNN_CIFAR_100.value:
         split = CNNCifar100ModelSplit
 
-        def create_model() -> Union[Type[CNNCifar10], Type[CNNCifar100]]:
+        def create_model() -> CNNCifar100:  # type: ignore
             """Create initial CNNCifar100 model."""
-            return CNNCifar100().to(device)
+            return CNNCifar100()
 
     else:
-        raise NotImplementedError("Model not implemented, check name. ")
+        raise NotImplementedError(f"Not a recognized model name {model_name}.")
     return create_model, split
 
 
-def plot_metric_from_history(
-    hist: History, save_plot_path: Path, suffix: Optional[str] = ""
-) -> None:
-    """Plot from Flower server History.
-
-    Parameters
-    ----------
-    hist : History
-        Object containing evaluation for all rounds.
-    save_plot_path : Path
-        Folder to save the plot to.
-    suffix: Optional[str]
-        Optional string to add at the end of the filename for the plot.
-    """
-    metric_type = "distributed"
-    metric_dict = (
-        hist.metrics_centralized
-        if metric_type == "centralized"
-        else hist.metrics_distributed
-    )
-    try:
-        _, values = zip(*metric_dict["accuracy"])
-    except KeyError:  # If no available metric data
-        return
-
-    # let's extract decentralized loss (main metric reported in FedProx paper)
-    rounds_loss, values_loss = zip(*hist.losses_distributed)
-
-    _, axs = plt.subplots(nrows=2, ncols=1, sharex="row")
-    axs[0].plot(np.asarray(rounds_loss), np.asarray(values_loss))  # type: ignore
-    axs[1].plot(np.asarray(rounds_loss), np.asarray(values))  # type: ignore
-
-    axs[0].set_ylabel("Loss")  # type: ignore
-    axs[1].set_ylabel("Accuracy")  # type: ignore
-
-    axs[0].grid()  # type: ignore
-    axs[1].grid()  # type: ignore
-    # plt.title(f"{metric_type.capitalize()} Validation - MNIST")
-    plt.xlabel("Rounds")
-    # plt.legend(loc="lower right")
-
-    plt.savefig(Path(save_plot_path) / Path(f"{metric_type}_metrics{suffix}.png"))
-    plt.close()
-
-
-def save_results_as_pickle(
-    history: History,
-    file_path: Union[str, Path],
-    default_filename: Optional[str] = "results.pkl",
-) -> None:
-    """Save results from simulation to pickle.
-
-    Parameters
-    ----------
-    history: History
-        History returned by start_simulation.
-    file_path: Union[str, Path]
-        Path to file to create and store both history and extra_results.
-        If path is a directory, the default_filename will be used.
-        path doesn't exist, it will be created. If file exists, a
-        randomly generated suffix will be added to the file name. This
-        is done to avoid overwritting results.
-    extra_results : Optional[Dict]
-        A dictionary containing additional results you would like
-        to be saved to disk. Default: {} (an empty dictionary)
-    default_filename: Optional[str]
-        File used by default if file_path points to a directory instead
-        to a file. Default: "results.pkl"
-    """
-    path = Path(file_path)
-
-    # ensure path exists
-    path.mkdir(exist_ok=True, parents=True)
-
-    def _add_random_suffix(path_: Path):
-        """Add a random suffix to the file name."""
-        print(f"File `{path_}` exists! ")
-        suffix = token_hex(4)
-        print(f"New results to be saved with suffix: {suffix}")
-        return path_.parent / (path_.stem + "_" + suffix + ".pkl")
-
-    def _complete_path_with_default_name(path_: Path):
-        """Append the default file name to the path."""
-        print("Using default filename")
-        if default_filename is None:
-            return path_
-        return path_ / default_filename
-
-    if path.is_dir():
-        path = _complete_path_with_default_name(path)
-
-    if path.is_file():
-        path = _add_random_suffix(path)
-
-    print(f"Results will be saved into: {path}")
-    # data = {"history": history, **extra_results}
-    data = {"history": history}
-    # save results to pickle
-    with open(str(path), "wb") as handle:
-        pickle.dump(data, handle, protocol=pickle.HIGHEST_PROTOCOL)
+def get_model_manager_class(
+    context: Context,
+) -> Union[Type[CNNCifar10ModelManager], Type[CNNCifar100ModelManager]]:
+    """Depending on the model name type return the corresponding model manager."""
+    model_name = str(context.run_config["model-name"])
+    if model_name.lower() == ModelDatasetName.CNN_CIFAR_10.value:
+        model_manager_class = CNNCifar10ModelManager
+    elif model_name.lower() == ModelDatasetName.CNN_CIFAR_100.value:
+        model_manager_class = CNNCifar100ModelManager  # type: ignore
+    else:
+        raise NotImplementedError(
+            f"Model {model_name} not implemented, please check model name."
+        )
+    return model_manager_class
+
+
+def get_server_strategy(
+    context: Context, params: Parameters, eval_fn: Callable
+) -> Union[FedAvg, FedRep]:
+    """Define server strategy based on input algorithm."""
+    algorithm = str(context.run_config["algorithm"]).lower()
+    if algorithm == Algorithm.FEDAVG.value:
+        strategy = FedAvg
+    elif algorithm == Algorithm.FEDREP.value:
+        strategy = FedRep
+    else:
+        raise RuntimeError(f"Unknown algorithm {algorithm}.")
+
+    # Read strategy config
+    fraction_fit = float(context.run_config["fraction-fit"])
+    fraction_evaluate = float(context.run_config["fraction-evaluate"])
+    min_available_clients = int(context.run_config["min-available-clients"])
+
+    strategy = strategy(
+        fraction_fit=float(fraction_fit),
+        fraction_evaluate=fraction_evaluate,
+        min_available_clients=min_available_clients,
+        initial_parameters=params,
+        evaluate_metrics_aggregation_fn=eval_fn,
+    )  # type: ignore
+    return strategy  # type: ignore
diff --git a/baselines/fedrep/pyproject.toml b/baselines/fedrep/pyproject.toml
index e4c3551af19a..9a45199032ef 100644
--- a/baselines/fedrep/pyproject.toml
+++ b/baselines/fedrep/pyproject.toml
@@ -1,73 +1,39 @@
 [build-system]
-requires = ["poetry-core>=1.4.0"]
-build-backend = "poetry.masonry.api"
+requires = ["hatchling"]
+build-backend = "hatchling.build"
 
-[tool.poetry]
+[project]
 name = "fedrep"
 version = "1.0.0"
-description = "Exploiting Shared Representations for Personalized Federated Learning"
+description = ""
 license = "Apache-2.0"
-authors = ["Jiahao Tan <karhoutam@qq.com>"]
-readme = "README.md"
-homepage = "https://flower.ai"
-repository = "https://github.com/adap/flower"
-documentation = "https://flower.ai"
-classifiers = [
-    "Development Status :: 3 - Alpha",
-    "Intended Audience :: Developers",
-    "Intended Audience :: Science/Research",
-    "License :: OSI Approved :: Apache Software License",
-    "Operating System :: MacOS :: MacOS X",
-    "Operating System :: POSIX :: Linux",
-    "Programming Language :: Python",
-    "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3 :: Only",
-    "Programming Language :: Python :: 3.8",
-    "Programming Language :: Python :: 3.9",
-    "Programming Language :: Python :: 3.10",
-    "Programming Language :: Python :: 3.11",
-    "Programming Language :: Python :: Implementation :: CPython",
-    "Topic :: Scientific/Engineering",
-    "Topic :: Scientific/Engineering :: Artificial Intelligence",
-    "Topic :: Scientific/Engineering :: Mathematics",
-    "Topic :: Software Development",
-    "Topic :: Software Development :: Libraries",
-    "Topic :: Software Development :: Libraries :: Python Modules",
-    "Typing :: Typed",
+dependencies = [
+    "flwr[simulation]>=1.13.1",
+    "flwr-datasets[vision]>=0.4.0",
+    "torch==2.2.1",
+    "torchvision==0.17.1",
 ]
 
-[tool.poetry.dependencies]
-python = ">=3.10.0, <3.11.0"                                 # don't change this
-flwr = { extras = ["simulation"], version = "1.9.0" }
-hydra-core = "1.3.2"                                         # don't change this
-pandas = "^2.2.2"
-matplotlib = "^3.9.0"
-tqdm = "^4.66.4"
-torch = "^2.2.2"
-torchvision = "^0.17.2"
-setuptools = "<70"
-flwr-datasets = { extras = ["vision"], version = ">=0.3.0" }
-
-[tool.poetry.dev-dependencies]
-isort = "==5.13.2"
-black = "==24.2.0"
-docformatter = "==1.7.5"
-mypy = "==1.4.1"
-pylint = "==2.8.2"
-flake8 = "==3.9.2"
-pytest = "==6.2.4"
-pytest-watch = "==4.2.0"
-ruff = "==0.0.272"
-types-requests = "==2.27.7"
-virtualenv = "==20.21.0"
+[tool.hatch.metadata]
+allow-direct-references = true
+
+[project.optional-dependencies]
+dev = [
+    "isort==5.13.2",
+    "black==24.2.0",
+    "docformatter==1.7.5",
+    "mypy==1.8.0",
+    "pylint==3.2.6",
+    "flake8==5.0.4",
+    "pytest==6.2.4",
+    "pytest-watch==4.2.0",
+    "ruff==0.1.9",
+    "types-requests==2.31.0.20240125",
+]
 
 [tool.isort]
-line_length = 88
-indent = "    "
-multi_line_output = 3
-include_trailing_comma = true
-force_grid_wrap = 0
-use_parentheses = true
+profile = "black"
+known_first_party = ["flwr"]
 
 [tool.black]
 line-length = 88
@@ -76,7 +42,9 @@ target-version = ["py38", "py39", "py310", "py311"]
 [tool.pytest.ini_options]
 minversion = "6.2"
 addopts = "-qq"
-testpaths = ["flwr_baselines"]
+testpaths = [
+    "flwr_baselines",
+]
 
 [tool.mypy]
 ignore_missing_imports = true
@@ -84,14 +52,22 @@ strict = false
 plugins = "numpy.typing.mypy_plugin"
 
 [tool.pylint."MESSAGES CONTROL"]
-good-names = "i,j,k,_,x,y,X,Y"
-signature-mutators = "hydra.main.main"
+disable = "duplicate-code,too-few-public-methods,useless-import-alias"
+good-names = "i,j,k,_,x,y,X,Y,K,N"
+max-args = 10
+max-attributes = 15
+max-locals = 36
+max-branches = 20
+max-statements = 55
 
-[tool.pylint."TYPECHECK"]
+[tool.pylint.typecheck]
 generated-members = "numpy.*, torch.*, tensorflow.*"
 
 [[tool.mypy.overrides]]
-module = ["importlib.metadata.*", "importlib_metadata.*"]
+module = [
+    "importlib.metadata.*",
+    "importlib_metadata.*",
+]
 follow_imports = "skip"
 follow_imports_for_stubs = true
 disallow_untyped_calls = false
@@ -137,3 +113,49 @@ exclude = [
 
 [tool.ruff.pydocstyle]
 convention = "numpy"
+
+[tool.hatch.build.targets.wheel]
+packages = ["."]
+
+[tool.flwr.app]
+publisher = "dimitris"
+
+[tool.flwr.app.components]
+serverapp = "fedrep.server_app:app"
+clientapp = "fedrep.client_app:app"
+
+[tool.flwr.app.config]
+algorithm = "fedrep"
+
+# dataset specs
+dataset-name = "cifar10"
+dataset-split = "sample"
+dataset-split-num-classes = 2
+dataset-split-seed = 42
+dataset-split-fraction = 0.83
+
+# model specs
+model-name = "cnncifar10"
+batch-size = 50
+learning-rate = 0.01
+momentum = 0.5
+enable-finetune = false
+num-finetune-epochs = 5
+num-local-epochs = 5  # number of local epochs
+num-rep-epochs = 1  # number of representation epochs (only for FedRep)
+
+# server specs
+num-server-rounds = 100
+fraction-fit = 0.1
+fraction-evaluate = 0.1
+min-available-clients = 2
+min-evaluate-clients = 2
+min-fit-clients = 2
+
+[tool.flwr.federations]
+default = "local-sim-100"
+
+[tool.flwr.federations.local-sim-100]
+options.num-supernodes = 100
+options.backend.client-resources.num-cpus = 2
+options.backend.client-resources.num-gpus = 0.5  # GPU fraction allocated to each client

From 39ee863b6ad8380abcb70c4b3bab61276a9457a6 Mon Sep 17 00:00:00 2001
From: Chong Shen Ng <chong.shen@flower.ai>
Date: Sat, 14 Dec 2024 18:39:56 +0000
Subject: [PATCH 067/104] feat(framework) Update message handler methods to
 raise `AbortRunException` if called but run is not running (#4694)

---
 src/py/flwr/common/typing.py                  |  8 ++++
 .../grpc_adapter/grpc_adapter_servicer.py     |  1 +
 .../fleet/grpc_rere/fleet_servicer.py         | 44 ++++++++++++++-----
 .../grpc_rere/server_interceptor_test.py      | 21 +++++++--
 .../fleet/message_handler/message_handler.py  | 33 +++++++++++++-
 .../superlink/fleet/rest_rere/rest_api.py     |  5 ++-
 6 files changed, 94 insertions(+), 18 deletions(-)

diff --git a/src/py/flwr/common/typing.py b/src/py/flwr/common/typing.py
index 42c7d9dab1ff..d6b940ba75e6 100644
--- a/src/py/flwr/common/typing.py
+++ b/src/py/flwr/common/typing.py
@@ -258,3 +258,11 @@ class Fab:
 
 class RunNotRunningException(BaseException):
     """Raised when a run is not running."""
+
+
+class InvalidRunStatusException(BaseException):
+    """Raised when an RPC is invalidated by the RunStatus."""
+
+    def __init__(self, message: str) -> None:
+        super().__init__(message)
+        self.message = message
diff --git a/src/py/flwr/server/superlink/fleet/grpc_adapter/grpc_adapter_servicer.py b/src/py/flwr/server/superlink/fleet/grpc_adapter/grpc_adapter_servicer.py
index ffef57d89e8c..49a658b589bf 100644
--- a/src/py/flwr/server/superlink/fleet/grpc_adapter/grpc_adapter_servicer.py
+++ b/src/py/flwr/server/superlink/fleet/grpc_adapter/grpc_adapter_servicer.py
@@ -158,4 +158,5 @@ def _get_fab(self, request: GetFabRequest) -> GetFabResponse:
         return message_handler.get_fab(
             request=request,
             ffs=self.ffs_factory.ffs(),
+            state=self.state_factory.state(),
         )
diff --git a/src/py/flwr/server/superlink/fleet/grpc_rere/fleet_servicer.py b/src/py/flwr/server/superlink/fleet/grpc_rere/fleet_servicer.py
index dacbab135057..225e5e5e225f 100644
--- a/src/py/flwr/server/superlink/fleet/grpc_rere/fleet_servicer.py
+++ b/src/py/flwr/server/superlink/fleet/grpc_rere/fleet_servicer.py
@@ -20,6 +20,7 @@
 import grpc
 
 from flwr.common.logger import log
+from flwr.common.typing import InvalidRunStatusException
 from flwr.proto import fleet_pb2_grpc  # pylint: disable=E0611
 from flwr.proto.fab_pb2 import GetFabRequest, GetFabResponse  # pylint: disable=E0611
 from flwr.proto.fleet_pb2 import (  # pylint: disable=E0611
@@ -38,6 +39,7 @@
 from flwr.server.superlink.ffs.ffs_factory import FfsFactory
 from flwr.server.superlink.fleet.message_handler import message_handler
 from flwr.server.superlink.linkstate import LinkStateFactory
+from flwr.server.superlink.utils import abort_grpc_context
 
 
 class FleetServicer(fleet_pb2_grpc.FleetServicer):
@@ -105,27 +107,45 @@ def PushTaskRes(
             )
         else:
             log(INFO, "[Fleet.PushTaskRes] No task results to push")
-        return message_handler.push_task_res(
-            request=request,
-            state=self.state_factory.state(),
-        )
+
+        try:
+            res = message_handler.push_task_res(
+                request=request,
+                state=self.state_factory.state(),
+            )
+        except InvalidRunStatusException as e:
+            abort_grpc_context(e.message, context)
+
+        return res
 
     def GetRun(
         self, request: GetRunRequest, context: grpc.ServicerContext
     ) -> GetRunResponse:
         """Get run information."""
         log(INFO, "[Fleet.GetRun] Requesting `Run` for run_id=%s", request.run_id)
-        return message_handler.get_run(
-            request=request,
-            state=self.state_factory.state(),
-        )
+
+        try:
+            res = message_handler.get_run(
+                request=request,
+                state=self.state_factory.state(),
+            )
+        except InvalidRunStatusException as e:
+            abort_grpc_context(e.message, context)
+
+        return res
 
     def GetFab(
         self, request: GetFabRequest, context: grpc.ServicerContext
     ) -> GetFabResponse:
         """Get FAB."""
         log(INFO, "[Fleet.GetFab] Requesting FAB for fab_hash=%s", request.hash_str)
-        return message_handler.get_fab(
-            request=request,
-            ffs=self.ffs_factory.ffs(),
-        )
+        try:
+            res = message_handler.get_fab(
+                request=request,
+                ffs=self.ffs_factory.ffs(),
+                state=self.state_factory.state(),
+            )
+        except InvalidRunStatusException as e:
+            abort_grpc_context(e.message, context)
+
+        return res
diff --git a/src/py/flwr/server/superlink/fleet/grpc_rere/server_interceptor_test.py b/src/py/flwr/server/superlink/fleet/grpc_rere/server_interceptor_test.py
index ce43fc4bae0a..23a28d0dfafc 100644
--- a/src/py/flwr/server/superlink/fleet/grpc_rere/server_interceptor_test.py
+++ b/src/py/flwr/server/superlink/fleet/grpc_rere/server_interceptor_test.py
@@ -21,7 +21,7 @@
 import grpc
 
 from flwr.common import ConfigsRecord
-from flwr.common.constant import FLEET_API_GRPC_RERE_DEFAULT_ADDRESS
+from flwr.common.constant import FLEET_API_GRPC_RERE_DEFAULT_ADDRESS, Status
 from flwr.common.secure_aggregation.crypto.symmetric_encryption import (
     compute_hmac,
     generate_key_pairs,
@@ -29,6 +29,7 @@
     private_key_to_bytes,
     public_key_to_bytes,
 )
+from flwr.common.typing import RunStatus
 from flwr.proto.fleet_pb2 import (  # pylint: disable=E0611
     CreateNodeRequest,
     CreateNodeResponse,
@@ -275,8 +276,14 @@ def test_successful_push_task_res_with_metadata(self) -> None:
         node_id = self.state.create_node(
             ping_interval=30, public_key=public_key_to_bytes(self._node_public_key)
         )
+        run_id = self.state.create_run("", "", "", {}, ConfigsRecord())
+        # Transition status to running. PushTaskRes is only allowed in running status.
+        _ = self.state.update_run_status(run_id, RunStatus(Status.STARTING, "", ""))
+        _ = self.state.update_run_status(run_id, RunStatus(Status.RUNNING, "", ""))
         request = PushTaskResRequest(
-            task_res_list=[TaskRes(task=Task(producer=Node(node_id=node_id)))]
+            task_res_list=[
+                TaskRes(task=Task(producer=Node(node_id=node_id)), run_id=run_id)
+            ]
         )
         shared_secret = generate_shared_key(
             self._node_private_key, self._server_public_key
@@ -307,6 +314,10 @@ def test_unsuccessful_push_task_res_with_metadata(self) -> None:
         node_id = self.state.create_node(
             ping_interval=30, public_key=public_key_to_bytes(self._node_public_key)
         )
+        run_id = self.state.create_run("", "", "", {}, ConfigsRecord())
+        # Transition status to running. PushTaskRes is only allowed in running status.
+        _ = self.state.update_run_status(run_id, RunStatus(Status.STARTING, "", ""))
+        _ = self.state.update_run_status(run_id, RunStatus(Status.RUNNING, "", ""))
         request = PushTaskResRequest(
             task_res_list=[TaskRes(task=Task(producer=Node(node_id=node_id)))]
         )
@@ -320,7 +331,7 @@ def test_unsuccessful_push_task_res_with_metadata(self) -> None:
         )
 
         # Execute & Assert
-        with self.assertRaises(grpc.RpcError):
+        with self.assertRaises(grpc.RpcError) as e:
             self._push_task_res.with_call(
                 request=request,
                 metadata=(
@@ -328,6 +339,7 @@ def test_unsuccessful_push_task_res_with_metadata(self) -> None:
                     (_AUTH_TOKEN_HEADER, hmac_value),
                 ),
             )
+        assert e.exception.code() == grpc.StatusCode.UNAUTHENTICATED
 
     def test_successful_get_run_with_metadata(self) -> None:
         """Test server interceptor for pull task ins."""
@@ -336,6 +348,9 @@ def test_successful_get_run_with_metadata(self) -> None:
             ping_interval=30, public_key=public_key_to_bytes(self._node_public_key)
         )
         run_id = self.state.create_run("", "", "", {}, ConfigsRecord())
+        # Transition status to running. GetRun is only allowed in running status.
+        _ = self.state.update_run_status(run_id, RunStatus(Status.STARTING, "", ""))
+        _ = self.state.update_run_status(run_id, RunStatus(Status.RUNNING, "", ""))
         request = GetRunRequest(run_id=run_id)
         shared_secret = generate_shared_key(
             self._node_private_key, self._server_public_key
diff --git a/src/py/flwr/server/superlink/fleet/message_handler/message_handler.py b/src/py/flwr/server/superlink/fleet/message_handler/message_handler.py
index 38df6f441a20..34917b8168eb 100644
--- a/src/py/flwr/server/superlink/fleet/message_handler/message_handler.py
+++ b/src/py/flwr/server/superlink/fleet/message_handler/message_handler.py
@@ -19,8 +19,9 @@
 from typing import Optional
 from uuid import UUID
 
+from flwr.common.constant import Status
 from flwr.common.serde import fab_to_proto, user_config_to_proto
-from flwr.common.typing import Fab
+from flwr.common.typing import Fab, InvalidRunStatusException
 from flwr.proto.fab_pb2 import GetFabRequest, GetFabResponse  # pylint: disable=E0611
 from flwr.proto.fleet_pb2 import (  # pylint: disable=E0611
     CreateNodeRequest,
@@ -44,6 +45,7 @@
 from flwr.proto.task_pb2 import TaskIns, TaskRes  # pylint: disable=E0611
 from flwr.server.superlink.ffs.ffs import Ffs
 from flwr.server.superlink.linkstate import LinkState
+from flwr.server.superlink.utils import check_abort
 
 
 def create_node(
@@ -98,6 +100,15 @@ def push_task_res(request: PushTaskResRequest, state: LinkState) -> PushTaskResR
     task_res: TaskRes = request.task_res_list[0]
     # pylint: enable=no-member
 
+    # Abort if the run is not running
+    abort_msg = check_abort(
+        task_res.run_id,
+        [Status.PENDING, Status.STARTING, Status.FINISHED],
+        state,
+    )
+    if abort_msg:
+        raise InvalidRunStatusException(abort_msg)
+
     # Set pushed_at (timestamp in seconds)
     task_res.task.pushed_at = time.time()
 
@@ -121,6 +132,15 @@ def get_run(
     if run is None:
         return GetRunResponse()
 
+    # Abort if the run is not running
+    abort_msg = check_abort(
+        request.run_id,
+        [Status.PENDING, Status.STARTING, Status.FINISHED],
+        state,
+    )
+    if abort_msg:
+        raise InvalidRunStatusException(abort_msg)
+
     return GetRunResponse(
         run=Run(
             run_id=run.run_id,
@@ -133,9 +153,18 @@ def get_run(
 
 
 def get_fab(
-    request: GetFabRequest, ffs: Ffs  # pylint: disable=W0613
+    request: GetFabRequest, ffs: Ffs, state: LinkState  # pylint: disable=W0613
 ) -> GetFabResponse:
     """Get FAB."""
+    # Abort if the run is not running
+    abort_msg = check_abort(
+        request.run_id,
+        [Status.PENDING, Status.STARTING, Status.FINISHED],
+        state,
+    )
+    if abort_msg:
+        raise InvalidRunStatusException(abort_msg)
+
     if result := ffs.get(request.hash_str):
         fab = Fab(request.hash_str, result[0])
         return GetFabResponse(fab=fab_to_proto(fab))
diff --git a/src/py/flwr/server/superlink/fleet/rest_rere/rest_api.py b/src/py/flwr/server/superlink/fleet/rest_rere/rest_api.py
index a684cd9b3bf2..11b8bbfcac07 100644
--- a/src/py/flwr/server/superlink/fleet/rest_rere/rest_api.py
+++ b/src/py/flwr/server/superlink/fleet/rest_rere/rest_api.py
@@ -154,8 +154,11 @@ async def get_fab(request: GetFabRequest) -> GetFabResponse:
     # Get ffs from app
     ffs: Ffs = cast(FfsFactory, app.state.FFS_FACTORY).ffs()
 
+    # Get state from app
+    state: LinkState = cast(LinkStateFactory, app.state.STATE_FACTORY).state()
+
     # Handle message
-    return message_handler.get_fab(request=request, ffs=ffs)
+    return message_handler.get_fab(request=request, ffs=ffs, state=state)
 
 
 routes = [

From eed8481ee23de4e65bb5a924e2569eea98eb3203 Mon Sep 17 00:00:00 2001
From: Chong Shen Ng <chong.shen@flower.ai>
Date: Sat, 14 Dec 2024 18:51:27 +0000
Subject: [PATCH 068/104] feat(framework) Add `FleetServicer` tests for allowed
 `RunStatus` (#4700)

---
 .../fleet/grpc_rere/fleet_servicer_test.py    | 242 ++++++++++++++++++
 1 file changed, 242 insertions(+)
 create mode 100644 src/py/flwr/server/superlink/fleet/grpc_rere/fleet_servicer_test.py

diff --git a/src/py/flwr/server/superlink/fleet/grpc_rere/fleet_servicer_test.py b/src/py/flwr/server/superlink/fleet/grpc_rere/fleet_servicer_test.py
new file mode 100644
index 000000000000..8959f802beb9
--- /dev/null
+++ b/src/py/flwr/server/superlink/fleet/grpc_rere/fleet_servicer_test.py
@@ -0,0 +1,242 @@
+# Copyright 2024 Flower Labs GmbH. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# ==============================================================================
+"""Flower FleetServicer tests."""
+
+
+import tempfile
+import unittest
+
+import grpc
+from parameterized import parameterized
+
+from flwr.common import ConfigsRecord
+from flwr.common.constant import FLEET_API_GRPC_RERE_DEFAULT_ADDRESS, Status
+from flwr.common.typing import RunStatus
+from flwr.proto.fab_pb2 import GetFabRequest, GetFabResponse  # pylint: disable=E0611
+from flwr.proto.fleet_pb2 import (  # pylint: disable=E0611
+    PushTaskResRequest,
+    PushTaskResResponse,
+)
+from flwr.proto.node_pb2 import Node  # pylint: disable=E0611
+from flwr.proto.run_pb2 import GetRunRequest, GetRunResponse  # pylint: disable=E0611
+from flwr.proto.task_pb2 import Task, TaskRes  # pylint: disable=E0611
+from flwr.server.app import _run_fleet_api_grpc_rere
+from flwr.server.superlink.ffs.ffs_factory import FfsFactory
+from flwr.server.superlink.linkstate.linkstate_factory import LinkStateFactory
+from flwr.server.superlink.utils import _STATUS_TO_MSG
+
+
+class TestFleetServicer(unittest.TestCase):  # pylint: disable=R0902
+    """FleetServicer tests for allowed RunStatuses."""
+
+    def setUp(self) -> None:
+        """Initialize mock stub and server interceptor."""
+        # Create a temporary directory
+        self.temp_dir = tempfile.TemporaryDirectory()  # pylint: disable=R1732
+        self.addCleanup(self.temp_dir.cleanup)  # Ensures cleanup after test
+
+        state_factory = LinkStateFactory(":flwr-in-memory-state:")
+        self.state = state_factory.state()
+        ffs_factory = FfsFactory(self.temp_dir.name)
+        self.ffs = ffs_factory.ffs()
+
+        self.status_to_msg = _STATUS_TO_MSG
+
+        self._server: grpc.Server = _run_fleet_api_grpc_rere(
+            FLEET_API_GRPC_RERE_DEFAULT_ADDRESS,
+            state_factory,
+            ffs_factory,
+            None,
+            None,
+        )
+
+        self._channel = grpc.insecure_channel("localhost:9092")
+        self._push_task_res = self._channel.unary_unary(
+            "/flwr.proto.Fleet/PushTaskRes",
+            request_serializer=PushTaskResRequest.SerializeToString,
+            response_deserializer=PushTaskResResponse.FromString,
+        )
+        self._get_run = self._channel.unary_unary(
+            "/flwr.proto.Fleet/GetRun",
+            request_serializer=GetRunRequest.SerializeToString,
+            response_deserializer=GetRunResponse.FromString,
+        )
+        self._get_fab = self._channel.unary_unary(
+            "/flwr.proto.Fleet/GetFab",
+            request_serializer=GetFabRequest.SerializeToString,
+            response_deserializer=GetFabResponse.FromString,
+        )
+
+    def tearDown(self) -> None:
+        """Clean up grpc server."""
+        self._server.stop(None)
+
+    def _transition_run_status(self, run_id: int, num_transitions: int) -> None:
+        if num_transitions > 0:
+            _ = self.state.update_run_status(run_id, RunStatus(Status.STARTING, "", ""))
+        if num_transitions > 1:
+            _ = self.state.update_run_status(run_id, RunStatus(Status.RUNNING, "", ""))
+        if num_transitions > 2:
+            _ = self.state.update_run_status(run_id, RunStatus(Status.FINISHED, "", ""))
+
+    def test_successful_push_task_res_if_running(self) -> None:
+        """Test `PushTaskRes` success."""
+        # Prepare
+        node_id = self.state.create_node(ping_interval=30)
+        run_id = self.state.create_run("", "", "", {}, ConfigsRecord())
+        # Transition status to running. PushTaskRes is only allowed in running status.
+        self._transition_run_status(run_id, 2)
+        request = PushTaskResRequest(
+            task_res_list=[
+                TaskRes(task=Task(producer=Node(node_id=node_id)), run_id=run_id)
+            ]
+        )
+
+        # Execute
+        response, call = self._push_task_res.with_call(request=request)
+
+        # Assert
+        assert isinstance(response, PushTaskResResponse)
+        assert grpc.StatusCode.OK == call.code()
+
+    def _assert_push_task_res_not_allowed(self, node_id: int, run_id: int) -> None:
+        """Assert `PushTaskRes` not allowed."""
+        run_status = self.state.get_run_status({run_id})[run_id]
+        request = PushTaskResRequest(
+            task_res_list=[
+                TaskRes(task=Task(producer=Node(node_id=node_id)), run_id=run_id)
+            ]
+        )
+
+        with self.assertRaises(grpc.RpcError) as e:
+            self._push_task_res.with_call(request=request)
+        assert e.exception.code() == grpc.StatusCode.PERMISSION_DENIED
+        assert e.exception.details() == self.status_to_msg[run_status.status]
+
+    @parameterized.expand(
+        [
+            (0,),  # Test not successful if RunStatus is pending.
+            (1,),  # Test not successful if RunStatus is starting.
+            (3,),  # Test not successful if RunStatus is finished.
+        ]
+    )  # type: ignore
+    def test_push_task_res_not_successful_if_not_running(
+        self, num_transitions: int
+    ) -> None:
+        """Test `PushTaskRes` not successful if RunStatus is not running."""
+        # Prepare
+        node_id = self.state.create_node(ping_interval=30)
+        run_id = self.state.create_run("", "", "", {}, ConfigsRecord())
+        self._transition_run_status(run_id, num_transitions)
+
+        # Execute & Assert
+        self._assert_push_task_res_not_allowed(node_id, run_id)
+
+    def test_successful_get_run_if_running(self) -> None:
+        """Test `GetRun` success."""
+        # Prepare
+        self.state.create_node(ping_interval=30)
+        run_id = self.state.create_run("", "", "", {}, ConfigsRecord())
+        # Transition status to running. PushTaskRes is only allowed in running status.
+        self._transition_run_status(run_id, 2)
+        request = GetRunRequest(run_id=run_id)
+
+        # Execute
+        response, call = self._get_run.with_call(request=request)
+
+        # Assert
+        assert isinstance(response, GetRunResponse)
+        assert grpc.StatusCode.OK == call.code()
+
+    def _assert_get_run_not_allowed(self, run_id: int) -> None:
+        """Assert `GetRun` not allowed."""
+        run_status = self.state.get_run_status({run_id})[run_id]
+        request = GetRunRequest(run_id=run_id)
+
+        with self.assertRaises(grpc.RpcError) as e:
+            self._get_run.with_call(request=request)
+        assert e.exception.code() == grpc.StatusCode.PERMISSION_DENIED
+        assert e.exception.details() == self.status_to_msg[run_status.status]
+
+    @parameterized.expand(
+        [
+            (0,),  # Test not successful if RunStatus is pending.
+            (1,),  # Test not successful if RunStatus is starting.
+            (3,),  # Test not successful if RunStatus is finished.
+        ]
+    )  # type: ignore
+    def test_get_run_not_successful_if_not_running(self, num_transitions: int) -> None:
+        """Test `GetRun` not successful if RunStatus is not running."""
+        # Prepare
+        run_id = self.state.create_run("", "", "", {}, ConfigsRecord())
+        self._transition_run_status(run_id, num_transitions)
+
+        # Execute & Assert
+        self._assert_get_run_not_allowed(run_id)
+
+    def test_successful_get_fab_if_running(self) -> None:
+        """Test `GetFab` success."""
+        # Prepare
+        node_id = self.state.create_node(ping_interval=30)
+        fab_content = b"content"
+        fab_hash = self.ffs.put(fab_content, {"meta": "data"})
+        run_id = self.state.create_run("", "", fab_hash, {}, ConfigsRecord())
+
+        # Transition status to running. PushTaskRes is only allowed in running status.
+        self._transition_run_status(run_id, 2)
+        request = GetFabRequest(
+            node=Node(node_id=node_id), hash_str=fab_hash, run_id=run_id
+        )
+
+        # Execute
+        response, call = self._get_fab.with_call(request=request)
+
+        # Assert
+        assert isinstance(response, GetFabResponse)
+        assert grpc.StatusCode.OK == call.code()
+
+    def _assert_get_fab_not_allowed(
+        self, node_id: int, hash_str: str, run_id: int
+    ) -> None:
+        """Assert `GetFab` not allowed."""
+        run_status = self.state.get_run_status({run_id})[run_id]
+        request = GetFabRequest(
+            node=Node(node_id=node_id), hash_str=hash_str, run_id=run_id
+        )
+
+        with self.assertRaises(grpc.RpcError) as e:
+            self._get_fab.with_call(request=request)
+        assert e.exception.code() == grpc.StatusCode.PERMISSION_DENIED
+        assert e.exception.details() == self.status_to_msg[run_status.status]
+
+    @parameterized.expand(
+        [
+            (0,),  # Test not successful if RunStatus is pending.
+            (1,),  # Test not successful if RunStatus is starting.
+            (3,),  # Test not successful if RunStatus is finished.
+        ]
+    )  # type: ignore
+    def test_get_fab_not_successful_if_not_running(self, num_transitions: int) -> None:
+        """Test `GetFab` not successful if RunStatus is not running."""
+        # Prepare
+        node_id = self.state.create_node(ping_interval=30)
+        fab_content = b"content"
+        fab_hash = self.ffs.put(fab_content, {"meta": "data"})
+        run_id = self.state.create_run("", "", fab_hash, {}, ConfigsRecord())
+
+        self._transition_run_status(run_id, num_transitions)
+
+        # Execute & Assert
+        self._assert_get_fab_not_allowed(node_id, fab_hash, run_id)

From 4e55367161a8d60d06f4aa853aecce3851bce6d8 Mon Sep 17 00:00:00 2001
From: Yan Gao <y.gaogy@gmail.com>
Date: Sun, 15 Dec 2024 03:08:19 +0800
Subject: [PATCH 069/104] fix(framework) Update FlowerTune template
 dependencies (#4708)

---
 .../flwr/cli/new/templates/app/pyproject.flowertune.toml.tpl  | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/py/flwr/cli/new/templates/app/pyproject.flowertune.toml.tpl b/src/py/flwr/cli/new/templates/app/pyproject.flowertune.toml.tpl
index 9d7c1bdf1292..4a2f4742f4f5 100644
--- a/src/py/flwr/cli/new/templates/app/pyproject.flowertune.toml.tpl
+++ b/src/py/flwr/cli/new/templates/app/pyproject.flowertune.toml.tpl
@@ -12,10 +12,10 @@ dependencies = [
     "flwr-datasets>=0.3.0",
     "torch==2.3.1",
     "trl==0.8.1",
-    "bitsandbytes==0.43.0",
+    "bitsandbytes==0.45.0",
     "scipy==1.13.0",
     "peft==0.6.2",
-    "transformers==4.43.1",
+    "transformers==4.47.0",
     "sentencepiece==0.2.0",
     "omegaconf==2.3.0",
     "hf_transfer==0.1.8",

From 90a12e96da1cfd64144984c2e8ff37ac866b39bb Mon Sep 17 00:00:00 2001
From: Yan Gao <y.gaogy@gmail.com>
Date: Sun, 15 Dec 2024 03:20:01 +0800
Subject: [PATCH 070/104] fix(benchmarks) Update LLM evaluation dependencies
 (#4709)

---
 benchmarks/flowertune-llm/evaluation/code/requirements.txt    | 4 ++--
 benchmarks/flowertune-llm/evaluation/finance/requirements.txt | 2 +-
 .../flowertune-llm/evaluation/general-nlp/requirements.txt    | 2 +-
 benchmarks/flowertune-llm/evaluation/medical/requirements.txt | 2 +-
 4 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/benchmarks/flowertune-llm/evaluation/code/requirements.txt b/benchmarks/flowertune-llm/evaluation/code/requirements.txt
index 9c9e3f8e27a1..5e6cb5418ca2 100644
--- a/benchmarks/flowertune-llm/evaluation/code/requirements.txt
+++ b/benchmarks/flowertune-llm/evaluation/code/requirements.txt
@@ -3,6 +3,6 @@ datasets==2.20.0
 evaluate==0.3.0
 sentencepiece==0.2.0
 protobuf==5.27.1
-bitsandbytes==0.43.1
+bitsandbytes==0.45.0
 hf_transfer==0.1.8
-git+https://github.com/bigcode-project/bigcode-evaluation-harness.git@0f3e95f0806e78a4f432056cdb1be93604a51d69
+git+https://github.com/bigcode-project/bigcode-evaluation-harness.git@6116c6a9a5672c69bd624373cfbc8938b7acc249
diff --git a/benchmarks/flowertune-llm/evaluation/finance/requirements.txt b/benchmarks/flowertune-llm/evaluation/finance/requirements.txt
index 89dcf40b819f..bbec80d10b9c 100644
--- a/benchmarks/flowertune-llm/evaluation/finance/requirements.txt
+++ b/benchmarks/flowertune-llm/evaluation/finance/requirements.txt
@@ -3,5 +3,5 @@ scikit-learn==1.5.0
 datasets==2.20.0
 sentencepiece==0.2.0
 protobuf==5.27.1
-bitsandbytes==0.43.1
+bitsandbytes==0.45.0
 hf_transfer==0.1.8
diff --git a/benchmarks/flowertune-llm/evaluation/general-nlp/requirements.txt b/benchmarks/flowertune-llm/evaluation/general-nlp/requirements.txt
index f5c46e869ce2..3dae79d9af17 100644
--- a/benchmarks/flowertune-llm/evaluation/general-nlp/requirements.txt
+++ b/benchmarks/flowertune-llm/evaluation/general-nlp/requirements.txt
@@ -4,5 +4,5 @@ scikit-learn==1.5.0
 datasets==2.20.0
 sentencepiece==0.2.0
 protobuf==5.27.1
-bitsandbytes==0.43.1
+bitsandbytes==0.45.0
 hf_transfer==0.1.8
diff --git a/benchmarks/flowertune-llm/evaluation/medical/requirements.txt b/benchmarks/flowertune-llm/evaluation/medical/requirements.txt
index f5c46e869ce2..3dae79d9af17 100644
--- a/benchmarks/flowertune-llm/evaluation/medical/requirements.txt
+++ b/benchmarks/flowertune-llm/evaluation/medical/requirements.txt
@@ -4,5 +4,5 @@ scikit-learn==1.5.0
 datasets==2.20.0
 sentencepiece==0.2.0
 protobuf==5.27.1
-bitsandbytes==0.43.1
+bitsandbytes==0.45.0
 hf_transfer==0.1.8

From b4a760d53c1bc62514cfb0737961a3f4b4343354 Mon Sep 17 00:00:00 2001
From: Chong Shen Ng <chong.shen@flower.ai>
Date: Sun, 15 Dec 2024 13:26:12 +0000
Subject: [PATCH 071/104] fix(framework) Fix docstring in
 `server_interceptor_test` (#4697)

---
 .../superlink/fleet/grpc_rere/server_interceptor_test.py  | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/src/py/flwr/server/superlink/fleet/grpc_rere/server_interceptor_test.py b/src/py/flwr/server/superlink/fleet/grpc_rere/server_interceptor_test.py
index 23a28d0dfafc..a0ff7a77304a 100644
--- a/src/py/flwr/server/superlink/fleet/grpc_rere/server_interceptor_test.py
+++ b/src/py/flwr/server/superlink/fleet/grpc_rere/server_interceptor_test.py
@@ -342,7 +342,7 @@ def test_unsuccessful_push_task_res_with_metadata(self) -> None:
         assert e.exception.code() == grpc.StatusCode.UNAUTHENTICATED
 
     def test_successful_get_run_with_metadata(self) -> None:
-        """Test server interceptor for pull task ins."""
+        """Test server interceptor for get run."""
         # Prepare
         self.state.create_node(
             ping_interval=30, public_key=public_key_to_bytes(self._node_public_key)
@@ -376,7 +376,7 @@ def test_successful_get_run_with_metadata(self) -> None:
         assert grpc.StatusCode.OK == call.code()
 
     def test_unsuccessful_get_run_with_metadata(self) -> None:
-        """Test server interceptor for pull task ins unsuccessfully."""
+        """Test server interceptor for get run unsuccessfully."""
         # Prepare
         self.state.create_node(
             ping_interval=30, public_key=public_key_to_bytes(self._node_public_key)
@@ -403,7 +403,7 @@ def test_unsuccessful_get_run_with_metadata(self) -> None:
             )
 
     def test_successful_ping_with_metadata(self) -> None:
-        """Test server interceptor for pull task ins."""
+        """Test server interceptor for ping."""
         # Prepare
         node_id = self.state.create_node(
             ping_interval=30, public_key=public_key_to_bytes(self._node_public_key)
@@ -433,7 +433,7 @@ def test_successful_ping_with_metadata(self) -> None:
         assert grpc.StatusCode.OK == call.code()
 
     def test_unsuccessful_ping_with_metadata(self) -> None:
-        """Test server interceptor for pull task ins unsuccessfully."""
+        """Test server interceptor for ping unsuccessfully."""
         # Prepare
         node_id = self.state.create_node(
             ping_interval=30, public_key=public_key_to_bytes(self._node_public_key)

From 8f1bf1b673e75e6d342d364655685e2ff1b478fe Mon Sep 17 00:00:00 2001
From: Javier <jafermarq@users.noreply.github.com>
Date: Mon, 16 Dec 2024 10:16:20 +0000
Subject: [PATCH 072/104] feat(framework) Wrap `SimulationIo` stub with
 `RetryInvoker`  (#4649)

---
 src/py/flwr/common/retry_invoker.py               | 4 +++-
 src/py/flwr/simulation/simulationio_connection.py | 3 +++
 2 files changed, 6 insertions(+), 1 deletion(-)

diff --git a/src/py/flwr/common/retry_invoker.py b/src/py/flwr/common/retry_invoker.py
index 4b834fa17302..d389cbb24c0e 100644
--- a/src/py/flwr/common/retry_invoker.py
+++ b/src/py/flwr/common/retry_invoker.py
@@ -30,6 +30,7 @@
 from flwr.common.typing import RunNotRunningException
 from flwr.proto.clientappio_pb2_grpc import ClientAppIoStub
 from flwr.proto.serverappio_pb2_grpc import ServerAppIoStub
+from flwr.proto.simulationio_pb2_grpc import SimulationIoStub
 
 
 def exponential(
@@ -365,7 +366,8 @@ def _should_giveup_fn(e: Exception) -> bool:
 
 
 def _wrap_stub(
-    stub: Union[ServerAppIoStub, ClientAppIoStub], retry_invoker: RetryInvoker
+    stub: Union[ServerAppIoStub, ClientAppIoStub, SimulationIoStub],
+    retry_invoker: RetryInvoker,
 ) -> None:
     """Wrap a gRPC stub with a retry invoker."""
 
diff --git a/src/py/flwr/simulation/simulationio_connection.py b/src/py/flwr/simulation/simulationio_connection.py
index ab6e5450c90e..011d2ff8e9d0 100644
--- a/src/py/flwr/simulation/simulationio_connection.py
+++ b/src/py/flwr/simulation/simulationio_connection.py
@@ -23,6 +23,7 @@
 from flwr.common.constant import SIMULATIONIO_API_DEFAULT_CLIENT_ADDRESS
 from flwr.common.grpc import create_channel
 from flwr.common.logger import log
+from flwr.common.retry_invoker import _make_simple_grpc_retry_invoker, _wrap_stub
 from flwr.proto.simulationio_pb2_grpc import SimulationIoStub  # pylint: disable=E0611
 
 
@@ -48,6 +49,7 @@ def __init__(  # pylint: disable=too-many-arguments
         self._cert = root_certificates
         self._grpc_stub: Optional[SimulationIoStub] = None
         self._channel: Optional[grpc.Channel] = None
+        self._retry_invoker = _make_simple_grpc_retry_invoker()
 
     @property
     def _is_connected(self) -> bool:
@@ -72,6 +74,7 @@ def _connect(self) -> None:
             root_certificates=self._cert,
         )
         self._grpc_stub = SimulationIoStub(self._channel)
+        _wrap_stub(self._grpc_stub, self._retry_invoker)
         log(DEBUG, "[SimulationIO] Connected to %s", self._addr)
 
     def _disconnect(self) -> None:

From 86825e556a5f58c1309fb3661936740ffc906962 Mon Sep 17 00:00:00 2001
From: Javier <jafermarq@users.noreply.github.com>
Date: Mon, 16 Dec 2024 10:26:14 +0000
Subject: [PATCH 073/104] refactor(framework) Remove delayed start for
 `Simulation Engine` (#4688)

---
 src/py/flwr/simulation/run_simulation.py | 15 ---------------
 1 file changed, 15 deletions(-)

diff --git a/src/py/flwr/simulation/run_simulation.py b/src/py/flwr/simulation/run_simulation.py
index c59f4e22b219..ae567b6f130e 100644
--- a/src/py/flwr/simulation/run_simulation.py
+++ b/src/py/flwr/simulation/run_simulation.py
@@ -24,7 +24,6 @@
 import traceback
 from logging import DEBUG, ERROR, INFO, WARNING
 from pathlib import Path
-from time import sleep
 from typing import Any, Optional
 
 from flwr.cli.config_utils import load_and_validate
@@ -136,7 +135,6 @@ def run_simulation_from_cli() -> None:
         app_dir=args.app,
         run=run,
         enable_tf_gpu_growth=args.enable_tf_gpu_growth,
-        delay_start=args.delay_start,
         verbose_logging=args.verbose,
         server_app_run_config=fused_config,
         is_app=True,
@@ -309,7 +307,6 @@ def _main_loop(
     enable_tf_gpu_growth: bool,
     run: Run,
     exit_event: EventType,
-    delay_start: int,
     flwr_dir: Optional[str] = None,
     client_app: Optional[ClientApp] = None,
     client_app_attr: Optional[str] = None,
@@ -354,9 +351,6 @@ def _main_loop(
             run_id=run.run_id,
         )
 
-        # Buffer time so the `ServerApp` in separate thread is ready
-        log(DEBUG, "Buffer time delay: %ds", delay_start)
-        sleep(delay_start)
         # Start Simulation Engine
         vce.start_vce(
             num_supernodes=num_supernodes,
@@ -405,7 +399,6 @@ def _run_simulation(
     flwr_dir: Optional[str] = None,
     run: Optional[Run] = None,
     enable_tf_gpu_growth: bool = False,
-    delay_start: int = 5,
     verbose_logging: bool = False,
     is_app: bool = False,
 ) -> None:
@@ -460,7 +453,6 @@ def _run_simulation(
         enable_tf_gpu_growth,
         run,
         exit_event,
-        delay_start,
         flwr_dir,
         client_app,
         client_app_attr,
@@ -538,13 +530,6 @@ def _parse_args_run_simulation() -> argparse.ArgumentParser:
         "Read more about how `tf.config.experimental.set_memory_growth()` works in "
         "the TensorFlow documentation: https://www.tensorflow.org/api/stable.",
     )
-    parser.add_argument(
-        "--delay-start",
-        type=int,
-        default=3,
-        help="Buffer time (in seconds) to delay the start the simulation engine after "
-        "the `ServerApp`, which runs in a separate thread, has been launched.",
-    )
     parser.add_argument(
         "--verbose",
         action="store_true",

From fae9df97f1fb3b945a275a7e4b39f868f5dfab42 Mon Sep 17 00:00:00 2001
From: Javier <jafermarq@users.noreply.github.com>
Date: Mon, 16 Dec 2024 11:01:49 +0000
Subject: [PATCH 074/104] refactor(framework) Wrap `ClientAppIoStub` with
 `RetryInvoker` (#4637)

---
 src/py/flwr/client/clientapp/app.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/src/py/flwr/client/clientapp/app.py b/src/py/flwr/client/clientapp/app.py
index e2588670de0a..96ff7e4fd2fc 100644
--- a/src/py/flwr/client/clientapp/app.py
+++ b/src/py/flwr/client/clientapp/app.py
@@ -32,6 +32,7 @@
 from flwr.common.grpc import create_channel
 from flwr.common.logger import log
 from flwr.common.message import Error
+from flwr.common.retry_invoker import _make_simple_grpc_retry_invoker, _wrap_stub
 from flwr.common.serde import (
     context_from_proto,
     context_to_proto,
@@ -106,9 +107,9 @@ def run_clientapp(  # pylint: disable=R0914
 
     # Resolve directory where FABs are installed
     flwr_dir_ = get_flwr_dir(flwr_dir)
-
     try:
         stub = ClientAppIoStub(channel)
+        _wrap_stub(stub, _make_simple_grpc_retry_invoker())
 
         while True:
             # If token is not set, loop until token is received from SuperNode

From 830b795d3f1bbd8067c552db01b1c3d98b3b2b4b Mon Sep 17 00:00:00 2001
From: Chong Shen Ng <chong.shen@flower.ai>
Date: Mon, 16 Dec 2024 11:49:36 +0000
Subject: [PATCH 075/104] feat(framework) Add exception handling to SuperNode
 for graceful exit when stopped (#4668)

---
 src/py/flwr/client/app.py                          | 12 +++++++++++-
 src/py/flwr/client/clientapp/app.py                |  1 +
 src/py/flwr/client/grpc_rere_client/connection.py  | 14 ++++++++++----
 .../fleet/message_handler/message_handler.py       |  4 +---
 4 files changed, 23 insertions(+), 8 deletions(-)

diff --git a/src/py/flwr/client/app.py b/src/py/flwr/client/app.py
index e245e5d96576..1f04efa99eeb 100644
--- a/src/py/flwr/client/app.py
+++ b/src/py/flwr/client/app.py
@@ -56,7 +56,7 @@
 from flwr.common.logger import log, warn_deprecated_feature
 from flwr.common.message import Error
 from flwr.common.retry_invoker import RetryInvoker, RetryState, exponential
-from flwr.common.typing import Fab, Run, UserConfig
+from flwr.common.typing import Fab, Run, RunNotRunningException, UserConfig
 from flwr.proto.clientappio_pb2_grpc import add_ClientAppIoServicer_to_server
 from flwr.server.superlink.fleet.grpc_bidi.grpc_server import generic_create_grpc_server
 from flwr.server.superlink.linkstate.utils import generate_rand_int_from_bytes
@@ -612,6 +612,16 @@ def _on_backoff(retry_state: RetryState) -> None:
                     send(reply_message)
                     log(INFO, "Sent reply")
 
+                except RunNotRunningException:
+                    log(INFO, "")
+                    log(
+                        INFO,
+                        "SuperNode aborted sending the reply message. "
+                        "Run ID %s is not in `RUNNING` status.",
+                        run_id,
+                    )
+                    log(INFO, "")
+
                 except StopIteration:
                     sleep_duration = 0
                     break
diff --git a/src/py/flwr/client/clientapp/app.py b/src/py/flwr/client/clientapp/app.py
index 96ff7e4fd2fc..32813205478a 100644
--- a/src/py/flwr/client/clientapp/app.py
+++ b/src/py/flwr/client/clientapp/app.py
@@ -140,6 +140,7 @@ def run_clientapp(  # pylint: disable=R0914
 
                 # Execute ClientApp
                 reply_message = client_app(message=message, context=context)
+
             except Exception as ex:  # pylint: disable=broad-exception-caught
                 # Don't update/change NodeState
 
diff --git a/src/py/flwr/client/grpc_rere_client/connection.py b/src/py/flwr/client/grpc_rere_client/connection.py
index ed5745512186..8f33f0b3f07a 100644
--- a/src/py/flwr/client/grpc_rere_client/connection.py
+++ b/src/py/flwr/client/grpc_rere_client/connection.py
@@ -42,7 +42,7 @@
 from flwr.common.message import Message, Metadata
 from flwr.common.retry_invoker import RetryInvoker
 from flwr.common.serde import message_from_taskins, message_to_taskres, run_from_proto
-from flwr.common.typing import Fab, Run
+from flwr.common.typing import Fab, Run, RunNotRunningException
 from flwr.proto.fab_pb2 import GetFabRequest, GetFabResponse  # pylint: disable=E0611
 from flwr.proto.fleet_pb2 import (  # pylint: disable=E0611
     CreateNodeRequest,
@@ -155,10 +155,16 @@ def grpc_request_response(  # pylint: disable=R0913,R0914,R0915,R0917
     ping_thread: Optional[threading.Thread] = None
     ping_stop_event = threading.Event()
 
+    def _should_giveup_fn(e: Exception) -> bool:
+        if e.code() == grpc.StatusCode.PERMISSION_DENIED:  # type: ignore
+            raise RunNotRunningException
+        if e.code() == grpc.StatusCode.UNAVAILABLE:  # type: ignore
+            return False
+        return True
+
     # Restrict retries to cases where the status code is UNAVAILABLE
-    retry_invoker.should_giveup = (
-        lambda e: e.code() != grpc.StatusCode.UNAVAILABLE  # type: ignore
-    )
+    # If the status code is PERMISSION_DENIED, additionally raise RunNotRunningException
+    retry_invoker.should_giveup = _should_giveup_fn
 
     ###########################################################################
     # ping/create_node/delete_node/receive/send/get_run functions
diff --git a/src/py/flwr/server/superlink/fleet/message_handler/message_handler.py b/src/py/flwr/server/superlink/fleet/message_handler/message_handler.py
index 34917b8168eb..c70c09cd7ac9 100644
--- a/src/py/flwr/server/superlink/fleet/message_handler/message_handler.py
+++ b/src/py/flwr/server/superlink/fleet/message_handler/message_handler.py
@@ -123,9 +123,7 @@ def push_task_res(request: PushTaskResRequest, state: LinkState) -> PushTaskResR
     return response
 
 
-def get_run(
-    request: GetRunRequest, state: LinkState  # pylint: disable=W0613
-) -> GetRunResponse:
+def get_run(request: GetRunRequest, state: LinkState) -> GetRunResponse:
     """Get run information."""
     run = state.get_run(request.run_id)
 

From a858212e6b92c379a957034eb9ab06a8ea093162 Mon Sep 17 00:00:00 2001
From: Javier <jafermarq@users.noreply.github.com>
Date: Mon, 16 Dec 2024 12:11:46 +0000
Subject: [PATCH 076/104] refactor(examples) Add link to previous version of
 tutorial (#4696)

---
 examples/flower-simulation-step-by-step-pytorch/README.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/examples/flower-simulation-step-by-step-pytorch/README.md b/examples/flower-simulation-step-by-step-pytorch/README.md
index 0f269f62c143..0a1a0adb3d56 100644
--- a/examples/flower-simulation-step-by-step-pytorch/README.md
+++ b/examples/flower-simulation-step-by-step-pytorch/README.md
@@ -8,6 +8,8 @@ framework: [torch]
 
 > \[!NOTE\]
 > While this tutorial shows how to extend the functionality of a Flower App that uses PyTorch, there is little specific about PyTorch in the changes described in this tutorial series. This means that you can make use of all the concepts presented even if you decide to use a different ML framework.
+>
+> The previous version of this tutorial from the 2023 video tutorial series can be found here: [c8120f2](https://github.com/adap/flower/tree/c8120f2669fef0f2e6815ab1e957e5366d06d19d/examples/flower-simulation-step-by-step-pytorch). Please note that method of running simulations is no longer recommended and some parts of it, e.g. using `start_simulation`, are deprecated in recent versions of `flwr`.
 
 This directory contains the code to follow along the `Flower AI Simulation 2025` tutorial series on Youtube. You can find all the videos [here](https://www.youtube.com/playlist?list=PLNG4feLHqCWkdlSrEL2xbCtGa6QBxlUZb) or clicking on the video previews below.
 

From 3f8c541f80c1f8e83d84ead0fcc94d9e13a9c0c2 Mon Sep 17 00:00:00 2001
From: Chong Shen Ng <chong.shen@flower.ai>
Date: Mon, 16 Dec 2024 12:21:01 +0000
Subject: [PATCH 077/104] feat(framework) Update `flwr ls` docstring (#4713)

---
 src/py/flwr/cli/ls.py | 15 ++++++++++++++-
 1 file changed, 14 insertions(+), 1 deletion(-)

diff --git a/src/py/flwr/cli/ls.py b/src/py/flwr/cli/ls.py
index cc9b87219abf..d66a7bd01fb5 100644
--- a/src/py/flwr/cli/ls.py
+++ b/src/py/flwr/cli/ls.py
@@ -81,7 +81,20 @@ def ls(  # pylint: disable=too-many-locals, too-many-branches
         ),
     ] = CliOutputFormat.DEFAULT,
 ) -> None:
-    """List runs."""
+    """List the details of one provided run ID or all runs in a Flower federation.
+
+    The following details are displayed:
+
+    - **Run ID:** Unique identifier for the run.
+    - **FAB:** Name of the FAB associated with the run (``{FAB_ID} (v{FAB_VERSION})``).
+    - **Status:** Current status of the run (pending, starting, running, finished).
+    - **Elapsed:** Time elapsed since the run started (``HH:MM:SS``).
+    - **Created At:** Timestamp when the run was created.
+    - **Running At:** Timestamp when the run started running.
+    - **Finished At:** Timestamp when the run finished.
+
+    All timestamps follow ISO 8601, UTC and are formatted as ``YYYY-MM-DD HH:MM:SSZ``.
+    """
     suppress_output = output_format == CliOutputFormat.JSON
     captured_output = io.StringIO()
     try:

From c312858fae250d97f1fb4b7e2fbe9240d486d93e Mon Sep 17 00:00:00 2001
From: Heng Pan <pan@flower.ai>
Date: Mon, 16 Dec 2024 20:31:28 +0800
Subject: [PATCH 078/104] refactor(framework) Remove one argument from
 `flower-superlink` (#4706)

---
 src/py/flwr/server/app.py | 15 +++++++--------
 1 file changed, 7 insertions(+), 8 deletions(-)

diff --git a/src/py/flwr/server/app.py b/src/py/flwr/server/app.py
index 7746a1cf5286..91514f845651 100644
--- a/src/py/flwr/server/app.py
+++ b/src/py/flwr/server/app.py
@@ -93,9 +93,13 @@
 
 
 try:
-    from flwr.ee import get_exec_auth_plugins
+    from flwr.ee import add_ee_args_superlink, get_exec_auth_plugins
 except ImportError:
 
+    # pylint: disable-next=unused-argument
+    def add_ee_args_superlink(parser: argparse.ArgumentParser) -> None:
+        """Add EE-specific arguments to the parser."""
+
     def get_exec_auth_plugins() -> dict[str, type[ExecAuthPlugin]]:
         """Return all Exec API authentication plugins."""
         raise NotImplementedError("No authentication plugins are currently supported.")
@@ -580,7 +584,7 @@ def _try_setup_node_authentication(
 
 
 def _try_obtain_user_auth_config(args: argparse.Namespace) -> Optional[dict[str, Any]]:
-    if args.user_auth_config is not None:
+    if getattr(args, "user_auth_config", None) is not None:
         with open(args.user_auth_config, encoding="utf-8") as file:
             config: dict[str, Any] = yaml.safe_load(file)
             return config
@@ -703,6 +707,7 @@ def _parse_args_run_superlink() -> argparse.ArgumentParser:
     )
 
     _add_args_common(parser=parser)
+    add_ee_args_superlink(parser=parser)
     _add_args_serverappio_api(parser=parser)
     _add_args_fleet_api(parser=parser)
     _add_args_exec_api(parser=parser)
@@ -792,12 +797,6 @@ def _add_args_common(parser: argparse.ArgumentParser) -> None:
         type=str,
         help="The SuperLink's public key (as a path str) to enable authentication.",
     )
-    parser.add_argument(
-        "--user-auth-config",
-        help="The path to the user authentication configuration YAML file.",
-        type=str,
-        default=None,
-    )
 
 
 def _add_args_serverappio_api(parser: argparse.ArgumentParser) -> None:

From e1408f8cac414fe635801789fa9ac912fa82ad50 Mon Sep 17 00:00:00 2001
From: Heng Pan <pan@flower.ai>
Date: Mon, 16 Dec 2024 22:50:36 +0800
Subject: [PATCH 079/104] refactor(framework) Update credentials file name
 format (#4717)

---
 src/py/flwr/cli/log.py         |  2 +-
 src/py/flwr/cli/login/login.py |  4 +---
 src/py/flwr/cli/ls.py          |  2 +-
 src/py/flwr/cli/run/run.py     |  2 +-
 src/py/flwr/cli/stop.py        |  2 +-
 src/py/flwr/cli/utils.py       | 19 +++----------------
 6 files changed, 8 insertions(+), 23 deletions(-)

diff --git a/src/py/flwr/cli/log.py b/src/py/flwr/cli/log.py
index d30001dc7aaa..93fe3c387974 100644
--- a/src/py/flwr/cli/log.py
+++ b/src/py/flwr/cli/log.py
@@ -170,7 +170,7 @@ def _log_with_exec_api(
     run_id: int,
     stream: bool,
 ) -> None:
-    auth_plugin = try_obtain_cli_auth_plugin(app, federation, federation_config)
+    auth_plugin = try_obtain_cli_auth_plugin(app, federation)
     channel = init_channel(app, federation_config, auth_plugin)
 
     if stream:
diff --git a/src/py/flwr/cli/login/login.py b/src/py/flwr/cli/login/login.py
index 5a2a39fff6e9..f08835b360af 100644
--- a/src/py/flwr/cli/login/login.py
+++ b/src/py/flwr/cli/login/login.py
@@ -65,9 +65,7 @@ def login(  # pylint: disable=R0914
 
     # Get the auth plugin
     auth_type = login_response.login_details.get(AUTH_TYPE)
-    auth_plugin = try_obtain_cli_auth_plugin(
-        app, federation, federation_config, auth_type
-    )
+    auth_plugin = try_obtain_cli_auth_plugin(app, federation, auth_type)
     if auth_plugin is None:
         typer.secho(
             f'❌ Authentication type "{auth_type}" not found',
diff --git a/src/py/flwr/cli/ls.py b/src/py/flwr/cli/ls.py
index d66a7bd01fb5..1e8b56b576e4 100644
--- a/src/py/flwr/cli/ls.py
+++ b/src/py/flwr/cli/ls.py
@@ -117,7 +117,7 @@ def ls(  # pylint: disable=too-many-locals, too-many-branches
                 raise ValueError(
                     "The options '--runs' and '--run-id' are mutually exclusive."
                 )
-            auth_plugin = try_obtain_cli_auth_plugin(app, federation, federation_config)
+            auth_plugin = try_obtain_cli_auth_plugin(app, federation)
             channel = init_channel(app, federation_config, auth_plugin)
             stub = ExecStub(channel)
 
diff --git a/src/py/flwr/cli/run/run.py b/src/py/flwr/cli/run/run.py
index eec0eec1f830..34e7fc50e2f0 100644
--- a/src/py/flwr/cli/run/run.py
+++ b/src/py/flwr/cli/run/run.py
@@ -144,7 +144,7 @@ def _run_with_exec_api(
     stream: bool,
     output_format: str,
 ) -> None:
-    auth_plugin = try_obtain_cli_auth_plugin(app, federation, federation_config)
+    auth_plugin = try_obtain_cli_auth_plugin(app, federation)
     channel = init_channel(app, federation_config, auth_plugin)
     stub = ExecStub(channel)
 
diff --git a/src/py/flwr/cli/stop.py b/src/py/flwr/cli/stop.py
index bcf07f8a6156..acfa818efb32 100644
--- a/src/py/flwr/cli/stop.py
+++ b/src/py/flwr/cli/stop.py
@@ -60,7 +60,7 @@ def stop(
     exit_if_no_address(federation_config, "stop")
 
     try:
-        auth_plugin = try_obtain_cli_auth_plugin(app, federation, federation_config)
+        auth_plugin = try_obtain_cli_auth_plugin(app, federation)
         channel = init_channel(app, federation_config, auth_plugin)
         stub = ExecStub(channel)  # pylint: disable=unused-variable # noqa: F841
 
diff --git a/src/py/flwr/cli/utils.py b/src/py/flwr/cli/utils.py
index e3766cd6d20b..7a8040756c5e 100644
--- a/src/py/flwr/cli/utils.py
+++ b/src/py/flwr/cli/utils.py
@@ -26,7 +26,6 @@
 import typer
 
 from flwr.cli.cli_user_auth_interceptor import CliUserAuthInterceptor
-from flwr.common.address import parse_address
 from flwr.common.auth_plugin import CliAuthPlugin
 from flwr.common.constant import AUTH_TYPE, CREDENTIALS_DIR, FLWR_DIR
 from flwr.common.grpc import GRPC_MAX_MESSAGE_LENGTH, create_channel
@@ -159,33 +158,21 @@ def get_sha256_hash(file_path: Path) -> str:
     return sha256.hexdigest()
 
 
-def get_user_auth_config_path(
-    root_dir: Path, federation: str, server_address: str
-) -> Path:
+def get_user_auth_config_path(root_dir: Path, federation: str) -> Path:
     """Return the path to the user auth config file."""
-    # Parse the server address
-    parsed_addr = parse_address(server_address)
-    if parsed_addr is None:
-        raise ValueError(f"Invalid server address: {server_address}")
-    host, port, is_v6 = parsed_addr
-    formatted_addr = f"[{host}]_{port}" if is_v6 else f"{host}_{port}"
-
     # Locate the credentials directory
     credentials_dir = root_dir.absolute() / FLWR_DIR / CREDENTIALS_DIR
     credentials_dir.mkdir(parents=True, exist_ok=True)
-    return credentials_dir / f"{federation}_{formatted_addr}.json"
+    return credentials_dir / f"{federation}.json"
 
 
 def try_obtain_cli_auth_plugin(
     root_dir: Path,
     federation: str,
-    federation_config: dict[str, Any],
     auth_type: Optional[str] = None,
 ) -> Optional[CliAuthPlugin]:
     """Load the CLI-side user auth plugin for the given auth type."""
-    config_path = get_user_auth_config_path(
-        root_dir, federation, federation_config["address"]
-    )
+    config_path = get_user_auth_config_path(root_dir, federation)
 
     # Load the config file if it exists
     config: dict[str, Any] = {}

From 39eba0aa2b1b2b8c418a4de2adf7abcfa0aec85e Mon Sep 17 00:00:00 2001
From: Heng Pan <pan@flower.ai>
Date: Mon, 16 Dec 2024 23:08:19 +0800
Subject: [PATCH 080/104] fix(*:skip) Fix the paths in the release tools
 (#4715)

---
 dev/update_changelog.py | 2 +-
 dev/update_version.py   | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/dev/update_changelog.py b/dev/update_changelog.py
index 0b4359d90e13..80bed873aeb3 100644
--- a/dev/update_changelog.py
+++ b/dev/update_changelog.py
@@ -33,7 +33,7 @@
 from github.Tag import Tag
 
 REPO_NAME = "adap/flower"
-CHANGELOG_FILE = "doc/source/ref-changelog.md"
+CHANGELOG_FILE = "framework/docs/source/ref-changelog.md"
 CHANGELOG_SECTION_HEADER = "### Changelog entry"
 
 # Load the TOML configuration
diff --git a/dev/update_version.py b/dev/update_version.py
index adfb904833b2..e80b1b6a68ca 100644
--- a/dev/update_version.py
+++ b/dev/update_version.py
@@ -80,7 +80,7 @@ def _update_versions(file_patterns, replace_strings, new_version, check):
 
 
 if __name__ == "__main__":
-    conf_path = Path("doc/source/conf.py")
+    conf_path = Path("framework/docs/source/conf.py")
 
     if not conf_path.is_file():
         raise FileNotFoundError(f"{conf_path} not found!")

From 39b8f8858564ff81cd841430487a449c19ab6fd2 Mon Sep 17 00:00:00 2001
From: Chong Shen Ng <chong.shen@flower.ai>
Date: Mon, 16 Dec 2024 15:56:27 +0000
Subject: [PATCH 081/104] feat(framework) Add `ServerAppIoServicer` tests for
 allowed `RunStatus` (#4704)

Co-authored-by: Heng Pan <pan@flower.ai>
---
 .../driver/serverappio_servicer_test.py       | 358 ++++++++++++++++++
 1 file changed, 358 insertions(+)

diff --git a/src/py/flwr/server/superlink/driver/serverappio_servicer_test.py b/src/py/flwr/server/superlink/driver/serverappio_servicer_test.py
index a498bdabc002..9f11b04a5228 100644
--- a/src/py/flwr/server/superlink/driver/serverappio_servicer_test.py
+++ b/src/py/flwr/server/superlink/driver/serverappio_servicer_test.py
@@ -15,7 +15,39 @@
 """ServerAppIoServicer tests."""
 
 
+import tempfile
+import unittest
+
+import grpc
+from parameterized import parameterized
+
+from flwr.common import ConfigsRecord, Context
+from flwr.common.constant import SERVERAPPIO_API_DEFAULT_SERVER_ADDRESS, Status
+from flwr.common.serde import context_to_proto, run_status_to_proto
+from flwr.common.serde_test import RecordMaker
+from flwr.common.typing import RunStatus
+from flwr.proto.node_pb2 import Node  # pylint: disable=E0611
+from flwr.proto.run_pb2 import (  # pylint: disable=E0611
+    UpdateRunStatusRequest,
+    UpdateRunStatusResponse,
+)
+from flwr.proto.serverappio_pb2 import (  # pylint: disable=E0611
+    GetNodesRequest,
+    GetNodesResponse,
+    PullTaskResRequest,
+    PullTaskResResponse,
+    PushServerAppOutputsRequest,
+    PushServerAppOutputsResponse,
+    PushTaskInsRequest,
+    PushTaskInsResponse,
+)
+from flwr.proto.task_pb2 import TaskIns  # pylint: disable=E0611
+from flwr.server.superlink.driver.serverappio_grpc import run_serverappio_api_grpc
 from flwr.server.superlink.driver.serverappio_servicer import _raise_if
+from flwr.server.superlink.ffs.ffs_factory import FfsFactory
+from flwr.server.superlink.linkstate.linkstate_factory import LinkStateFactory
+from flwr.server.superlink.linkstate.linkstate_test import create_task_ins
+from flwr.server.superlink.utils import _STATUS_TO_MSG
 
 # pylint: disable=broad-except
 
@@ -54,3 +86,329 @@ def test_raise_if_true() -> None:
         assert str(err) == "Malformed PushTaskInsRequest: test"
     except Exception as err:
         raise AssertionError() from err
+
+
+class TestServerAppIoServicer(unittest.TestCase):  # pylint: disable=R0902
+    """ServerAppIoServicer tests for allowed RunStatuses."""
+
+    def setUp(self) -> None:
+        """Initialize mock stub and server interceptor."""
+        # Create a temporary directory
+        self.temp_dir = tempfile.TemporaryDirectory()  # pylint: disable=R1732
+        self.addCleanup(self.temp_dir.cleanup)  # Ensures cleanup after test
+
+        state_factory = LinkStateFactory(":flwr-in-memory-state:")
+        self.state = state_factory.state()
+        ffs_factory = FfsFactory(self.temp_dir.name)
+        self.ffs = ffs_factory.ffs()
+
+        self.status_to_msg = _STATUS_TO_MSG
+
+        self._server: grpc.Server = run_serverappio_api_grpc(
+            SERVERAPPIO_API_DEFAULT_SERVER_ADDRESS,
+            state_factory,
+            ffs_factory,
+            None,
+        )
+
+        self._channel = grpc.insecure_channel("localhost:9091")
+        self._get_nodes = self._channel.unary_unary(
+            "/flwr.proto.ServerAppIo/GetNodes",
+            request_serializer=GetNodesRequest.SerializeToString,
+            response_deserializer=GetNodesResponse.FromString,
+        )
+        self._push_task_ins = self._channel.unary_unary(
+            "/flwr.proto.ServerAppIo/PushTaskIns",
+            request_serializer=PushTaskInsRequest.SerializeToString,
+            response_deserializer=PushTaskInsResponse.FromString,
+        )
+        self._pull_task_res = self._channel.unary_unary(
+            "/flwr.proto.ServerAppIo/PullTaskRes",
+            request_serializer=PullTaskResRequest.SerializeToString,
+            response_deserializer=PullTaskResResponse.FromString,
+        )
+        self._push_serverapp_outputs = self._channel.unary_unary(
+            "/flwr.proto.ServerAppIo/PushServerAppOutputs",
+            request_serializer=PushServerAppOutputsRequest.SerializeToString,
+            response_deserializer=PushServerAppOutputsResponse.FromString,
+        )
+        self._update_run_status = self._channel.unary_unary(
+            "/flwr.proto.ServerAppIo/UpdateRunStatus",
+            request_serializer=UpdateRunStatusRequest.SerializeToString,
+            response_deserializer=UpdateRunStatusResponse.FromString,
+        )
+
+    def tearDown(self) -> None:
+        """Clean up grpc server."""
+        self._server.stop(None)
+
+    def _transition_run_status(self, run_id: int, num_transitions: int) -> None:
+        if num_transitions > 0:
+            _ = self.state.update_run_status(run_id, RunStatus(Status.STARTING, "", ""))
+        if num_transitions > 1:
+            _ = self.state.update_run_status(run_id, RunStatus(Status.RUNNING, "", ""))
+        if num_transitions > 2:
+            _ = self.state.update_run_status(run_id, RunStatus(Status.FINISHED, "", ""))
+
+    def test_successful_get_node_if_running(self) -> None:
+        """Test `GetNode` success."""
+        # Prepare
+        run_id = self.state.create_run("", "", "", {}, ConfigsRecord())
+
+        # Transition status to running. PushTaskRes is only allowed in running status.
+        self._transition_run_status(run_id, 2)
+        request = GetNodesRequest(run_id=run_id)
+
+        # Execute
+        response, call = self._get_nodes.with_call(request=request)
+
+        # Assert
+        assert isinstance(response, GetNodesResponse)
+        assert grpc.StatusCode.OK == call.code()
+
+    def _assert_get_nodes_not_allowed(self, run_id: int) -> None:
+        """Assert `GetNodes` not allowed."""
+        run_status = self.state.get_run_status({run_id})[run_id]
+        request = GetNodesRequest(run_id=run_id)
+
+        with self.assertRaises(grpc.RpcError) as e:
+            self._get_nodes.with_call(request=request)
+        assert e.exception.code() == grpc.StatusCode.PERMISSION_DENIED
+        assert e.exception.details() == self.status_to_msg[run_status.status]
+
+    @parameterized.expand(
+        [
+            (0,),  # Test not successful if RunStatus is pending.
+            (1,),  # Test not successful if RunStatus is starting.
+            (3,),  # Test not successful if RunStatus is finished.
+        ]
+    )  # type: ignore
+    def test_get_nodes_not_successful_if_not_running(
+        self, num_transitions: int
+    ) -> None:
+        """Test `GetNodes` not sucessful if RunStatus is pending."""
+        # Prepare
+        run_id = self.state.create_run("", "", "", {}, ConfigsRecord())
+
+        self._transition_run_status(run_id, num_transitions)
+
+        # Execute & Assert
+        self._assert_get_nodes_not_allowed(run_id)
+
+    def test_successful_push_task_ins_if_running(self) -> None:
+        """Test `PushTaskIns` success."""
+        # Prepare
+        node_id = self.state.create_node(ping_interval=30)
+        run_id = self.state.create_run("", "", "", {}, ConfigsRecord())
+        task_ins = create_task_ins(
+            consumer_node_id=node_id, anonymous=False, run_id=run_id
+        )
+
+        # Transition status to running. PushTaskRes is only allowed in running status.
+        self._transition_run_status(run_id, 2)
+        request = PushTaskInsRequest(task_ins_list=[task_ins], run_id=run_id)
+
+        # Execute
+        response, call = self._push_task_ins.with_call(request=request)
+
+        # Assert
+        assert isinstance(response, PushTaskInsResponse)
+        assert grpc.StatusCode.OK == call.code()
+
+    def _assert_push_task_ins_not_allowed(self, task_ins: TaskIns, run_id: int) -> None:
+        """Assert `PushTaskIns` not allowed."""
+        run_status = self.state.get_run_status({run_id})[run_id]
+        request = PushTaskInsRequest(task_ins_list=[task_ins], run_id=run_id)
+
+        with self.assertRaises(grpc.RpcError) as e:
+            self._push_task_ins.with_call(request=request)
+        assert e.exception.code() == grpc.StatusCode.PERMISSION_DENIED
+        assert e.exception.details() == self.status_to_msg[run_status.status]
+
+    @parameterized.expand(
+        [
+            (0,),  # Test not successful if RunStatus is pending.
+            (1,),  # Test not successful if RunStatus is starting.
+            (3,),  # Test not successful if RunStatus is finished.
+        ]
+    )  # type: ignore
+    def test_push_task_ins_not_successful_if_not_running(
+        self, num_transitions: int
+    ) -> None:
+        """Test `PushTaskIns` not successful if RunStatus is not running."""
+        # Prepare
+        node_id = self.state.create_node(ping_interval=30)
+        run_id = self.state.create_run("", "", "", {}, ConfigsRecord())
+        task_ins = create_task_ins(
+            consumer_node_id=node_id, anonymous=False, run_id=run_id
+        )
+
+        self._transition_run_status(run_id, num_transitions)
+
+        # Execute & Assert
+        self._assert_push_task_ins_not_allowed(task_ins, run_id)
+
+    def test_pull_task_res_successful_if_running(self) -> None:
+        """Test `PullTaskRes` success."""
+        # Prepare
+        run_id = self.state.create_run("", "", "", {}, ConfigsRecord())
+        # Transition status to running. PushTaskRes is only allowed in running status.
+        self._transition_run_status(run_id, 2)
+        request = PullTaskResRequest(task_ids=[], run_id=run_id)
+
+        # Execute
+        response, call = self._pull_task_res.with_call(request=request)
+
+        # Assert
+        assert isinstance(response, PullTaskResResponse)
+        assert grpc.StatusCode.OK == call.code()
+
+    def _assert_pull_task_res_not_allowed(self, run_id: int) -> None:
+        """Assert `PullTaskRes` not allowed."""
+        run_status = self.state.get_run_status({run_id})[run_id]
+        request = PullTaskResRequest(node=Node(node_id=0), run_id=run_id)
+
+        with self.assertRaises(grpc.RpcError) as e:
+            self._pull_task_res.with_call(request=request)
+        assert e.exception.code() == grpc.StatusCode.PERMISSION_DENIED
+        assert e.exception.details() == self.status_to_msg[run_status.status]
+
+    @parameterized.expand(
+        [
+            (0,),  # Test not successful if RunStatus is pending.
+            (1,),  # Test not successful if RunStatus is starting.
+            (3,),  # Test not successful if RunStatus is finished.
+        ]
+    )  # type: ignore
+    def test_pull_task_res_not_successful_if_not_running(
+        self, num_transitions: int
+    ) -> None:
+        """Test `PullTaskRes` not successful if RunStatus is not running."""
+        # Prepare
+        run_id = self.state.create_run("", "", "", {}, ConfigsRecord())
+
+        self._transition_run_status(run_id, num_transitions)
+
+        # Execute & Assert
+        self._assert_pull_task_res_not_allowed(run_id)
+
+    def test_push_serverapp_outputs_successful_if_running(self) -> None:
+        """Test `PushServerAppOutputs` success."""
+        # Prepare
+        run_id = self.state.create_run("", "", "", {}, ConfigsRecord())
+
+        maker = RecordMaker()
+        context = Context(
+            run_id=run_id,
+            node_id=0,
+            node_config=maker.user_config(),
+            state=maker.recordset(1, 1, 1),
+            run_config=maker.user_config(),
+        )
+
+        # Transition status to running. PushTaskRes is only allowed in running status.
+        self._transition_run_status(run_id, 2)
+        request = PushServerAppOutputsRequest(
+            run_id=run_id, context=context_to_proto(context)
+        )
+
+        # Execute
+        response, call = self._push_serverapp_outputs.with_call(request=request)
+
+        # Assert
+        assert isinstance(response, PushServerAppOutputsResponse)
+        assert grpc.StatusCode.OK == call.code()
+
+    def _assert_push_serverapp_outputs_not_allowed(
+        self, run_id: int, context: Context
+    ) -> None:
+        """Assert `PushServerAppOutputs` not allowed."""
+        run_status = self.state.get_run_status({run_id})[run_id]
+        request = PushServerAppOutputsRequest(
+            run_id=run_id, context=context_to_proto(context)
+        )
+
+        with self.assertRaises(grpc.RpcError) as e:
+            self._push_serverapp_outputs.with_call(request=request)
+        assert e.exception.code() == grpc.StatusCode.PERMISSION_DENIED
+        assert e.exception.details() == self.status_to_msg[run_status.status]
+
+    @parameterized.expand(
+        [
+            (0,),  # Test not successful if RunStatus is pending.
+            (1,),  # Test not successful if RunStatus is starting.
+            (3,),  # Test not successful if RunStatus is finished.
+        ]
+    )  # type: ignore
+    def test_push_serverapp_outputs_not_successful_if_not_running(
+        self, num_transitions: int
+    ) -> None:
+        """Test `PushServerAppOutputs` not successful if RunStatus is not running."""
+        # Prepare
+        run_id = self.state.create_run("", "", "", {}, ConfigsRecord())
+
+        maker = RecordMaker()
+        context = Context(
+            run_id=run_id,
+            node_id=0,
+            node_config=maker.user_config(),
+            state=maker.recordset(1, 1, 1),
+            run_config=maker.user_config(),
+        )
+
+        self._transition_run_status(run_id, num_transitions)
+
+        # Execute & Assert
+        self._assert_push_serverapp_outputs_not_allowed(run_id, context)
+
+    @parameterized.expand(
+        [
+            (0,),  # Test successful if RunStatus is pending.
+            (1,),  # Test successful if RunStatus is starting.
+            (2,),  # Test successful if RunStatus is running.
+        ]
+    )  # type: ignore
+    def test_update_run_status_successful_if_not_finished(
+        self, num_transitions: int
+    ) -> None:
+        """Test `UpdateRunStatus` success."""
+        # Prepare
+        run_id = self.state.create_run("", "", "", {}, ConfigsRecord())
+        _ = self.state.get_run_status({run_id})[run_id]
+        next_run_status = RunStatus(Status.STARTING, "", "")
+
+        if num_transitions > 0:
+            _ = self.state.update_run_status(run_id, RunStatus(Status.STARTING, "", ""))
+            next_run_status = RunStatus(Status.RUNNING, "", "")
+        if num_transitions > 1:
+            _ = self.state.update_run_status(run_id, RunStatus(Status.RUNNING, "", ""))
+            next_run_status = RunStatus(Status.FINISHED, "", "")
+
+        request = UpdateRunStatusRequest(
+            run_id=run_id, run_status=run_status_to_proto(next_run_status)
+        )
+
+        # Execute
+        response, call = self._update_run_status.with_call(request=request)
+
+        # Assert
+        assert isinstance(response, UpdateRunStatusResponse)
+        assert grpc.StatusCode.OK == call.code()
+
+    def test_update_run_status_not_successful_if_finished(self) -> None:
+        """Test `UpdateRunStatus` not successful."""
+        # Prepare
+        run_id = self.state.create_run("", "", "", {}, ConfigsRecord())
+        _ = self.state.get_run_status({run_id})[run_id]
+        _ = self.state.update_run_status(run_id, RunStatus(Status.FINISHED, "", ""))
+        run_status = self.state.get_run_status({run_id})[run_id]
+        next_run_status = RunStatus(Status.FINISHED, "", "")
+
+        request = UpdateRunStatusRequest(
+            run_id=run_id, run_status=run_status_to_proto(next_run_status)
+        )
+
+        with self.assertRaises(grpc.RpcError) as e:
+            self._update_run_status.with_call(request=request)
+        assert e.exception.code() == grpc.StatusCode.PERMISSION_DENIED
+        assert e.exception.details() == self.status_to_msg[run_status.status]

From 7a5ba4b8f145e1c1fedb26d5be4b9d1b56ee8c73 Mon Sep 17 00:00:00 2001
From: Dimitris Stripelis <11239849+dstripelis@users.noreply.github.com>
Date: Mon, 16 Dec 2024 21:34:08 +0200
Subject: [PATCH 082/104] docs(framework) Fix typo (#4723)

---
 .../docs/source/how-to-run-flower-on-azure.rst    | 15 ++++++++-------
 1 file changed, 8 insertions(+), 7 deletions(-)

diff --git a/framework/docs/source/how-to-run-flower-on-azure.rst b/framework/docs/source/how-to-run-flower-on-azure.rst
index dfeda022377f..d9b3305943ab 100644
--- a/framework/docs/source/how-to-run-flower-on-azure.rst
+++ b/framework/docs/source/how-to-run-flower-on-azure.rst
@@ -19,15 +19,16 @@ Run Flower on Azure
 
 .. note::
 
-    There are many ways to deploy Flower on Microst Azure. The instructions provided in
-    this guide is just a basic walkthrough, step-by-step guide on how to quickly setup
-    and run a Flower application on a Federated Learning environment on Microst Azure.
+    There are many ways to deploy Flower on Microsoft Azure. The instructions provided
+    in this guide is just a basic walkthrough, step-by-step guide on how to quickly
+    setup and run a Flower application on a Federated Learning environment on Microsoft
+    Azure.
 
-In this how-to guide, we want to create a Federated Learning environment on Microst
+In this how-to guide, we want to create a Federated Learning environment on Microsoft
 Azure using three Virtual Machines (VMs). From the three machines, one machine will be
 used as the Federation server and two as the Federation clients. Our goal is to create a
-Flower federation on Microst Azure where we can run Flower apps from our local machine,
-e.g., laptop.
+Flower federation on Microsoft Azure where we can run Flower apps from our local
+machine, e.g., laptop.
 
 On the Federation server VM we will deploy the long-running Flower server
 (``SuperLink``) and on the two Federation client VMs we will deploy the long-running
@@ -43,7 +44,7 @@ networking rules to allow cross-VM communication.
 VM Create
 ~~~~~~~~~
 
-Assuming we are already inside the Microst Azure portal, we navigate to the ``Create``
+Assuming we are already inside the Microsoft Azure portal, we navigate to the ``Create``
 page and we select ``Azure virtual machine``. In the new page, for each VM we edit the
 properties as follows:
 

From 2c2e11617e404f6eaa11da470d07e44e76d9f226 Mon Sep 17 00:00:00 2001
From: Chong Shen Ng <chong.shen@flower.ai>
Date: Mon, 16 Dec 2024 19:42:13 +0000
Subject: [PATCH 083/104] refactor(framework) Move `print_json_error` to
 utility function (#4711)

---
 src/py/flwr/cli/ls.py        | 19 +++----------------
 src/py/flwr/cli/run/run.py   | 18 +++---------------
 src/py/flwr/common/logger.py | 17 ++++++++++++++++-
 3 files changed, 22 insertions(+), 32 deletions(-)

diff --git a/src/py/flwr/cli/ls.py b/src/py/flwr/cli/ls.py
index 1e8b56b576e4..e845583d61ac 100644
--- a/src/py/flwr/cli/ls.py
+++ b/src/py/flwr/cli/ls.py
@@ -19,13 +19,12 @@
 import json
 from datetime import datetime, timedelta
 from pathlib import Path
-from typing import Annotated, Optional, Union
+from typing import Annotated, Optional
 
 import typer
 from rich.console import Console
 from rich.table import Table
 from rich.text import Text
-from typer import Exit
 
 from flwr.cli.config_utils import (
     exit_if_no_address,
@@ -35,7 +34,7 @@
 )
 from flwr.common.constant import FAB_CONFIG_FILE, CliOutputFormat, SubStatus
 from flwr.common.date import format_timedelta, isoformat8601_utc
-from flwr.common.logger import redirect_output, remove_emojis, restore_output
+from flwr.common.logger import print_json_error, redirect_output, restore_output
 from flwr.common.serde import run_from_proto
 from flwr.common.typing import Run
 from flwr.proto.exec_pb2 import (  # pylint: disable=E0611
@@ -145,7 +144,7 @@ def ls(  # pylint: disable=too-many-locals, too-many-branches
         if suppress_output:
             restore_output()
             e_message = captured_output.getvalue()
-            _print_json_error(e_message, err)
+            print_json_error(e_message, err)
         else:
             typer.secho(
                 f"{err}",
@@ -323,15 +322,3 @@ def _display_one_run(
         Console().print_json(_to_json(formatted_runs))
     else:
         Console().print(_to_table(formatted_runs))
-
-
-def _print_json_error(msg: str, e: Union[Exit, Exception]) -> None:
-    """Print error message as JSON."""
-    Console().print_json(
-        json.dumps(
-            {
-                "success": False,
-                "error-message": remove_emojis(str(msg) + "\n" + str(e)),
-            }
-        )
-    )
diff --git a/src/py/flwr/cli/run/run.py b/src/py/flwr/cli/run/run.py
index 34e7fc50e2f0..19db2ade39dc 100644
--- a/src/py/flwr/cli/run/run.py
+++ b/src/py/flwr/cli/run/run.py
@@ -19,7 +19,7 @@
 import json
 import subprocess
 from pathlib import Path
-from typing import Annotated, Any, Optional, Union
+from typing import Annotated, Any, Optional
 
 import typer
 from rich.console import Console
@@ -37,7 +37,7 @@
     user_config_to_configsrecord,
 )
 from flwr.common.constant import CliOutputFormat
-from flwr.common.logger import redirect_output, remove_emojis, restore_output
+from flwr.common.logger import print_json_error, redirect_output, restore_output
 from flwr.common.serde import (
     configs_record_to_proto,
     fab_to_proto,
@@ -122,7 +122,7 @@ def run(
         if suppress_output:
             restore_output()
             e_message = captured_output.getvalue()
-            _print_json_error(e_message, err)
+            print_json_error(e_message, err)
         else:
             typer.secho(
                 f"{err}",
@@ -239,15 +239,3 @@ def _run_without_exec_api(
         check=True,
         text=True,
     )
-
-
-def _print_json_error(msg: str, e: Union[typer.Exit, Exception]) -> None:
-    """Print error message as JSON."""
-    Console().print_json(
-        json.dumps(
-            {
-                "success": False,
-                "error-message": remove_emojis(str(msg) + "\n" + str(e)),
-            }
-        )
-    )
diff --git a/src/py/flwr/common/logger.py b/src/py/flwr/common/logger.py
index 00395cacf2b8..64763faf740d 100644
--- a/src/py/flwr/common/logger.py
+++ b/src/py/flwr/common/logger.py
@@ -15,6 +15,7 @@
 """Flower Logger."""
 
 
+import json as _json
 import logging
 import re
 import sys
@@ -27,6 +28,8 @@
 from typing import TYPE_CHECKING, Any, Optional, TextIO, Union
 
 import grpc
+import typer
+from rich.console import Console
 
 from flwr.proto.log_pb2 import PushLogsRequest  # pylint: disable=E0611
 from flwr.proto.node_pb2 import Node  # pylint: disable=E0611
@@ -377,7 +380,7 @@ def stop_log_uploader(
     log_uploader.join()
 
 
-def remove_emojis(text: str) -> str:
+def _remove_emojis(text: str) -> str:
     """Remove emojis from the provided text."""
     emoji_pattern = re.compile(
         "["
@@ -391,3 +394,15 @@ def remove_emojis(text: str) -> str:
         flags=re.UNICODE,
     )
     return emoji_pattern.sub(r"", text)
+
+
+def print_json_error(msg: str, e: Union[typer.Exit, Exception]) -> None:
+    """Print error message as JSON."""
+    Console().print_json(
+        _json.dumps(
+            {
+                "success": False,
+                "error-message": _remove_emojis(str(msg) + "\n" + str(e)),
+            }
+        )
+    )

From 0d1cff5a1f60482b3b0e66914201bb38458af8eb Mon Sep 17 00:00:00 2001
From: Vidit Khandelwal <34510012+TheVidz@users.noreply.github.com>
Date: Tue, 17 Dec 2024 01:23:44 +0530
Subject: [PATCH 084/104] fix(examples) Remove `numpy` specification in
 `vertical-fl` (#4724)

---
 examples/vertical-fl/pyproject.toml | 1 -
 1 file changed, 1 deletion(-)

diff --git a/examples/vertical-fl/pyproject.toml b/examples/vertical-fl/pyproject.toml
index 2376b55e1110..4efa726eb530 100644
--- a/examples/vertical-fl/pyproject.toml
+++ b/examples/vertical-fl/pyproject.toml
@@ -10,7 +10,6 @@ license = "Apache-2.0"
 dependencies = [
     "flwr[simulation]>=1.13.1",
     "flwr-datasets>=0.3.0",
-    "numpy==1.24.4",
     "pandas==2.0.3",
     "scikit-learn==1.3.2",
     "torch==2.1.0",

From 194cc9341bc311b546d2d44363430684c3ce0e9a Mon Sep 17 00:00:00 2001
From: Chong Shen Ng <chong.shen@flower.ai>
Date: Mon, 16 Dec 2024 20:34:10 +0000
Subject: [PATCH 085/104] refactor(framework) Add `try`-`except` block to `flwr
 stop` for `JSON` output (#4712)

---
 src/py/flwr/cli/stop.py | 52 ++++++++++++++++++++++++-----------------
 1 file changed, 30 insertions(+), 22 deletions(-)

diff --git a/src/py/flwr/cli/stop.py b/src/py/flwr/cli/stop.py
index acfa818efb32..84002f0f6e27 100644
--- a/src/py/flwr/cli/stop.py
+++ b/src/py/flwr/cli/stop.py
@@ -48,34 +48,42 @@ def stop(
     ] = None,
 ) -> None:
     """Stop a run."""
-    # Load and validate federation config
-    typer.secho("Loading project configuration... ", fg=typer.colors.BLUE)
+    try:
+        # Load and validate federation config
+        typer.secho("Loading project configuration... ", fg=typer.colors.BLUE)
 
-    pyproject_path = app / FAB_CONFIG_FILE if app else None
-    config, errors, warnings = load_and_validate(path=pyproject_path)
-    config = process_loaded_project_config(config, errors, warnings)
-    federation, federation_config = validate_federation_in_project_config(
-        federation, config
-    )
-    exit_if_no_address(federation_config, "stop")
+        pyproject_path = app / FAB_CONFIG_FILE if app else None
+        config, errors, warnings = load_and_validate(path=pyproject_path)
+        config = process_loaded_project_config(config, errors, warnings)
+        federation, federation_config = validate_federation_in_project_config(
+            federation, config
+        )
+        exit_if_no_address(federation_config, "stop")
 
-    try:
-        auth_plugin = try_obtain_cli_auth_plugin(app, federation)
-        channel = init_channel(app, federation_config, auth_plugin)
-        stub = ExecStub(channel)  # pylint: disable=unused-variable # noqa: F841
+        try:
+            auth_plugin = try_obtain_cli_auth_plugin(app, federation)
+            channel = init_channel(app, federation_config, auth_plugin)
+            stub = ExecStub(channel)  # pylint: disable=unused-variable # noqa: F841
 
-        typer.secho(f"✋ Stopping run ID {run_id}...", fg=typer.colors.GREEN)
-        _stop_run(stub, run_id=run_id)
+            typer.secho(f"✋ Stopping run ID {run_id}...", fg=typer.colors.GREEN)
+            _stop_run(stub, run_id=run_id)
 
-    except ValueError as err:
-        typer.secho(
-            f"❌ {err}",
-            fg=typer.colors.RED,
-            bold=True,
-        )
+        except ValueError as err:
+            typer.secho(
+                f"❌ {err}",
+                fg=typer.colors.RED,
+                bold=True,
+            )
+            raise typer.Exit(code=1) from err
+        finally:
+            channel.close()
+    except (
+        typer.Exit,
+        Exception,
+    ) as err:  # pylint: disable=broad-except, W0612  # noqa: F841
         raise typer.Exit(code=1) from err
     finally:
-        channel.close()
+        pass
 
 
 def _stop_run(

From 210ae959d0b7cd7db14f0550d4066db8a9101719 Mon Sep 17 00:00:00 2001
From: Chong Shen Ng <chong.shen@flower.ai>
Date: Mon, 16 Dec 2024 20:53:00 +0000
Subject: [PATCH 086/104] feat(framework) Add JSON output to `flwr stop`
 (#4710)

---
 src/py/flwr/cli/stop.py | 58 +++++++++++++++++++++++++++++++----------
 1 file changed, 44 insertions(+), 14 deletions(-)

diff --git a/src/py/flwr/cli/stop.py b/src/py/flwr/cli/stop.py
index 84002f0f6e27..4989d216f28f 100644
--- a/src/py/flwr/cli/stop.py
+++ b/src/py/flwr/cli/stop.py
@@ -15,10 +15,13 @@
 """Flower command line interface `stop` command."""
 
 
+import io
+import json
 from pathlib import Path
 from typing import Annotated, Optional
 
 import typer
+from rich.console import Console
 
 from flwr.cli.config_utils import (
     exit_if_no_address,
@@ -26,14 +29,15 @@
     process_loaded_project_config,
     validate_federation_in_project_config,
 )
-from flwr.common.constant import FAB_CONFIG_FILE
+from flwr.common.constant import FAB_CONFIG_FILE, CliOutputFormat
+from flwr.common.logger import print_json_error, redirect_output, restore_output
 from flwr.proto.exec_pb2 import StopRunRequest, StopRunResponse  # pylint: disable=E0611
 from flwr.proto.exec_pb2_grpc import ExecStub
 
 from .utils import init_channel, try_obtain_cli_auth_plugin
 
 
-def stop(
+def stop(  # pylint: disable=R0914
     run_id: Annotated[  # pylint: disable=unused-argument
         int,
         typer.Argument(help="The Flower run ID to stop"),
@@ -46,9 +50,22 @@ def stop(
         Optional[str],
         typer.Argument(help="Name of the federation"),
     ] = None,
+    output_format: Annotated[
+        str,
+        typer.Option(
+            "--format",
+            case_sensitive=False,
+            help="Format output using 'default' view or 'json'",
+        ),
+    ] = CliOutputFormat.DEFAULT,
 ) -> None:
     """Stop a run."""
+    suppress_output = output_format == CliOutputFormat.JSON
+    captured_output = io.StringIO()
     try:
+        if suppress_output:
+            redirect_output(captured_output)
+
         # Load and validate federation config
         typer.secho("Loading project configuration... ", fg=typer.colors.BLUE)
 
@@ -66,7 +83,7 @@ def stop(
             stub = ExecStub(channel)  # pylint: disable=unused-variable # noqa: F841
 
             typer.secho(f"✋ Stopping run ID {run_id}...", fg=typer.colors.GREEN)
-            _stop_run(stub, run_id=run_id)
+            _stop_run(stub=stub, run_id=run_id, output_format=output_format)
 
         except ValueError as err:
             typer.secho(
@@ -77,23 +94,36 @@ def stop(
             raise typer.Exit(code=1) from err
         finally:
             channel.close()
-    except (
-        typer.Exit,
-        Exception,
-    ) as err:  # pylint: disable=broad-except, W0612  # noqa: F841
-        raise typer.Exit(code=1) from err
+    except (typer.Exit, Exception) as err:  # pylint: disable=broad-except
+        if suppress_output:
+            restore_output()
+            e_message = captured_output.getvalue()
+            print_json_error(e_message, err)
+        else:
+            typer.secho(
+                f"{err}",
+                fg=typer.colors.RED,
+                bold=True,
+            )
     finally:
-        pass
+        if suppress_output:
+            restore_output()
+        captured_output.close()
 
 
-def _stop_run(
-    stub: ExecStub,  # pylint: disable=unused-argument
-    run_id: int,  # pylint: disable=unused-argument
-) -> None:
+def _stop_run(stub: ExecStub, run_id: int, output_format: str) -> None:
     """Stop a run."""
     response: StopRunResponse = stub.StopRun(request=StopRunRequest(run_id=run_id))
-
     if response.success:
         typer.secho(f"✅ Run {run_id} successfully stopped.", fg=typer.colors.GREEN)
+        if output_format == CliOutputFormat.JSON:
+            run_output = json.dumps(
+                {
+                    "success": True,
+                    "run-id": run_id,
+                }
+            )
+            restore_output()
+            Console().print_json(run_output)
     else:
         typer.secho(f"❌ Run {run_id} couldn't be stopped.", fg=typer.colors.RED)

From 4f5e2cb0d71468d4cbc575d5b5ad7ace3418f80b Mon Sep 17 00:00:00 2001
From: Javier <jafermarq@users.noreply.github.com>
Date: Mon, 16 Dec 2024 21:06:41 +0000
Subject: [PATCH 087/104] fix(examples) Update pinned `numpy` in
 `quickstart-pandas` and `vertical-fl` examples (#4725)

---
 examples/quickstart-pandas/pyproject.toml | 2 +-
 examples/vertical-fl/pyproject.toml       | 1 +
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/examples/quickstart-pandas/pyproject.toml b/examples/quickstart-pandas/pyproject.toml
index 986ae9abd0ac..8e3d8e46ecad 100644
--- a/examples/quickstart-pandas/pyproject.toml
+++ b/examples/quickstart-pandas/pyproject.toml
@@ -14,7 +14,7 @@ authors = [
 dependencies = [
     "flwr[simulation]>=1.13.1",
     "flwr-datasets[vision]>=0.3.0",
-    "numpy==1.24.4",
+    "numpy>=1.26.0",
     "pandas==2.0.0",
 ]
 
diff --git a/examples/vertical-fl/pyproject.toml b/examples/vertical-fl/pyproject.toml
index 4efa726eb530..a1d0a70afe61 100644
--- a/examples/vertical-fl/pyproject.toml
+++ b/examples/vertical-fl/pyproject.toml
@@ -11,6 +11,7 @@ dependencies = [
     "flwr[simulation]>=1.13.1",
     "flwr-datasets>=0.3.0",
     "pandas==2.0.3",
+    "numpy>=1.26.0",
     "scikit-learn==1.3.2",
     "torch==2.1.0",
 ]

From 69253c253d3e28c93a58ff408082b877c050a1dc Mon Sep 17 00:00:00 2001
From: Charles Beauville <charles@flower.ai>
Date: Mon, 16 Dec 2024 23:25:12 -0800
Subject: [PATCH 088/104] docs(framework) Fix other versions (#4727)

---
 .github/workflows/docs.yml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index a0e4aea55a06..dfe40350f647 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -45,6 +45,7 @@ jobs:
           AWS_SECRET_ACCESS_KEY: ${{ secrets. AWS_SECRET_ACCESS_KEY }}
           DOCS_BUCKET: flower.ai
         run: |
+          aws s3 sync --delete --exclude ".*" --exclude "v/*" --cache-control "no-cache" ./doc/build/html/ s3://${{ env.DOCS_BUCKET }}/docs/framework
           aws s3 sync --delete --exclude ".*" --exclude "v/*" --cache-control "no-cache" ./framework/docs/build/html/ s3://${{ env.DOCS_BUCKET }}/docs/framework
           aws s3 sync --delete --exclude ".*" --exclude "v/*" --cache-control "no-cache" ./baselines/docs/build/html/ s3://${{ env.DOCS_BUCKET }}/docs/baselines
           aws s3 sync --delete --exclude ".*" --exclude "v/*" --cache-control "no-cache" ./examples/docs/build/html/ s3://${{ env.DOCS_BUCKET }}/docs/examples

From 21e55772b5fddf4fab2e639bf6417291706193a0 Mon Sep 17 00:00:00 2001
From: Charles Beauville <charles@flower.ai>
Date: Tue, 17 Dec 2024 00:34:10 -0800
Subject: [PATCH 089/104] ci(framework) Fix docs deployement workflow (#4728)

---
 .github/workflows/docs.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index dfe40350f647..f98dfa43dd18 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -45,7 +45,7 @@ jobs:
           AWS_SECRET_ACCESS_KEY: ${{ secrets. AWS_SECRET_ACCESS_KEY }}
           DOCS_BUCKET: flower.ai
         run: |
-          aws s3 sync --delete --exclude ".*" --exclude "v/*" --cache-control "no-cache" ./doc/build/html/ s3://${{ env.DOCS_BUCKET }}/docs/framework
+          cp -r doc/build/html/v* framework/docs/build/html
           aws s3 sync --delete --exclude ".*" --exclude "v/*" --cache-control "no-cache" ./framework/docs/build/html/ s3://${{ env.DOCS_BUCKET }}/docs/framework
           aws s3 sync --delete --exclude ".*" --exclude "v/*" --cache-control "no-cache" ./baselines/docs/build/html/ s3://${{ env.DOCS_BUCKET }}/docs/baselines
           aws s3 sync --delete --exclude ".*" --exclude "v/*" --cache-control "no-cache" ./examples/docs/build/html/ s3://${{ env.DOCS_BUCKET }}/docs/examples

From ea7c194860afdd72222c13c54202640a2302bfe2 Mon Sep 17 00:00:00 2001
From: Javier <jafermarq@users.noreply.github.com>
Date: Tue, 17 Dec 2024 14:20:23 +0000
Subject: [PATCH 090/104] break(framework) Remove setting `Context` as `Client`
 and `NumPyClient` attribute (#4652)

---
 e2e/e2e-bare/e2e_bare/client_app.py           | 22 ++++++----
 e2e/e2e-pytorch/e2e_pytorch/client_app.py     | 20 +++++----
 src/py/flwr/client/client.py                  | 32 --------------
 .../client/message_handler/message_handler.py |  2 -
 src/py/flwr/client/numpy_client.py            | 44 -------------------
 5 files changed, 24 insertions(+), 96 deletions(-)

diff --git a/e2e/e2e-bare/e2e_bare/client_app.py b/e2e/e2e-bare/e2e_bare/client_app.py
index 943e60d5db9f..3780774954d4 100644
--- a/e2e/e2e-bare/e2e_bare/client_app.py
+++ b/e2e/e2e-bare/e2e_bare/client_app.py
@@ -3,7 +3,7 @@
 import numpy as np
 
 from flwr.client import ClientApp, NumPyClient, start_client
-from flwr.common import ConfigsRecord, Context
+from flwr.common import ConfigsRecord, Context, RecordSet
 
 SUBSET_SIZE = 1000
 STATE_VAR = "timestamp"
@@ -15,6 +15,9 @@
 
 # Define Flower client
 class FlowerClient(NumPyClient):
+    def __init__(self, state: RecordSet):
+        self.state = state
+
     def get_parameters(self, config):
         return model_params
 
@@ -22,16 +25,14 @@ def _record_timestamp_to_state(self):
         """Record timestamp to client's state."""
         t_stamp = datetime.now().timestamp()
         value = str(t_stamp)
-        if STATE_VAR in self.context.state.configs_records.keys():
-            value = self.context.state.configs_records[STATE_VAR][STATE_VAR]  # type: ignore
+        if STATE_VAR in self.state.configs_records.keys():
+            value = self.state.configs_records[STATE_VAR][STATE_VAR]  # type: ignore
             value += f",{t_stamp}"
 
-        self.context.state.configs_records[STATE_VAR] = ConfigsRecord(
-            {STATE_VAR: value}
-        )
+        self.state.configs_records[STATE_VAR] = ConfigsRecord({STATE_VAR: value})
 
     def _retrieve_timestamp_from_state(self):
-        return self.context.state.configs_records[STATE_VAR][STATE_VAR]
+        return self.state.configs_records[STATE_VAR][STATE_VAR]
 
     def fit(self, parameters, config):
         model_params = parameters
@@ -52,7 +53,7 @@ def evaluate(self, parameters, config):
 
 
 def client_fn(context: Context):
-    return FlowerClient().to_client()
+    return FlowerClient(context.state).to_client()
 
 
 app = ClientApp(
@@ -61,4 +62,7 @@ def client_fn(context: Context):
 
 if __name__ == "__main__":
     # Start Flower client
-    start_client(server_address="127.0.0.1:8080", client=FlowerClient().to_client())
+    start_client(
+        server_address="127.0.0.1:8080",
+        client=FlowerClient(state=RecordSet()).to_client(),
+    )
diff --git a/e2e/e2e-pytorch/e2e_pytorch/client_app.py b/e2e/e2e-pytorch/e2e_pytorch/client_app.py
index 988cd774018d..b7f1ce33b3f0 100644
--- a/e2e/e2e-pytorch/e2e_pytorch/client_app.py
+++ b/e2e/e2e-pytorch/e2e_pytorch/client_app.py
@@ -11,7 +11,7 @@
 from tqdm import tqdm
 
 from flwr.client import ClientApp, NumPyClient, start_client
-from flwr.common import ConfigsRecord, Context
+from flwr.common import ConfigsRecord, Context, RecordSet
 
 # #############################################################################
 # 1. Regular PyTorch pipeline: nn.Module, train, test, and DataLoader
@@ -90,6 +90,10 @@ def load_data():
 
 # Define Flower client
 class FlowerClient(NumPyClient):
+
+    def __init__(self, state: RecordSet):
+        self.state = state
+
     def get_parameters(self, config):
         return [val.cpu().numpy() for _, val in net.state_dict().items()]
 
@@ -97,16 +101,14 @@ def _record_timestamp_to_state(self):
         """Record timestamp to client's state."""
         t_stamp = datetime.now().timestamp()
         value = str(t_stamp)
-        if STATE_VAR in self.context.state.configs_records.keys():
-            value = self.context.state.configs_records[STATE_VAR][STATE_VAR]  # type: ignore
+        if STATE_VAR in self.state.configs_records.keys():
+            value = self.state.configs_records[STATE_VAR][STATE_VAR]  # type: ignore
             value += f",{t_stamp}"
 
-        self.context.state.configs_records[STATE_VAR] = ConfigsRecord(
-            {STATE_VAR: value}
-        )
+        self.state.configs_records[STATE_VAR] = ConfigsRecord({STATE_VAR: value})
 
     def _retrieve_timestamp_from_state(self):
-        return self.context.state.configs_records[STATE_VAR][STATE_VAR]
+        return self.state.configs_records[STATE_VAR][STATE_VAR]
 
     def fit(self, parameters, config):
         set_parameters(net, parameters)
@@ -137,7 +139,7 @@ def set_parameters(model, parameters):
 
 
 def client_fn(context: Context):
-    return FlowerClient().to_client()
+    return FlowerClient(context.state).to_client()
 
 
 app = ClientApp(
@@ -149,5 +151,5 @@ def client_fn(context: Context):
     # Start Flower client
     start_client(
         server_address="127.0.0.1:8080",
-        client=FlowerClient().to_client(),
+        client=FlowerClient(state=RecordSet()).to_client(),
     )
diff --git a/src/py/flwr/client/client.py b/src/py/flwr/client/client.py
index c7a7f01b38ba..ec566b428041 100644
--- a/src/py/flwr/client/client.py
+++ b/src/py/flwr/client/client.py
@@ -22,7 +22,6 @@
 
 from flwr.common import (
     Code,
-    Context,
     EvaluateIns,
     EvaluateRes,
     FitIns,
@@ -34,14 +33,11 @@
     Parameters,
     Status,
 )
-from flwr.common.logger import warn_deprecated_feature_with_example
 
 
 class Client(ABC):
     """Abstract base class for Flower clients."""
 
-    _context: Context
-
     def get_properties(self, ins: GetPropertiesIns) -> GetPropertiesRes:
         """Return set of client's properties.
 
@@ -143,34 +139,6 @@ def evaluate(self, ins: EvaluateIns) -> EvaluateRes:
             metrics={},
         )
 
-    @property
-    def context(self) -> Context:
-        """Getter for `Context` client attribute."""
-        warn_deprecated_feature_with_example(
-            "Accessing the context via the client's attribute is deprecated.",
-            example_message="Instead, pass it to the client's "
-            "constructor in your `client_fn()` which already "
-            "receives a context object.",
-            code_example="def client_fn(context: Context) -> Client:\n\n"
-            "\t\t# Your existing client_fn\n\n"
-            "\t\t# Pass `context` to the constructor\n"
-            "\t\treturn FlowerClient(context).to_client()",
-        )
-        return self._context
-
-    @context.setter
-    def context(self, context: Context) -> None:
-        """Setter for `Context` client attribute."""
-        self._context = context
-
-    def get_context(self) -> Context:
-        """Get the run context from this client."""
-        return self.context
-
-    def set_context(self, context: Context) -> None:
-        """Apply a run context to this client."""
-        self.context = context
-
     def to_client(self) -> Client:
         """Return client (itself)."""
         return self
diff --git a/src/py/flwr/client/message_handler/message_handler.py b/src/py/flwr/client/message_handler/message_handler.py
index cf4a4b006858..4f03559fa1e4 100644
--- a/src/py/flwr/client/message_handler/message_handler.py
+++ b/src/py/flwr/client/message_handler/message_handler.py
@@ -105,8 +105,6 @@ def handle_legacy_message_from_msgtype(
             "Please use `NumPyClient.to_client()` method to convert it to `Client`.",
         )
 
-    client.set_context(context)
-
     message_type = message.metadata.message_type
 
     # Handle GetPropertiesIns
diff --git a/src/py/flwr/client/numpy_client.py b/src/py/flwr/client/numpy_client.py
index 6a656cb661d2..eb3cac7c9af1 100644
--- a/src/py/flwr/client/numpy_client.py
+++ b/src/py/flwr/client/numpy_client.py
@@ -21,13 +21,11 @@
 from flwr.client.client import Client
 from flwr.common import (
     Config,
-    Context,
     NDArrays,
     Scalar,
     ndarrays_to_parameters,
     parameters_to_ndarrays,
 )
-from flwr.common.logger import warn_deprecated_feature_with_example
 from flwr.common.typing import (
     Code,
     EvaluateIns,
@@ -71,8 +69,6 @@
 class NumPyClient(ABC):
     """Abstract base class for Flower clients using NumPy."""
 
-    _context: Context
-
     def get_properties(self, config: Config) -> dict[str, Scalar]:
         """Return a client's set of properties.
 
@@ -175,34 +171,6 @@ def evaluate(
         _ = (self, parameters, config)
         return 0.0, 0, {}
 
-    @property
-    def context(self) -> Context:
-        """Getter for `Context` client attribute."""
-        warn_deprecated_feature_with_example(
-            "Accessing the context via the client's attribute is deprecated.",
-            example_message="Instead, pass it to the client's "
-            "constructor in your `client_fn()` which already "
-            "receives a context object.",
-            code_example="def client_fn(context: Context) -> Client:\n\n"
-            "\t\t# Your existing client_fn\n\n"
-            "\t\t# Pass `context` to the constructor\n"
-            "\t\treturn FlowerClient(context).to_client()",
-        )
-        return self._context
-
-    @context.setter
-    def context(self, context: Context) -> None:
-        """Setter for `Context` client attribute."""
-        self._context = context
-
-    def get_context(self) -> Context:
-        """Get the run context from this client."""
-        return self.context
-
-    def set_context(self, context: Context) -> None:
-        """Apply a run context to this client."""
-        self.context = context
-
     def to_client(self) -> Client:
         """Convert to object to Client type and return it."""
         return _wrap_numpy_client(client=self)
@@ -299,21 +267,9 @@ def _evaluate(self: Client, ins: EvaluateIns) -> EvaluateRes:
     )
 
 
-def _get_context(self: Client) -> Context:
-    """Return context of underlying NumPyClient."""
-    return self.numpy_client.get_context()  # type: ignore
-
-
-def _set_context(self: Client, context: Context) -> None:
-    """Apply context to underlying NumPyClient."""
-    self.numpy_client.set_context(context)  # type: ignore
-
-
 def _wrap_numpy_client(client: NumPyClient) -> Client:
     member_dict: dict[str, Callable] = {  # type: ignore
         "__init__": _constructor,
-        "get_context": _get_context,
-        "set_context": _set_context,
     }
 
     # Add wrapper type methods (if overridden)

From bdfcf1fd48c4f94ed8c32aa3fd2b2d9d2c6333ff Mon Sep 17 00:00:00 2001
From: Chong Shen Ng <chong.shen@flower.ai>
Date: Tue, 17 Dec 2024 14:41:21 +0000
Subject: [PATCH 091/104] docs(framework) Add how-to guide for using JSON
 output with CLI (#4714)

---
 .../source/how-to-use-cli-json-output.rst     | 194 ++++++++++++++++++
 framework/docs/source/index.rst               |   1 +
 2 files changed, 195 insertions(+)
 create mode 100644 framework/docs/source/how-to-use-cli-json-output.rst

diff --git a/framework/docs/source/how-to-use-cli-json-output.rst b/framework/docs/source/how-to-use-cli-json-output.rst
new file mode 100644
index 000000000000..d24940f5068e
--- /dev/null
+++ b/framework/docs/source/how-to-use-cli-json-output.rst
@@ -0,0 +1,194 @@
+Use CLI JSON output
+===================
+
+The `Flower CLIs <ref-api-cli.html>`_ come with a built-in JSON output mode. This mode
+is useful when you want to consume the output of a Flower CLI programmatically. For
+example, you might want to use the output of the ``flwr`` CLI in a script or a
+continuous integration pipeline.
+
+.. note::
+
+    The JSON output mode is currently only available when using the Flower CLIs with a
+    `SuperLink <ref-api-cli.html#flower-superlink>`_. Learn more about the `SuperLink`
+    in the `Flower Architecture Overview <explanation-flower-architecture.html>`_ page.
+
+In this guide, we'll show you how to specify a JSON output with the ``flwr run``, ``flwr
+ls``, and ``flwr stop`` commands. We will also provide examples of the JSON output for
+each of these commands.
+
+.. |flwr_run| replace:: ``flwr run``
+
+.. |flwr_ls| replace:: ``flwr ls``
+
+.. |flwr_stop| replace:: ``flwr stop``
+
+.. _flwr_ls: ref-api-cli.html#flwr-ls
+
+.. _flwr_run: ref-api-cli.html#flwr-run
+
+.. _flwr_stop: ref-api-cli.html#flwr-stop
+
+``flwr run`` JSON output
+------------------------
+
+The |flwr_run|_ command runs a Flower app from a provided directory. Note that if the
+app path argument is not passed to ``flwr run``, the current working directory is used
+as the default Flower app directory. By default, executing the ``flwr run`` command
+prints the status of the app build and run process as follows:
+
+.. code-block:: bash
+
+    $ flwr run
+    Loading project configuration...
+    Success
+    🎊 Successfully built flwrlabs.myawesomeapp.1-0-0.014c8eb3.fab
+    🎊 Successfully started run 1859953118041441032
+
+To get the output in JSON format, pass an additional ``--format json`` flag:
+
+.. code-block:: bash
+
+    $ flwr run --format json
+    {
+      "success": true,
+      "run-id": 1859953118041441032,
+      "fab-id": "flwrlabs/myawesomeapp",
+      "fab-name": "myawesomeapp",
+      "fab-version": "1.0.0",
+      "fab-hash": "014c8eb3",
+      "fab-filename": "flwrlabs.myawesomeapp.1-0-0.014c8eb3.fab"
+    }
+
+The JSON output for ``flwr run`` contains the following fields:
+
+- ``success``: A boolean indicating whether the command was successful.
+- ``run-id``: The ID of the run.
+- ``fab-id``: The ID of the Flower app.
+- ``fab-name``: The name of the Flower app.
+- ``fab-version``: The version of the Flower app.
+- ``fab-hash``: The short hash of the Flower app.
+- ``fab-filename``: The filename of the Flower app.
+
+If the command fails, the JSON output will contain two fields, ``success`` with the
+value of ``false`` and ``error-message``. For example, if the command fails to find the
+name of the federation on the SuperLink, the output will look like this:
+
+.. _json_error_output:
+
+.. code-block:: bash
+
+    $ flwr run --format json
+    {
+      "success": false,
+      "error-message": "Loading project configuration... \nSuccess\n There is no `[missing]` federation declared in the `pyproject.toml`.\n The following federations were found:\n\nfed-existing-1\nfed-existing-2\n\n"
+    }
+
+``flwr ls`` JSON output
+-----------------------
+
+The |flwr_ls|_ command lists all the runs in the current project. Similar to ``flwr
+run``, if the app path argument is not passed to ``flwr ls``, the current working
+directory is used as the Flower app directory. By default, the command list the details
+of all runs in a Flower federation in a tabular format:
+
+.. code-block:: bash
+
+    $ flwr ls
+    Loading project configuration...
+    Success
+    📄 Listing all runs...
+    ┏━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━┓
+    ┃    Run ID    ┃     FAB      ┃    Status    ┃ Elapsed  ┃  Created At  ┃  Running At  ┃ Finished At ┃
+    ┡━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━━━━━━┩
+    │ 185995311804 │ flwrlabs/my… │ finished:co… │ 00:00:55 │ 2024-12-16   │ 2024-12-16   │ 2024-12-16  │
+    │ 1441032      │ (v1.0.0)     │              │          │ 11:12:33Z    │ 11:12:33Z    │ 11:13:29Z   │
+    ├──────────────┼──────────────┼──────────────┼──────────┼──────────────┼──────────────┼─────────────┤
+    │ 142007406570 │ flwrlabs/my… │ running      │ 00:00:05 │ 2024-12-16   │ 2024-12-16   │ N/A         │
+    │ 11601420     │ (v1.0.0)     │              │          │ 12:18:39Z    │ 12:18:39Z    │             │
+    └──────────────┴──────────────┴──────────────┴──────────┴──────────────┴──────────────┴─────────────┘
+
+To get the output in JSON format, simply pass the ``--format json`` flag:
+
+.. code-block:: bash
+
+    $ flwr ls --format json
+    {
+      "success": true,
+      "runs": [
+        {
+          "run-id": 1859953118041441032,
+          "fab-id": "flwrlabs/myawesomeapp1",
+          "fab-name": "myawesomeapp1",
+          "fab-version": "1.0.0",
+          "fab-hash": "014c8eb3",
+          "status": "finished:completed",
+          "elapsed": "00:00:55",
+          "created-at": "2024-12-16 11:12:33Z",
+          "running-at": "2024-12-16 11:12:33Z",
+          "finished-at": "2024-12-16 11:13:29Z"
+        },
+        {
+          "run-id": 14200740657011601420,
+          "fab-id": "flwrlabs/myawesomeapp2",
+          "fab-name": "myawesomeapp2",
+          "fab-version": "1.0.0",
+          "fab-hash": "014c8eb3",
+          "status": "running",
+          "elapsed": "00:00:09",
+          "created-at": "2024-12-16 12:18:39Z",
+          "running-at": "2024-12-16 12:18:39Z",
+          "finished-at": "N/A"
+        },
+      ]
+    }
+
+The JSON output for ``flwr ls`` contains similar fields as ``flwr run`` with the
+addition of the ``status``, ``elapsed``, ``created-at``, ``running-at``, and
+``finished-at`` fields. The ``runs`` key contains a list of dictionaries, each
+representing a run. The additional fields are:
+
+- ``status``: The status of the run, either pending, starting, running, or finished.
+- ``elapsed``: The time elapsed since the run started, formatted as ``HH:MM:SS``.
+- ``created-at``: The time the run was created.
+- ``running-at``: The time the run started running.
+- ``finished-at``: The time the run finished.
+
+All timestamps adhere to ISO 8601, UTC and are formatted as ``YYYY-MM-DD HH:MM:SSZ``.
+
+You can also use the ``--run-id`` flag to list the details for one run. In this case,
+the JSON output will have the same structure as above with only one entry in the
+``runs`` key. For more details of this command, see the |flwr_ls|_ documentation. If the
+command fails, the JSON output will return two fields, ``success`` and
+``error-message``, as shown in :ref:`the above example <json_error_output>`. Note that
+the content of the error message will be different depending on the error that occurred.
+
+``flwr stop`` JSON output
+-------------------------
+
+The |flwr_stop|_ command stops a running Flower app for a provided run ID. Similar to
+``flwr run``, if the app path argument is not passed to ``flwr stop``, the current
+working directory is used as the Flower app directory. By default, the command prints
+the status of the stop process as follows:
+
+.. code-block:: bash
+
+    $ flwr stop 1859953118041441032
+    Loading project configuration...
+    Success
+    ✋ Stopping run ID 1859953118041441032...
+    ✅ Run 1859953118041441032 successfully stopped.
+
+To get the output in JSON format, simply pass the ``--format json`` flag:
+
+.. code-block:: bash
+
+    $ flwr stop 1859953118041441032 --format json
+    {
+      "success": true,
+      "run-id": 1859953118041441032,
+    }
+
+If the command fails, the JSON output will contain two fields ``success`` with the value
+of ``false`` and ``error-message``, as shown in :ref:`the above example
+<json_error_output>`. Note that the content of the error message will be different
+depending on the error that occurred.
diff --git a/framework/docs/source/index.rst b/framework/docs/source/index.rst
index ddb123acd27b..cad980388373 100644
--- a/framework/docs/source/index.rst
+++ b/framework/docs/source/index.rst
@@ -100,6 +100,7 @@ Problem-oriented how-to guides show step-by-step how to achieve a specific goal.
     how-to-authenticate-supernodes
     how-to-implement-fedbn
     how-to-run-flower-on-azure
+    how-to-use-cli-json-output
     docker/index
     how-to-upgrade-to-flower-1.0
     how-to-upgrade-to-flower-1.13

From 470ba4a58537c70932582df0e7e1edb1d6d2b523 Mon Sep 17 00:00:00 2001
From: Javier <jafermarq@users.noreply.github.com>
Date: Tue, 17 Dec 2024 14:54:49 +0000
Subject: [PATCH 092/104] feat(framework) Push to the `LinkState` the `Context`
 of a `ServerApp` run in simulation (#4721)

Co-authored-by: Chong Shen Ng <chong.shen@flower.ai>
---
 src/py/flwr/simulation/app.py            |  5 ++--
 src/py/flwr/simulation/run_simulation.py | 33 +++++++++++++++++++-----
 2 files changed, 30 insertions(+), 8 deletions(-)

diff --git a/src/py/flwr/simulation/app.py b/src/py/flwr/simulation/app.py
index ebcb275b6052..4aab3d75156f 100644
--- a/src/py/flwr/simulation/app.py
+++ b/src/py/flwr/simulation/app.py
@@ -48,6 +48,7 @@
 from flwr.common.serde import (
     configs_record_from_proto,
     context_from_proto,
+    context_to_proto,
     fab_from_proto,
     run_from_proto,
     run_status_to_proto,
@@ -202,7 +203,7 @@ def run_simulation_process(  # pylint: disable=R0914, disable=W0212, disable=R09
             enable_tf_gpu_growth: bool = fed_opt.get("enable_tf_gpu_growth", False)
 
             # Launch the simulation
-            _run_simulation(
+            updated_context = _run_simulation(
                 server_app_attr=server_app_attr,
                 client_app_attr=client_app_attr,
                 num_supernodes=num_supernodes,
@@ -217,7 +218,7 @@ def run_simulation_process(  # pylint: disable=R0914, disable=W0212, disable=R09
             )
 
             # Send resulting context
-            context_proto = None  # context_to_proto(updated_context)
+            context_proto = context_to_proto(updated_context)
             out_req = PushSimulationOutputsRequest(
                 run_id=run.run_id, context=context_proto
             )
diff --git a/src/py/flwr/simulation/run_simulation.py b/src/py/flwr/simulation/run_simulation.py
index ae567b6f130e..cc8844405b0b 100644
--- a/src/py/flwr/simulation/run_simulation.py
+++ b/src/py/flwr/simulation/run_simulation.py
@@ -24,6 +24,7 @@
 import traceback
 from logging import DEBUG, ERROR, INFO, WARNING
 from pathlib import Path
+from queue import Empty, Queue
 from typing import Any, Optional
 
 from flwr.cli.config_utils import load_and_validate
@@ -126,7 +127,7 @@ def run_simulation_from_cli() -> None:
     run = Run.create_empty(run_id)
     run.override_config = override_config
 
-    _run_simulation(
+    _ = _run_simulation(
         server_app_attr=server_app_attr,
         client_app_attr=client_app_attr,
         num_supernodes=args.num_supernodes,
@@ -206,7 +207,7 @@ def run_simulation(
             "\n\tflwr.simulation.run_simulationt(...)",
         )
 
-    _run_simulation(
+    _ = _run_simulation(
         num_supernodes=num_supernodes,
         client_app=client_app,
         server_app=server_app,
@@ -229,6 +230,7 @@ def run_serverapp_th(
     has_exception: threading.Event,
     enable_tf_gpu_growth: bool,
     run_id: int,
+    ctx_queue: "Queue[Context]",
 ) -> threading.Thread:
     """Run SeverApp in a thread."""
 
@@ -241,6 +243,7 @@ def server_th_with_start_checks(
         _server_app_run_config: UserConfig,
         _server_app_attr: Optional[str],
         _server_app: Optional[ServerApp],
+        _ctx_queue: "Queue[Context]",
     ) -> None:
         """Run SeverApp, after check if GPU memory growth has to be set.
 
@@ -261,13 +264,14 @@ def server_th_with_start_checks(
             )
 
             # Run ServerApp
-            _run(
+            updated_context = _run(
                 driver=_driver,
                 context=context,
                 server_app_dir=_server_app_dir,
                 server_app_attr=_server_app_attr,
                 loaded_server_app=_server_app,
             )
+            _ctx_queue.put(updated_context)
         except Exception as ex:  # pylint: disable=broad-exception-caught
             log(ERROR, "ServerApp thread raised an exception: %s", ex)
             log(ERROR, traceback.format_exc())
@@ -291,6 +295,7 @@ def server_th_with_start_checks(
             server_app_run_config,
             server_app_attr,
             server_app,
+            ctx_queue,
         ),
     )
     serverapp_th.start()
@@ -313,7 +318,7 @@ def _main_loop(
     server_app: Optional[ServerApp] = None,
     server_app_attr: Optional[str] = None,
     server_app_run_config: Optional[UserConfig] = None,
-) -> None:
+) -> Context:
     """Start ServerApp on a separate thread, then launch Simulation Engine."""
     # Initialize StateFactory
     state_factory = LinkStateFactory(":flwr-in-memory-state:")
@@ -323,6 +328,13 @@ def _main_loop(
     server_app_thread_has_exception = threading.Event()
     serverapp_th = None
     success = True
+    updated_context = Context(
+        run_id=run.run_id,
+        node_id=0,
+        node_config=UserConfig(),
+        state=RecordSet(),
+        run_config=UserConfig(),
+    )
     try:
         # Register run
         log(DEBUG, "Pre-registering run with id %s", run.run_id)
@@ -337,6 +349,7 @@ def _main_loop(
         # Initialize Driver
         driver = InMemoryDriver(state_factory=state_factory)
         driver.set_run(run_id=run.run_id)
+        output_context_queue: "Queue[Context]" = Queue()
 
         # Get and run ServerApp thread
         serverapp_th = run_serverapp_th(
@@ -349,6 +362,7 @@ def _main_loop(
             has_exception=server_app_thread_has_exception,
             enable_tf_gpu_growth=enable_tf_gpu_growth,
             run_id=run.run_id,
+            ctx_queue=output_context_queue,
         )
 
         # Start Simulation Engine
@@ -366,6 +380,11 @@ def _main_loop(
             flwr_dir=flwr_dir,
         )
 
+        updated_context = output_context_queue.get(timeout=3)
+
+    except Empty:
+        log(DEBUG, "Queue timeout. No context received.")
+
     except Exception as ex:
         log(ERROR, "An exception occurred !! %s", ex)
         log(ERROR, traceback.format_exc())
@@ -382,6 +401,7 @@ def _main_loop(
                 raise RuntimeError("Exception in ServerApp thread")
 
     log(DEBUG, "Stopping Simulation Engine now.")
+    return updated_context
 
 
 # pylint: disable=too-many-arguments,too-many-locals,too-many-positional-arguments
@@ -401,7 +421,7 @@ def _run_simulation(
     enable_tf_gpu_growth: bool = False,
     verbose_logging: bool = False,
     is_app: bool = False,
-) -> None:
+) -> Context:
     """Launch the Simulation Engine."""
     if backend_config is None:
         backend_config = {}
@@ -480,7 +500,8 @@ def _run_simulation(
             # Set logger propagation to False to prevent duplicated log output in Colab.
             logger = set_logger_propagation(logger, False)
 
-        _main_loop(*args)
+        updated_context = _main_loop(*args)
+    return updated_context
 
 
 def _parse_args_run_simulation() -> argparse.ArgumentParser:

From e9c36531f5a9a21a1cfb0be82dda53a0890ee60f Mon Sep 17 00:00:00 2001
From: Javier <jafermarq@users.noreply.github.com>
Date: Tue, 17 Dec 2024 15:11:34 +0000
Subject: [PATCH 093/104] refactor(framework) Introduce run status checks in
 `SimulationIo` (#4729)

---
 .../simulation/simulation_servicer_test.py    | 209 ++++++++++++++++++
 .../simulation/simulationio_servicer.py       |  13 ++
 2 files changed, 222 insertions(+)
 create mode 100644 src/py/flwr/server/superlink/simulation/simulation_servicer_test.py

diff --git a/src/py/flwr/server/superlink/simulation/simulation_servicer_test.py b/src/py/flwr/server/superlink/simulation/simulation_servicer_test.py
new file mode 100644
index 000000000000..fa0302458fb2
--- /dev/null
+++ b/src/py/flwr/server/superlink/simulation/simulation_servicer_test.py
@@ -0,0 +1,209 @@
+# Copyright 2024 Flower Labs GmbH. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# ==============================================================================
+"""SimulationIoServicer tests."""
+
+
+import tempfile
+import unittest
+
+import grpc
+from parameterized import parameterized
+
+from flwr.common import ConfigsRecord, Context
+from flwr.common.constant import SIMULATIONIO_API_DEFAULT_SERVER_ADDRESS, Status
+from flwr.common.serde import context_to_proto, run_status_to_proto
+from flwr.common.serde_test import RecordMaker
+from flwr.common.typing import RunStatus
+from flwr.proto.run_pb2 import (  # pylint: disable=E0611
+    UpdateRunStatusRequest,
+    UpdateRunStatusResponse,
+)
+from flwr.proto.simulationio_pb2 import (  # pylint: disable=E0611
+    PushSimulationOutputsRequest,
+    PushSimulationOutputsResponse,
+)
+from flwr.server.superlink.ffs.ffs_factory import FfsFactory
+from flwr.server.superlink.linkstate.linkstate_factory import LinkStateFactory
+from flwr.server.superlink.simulation.simulationio_grpc import run_simulationio_api_grpc
+from flwr.server.superlink.utils import _STATUS_TO_MSG
+
+
+class TestSimulationIoServicer(unittest.TestCase):  # pylint: disable=R0902
+    """SimulationIoServicer tests for allowed RunStatuses."""
+
+    def setUp(self) -> None:
+        """Initialize mock stub and server interceptor."""
+        # Create a temporary directory
+        self.temp_dir = tempfile.TemporaryDirectory()  # pylint: disable=R1732
+        self.addCleanup(self.temp_dir.cleanup)  # Ensures cleanup after test
+
+        state_factory = LinkStateFactory(":flwr-in-memory-state:")
+        self.state = state_factory.state()
+        ffs_factory = FfsFactory(self.temp_dir.name)
+        self.ffs = ffs_factory.ffs()
+
+        self.status_to_msg = _STATUS_TO_MSG
+
+        self._server: grpc.Server = run_simulationio_api_grpc(
+            SIMULATIONIO_API_DEFAULT_SERVER_ADDRESS,
+            state_factory,
+            ffs_factory,
+            None,
+        )
+
+        self._channel = grpc.insecure_channel("localhost:9096")
+        self._push_simulation_outputs = self._channel.unary_unary(
+            "/flwr.proto.SimulationIo/PushSimulationOutputs",
+            request_serializer=PushSimulationOutputsRequest.SerializeToString,
+            response_deserializer=PushSimulationOutputsResponse.FromString,
+        )
+        self._update_run_status = self._channel.unary_unary(
+            "/flwr.proto.SimulationIo/UpdateRunStatus",
+            request_serializer=UpdateRunStatusRequest.SerializeToString,
+            response_deserializer=UpdateRunStatusResponse.FromString,
+        )
+
+    def tearDown(self) -> None:
+        """Clean up grpc server."""
+        self._server.stop(None)
+
+    def _transition_run_status(self, run_id: int, num_transitions: int) -> None:
+        if num_transitions > 0:
+            _ = self.state.update_run_status(run_id, RunStatus(Status.STARTING, "", ""))
+        if num_transitions > 1:
+            _ = self.state.update_run_status(run_id, RunStatus(Status.RUNNING, "", ""))
+        if num_transitions > 2:
+            _ = self.state.update_run_status(run_id, RunStatus(Status.FINISHED, "", ""))
+
+    def test_push_simulation_outputs_successful_if_running(self) -> None:
+        """Test `PushSimulationOutputs` success."""
+        # Prepare
+        run_id = self.state.create_run("", "", "", {}, ConfigsRecord())
+
+        maker = RecordMaker()
+        context = Context(
+            run_id=run_id,
+            node_id=0,
+            node_config=maker.user_config(),
+            state=maker.recordset(1, 1, 1),
+            run_config=maker.user_config(),
+        )
+
+        # Transition status to running. PushTaskRes is only allowed in running status.
+        self._transition_run_status(run_id, 2)
+        request = PushSimulationOutputsRequest(
+            run_id=run_id, context=context_to_proto(context)
+        )
+
+        # Execute
+        response, call = self._push_simulation_outputs.with_call(request=request)
+
+        # Assert
+        assert isinstance(response, PushSimulationOutputsResponse)
+        assert grpc.StatusCode.OK == call.code()
+
+    def _assert_push_simulation_outputs_not_allowed(
+        self, run_id: int, context: Context
+    ) -> None:
+        """Assert `PushSimulationOutputs` not allowed."""
+        run_status = self.state.get_run_status({run_id})[run_id]
+        request = PushSimulationOutputsRequest(
+            run_id=run_id, context=context_to_proto(context)
+        )
+
+        with self.assertRaises(grpc.RpcError) as e:
+            self._push_simulation_outputs.with_call(request=request)
+        assert e.exception.code() == grpc.StatusCode.PERMISSION_DENIED
+        assert e.exception.details() == self.status_to_msg[run_status.status]
+
+    @parameterized.expand(
+        [
+            (0,),  # Test not successful if RunStatus is pending.
+            (1,),  # Test not successful if RunStatus is starting.
+            (3,),  # Test not successful if RunStatus is finished.
+        ]
+    )  # type: ignore
+    def test_push_simulation_outputs_not_successful_if_not_running(
+        self, num_transitions: int
+    ) -> None:
+        """Test `PushSimulationOutputs` not successful if RunStatus is not running."""
+        # Prepare
+        run_id = self.state.create_run("", "", "", {}, ConfigsRecord())
+
+        maker = RecordMaker()
+        context = Context(
+            run_id=run_id,
+            node_id=0,
+            node_config=maker.user_config(),
+            state=maker.recordset(1, 1, 1),
+            run_config=maker.user_config(),
+        )
+
+        self._transition_run_status(run_id, num_transitions)
+
+        # Execute & Assert
+        self._assert_push_simulation_outputs_not_allowed(run_id, context)
+
+    @parameterized.expand(
+        [
+            (0,),  # Test successful if RunStatus is pending.
+            (1,),  # Test successful if RunStatus is starting.
+            (2,),  # Test successful if RunStatus is running.
+        ]
+    )  # type: ignore
+    def test_update_run_status_successful_if_not_finished(
+        self, num_transitions: int
+    ) -> None:
+        """Test `UpdateRunStatus` success."""
+        # Prepare
+        run_id = self.state.create_run("", "", "", {}, ConfigsRecord())
+        _ = self.state.get_run_status({run_id})[run_id]
+        next_run_status = RunStatus(Status.STARTING, "", "")
+
+        if num_transitions > 0:
+            _ = self.state.update_run_status(run_id, RunStatus(Status.STARTING, "", ""))
+            next_run_status = RunStatus(Status.RUNNING, "", "")
+        if num_transitions > 1:
+            _ = self.state.update_run_status(run_id, RunStatus(Status.RUNNING, "", ""))
+            next_run_status = RunStatus(Status.FINISHED, "", "")
+
+        request = UpdateRunStatusRequest(
+            run_id=run_id, run_status=run_status_to_proto(next_run_status)
+        )
+
+        # Execute
+        response, call = self._update_run_status.with_call(request=request)
+
+        # Assert
+        assert isinstance(response, UpdateRunStatusResponse)
+        assert grpc.StatusCode.OK == call.code()
+
+    def test_update_run_status_not_successful_if_finished(self) -> None:
+        """Test `UpdateRunStatus` not successful."""
+        # Prepare
+        run_id = self.state.create_run("", "", "", {}, ConfigsRecord())
+        _ = self.state.get_run_status({run_id})[run_id]
+        _ = self.state.update_run_status(run_id, RunStatus(Status.FINISHED, "", ""))
+        run_status = self.state.get_run_status({run_id})[run_id]
+        next_run_status = RunStatus(Status.FINISHED, "", "")
+
+        request = UpdateRunStatusRequest(
+            run_id=run_id, run_status=run_status_to_proto(next_run_status)
+        )
+
+        with self.assertRaises(grpc.RpcError) as e:
+            self._update_run_status.with_call(request=request)
+        assert e.exception.code() == grpc.StatusCode.PERMISSION_DENIED
+        assert e.exception.details() == self.status_to_msg[run_status.status]
diff --git a/src/py/flwr/server/superlink/simulation/simulationio_servicer.py b/src/py/flwr/server/superlink/simulation/simulationio_servicer.py
index 9104d9cde875..bfaec9953ec5 100644
--- a/src/py/flwr/server/superlink/simulation/simulationio_servicer.py
+++ b/src/py/flwr/server/superlink/simulation/simulationio_servicer.py
@@ -54,6 +54,7 @@
 )
 from flwr.server.superlink.ffs.ffs_factory import FfsFactory
 from flwr.server.superlink.linkstate import LinkStateFactory
+from flwr.server.superlink.utils import abort_if
 
 
 class SimulationIoServicer(simulationio_pb2_grpc.SimulationIoServicer):
@@ -110,6 +111,15 @@ def PushSimulationOutputs(
         """Push Simulation process outputs."""
         log(DEBUG, "SimultionIoServicer.PushSimulationOutputs")
         state = self.state_factory.state()
+
+        # Abort if the run is not running
+        abort_if(
+            request.run_id,
+            [Status.PENDING, Status.STARTING, Status.FINISHED],
+            state,
+            context,
+        )
+
         state.set_serverapp_context(request.run_id, context_from_proto(request.context))
         return PushSimulationOutputsResponse()
 
@@ -120,6 +130,9 @@ def UpdateRunStatus(
         log(DEBUG, "SimultionIoServicer.UpdateRunStatus")
         state = self.state_factory.state()
 
+        # Abort if the run is finished
+        abort_if(request.run_id, [Status.FINISHED], state, context)
+
         # Update the run status
         state.update_run_status(
             run_id=request.run_id, new_status=run_status_from_proto(request.run_status)

From 69988749eee91787cae4f3269353f2b396af57d1 Mon Sep 17 00:00:00 2001
From: Heng Pan <pan@flower.ai>
Date: Wed, 18 Dec 2024 00:21:51 +0900
Subject: [PATCH 094/104] feat(framework) Add prompt for `flwr login` when
 authentication fails (#4719)

---
 src/py/flwr/cli/log.py     | 14 ++++++++------
 src/py/flwr/cli/ls.py      |  8 +++++---
 src/py/flwr/cli/run/run.py |  9 +++++++--
 src/py/flwr/cli/stop.py    |  5 +++--
 src/py/flwr/cli/utils.py   | 23 +++++++++++++++++++++++
 5 files changed, 46 insertions(+), 13 deletions(-)

diff --git a/src/py/flwr/cli/log.py b/src/py/flwr/cli/log.py
index 93fe3c387974..ef9fa2da2e65 100644
--- a/src/py/flwr/cli/log.py
+++ b/src/py/flwr/cli/log.py
@@ -34,7 +34,7 @@
 from flwr.proto.exec_pb2 import StreamLogsRequest  # pylint: disable=E0611
 from flwr.proto.exec_pb2_grpc import ExecStub
 
-from .utils import init_channel, try_obtain_cli_auth_plugin
+from .utils import init_channel, try_obtain_cli_auth_plugin, unauthenticated_exc_handler
 
 
 def start_stream(
@@ -88,8 +88,9 @@ def stream_logs(
     latest_timestamp = 0.0
     res = None
     try:
-        for res in stub.StreamLogs(req, timeout=duration):
-            print(res.log_output, end="")
+        with unauthenticated_exc_handler():
+            for res in stub.StreamLogs(req, timeout=duration):
+                print(res.log_output, end="")
     except grpc.RpcError as e:
         # pylint: disable=E1101
         if e.code() != grpc.StatusCode.DEADLINE_EXCEEDED:
@@ -109,9 +110,10 @@ def print_logs(run_id: int, channel: grpc.Channel, timeout: int) -> None:
     try:
         while True:
             try:
-                # Enforce timeout for graceful exit
-                for res in stub.StreamLogs(req, timeout=timeout):
-                    print(res.log_output)
+                with unauthenticated_exc_handler():
+                    # Enforce timeout for graceful exit
+                    for res in stub.StreamLogs(req, timeout=timeout):
+                        print(res.log_output)
             except grpc.RpcError as e:
                 # pylint: disable=E1101
                 if e.code() == grpc.StatusCode.DEADLINE_EXCEEDED:
diff --git a/src/py/flwr/cli/ls.py b/src/py/flwr/cli/ls.py
index e845583d61ac..9c30a158952f 100644
--- a/src/py/flwr/cli/ls.py
+++ b/src/py/flwr/cli/ls.py
@@ -43,7 +43,7 @@
 )
 from flwr.proto.exec_pb2_grpc import ExecStub
 
-from .utils import init_channel, try_obtain_cli_auth_plugin
+from .utils import init_channel, try_obtain_cli_auth_plugin, unauthenticated_exc_handler
 
 _RunListType = tuple[int, str, str, str, str, str, str, str, str]
 
@@ -295,7 +295,8 @@ def _list_runs(
     output_format: str = CliOutputFormat.DEFAULT,
 ) -> None:
     """List all runs."""
-    res: ListRunsResponse = stub.ListRuns(ListRunsRequest())
+    with unauthenticated_exc_handler():
+        res: ListRunsResponse = stub.ListRuns(ListRunsRequest())
     run_dict = {run_id: run_from_proto(proto) for run_id, proto in res.run_dict.items()}
 
     formatted_runs = _format_runs(run_dict, res.now)
@@ -311,7 +312,8 @@ def _display_one_run(
     output_format: str = CliOutputFormat.DEFAULT,
 ) -> None:
     """Display information about a specific run."""
-    res: ListRunsResponse = stub.ListRuns(ListRunsRequest(run_id=run_id))
+    with unauthenticated_exc_handler():
+        res: ListRunsResponse = stub.ListRuns(ListRunsRequest(run_id=run_id))
     if not res.run_dict:
         raise ValueError(f"Run ID {run_id} not found")
 
diff --git a/src/py/flwr/cli/run/run.py b/src/py/flwr/cli/run/run.py
index 19db2ade39dc..9436f5879c80 100644
--- a/src/py/flwr/cli/run/run.py
+++ b/src/py/flwr/cli/run/run.py
@@ -48,7 +48,11 @@
 from flwr.proto.exec_pb2_grpc import ExecStub
 
 from ..log import start_stream
-from ..utils import init_channel, try_obtain_cli_auth_plugin
+from ..utils import (
+    init_channel,
+    try_obtain_cli_auth_plugin,
+    unauthenticated_exc_handler,
+)
 
 CONN_REFRESH_PERIOD = 60  # Connection refresh period for log streaming (seconds)
 
@@ -166,7 +170,8 @@ def _run_with_exec_api(
         override_config=user_config_to_proto(parse_config_args(config_overrides)),
         federation_options=configs_record_to_proto(c_record),
     )
-    res = stub.StartRun(req)
+    with unauthenticated_exc_handler():
+        res = stub.StartRun(req)
 
     if res.HasField("run_id"):
         typer.secho(f"🎊 Successfully started run {res.run_id}", fg=typer.colors.GREEN)
diff --git a/src/py/flwr/cli/stop.py b/src/py/flwr/cli/stop.py
index 4989d216f28f..2a96e337bf80 100644
--- a/src/py/flwr/cli/stop.py
+++ b/src/py/flwr/cli/stop.py
@@ -34,7 +34,7 @@
 from flwr.proto.exec_pb2 import StopRunRequest, StopRunResponse  # pylint: disable=E0611
 from flwr.proto.exec_pb2_grpc import ExecStub
 
-from .utils import init_channel, try_obtain_cli_auth_plugin
+from .utils import init_channel, try_obtain_cli_auth_plugin, unauthenticated_exc_handler
 
 
 def stop(  # pylint: disable=R0914
@@ -113,7 +113,8 @@ def stop(  # pylint: disable=R0914
 
 def _stop_run(stub: ExecStub, run_id: int, output_format: str) -> None:
     """Stop a run."""
-    response: StopRunResponse = stub.StopRun(request=StopRunRequest(run_id=run_id))
+    with unauthenticated_exc_handler():
+        response: StopRunResponse = stub.StopRun(request=StopRunRequest(run_id=run_id))
     if response.success:
         typer.secho(f"✅ Run {run_id} successfully stopped.", fg=typer.colors.GREEN)
         if output_format == CliOutputFormat.JSON:
diff --git a/src/py/flwr/cli/utils.py b/src/py/flwr/cli/utils.py
index 7a8040756c5e..8cb89255ed40 100644
--- a/src/py/flwr/cli/utils.py
+++ b/src/py/flwr/cli/utils.py
@@ -18,6 +18,8 @@
 import hashlib
 import json
 import re
+from collections.abc import Iterator
+from contextlib import contextmanager
 from logging import DEBUG
 from pathlib import Path
 from typing import Any, Callable, Optional, cast
@@ -231,3 +233,24 @@ def on_channel_state_change(channel_connectivity: str) -> None:
     )
     channel.subscribe(on_channel_state_change)
     return channel
+
+
+@contextmanager
+def unauthenticated_exc_handler() -> Iterator[None]:
+    """Context manager to handle gRPC UNAUTHENTICATED errors.
+
+    It catches grpc.RpcError exceptions with UNAUTHENTICATED status, informs the user,
+    and exits the application. All other exceptions will be allowed to escape.
+    """
+    try:
+        yield
+    except grpc.RpcError as e:
+        if e.code() != grpc.StatusCode.UNAUTHENTICATED:
+            raise
+        typer.secho(
+            "❌ Authentication failed. Please run `flwr login`"
+            " to authenticate and try again.",
+            fg=typer.colors.RED,
+            bold=True,
+        )
+        raise typer.Exit(code=1) from None

From 7f3acafee9574d16e2962715093ff677774e4327 Mon Sep 17 00:00:00 2001
From: Chong Shen Ng <chong.shen@flower.ai>
Date: Tue, 17 Dec 2024 15:32:42 +0000
Subject: [PATCH 095/104] refactor(framework) Add request validation to
 ServerAppIoServicer (#4720)

---
 .../flwr/server/superlink/driver/serverappio_servicer.py | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/src/py/flwr/server/superlink/driver/serverappio_servicer.py b/src/py/flwr/server/superlink/driver/serverappio_servicer.py
index f52129a2ba11..f4183763cae5 100644
--- a/src/py/flwr/server/superlink/driver/serverappio_servicer.py
+++ b/src/py/flwr/server/superlink/driver/serverappio_servicer.py
@@ -159,6 +159,9 @@ def PushTaskIns(
         for task_ins in request.task_ins_list:
             validation_errors = validate_task_ins_or_res(task_ins)
             _raise_if(bool(validation_errors), ", ".join(validation_errors))
+            _raise_if(
+                request.run_id != task_ins.run_id, "`task_ins` has mismatched `run_id`"
+            )
 
         # Store each TaskIns
         task_ids: list[Optional[UUID]] = []
@@ -193,6 +196,12 @@ def PullTaskRes(
         # Read from state
         task_res_list: list[TaskRes] = state.get_task_res(task_ids=task_ids)
 
+        # Validate request
+        for task_res in task_res_list:
+            _raise_if(
+                request.run_id != task_res.run_id, "`task_res` has mismatched `run_id`"
+            )
+
         # Delete the TaskIns/TaskRes pairs if TaskRes is found
         task_ins_ids_to_delete = {
             UUID(task_res.task.ancestry[0]) for task_res in task_res_list

From 0c838d7bf8078a85572efa82b57ddace847d20b6 Mon Sep 17 00:00:00 2001
From: Adam Narozniak <51029327+adam-narozniak@users.noreply.github.com>
Date: Tue, 17 Dec 2024 19:16:14 +0100
Subject: [PATCH 096/104] fix(datasets) Update outdated docs references (#4732)

Co-authored-by: Taner Topal <taner@flower.ai>
---
 datasets/README.md     | 2 +-
 datasets/dev/format.sh | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/datasets/README.md b/datasets/README.md
index 0d35d2e31b6a..f3091ab7532b 100644
--- a/datasets/README.md
+++ b/datasets/README.md
@@ -51,7 +51,7 @@ Create **custom partitioning schemes** or choose from the **implemented [partiti
 * Exponential partitioning `ExponentialPartitioner(num_partitions)`
 * more to come in the future releases (contributions are welcome).
 <p align="center">
-  <img src="./doc/source/_static/readme/comparison_of_partitioning_schemes.png" alt="Comparison of partitioning schemes."/>
+  <img src="./docs/source/_static/readme/comparison_of_partitioning_schemes.png" alt="Comparison of partitioning schemes."/>
   <br>
   <em>Comparison of Partitioning Schemes on CIFAR10</em>
 </p>
diff --git a/datasets/dev/format.sh b/datasets/dev/format.sh
index b7dca9accabf..94c70444d735 100755
--- a/datasets/dev/format.sh
+++ b/datasets/dev/format.sh
@@ -28,7 +28,7 @@ echo "Formatting done: Python"
 
 # Notebooks
 echo "Formatting started: Notebooks"
-python -m black --ipynb -q doc/source/*.ipynb
+python -m black --ipynb -q docs/source/*.ipynb
 KEYS="metadata.celltoolbar metadata.language_info metadata.toc metadata.notify_time metadata.varInspector metadata.accelerator metadata.vscode cell.metadata.id cell.metadata.heading_collapsed cell.metadata.hidden cell.metadata.code_folding cell.metadata.tags cell.metadata.init_cell cell.metadata.vscode cell.metadata.pycharm"
-python -m nbstripout --keep-output doc/source/*.ipynb --extra-keys "$KEYS"
+python -m nbstripout --keep-output docs/source/*.ipynb --extra-keys "$KEYS"
 echo "Formatting done: Notebooks"

From 6eeb98aef7b6253fc60f92b27e4c9059a19d4cb4 Mon Sep 17 00:00:00 2001
From: Javier <jafermarq@users.noreply.github.com>
Date: Tue, 17 Dec 2024 19:44:42 +0000
Subject: [PATCH 097/104] fix(framework) Record `fab-id` and `fab-version` also
 in `SQLLinkState` (#4738)

---
 src/py/flwr/server/superlink/linkstate/sqlite_linkstate.py | 2 --
 1 file changed, 2 deletions(-)

diff --git a/src/py/flwr/server/superlink/linkstate/sqlite_linkstate.py b/src/py/flwr/server/superlink/linkstate/sqlite_linkstate.py
index 6e4f2290ab62..99334233319d 100644
--- a/src/py/flwr/server/superlink/linkstate/sqlite_linkstate.py
+++ b/src/py/flwr/server/superlink/linkstate/sqlite_linkstate.py
@@ -761,8 +761,6 @@ def create_run(
                 "federation_options, pending_at, starting_at, running_at, finished_at, "
                 "sub_status, details) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?);"
             )
-            if fab_hash:
-                fab_id, fab_version = "", ""
             override_config_json = json.dumps(override_config)
             data = [
                 sint64_run_id,

From b214ab9f826eafdcb2fa0d0681ec138696852a96 Mon Sep 17 00:00:00 2001
From: Chong Shen Ng <chong.shen@flower.ai>
Date: Tue, 17 Dec 2024 19:54:45 +0000
Subject: [PATCH 098/104] fix(framework) Suppress output when in JSON format
 for `flwr ls` (#4734)

---
 src/py/flwr/cli/ls.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/src/py/flwr/cli/ls.py b/src/py/flwr/cli/ls.py
index 9c30a158952f..0b6ea3918778 100644
--- a/src/py/flwr/cli/ls.py
+++ b/src/py/flwr/cli/ls.py
@@ -99,7 +99,6 @@ def ls(  # pylint: disable=too-many-locals, too-many-branches
     try:
         if suppress_output:
             redirect_output(captured_output)
-
         # Load and validate federation config
         typer.secho("Loading project configuration... ", fg=typer.colors.BLUE)
 
@@ -132,6 +131,8 @@ def ls(  # pylint: disable=too-many-locals, too-many-branches
                 _list_runs(stub, output_format)
 
         except ValueError as err:
+            if suppress_output:
+                redirect_output(captured_output)
             typer.secho(
                 f"❌ {err}",
                 fg=typer.colors.RED,

From fe2ef85030268251090bb26fd486ee0f55042669 Mon Sep 17 00:00:00 2001
From: "github-actions[bot]"
 <41898282+github-actions[bot]@users.noreply.github.com>
Date: Wed, 18 Dec 2024 08:42:06 +0000
Subject: [PATCH 099/104] Update text and language files (#4739)

---
 .../locales/fr/LC_MESSAGES/framework-docs.po  | 675 ++++++++++++-----
 .../locales/ko/LC_MESSAGES/framework-docs.po  | 681 ++++++++++++-----
 .../pt_BR/LC_MESSAGES/framework-docs.po       | 673 ++++++++++++-----
 .../zh_Hans/LC_MESSAGES/framework-docs.po     | 691 ++++++++++++------
 4 files changed, 1926 insertions(+), 794 deletions(-)

diff --git a/framework/docs/locales/fr/LC_MESSAGES/framework-docs.po b/framework/docs/locales/fr/LC_MESSAGES/framework-docs.po
index dd6cacab9cef..6bf39bff3d44 100644
--- a/framework/docs/locales/fr/LC_MESSAGES/framework-docs.po
+++ b/framework/docs/locales/fr/LC_MESSAGES/framework-docs.po
@@ -3,7 +3,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Flower Docs\n"
 "Report-Msgid-Bugs-To: EMAIL@ADDRESS\n"
-"POT-Creation-Date: 2024-12-13 00:33+0000\n"
+"POT-Creation-Date: 2024-12-18 00:32+0000\n"
 "PO-Revision-Date: 2023-09-05 17:54+0000\n"
 "Last-Translator: Charles Beauville <charles@flower.ai>\n"
 "Language: fr\n"
@@ -6237,7 +6237,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/how-to-implement-fedbn.rst:99
-#: ../../source/how-to-run-flower-on-azure.rst:217
+#: ../../source/how-to-run-flower-on-azure.rst:218
 msgid "Next Steps"
 msgstr "Prochaines étapes"
 
@@ -6801,23 +6801,23 @@ msgstr "Serveur de Flower"
 
 #: ../../source/how-to-run-flower-on-azure.rst:22
 msgid ""
-"There are many ways to deploy Flower on Microst Azure. The instructions "
-"provided in this guide is just a basic walkthrough, step-by-step guide on"
-" how to quickly setup and run a Flower application on a Federated "
-"Learning environment on Microst Azure."
+"There are many ways to deploy Flower on Microsoft Azure. The instructions"
+" provided in this guide is just a basic walkthrough, step-by-step guide "
+"on how to quickly setup and run a Flower application on a Federated "
+"Learning environment on Microsoft Azure."
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:26
+#: ../../source/how-to-run-flower-on-azure.rst:27
 msgid ""
 "In this how-to guide, we want to create a Federated Learning environment "
-"on Microst Azure using three Virtual Machines (VMs). From the three "
+"on Microsoft Azure using three Virtual Machines (VMs). From the three "
 "machines, one machine will be used as the Federation server and two as "
 "the Federation clients. Our goal is to create a Flower federation on "
-"Microst Azure where we can run Flower apps from our local machine, e.g., "
-"laptop."
+"Microsoft Azure where we can run Flower apps from our local machine, "
+"e.g., laptop."
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:32
+#: ../../source/how-to-run-flower-on-azure.rst:33
 msgid ""
 "On the Federation server VM we will deploy the long-running Flower server"
 " (``SuperLink``) and on the two Federation client VMs we will deploy the "
@@ -6826,60 +6826,60 @@ msgid ""
 "see the |flower_architecture_link|_ ."
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:38
+#: ../../source/how-to-run-flower-on-azure.rst:39
 msgid "Azure VMs"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:40
+#: ../../source/how-to-run-flower-on-azure.rst:41
 msgid ""
 "First we need to create the three VMs configure their Python "
 "environments, and inbound networking rules to allow cross-VM "
 "communication."
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:44
+#: ../../source/how-to-run-flower-on-azure.rst:45
 msgid "VM Create"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:46
+#: ../../source/how-to-run-flower-on-azure.rst:47
 msgid ""
-"Assuming we are already inside the Microst Azure portal, we navigate to "
-"the ``Create`` page and we select ``Azure virtual machine``. In the new "
+"Assuming we are already inside the Microsoft Azure portal, we navigate to"
+" the ``Create`` page and we select ``Azure virtual machine``. In the new "
 "page, for each VM we edit the properties as follows:"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:55
+#: ../../source/how-to-run-flower-on-azure.rst:56
 msgid "**Virtual machine name**"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:56
+#: ../../source/how-to-run-flower-on-azure.rst:57
 msgid ""
 "for server machine we can use ``flower-server`` and for clients, "
 "``flower-client-1`` and ``flower-client-2``"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:58
+#: ../../source/how-to-run-flower-on-azure.rst:59
 #, fuzzy
 msgid "**Image**"
 msgstr "**Apporter des modifications**"
 
-#: ../../source/how-to-run-flower-on-azure.rst:59
+#: ../../source/how-to-run-flower-on-azure.rst:60
 msgid "in this guide, we use ``Ubuntu Server 24.04 - x64 Gen2 LTS``"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:60
+#: ../../source/how-to-run-flower-on-azure.rst:61
 msgid "**Size**"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:61
+#: ../../source/how-to-run-flower-on-azure.rst:62
 msgid "in this guide, we use ``Standard_D2s_v3 - 2 vcpus, 8GiB memory``"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:65
+#: ../../source/how-to-run-flower-on-azure.rst:66
 msgid "For resource group, we can create a new group and assign it to all VMs."
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:67
+#: ../../source/how-to-run-flower-on-azure.rst:68
 msgid ""
 "When each VM instance has been created the portal will allow you to "
 "download the public key (.pem) of each instance. Make sure you save this "
@@ -6887,7 +6887,7 @@ msgid ""
 " the ``chmod 400 <PATH_TO_PEM_FILE>`` command for every .pem file."
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:72
+#: ../../source/how-to-run-flower-on-azure.rst:73
 msgid ""
 "Once all three VMs are created then navigate to the overview page where "
 "all three VMs are listed and open every other VM, and copy its Public IP "
@@ -6897,11 +6897,11 @@ msgid ""
 "``azureuser``):"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:83
+#: ../../source/how-to-run-flower-on-azure.rst:84
 msgid "VM Networking"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:85
+#: ../../source/how-to-run-flower-on-azure.rst:86
 msgid ""
 "During the execution of the Flower application, the server VM "
 "(``SuperLink``) will be responsible to orchestrate the execution of the "
@@ -6912,7 +6912,7 @@ msgid ""
 "applications."
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:92
+#: ../../source/how-to-run-flower-on-azure.rst:93
 msgid ""
 "Therefore, to enable this communication we need to allow inbound traffic "
 "to the server VM instance. To achieve this, we need to navigate to the "
@@ -6921,68 +6921,68 @@ msgid ""
 "appears, we edit the rule properties as follows:"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:97
+#: ../../source/how-to-run-flower-on-azure.rst:98
 msgid "The rest of the fields can be left at their default values."
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:104
-#: ../../source/how-to-run-flower-on-azure.rst:145
+#: ../../source/how-to-run-flower-on-azure.rst:105
+#: ../../source/how-to-run-flower-on-azure.rst:146
 #, fuzzy
 msgid "**Source**"
 msgstr "flower-superlink"
 
-#: ../../source/how-to-run-flower-on-azure.rst:105
+#: ../../source/how-to-run-flower-on-azure.rst:106
 msgid "``IP Addresses``"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:106
-#: ../../source/how-to-run-flower-on-azure.rst:133
+#: ../../source/how-to-run-flower-on-azure.rst:107
+#: ../../source/how-to-run-flower-on-azure.rst:134
 msgid "**Source IP addresses/CIDR ranges**"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:107
+#: ../../source/how-to-run-flower-on-azure.rst:108
 msgid "add client VMs' Public IP (separated by comma)"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:108
+#: ../../source/how-to-run-flower-on-azure.rst:109
 #, fuzzy
 msgid "**Destination**"
 msgstr "Dépréciations"
 
-#: ../../source/how-to-run-flower-on-azure.rst:109
-#: ../../source/how-to-run-flower-on-azure.rst:146
+#: ../../source/how-to-run-flower-on-azure.rst:110
+#: ../../source/how-to-run-flower-on-azure.rst:147
 msgid "``Any``"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:110
+#: ../../source/how-to-run-flower-on-azure.rst:111
 #, fuzzy
 msgid "**Service**"
 msgstr "flower-superlink"
 
-#: ../../source/how-to-run-flower-on-azure.rst:111
+#: ../../source/how-to-run-flower-on-azure.rst:112
 msgid "``custom``"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:112
-#: ../../source/how-to-run-flower-on-azure.rst:135
-#: ../../source/how-to-run-flower-on-azure.rst:147
+#: ../../source/how-to-run-flower-on-azure.rst:113
+#: ../../source/how-to-run-flower-on-azure.rst:136
+#: ../../source/how-to-run-flower-on-azure.rst:148
 msgid "**Destination port ranges**"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:113
+#: ../../source/how-to-run-flower-on-azure.rst:114
 msgid "``9092``"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:114
+#: ../../source/how-to-run-flower-on-azure.rst:115
 msgid "**Protocol**"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:115
+#: ../../source/how-to-run-flower-on-azure.rst:116
 #, fuzzy
 msgid "``TCP``"
 msgstr "Configurer les clients"
 
-#: ../../source/how-to-run-flower-on-azure.rst:117
+#: ../../source/how-to-run-flower-on-azure.rst:118
 msgid ""
 "Finally, we need to also open port 9093 to allow receiving and executing "
 "incoming application requests. To enable this we just need to repeat the "
@@ -6994,31 +6994,31 @@ msgid ""
 " source to ``Any``."
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:125
+#: ../../source/how-to-run-flower-on-azure.rst:126
 msgid ""
 "To be more precise, if we know the Public IP of our machine, then we make"
 " the following changes:"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:134
+#: ../../source/how-to-run-flower-on-azure.rst:135
 msgid "add machine's Public IP"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:136
-#: ../../source/how-to-run-flower-on-azure.rst:148
+#: ../../source/how-to-run-flower-on-azure.rst:137
+#: ../../source/how-to-run-flower-on-azure.rst:149
 msgid "``9093``"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:138
+#: ../../source/how-to-run-flower-on-azure.rst:139
 msgid "Otherwise, we change the properties as follows:"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:151
+#: ../../source/how-to-run-flower-on-azure.rst:152
 #, fuzzy
 msgid "Flower Environment"
 msgstr "Créer/Supprimer l'environment virtuel"
 
-#: ../../source/how-to-run-flower-on-azure.rst:153
+#: ../../source/how-to-run-flower-on-azure.rst:154
 msgid ""
 "Assuming we have been able to login to each VM, and create a Python "
 "environment with Flower and all its dependencies installed (``pip install"
@@ -7028,19 +7028,19 @@ msgid ""
 "the Flower Framework we want to run, e.g., ``numpy``."
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:161
+#: ../../source/how-to-run-flower-on-azure.rst:162
 msgid ""
 "An alternative approach would be to use Docker in each VM, with each "
 "image containing the necessary environment and dependencies. For more "
 "details please refer to the |flower_docker_index|_ guide."
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:166
+#: ../../source/how-to-run-flower-on-azure.rst:167
 #, fuzzy
 msgid "Server Initialization"
 msgstr "Vérifie l'installation"
 
-#: ../../source/how-to-run-flower-on-azure.rst:168
+#: ../../source/how-to-run-flower-on-azure.rst:169
 msgid ""
 "After configuring the Flower application environment, we proceed by "
 "starting the Flower long-running processes (i.e., ``SuperLink`` and "
@@ -7049,19 +7049,19 @@ msgid ""
 "client (``SuperNode``)."
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:175
+#: ../../source/how-to-run-flower-on-azure.rst:176
 msgid ""
 "To enable authentication and encrypted communication during the execution"
 " lifecycle of the Flower application, please have a look at the following"
 " resources: |authenticate_supernodes|_, |enable_tls_connections|_"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:197
+#: ../../source/how-to-run-flower-on-azure.rst:198
 #, fuzzy
 msgid "Run Flower App"
 msgstr "Serveur de Flower"
 
-#: ../../source/how-to-run-flower-on-azure.rst:199
+#: ../../source/how-to-run-flower-on-azure.rst:200
 msgid ""
 "Finally, after all running Flower processes have been initialized on the "
 "Microsoft Azure cluster, in our local machine, we first need to install "
@@ -7071,17 +7071,17 @@ msgid ""
 "``pyproject.toml`` file, and then add the following sections:"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:214
+#: ../../source/how-to-run-flower-on-azure.rst:215
 msgid "Then from our local machine we need to run ``flwr run . my-federation``."
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:221
+#: ../../source/how-to-run-flower-on-azure.rst:222
 msgid ""
 "This guide is not suitable for production environments due to missing "
 "authentication and TLS security."
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:224
+#: ../../source/how-to-run-flower-on-azure.rst:225
 msgid ""
 "To enable authentication and establish secure connections, please refer "
 "to the following resources: |authenticate_supernodes|_, "
@@ -8546,6 +8546,186 @@ msgstr ""
 msgid "Enjoy building a more robust and flexible ``ClientApp`` with mods!"
 msgstr ""
 
+#: ../../source/how-to-use-cli-json-output.rst:2
+msgid "Use CLI JSON output"
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:4
+msgid ""
+"The `Flower CLIs <ref-api-cli.html>`_ come with a built-in JSON output "
+"mode. This mode is useful when you want to consume the output of a Flower"
+" CLI programmatically. For example, you might want to use the output of "
+"the ``flwr`` CLI in a script or a continuous integration pipeline."
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:11
+msgid ""
+"The JSON output mode is currently only available when using the Flower "
+"CLIs with a `SuperLink <ref-api-cli.html#flower-superlink>`_. Learn more "
+"about the `SuperLink` in the `Flower Architecture Overview <explanation-"
+"flower-architecture.html>`_ page."
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:15
+msgid ""
+"In this guide, we'll show you how to specify a JSON output with the "
+"``flwr run``, ``flwr ls``, and ``flwr stop`` commands. We will also "
+"provide examples of the JSON output for each of these commands."
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:32
+msgid "``flwr run`` JSON output"
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:34
+msgid ""
+"The |flwr_run|_ command runs a Flower app from a provided directory. Note"
+" that if the app path argument is not passed to ``flwr run``, the current"
+" working directory is used as the default Flower app directory. By "
+"default, executing the ``flwr run`` command prints the status of the app "
+"build and run process as follows:"
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:47
+msgid ""
+"To get the output in JSON format, pass an additional ``--format json`` "
+"flag:"
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:62
+#, fuzzy
+msgid "The JSON output for ``flwr run`` contains the following fields:"
+msgstr "Crée une demande de pull qui contient les modifications suivantes :"
+
+#: ../../source/how-to-use-cli-json-output.rst:64
+msgid "``success``: A boolean indicating whether the command was successful."
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:65
+msgid "``run-id``: The ID of the run."
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:66
+#, fuzzy
+msgid "``fab-id``: The ID of the Flower app."
+msgstr "Chargement des données"
+
+#: ../../source/how-to-use-cli-json-output.rst:67
+#, fuzzy
+msgid "``fab-name``: The name of the Flower app."
+msgstr "Chargement des données"
+
+#: ../../source/how-to-use-cli-json-output.rst:68
+#, fuzzy
+msgid "``fab-version``: The version of the Flower app."
+msgstr "Chargement des données"
+
+#: ../../source/how-to-use-cli-json-output.rst:69
+#, fuzzy
+msgid "``fab-hash``: The short hash of the Flower app."
+msgstr "Chargement des données"
+
+#: ../../source/how-to-use-cli-json-output.rst:70
+#, fuzzy
+msgid "``fab-filename``: The filename of the Flower app."
+msgstr "Chargement des données"
+
+#: ../../source/how-to-use-cli-json-output.rst:72
+msgid ""
+"If the command fails, the JSON output will contain two fields, "
+"``success`` with the value of ``false`` and ``error-message``. For "
+"example, if the command fails to find the name of the federation on the "
+"SuperLink, the output will look like this:"
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:87
+msgid "``flwr ls`` JSON output"
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:89
+msgid ""
+"The |flwr_ls|_ command lists all the runs in the current project. Similar"
+" to ``flwr run``, if the app path argument is not passed to ``flwr ls``, "
+"the current working directory is used as the Flower app directory. By "
+"default, the command list the details of all runs in a Flower federation "
+"in a tabular format:"
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:110
+#: ../../source/how-to-use-cli-json-output.rst:181
+msgid "To get the output in JSON format, simply pass the ``--format json`` flag:"
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:145
+msgid ""
+"The JSON output for ``flwr ls`` contains similar fields as ``flwr run`` "
+"with the addition of the ``status``, ``elapsed``, ``created-at``, "
+"``running-at``, and ``finished-at`` fields. The ``runs`` key contains a "
+"list of dictionaries, each representing a run. The additional fields are:"
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:150
+msgid ""
+"``status``: The status of the run, either pending, starting, running, or "
+"finished."
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:151
+msgid ""
+"``elapsed``: The time elapsed since the run started, formatted as "
+"``HH:MM:SS``."
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:152
+msgid "``created-at``: The time the run was created."
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:153
+msgid "``running-at``: The time the run started running."
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:154
+msgid "``finished-at``: The time the run finished."
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:156
+msgid ""
+"All timestamps adhere to ISO 8601, UTC and are formatted as ``YYYY-MM-DD "
+"HH:MM:SSZ``."
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:158
+msgid ""
+"You can also use the ``--run-id`` flag to list the details for one run. "
+"In this case, the JSON output will have the same structure as above with "
+"only one entry in the ``runs`` key. For more details of this command, see"
+" the |flwr_ls|_ documentation. If the command fails, the JSON output will"
+" return two fields, ``success`` and ``error-message``, as shown in "
+":ref:`the above example <json_error_output>`. Note that the content of "
+"the error message will be different depending on the error that occurred."
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:166
+msgid "``flwr stop`` JSON output"
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:168
+msgid ""
+"The |flwr_stop|_ command stops a running Flower app for a provided run "
+"ID. Similar to ``flwr run``, if the app path argument is not passed to "
+"``flwr stop``, the current working directory is used as the Flower app "
+"directory. By default, the command prints the status of the stop process "
+"as follows:"
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:191
+msgid ""
+"If the command fails, the JSON output will contain two fields ``success``"
+" with the value of ``false`` and ``error-message``, as shown in :ref:`the"
+" above example <json_error_output>`. Note that the content of the error "
+"message will be different depending on the error that occurred."
+msgstr ""
+
 #: ../../source/how-to-use-differential-privacy.rst:2
 #, fuzzy
 msgid "Use Differential Privacy"
@@ -8864,7 +9044,7 @@ msgstr "Quickstart tutorials"
 msgid "How-to guides"
 msgstr "Guides"
 
-#: ../../source/index.rst:108 ../../source/index.rst:113
+#: ../../source/index.rst:109 ../../source/index.rst:114
 msgid "Explanations"
 msgstr "Explications"
 
@@ -8872,26 +9052,26 @@ msgstr "Explications"
 msgid "API reference"
 msgstr "Référence pour l'API"
 
-#: ../../source/index.rst:139
+#: ../../source/index.rst:140
 msgid "Reference docs"
 msgstr "Référence pour la documentation"
 
-#: ../../source/index.rst:154
+#: ../../source/index.rst:155
 #, fuzzy
 msgid "Contributor tutorials"
 msgstr "Configuration du contributeur"
 
-#: ../../source/index.rst:161
+#: ../../source/index.rst:162
 #, fuzzy
 msgid "Contributor how-to guides"
 msgstr "Guide pour les contributeurs"
 
-#: ../../source/index.rst:173
+#: ../../source/index.rst:174
 #, fuzzy
 msgid "Contributor explanations"
 msgstr "Explications"
 
-#: ../../source/index.rst:179
+#: ../../source/index.rst:180
 #, fuzzy
 msgid "Contributor references"
 msgstr "Configuration du contributeur"
@@ -9001,7 +9181,7 @@ msgstr ""
 "Guides orientés sur la résolutions étapes par étapes de problèmes ou "
 "objectifs specifiques."
 
-#: ../../source/index.rst:110
+#: ../../source/index.rst:111
 msgid ""
 "Understanding-oriented concept guides explain and discuss key topics and "
 "underlying ideas behind Flower and collaborative AI."
@@ -9009,29 +9189,29 @@ msgstr ""
 "Guides orientés sur la compréhension et l'explication des sujets et idées"
 " de fonds sur lesquels sont construits Flower et l'IA collaborative."
 
-#: ../../source/index.rst:122
+#: ../../source/index.rst:123
 #, fuzzy
 msgid "References"
 msgstr "Référence"
 
-#: ../../source/index.rst:124
+#: ../../source/index.rst:125
 msgid "Information-oriented API reference and other reference material."
 msgstr "Référence de l'API orientée sur l'information pure."
 
-#: ../../source/index.rst:133:<autosummary>:1
+#: ../../source/index.rst:134:<autosummary>:1
 msgid ":py:obj:`flwr <flwr>`\\"
 msgstr ""
 
-#: ../../source/index.rst:133:<autosummary>:1 flwr:1 of
+#: ../../source/index.rst:134:<autosummary>:1 flwr:1 of
 msgid "Flower main package."
 msgstr ""
 
-#: ../../source/index.rst:149
+#: ../../source/index.rst:150
 #, fuzzy
 msgid "Contributor docs"
 msgstr "Configuration du contributeur"
 
-#: ../../source/index.rst:151
+#: ../../source/index.rst:152
 #, fuzzy
 msgid ""
 "The Flower community welcomes contributions. The following docs are "
@@ -9161,7 +9341,7 @@ msgstr ""
 msgid "Flag to stream or print logs from the Flower run"
 msgstr ""
 
-#: ../../flwr log ls run
+#: ../../flwr log ls run stop
 #, fuzzy
 msgid "default"
 msgstr "Flux de travail"
@@ -9203,7 +9383,51 @@ msgid "Name of the federation to login into."
 msgstr ""
 
 #: ../../flwr ls:1
-msgid "List runs."
+msgid ""
+"List the details of one provided run ID or all runs in a Flower "
+"federation."
+msgstr ""
+
+#: ../../flwr ls:1
+msgid "The following details are displayed:"
+msgstr ""
+
+#: ../../flwr ls:1
+msgid "**Run ID:** Unique identifier for the run."
+msgstr ""
+
+#: ../../flwr ls:1
+msgid ""
+"**FAB:** Name of the FAB associated with the run (``{FAB_ID} "
+"(v{FAB_VERSION})``)."
+msgstr ""
+
+#: ../../flwr ls:1
+msgid ""
+"**Status:** Current status of the run (pending, starting, running, "
+"finished)."
+msgstr ""
+
+#: ../../flwr ls:1
+msgid "**Elapsed:** Time elapsed since the run started (``HH:MM:SS``)."
+msgstr ""
+
+#: ../../flwr ls:1
+msgid "**Created At:** Timestamp when the run was created."
+msgstr ""
+
+#: ../../flwr ls:1
+msgid "**Running At:** Timestamp when the run started running."
+msgstr ""
+
+#: ../../flwr ls:1
+msgid "**Finished At:** Timestamp when the run finished."
+msgstr ""
+
+#: ../../flwr ls:1
+msgid ""
+"All timestamps follow ISO 8601, UTC and are formatted as ``YYYY-MM-DD "
+"HH:MM:SSZ``."
 msgstr ""
 
 #: ../../flwr ls:1
@@ -9218,11 +9442,11 @@ msgstr ""
 msgid "Specific run ID to display"
 msgstr ""
 
-#: ../../flwr ls:1 run:1
+#: ../../flwr ls:1 run:1 stop:1
 msgid "Format output using 'default' view or 'json'"
 msgstr ""
 
-#: ../../flwr ls:1 run:1
+#: ../../flwr ls:1 run:1 stop:1
 #, fuzzy
 msgid "``'default'``"
 msgstr "Flux de travail"
@@ -9580,123 +9804,57 @@ msgstr ""
 msgid "Methods"
 msgstr ""
 
-#: ../../source/ref-api/flwr.client.Client.rst:44:<autosummary>:1
+#: flwr.client.client.Client.evaluate:1:<autosummary>:1 of
 msgid ":py:obj:`evaluate <flwr.client.Client.evaluate>`\\ \\(ins\\)"
 msgstr ""
 
-#: ../../source/ref-api/flwr.client.Client.rst:44:<autosummary>:1
-#: ../../source/ref-api/flwr.client.NumPyClient.rst:44:<autosummary>:1
 #: flwr.client.client.Client.evaluate:1
-#: flwr.client.numpy_client.NumPyClient.evaluate:1 of
+#: flwr.client.client.Client.evaluate:1:<autosummary>:1
+#: flwr.client.numpy_client.NumPyClient.evaluate:1
+#: flwr.client.numpy_client.NumPyClient.evaluate:1:<autosummary>:1 of
 #, fuzzy
 msgid "Evaluate the provided parameters using the locally held dataset."
 msgstr "évaluer le modèle mis à jour sur l'ensemble de test local"
 
-#: ../../source/ref-api/flwr.client.Client.rst:44:<autosummary>:1
+#: flwr.client.client.Client.evaluate:1:<autosummary>:1 of
 msgid ":py:obj:`fit <flwr.client.Client.fit>`\\ \\(ins\\)"
 msgstr ""
 
-#: ../../source/ref-api/flwr.client.Client.rst:44:<autosummary>:1
+#: flwr.client.client.Client.evaluate:1:<autosummary>:1
 #: flwr.client.client.Client.fit:1 of
 msgid "Refine the provided parameters using the locally held dataset."
 msgstr ""
 
-#: ../../source/ref-api/flwr.client.Client.rst:44:<autosummary>:1
-msgid ":py:obj:`get_context <flwr.client.Client.get_context>`\\ \\(\\)"
-msgstr ""
-
-#: ../../source/ref-api/flwr.client.Client.rst:44:<autosummary>:1
-#: ../../source/ref-api/flwr.client.NumPyClient.rst:44:<autosummary>:1
-#: flwr.client.client.Client.get_context:1
-#: flwr.client.numpy_client.NumPyClient.get_context:1 of
-#, fuzzy
-msgid "Get the run context from this client."
-msgstr "Évaluer la réponse d'un client."
-
-#: ../../source/ref-api/flwr.client.Client.rst:44:<autosummary>:1
+#: flwr.client.client.Client.evaluate:1:<autosummary>:1 of
 msgid ":py:obj:`get_parameters <flwr.client.Client.get_parameters>`\\ \\(ins\\)"
 msgstr ""
 
-#: ../../source/ref-api/flwr.client.Client.rst:44:<autosummary>:1
-#: ../../source/ref-api/flwr.client.NumPyClient.rst:44:<autosummary>:1
+#: flwr.client.client.Client.evaluate:1:<autosummary>:1
 #: flwr.client.client.Client.get_parameters:1
+#: flwr.client.numpy_client.NumPyClient.evaluate:1:<autosummary>:1
 #: flwr.client.numpy_client.NumPyClient.get_parameters:1 of
 #, fuzzy
 msgid "Return the current local model parameters."
 msgstr "``get_parameters`` : renvoie les paramètres du modèle local actuel"
 
-#: ../../source/ref-api/flwr.client.Client.rst:44:<autosummary>:1
+#: flwr.client.client.Client.evaluate:1:<autosummary>:1 of
 msgid ":py:obj:`get_properties <flwr.client.Client.get_properties>`\\ \\(ins\\)"
 msgstr ""
 
-#: ../../source/ref-api/flwr.client.Client.rst:44:<autosummary>:1
+#: flwr.client.client.Client.evaluate:1:<autosummary>:1
 #: flwr.client.client.Client.get_properties:1 of
 msgid "Return set of client's properties."
 msgstr ""
 
-#: ../../source/ref-api/flwr.client.Client.rst:44:<autosummary>:1
-msgid ":py:obj:`set_context <flwr.client.Client.set_context>`\\ \\(context\\)"
-msgstr ""
-
-#: ../../source/ref-api/flwr.client.Client.rst:44:<autosummary>:1
-#: ../../source/ref-api/flwr.client.NumPyClient.rst:44:<autosummary>:1
-#: flwr.client.client.Client.set_context:1
-#: flwr.client.numpy_client.NumPyClient.set_context:1 of
-msgid "Apply a run context to this client."
-msgstr ""
-
-#: ../../source/ref-api/flwr.client.Client.rst:44:<autosummary>:1
+#: flwr.client.client.Client.evaluate:1:<autosummary>:1 of
 msgid ":py:obj:`to_client <flwr.client.Client.to_client>`\\ \\(\\)"
 msgstr ""
 
-#: ../../source/ref-api/flwr.client.Client.rst:44:<autosummary>:1
+#: flwr.client.client.Client.evaluate:1:<autosummary>:1
 #: flwr.client.client.Client.to_client:1 of
 msgid "Return client (itself)."
 msgstr ""
 
-#: ../../source/ref-api/flwr.client.Client.rst:46
-#: ../../source/ref-api/flwr.client.NumPyClient.rst:46
-#: ../../source/ref-api/flwr.common.Array.rst:28
-#: ../../source/ref-api/flwr.common.ClientMessage.rst:25
-#: ../../source/ref-api/flwr.common.Code.rst:19
-#: ../../source/ref-api/flwr.common.Context.rst:25
-#: ../../source/ref-api/flwr.common.DisconnectRes.rst:25
-#: ../../source/ref-api/flwr.common.Error.rst:25
-#: ../../source/ref-api/flwr.common.EvaluateIns.rst:25
-#: ../../source/ref-api/flwr.common.EvaluateRes.rst:25
-#: ../../source/ref-api/flwr.common.EventType.rst:165
-#: ../../source/ref-api/flwr.common.FitIns.rst:25
-#: ../../source/ref-api/flwr.common.FitRes.rst:25
-#: ../../source/ref-api/flwr.common.GetParametersIns.rst:25
-#: ../../source/ref-api/flwr.common.GetParametersRes.rst:25
-#: ../../source/ref-api/flwr.common.GetPropertiesIns.rst:25
-#: ../../source/ref-api/flwr.common.GetPropertiesRes.rst:25
-#: ../../source/ref-api/flwr.common.Message.rst:37
-#: ../../source/ref-api/flwr.common.MessageType.rst:25
-#: ../../source/ref-api/flwr.common.MessageTypeLegacy.rst:25
-#: ../../source/ref-api/flwr.common.Metadata.rst:25
-#: ../../source/ref-api/flwr.common.Parameters.rst:25
-#: ../../source/ref-api/flwr.common.ReconnectIns.rst:25
-#: ../../source/ref-api/flwr.common.RecordSet.rst:25
-#: ../../source/ref-api/flwr.common.ServerMessage.rst:25
-#: ../../source/ref-api/flwr.common.Status.rst:25
-#: ../../source/ref-api/flwr.server.Driver.rst:43
-#: ../../source/ref-api/flwr.server.LegacyContext.rst:25
-#: ../../source/ref-api/flwr.server.ServerAppComponents.rst:25
-#: ../../source/ref-api/flwr.server.ServerConfig.rst:25
-msgid "Attributes"
-msgstr ""
-
-#: flwr.client.Client.context:1:<autosummary>:1 of
-msgid ":py:obj:`context <flwr.client.Client.context>`\\"
-msgstr ""
-
-#: flwr.client.Client.context:1 flwr.client.Client.context:1:<autosummary>:1
-#: flwr.client.NumPyClient.context:1
-#: flwr.client.NumPyClient.context:1:<autosummary>:1 of
-msgid "Getter for `Context` client attribute."
-msgstr ""
-
 #: ../../source/ref-api/flwr.common.Parameters.rst:2
 #: flwr.client.app.start_client flwr.client.app.start_numpy_client
 #: flwr.client.client.Client.evaluate flwr.client.client.Client.fit
@@ -9951,63 +10109,49 @@ msgstr ""
 msgid "NumPyClient"
 msgstr "NumPyClient"
 
-#: ../../source/ref-api/flwr.client.NumPyClient.rst:44:<autosummary>:1
+#: flwr.client.numpy_client.NumPyClient.evaluate:1:<autosummary>:1 of
 msgid ""
 ":py:obj:`evaluate <flwr.client.NumPyClient.evaluate>`\\ \\(parameters\\, "
 "config\\)"
 msgstr ""
 
-#: ../../source/ref-api/flwr.client.NumPyClient.rst:44:<autosummary>:1
+#: flwr.client.numpy_client.NumPyClient.evaluate:1:<autosummary>:1 of
 msgid ":py:obj:`fit <flwr.client.NumPyClient.fit>`\\ \\(parameters\\, config\\)"
 msgstr ""
 
-#: ../../source/ref-api/flwr.client.NumPyClient.rst:44:<autosummary>:1
+#: flwr.client.numpy_client.NumPyClient.evaluate:1:<autosummary>:1
 #: flwr.client.numpy_client.NumPyClient.fit:1 of
 #, fuzzy
 msgid "Train the provided parameters using the locally held dataset."
 msgstr "entraîne le modèle sur l'ensemble d'apprentissage local"
 
-#: ../../source/ref-api/flwr.client.NumPyClient.rst:44:<autosummary>:1
-msgid ":py:obj:`get_context <flwr.client.NumPyClient.get_context>`\\ \\(\\)"
-msgstr ""
-
-#: ../../source/ref-api/flwr.client.NumPyClient.rst:44:<autosummary>:1
+#: flwr.client.numpy_client.NumPyClient.evaluate:1:<autosummary>:1 of
 msgid ""
 ":py:obj:`get_parameters <flwr.client.NumPyClient.get_parameters>`\\ "
 "\\(config\\)"
 msgstr ""
 
-#: ../../source/ref-api/flwr.client.NumPyClient.rst:44:<autosummary>:1
+#: flwr.client.numpy_client.NumPyClient.evaluate:1:<autosummary>:1 of
 msgid ""
 ":py:obj:`get_properties <flwr.client.NumPyClient.get_properties>`\\ "
 "\\(config\\)"
 msgstr ""
 
-#: ../../source/ref-api/flwr.client.NumPyClient.rst:44:<autosummary>:1
+#: flwr.client.numpy_client.NumPyClient.evaluate:1:<autosummary>:1
 #: flwr.client.numpy_client.NumPyClient.get_properties:1 of
 msgid "Return a client's set of properties."
 msgstr ""
 
-#: ../../source/ref-api/flwr.client.NumPyClient.rst:44:<autosummary>:1
-msgid ""
-":py:obj:`set_context <flwr.client.NumPyClient.set_context>`\\ "
-"\\(context\\)"
-msgstr ""
-
-#: ../../source/ref-api/flwr.client.NumPyClient.rst:44:<autosummary>:1
+#: flwr.client.numpy_client.NumPyClient.evaluate:1:<autosummary>:1 of
 msgid ":py:obj:`to_client <flwr.client.NumPyClient.to_client>`\\ \\(\\)"
 msgstr ""
 
-#: ../../source/ref-api/flwr.client.NumPyClient.rst:44:<autosummary>:1
+#: flwr.client.numpy_client.NumPyClient.evaluate:1:<autosummary>:1
 #: flwr.client.numpy_client.NumPyClient.to_client:1 of
 #, fuzzy
 msgid "Convert to object to Client type and return it."
 msgstr "Convertit l'objet des paramètres en ndarrays NumPy."
 
-#: flwr.client.NumPyClient.context:1:<autosummary>:1 of
-msgid ":py:obj:`context <flwr.client.NumPyClient.context>`\\"
-msgstr ""
-
 #: flwr.client.numpy_client.NumPyClient.evaluate:3
 #: flwr.client.numpy_client.NumPyClient.fit:3
 #: flwr.server.strategy.dpfedavg_fixed.DPFedAvgFixed.configure_evaluate:5
@@ -10933,6 +11077,37 @@ msgstr "serveur.stratégie.Stratégie"
 msgid "Return the array as a NumPy array."
 msgstr "renvoie le poids du modèle sous la forme d'une liste de ndarrays NumPy"
 
+#: ../../source/ref-api/flwr.common.Array.rst:28
+#: ../../source/ref-api/flwr.common.ClientMessage.rst:25
+#: ../../source/ref-api/flwr.common.Code.rst:19
+#: ../../source/ref-api/flwr.common.Context.rst:25
+#: ../../source/ref-api/flwr.common.DisconnectRes.rst:25
+#: ../../source/ref-api/flwr.common.Error.rst:25
+#: ../../source/ref-api/flwr.common.EvaluateIns.rst:25
+#: ../../source/ref-api/flwr.common.EvaluateRes.rst:25
+#: ../../source/ref-api/flwr.common.EventType.rst:165
+#: ../../source/ref-api/flwr.common.FitIns.rst:25
+#: ../../source/ref-api/flwr.common.FitRes.rst:25
+#: ../../source/ref-api/flwr.common.GetParametersIns.rst:25
+#: ../../source/ref-api/flwr.common.GetParametersRes.rst:25
+#: ../../source/ref-api/flwr.common.GetPropertiesIns.rst:25
+#: ../../source/ref-api/flwr.common.GetPropertiesRes.rst:25
+#: ../../source/ref-api/flwr.common.Message.rst:37
+#: ../../source/ref-api/flwr.common.MessageType.rst:25
+#: ../../source/ref-api/flwr.common.MessageTypeLegacy.rst:25
+#: ../../source/ref-api/flwr.common.Metadata.rst:25
+#: ../../source/ref-api/flwr.common.Parameters.rst:25
+#: ../../source/ref-api/flwr.common.ReconnectIns.rst:25
+#: ../../source/ref-api/flwr.common.RecordSet.rst:25
+#: ../../source/ref-api/flwr.common.ServerMessage.rst:25
+#: ../../source/ref-api/flwr.common.Status.rst:25
+#: ../../source/ref-api/flwr.server.Driver.rst:43
+#: ../../source/ref-api/flwr.server.LegacyContext.rst:25
+#: ../../source/ref-api/flwr.server.ServerAppComponents.rst:25
+#: ../../source/ref-api/flwr.server.ServerConfig.rst:25
+msgid "Attributes"
+msgstr ""
+
 #: flwr.common.record.parametersrecord.Array.numpy:1:<autosummary>:1 of
 msgid ":py:obj:`dtype <flwr.common.Array.dtype>`\\"
 msgstr ""
@@ -29230,7 +29405,7 @@ msgstr ""
 "chose d'autre, comme la régression linéaire classique."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:41
-msgid "|ae2337ba61dd4efc818e63933fd81666|"
+msgid "|31d9fb7c284a414ba34e32ced3b17b11|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:109
@@ -29249,7 +29424,7 @@ msgstr ""
 " Go."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:53
-msgid "|14a8d3feda794591a601daaaaa79d0b6|"
+msgid "|32af43ffb54a421d8cfe59939c34206b|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:111
@@ -29281,7 +29456,7 @@ msgstr ""
 "chanson."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:67
-msgid "|c67497f1afa84a30a3901418c6c0bb62|"
+msgid "|34c462a3cde341389422badb2077fc36|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:113
@@ -29302,7 +29477,7 @@ msgstr ""
 " données pour la même tâche."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:79
-msgid "|d4ce55da082146d7ad13ec4f73d427a2|"
+msgid "|3a2ded531a9a4b86af3e743490e78172|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:115
@@ -29324,7 +29499,7 @@ msgstr ""
 "cloud."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:91
-msgid "|0a0c4ca9de6549c1b35225c6e1183bc0|"
+msgid "|52e91c4927884d7293956a379489d8c3|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:117
@@ -29345,7 +29520,7 @@ msgstr ""
 "appuyés."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:103
-msgid "|f2f5e8cc5594472c842192ec38ab9bbe|"
+msgid "|2bb7af14de844e40bd4186c902800ff5|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:119
@@ -29371,7 +29546,7 @@ msgstr ""
 " sur un serveur centralisé."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:138
-msgid "|4e7b0cd854064aab9895573a612a0f06|"
+msgid "|c7538d5f23f142e693a8879fb03e3932|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:173
@@ -29390,7 +29565,7 @@ msgstr ""
 "suffisantes pour former un bon modèle."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:150
-msgid "|e121faa35b114a0da17cf4bc42e74ce9|"
+msgid "|44f9182037b141868306b5c7d2d7bdf6|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:175
@@ -29621,7 +29796,7 @@ msgstr ""
 "partir d'un point de contrôle précédemment sauvegardé."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:210
-msgid "|e7a57a83812c4dc8933fbb93cd0e46dc|"
+msgid "|e198f643aecc4cd58ca665e6979b5bb3|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:307
@@ -29656,7 +29831,7 @@ msgstr ""
 "rendements décroissants."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:225
-msgid "|a0283fe3cd0c4f3cb5d119f424c657fd|"
+msgid "|3e52791d62db46e0b0485e4f05a71070|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:309
@@ -29689,7 +29864,7 @@ msgstr ""
 "données locales, ou même de quelques étapes (mini-batchs)."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:240
-msgid "|debbe320f2c741388902ebabfb6fc705|"
+msgid "|eeb43ec811934701963187e3822826ae|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:311
@@ -29720,7 +29895,7 @@ msgstr ""
 " l'entraînement local."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:255
-msgid "|8be6ce669d3148f9af6272ca27a98197|"
+msgid "|b1642f82fc774ff3a1f7b2f077844291|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:313
@@ -29780,7 +29955,7 @@ msgstr ""
 "times as much as each of the 100 examples."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:273
-msgid "|47c4a06eafbb4e2fa1c62b5ca47d3411|"
+msgid "|17ab6ee928b54a02afcac8d896a3a637|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:315
@@ -29924,7 +30099,7 @@ msgstr ""
 "quel cadre de ML et n'importe quel langage de programmation."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:334
-msgid "|5e84b181879b4bcda37b672215325b30|"
+msgid "|1bd7ba9475d44bdbb4d4a4a40d3e2267|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:340
@@ -43455,3 +43630,111 @@ msgstr ""
 #~ msgid "|e4adf0f92ebf4c3d9e6e64355204f897|"
 #~ msgstr ""
 
+#~ msgid ""
+#~ "There are many ways to deploy "
+#~ "Flower on Microst Azure. The "
+#~ "instructions provided in this guide is"
+#~ " just a basic walkthrough, step-"
+#~ "by-step guide on how to quickly "
+#~ "setup and run a Flower application "
+#~ "on a Federated Learning environment on"
+#~ " Microst Azure."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "In this how-to guide, we want "
+#~ "to create a Federated Learning "
+#~ "environment on Microst Azure using three"
+#~ " Virtual Machines (VMs). From the "
+#~ "three machines, one machine will be "
+#~ "used as the Federation server and "
+#~ "two as the Federation clients. Our "
+#~ "goal is to create a Flower "
+#~ "federation on Microst Azure where we "
+#~ "can run Flower apps from our local"
+#~ " machine, e.g., laptop."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "Assuming we are already inside the "
+#~ "Microst Azure portal, we navigate to "
+#~ "the ``Create`` page and we select "
+#~ "``Azure virtual machine``. In the new"
+#~ " page, for each VM we edit the"
+#~ " properties as follows:"
+#~ msgstr ""
+
+#~ msgid "List runs."
+#~ msgstr ""
+
+#~ msgid ":py:obj:`get_context <flwr.client.Client.get_context>`\\ \\(\\)"
+#~ msgstr ""
+
+#~ msgid "Get the run context from this client."
+#~ msgstr "Évaluer la réponse d'un client."
+
+#~ msgid ":py:obj:`set_context <flwr.client.Client.set_context>`\\ \\(context\\)"
+#~ msgstr ""
+
+#~ msgid "Apply a run context to this client."
+#~ msgstr ""
+
+#~ msgid ":py:obj:`context <flwr.client.Client.context>`\\"
+#~ msgstr ""
+
+#~ msgid "Getter for `Context` client attribute."
+#~ msgstr ""
+
+#~ msgid ":py:obj:`get_context <flwr.client.NumPyClient.get_context>`\\ \\(\\)"
+#~ msgstr ""
+
+#~ msgid ""
+#~ ":py:obj:`set_context <flwr.client.NumPyClient.set_context>`\\"
+#~ " \\(context\\)"
+#~ msgstr ""
+
+#~ msgid ":py:obj:`context <flwr.client.NumPyClient.context>`\\"
+#~ msgstr ""
+
+#~ msgid "|ae2337ba61dd4efc818e63933fd81666|"
+#~ msgstr ""
+
+#~ msgid "|14a8d3feda794591a601daaaaa79d0b6|"
+#~ msgstr ""
+
+#~ msgid "|c67497f1afa84a30a3901418c6c0bb62|"
+#~ msgstr ""
+
+#~ msgid "|d4ce55da082146d7ad13ec4f73d427a2|"
+#~ msgstr ""
+
+#~ msgid "|0a0c4ca9de6549c1b35225c6e1183bc0|"
+#~ msgstr ""
+
+#~ msgid "|f2f5e8cc5594472c842192ec38ab9bbe|"
+#~ msgstr ""
+
+#~ msgid "|4e7b0cd854064aab9895573a612a0f06|"
+#~ msgstr ""
+
+#~ msgid "|e121faa35b114a0da17cf4bc42e74ce9|"
+#~ msgstr ""
+
+#~ msgid "|e7a57a83812c4dc8933fbb93cd0e46dc|"
+#~ msgstr ""
+
+#~ msgid "|a0283fe3cd0c4f3cb5d119f424c657fd|"
+#~ msgstr ""
+
+#~ msgid "|debbe320f2c741388902ebabfb6fc705|"
+#~ msgstr ""
+
+#~ msgid "|8be6ce669d3148f9af6272ca27a98197|"
+#~ msgstr ""
+
+#~ msgid "|47c4a06eafbb4e2fa1c62b5ca47d3411|"
+#~ msgstr ""
+
+#~ msgid "|5e84b181879b4bcda37b672215325b30|"
+#~ msgstr ""
+
diff --git a/framework/docs/locales/ko/LC_MESSAGES/framework-docs.po b/framework/docs/locales/ko/LC_MESSAGES/framework-docs.po
index a37643eb8c0c..577ee112f1ca 100644
--- a/framework/docs/locales/ko/LC_MESSAGES/framework-docs.po
+++ b/framework/docs/locales/ko/LC_MESSAGES/framework-docs.po
@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Flower main\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-13 00:33+0000\n"
+"POT-Creation-Date: 2024-12-18 00:32+0000\n"
 "PO-Revision-Date: 2024-08-23 13:09+0000\n"
 "Last-Translator: Seulki Yun <icstuckyi@gmail.com>\n"
 "Language: ko\n"
@@ -6144,7 +6144,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/how-to-implement-fedbn.rst:99
-#: ../../source/how-to-run-flower-on-azure.rst:217
+#: ../../source/how-to-run-flower-on-azure.rst:218
 msgid "Next Steps"
 msgstr "다음 단계"
 
@@ -6645,23 +6645,23 @@ msgstr "Flower 서버."
 
 #: ../../source/how-to-run-flower-on-azure.rst:22
 msgid ""
-"There are many ways to deploy Flower on Microst Azure. The instructions "
-"provided in this guide is just a basic walkthrough, step-by-step guide on"
-" how to quickly setup and run a Flower application on a Federated "
-"Learning environment on Microst Azure."
+"There are many ways to deploy Flower on Microsoft Azure. The instructions"
+" provided in this guide is just a basic walkthrough, step-by-step guide "
+"on how to quickly setup and run a Flower application on a Federated "
+"Learning environment on Microsoft Azure."
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:26
+#: ../../source/how-to-run-flower-on-azure.rst:27
 msgid ""
 "In this how-to guide, we want to create a Federated Learning environment "
-"on Microst Azure using three Virtual Machines (VMs). From the three "
+"on Microsoft Azure using three Virtual Machines (VMs). From the three "
 "machines, one machine will be used as the Federation server and two as "
 "the Federation clients. Our goal is to create a Flower federation on "
-"Microst Azure where we can run Flower apps from our local machine, e.g., "
-"laptop."
+"Microsoft Azure where we can run Flower apps from our local machine, "
+"e.g., laptop."
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:32
+#: ../../source/how-to-run-flower-on-azure.rst:33
 msgid ""
 "On the Federation server VM we will deploy the long-running Flower server"
 " (``SuperLink``) and on the two Federation client VMs we will deploy the "
@@ -6670,60 +6670,60 @@ msgid ""
 "see the |flower_architecture_link|_ ."
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:38
+#: ../../source/how-to-run-flower-on-azure.rst:39
 msgid "Azure VMs"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:40
+#: ../../source/how-to-run-flower-on-azure.rst:41
 msgid ""
 "First we need to create the three VMs configure their Python "
 "environments, and inbound networking rules to allow cross-VM "
 "communication."
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:44
+#: ../../source/how-to-run-flower-on-azure.rst:45
 msgid "VM Create"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:46
+#: ../../source/how-to-run-flower-on-azure.rst:47
 msgid ""
-"Assuming we are already inside the Microst Azure portal, we navigate to "
-"the ``Create`` page and we select ``Azure virtual machine``. In the new "
+"Assuming we are already inside the Microsoft Azure portal, we navigate to"
+" the ``Create`` page and we select ``Azure virtual machine``. In the new "
 "page, for each VM we edit the properties as follows:"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:55
+#: ../../source/how-to-run-flower-on-azure.rst:56
 msgid "**Virtual machine name**"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:56
+#: ../../source/how-to-run-flower-on-azure.rst:57
 msgid ""
 "for server machine we can use ``flower-server`` and for clients, "
 "``flower-client-1`` and ``flower-client-2``"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:58
+#: ../../source/how-to-run-flower-on-azure.rst:59
 #, fuzzy
 msgid "**Image**"
 msgstr "**변경하기**"
 
-#: ../../source/how-to-run-flower-on-azure.rst:59
+#: ../../source/how-to-run-flower-on-azure.rst:60
 msgid "in this guide, we use ``Ubuntu Server 24.04 - x64 Gen2 LTS``"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:60
+#: ../../source/how-to-run-flower-on-azure.rst:61
 msgid "**Size**"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:61
+#: ../../source/how-to-run-flower-on-azure.rst:62
 msgid "in this guide, we use ``Standard_D2s_v3 - 2 vcpus, 8GiB memory``"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:65
+#: ../../source/how-to-run-flower-on-azure.rst:66
 msgid "For resource group, we can create a new group and assign it to all VMs."
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:67
+#: ../../source/how-to-run-flower-on-azure.rst:68
 msgid ""
 "When each VM instance has been created the portal will allow you to "
 "download the public key (.pem) of each instance. Make sure you save this "
@@ -6731,7 +6731,7 @@ msgid ""
 " the ``chmod 400 <PATH_TO_PEM_FILE>`` command for every .pem file."
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:72
+#: ../../source/how-to-run-flower-on-azure.rst:73
 msgid ""
 "Once all three VMs are created then navigate to the overview page where "
 "all three VMs are listed and open every other VM, and copy its Public IP "
@@ -6741,11 +6741,11 @@ msgid ""
 "``azureuser``):"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:83
+#: ../../source/how-to-run-flower-on-azure.rst:84
 msgid "VM Networking"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:85
+#: ../../source/how-to-run-flower-on-azure.rst:86
 msgid ""
 "During the execution of the Flower application, the server VM "
 "(``SuperLink``) will be responsible to orchestrate the execution of the "
@@ -6756,7 +6756,7 @@ msgid ""
 "applications."
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:92
+#: ../../source/how-to-run-flower-on-azure.rst:93
 msgid ""
 "Therefore, to enable this communication we need to allow inbound traffic "
 "to the server VM instance. To achieve this, we need to navigate to the "
@@ -6765,70 +6765,70 @@ msgid ""
 "appears, we edit the rule properties as follows:"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:97
+#: ../../source/how-to-run-flower-on-azure.rst:98
 msgid "The rest of the fields can be left at their default values."
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:104
-#: ../../source/how-to-run-flower-on-azure.rst:145
+#: ../../source/how-to-run-flower-on-azure.rst:105
+#: ../../source/how-to-run-flower-on-azure.rst:146
 #, fuzzy
 msgid "**Source**"
 msgstr "run\\_supernode"
 
-#: ../../source/how-to-run-flower-on-azure.rst:105
+#: ../../source/how-to-run-flower-on-azure.rst:106
 msgid "``IP Addresses``"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:106
-#: ../../source/how-to-run-flower-on-azure.rst:133
+#: ../../source/how-to-run-flower-on-azure.rst:107
+#: ../../source/how-to-run-flower-on-azure.rst:134
 msgid "**Source IP addresses/CIDR ranges**"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:107
+#: ../../source/how-to-run-flower-on-azure.rst:108
 msgid "add client VMs' Public IP (separated by comma)"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:108
+#: ../../source/how-to-run-flower-on-azure.rst:109
 #, fuzzy
 msgid "**Destination**"
 msgstr "설명"
 
-#: ../../source/how-to-run-flower-on-azure.rst:109
-#: ../../source/how-to-run-flower-on-azure.rst:146
+#: ../../source/how-to-run-flower-on-azure.rst:110
+#: ../../source/how-to-run-flower-on-azure.rst:147
 #, fuzzy
 msgid "``Any``"
 msgstr "``flwr/base``"
 
-#: ../../source/how-to-run-flower-on-azure.rst:110
+#: ../../source/how-to-run-flower-on-azure.rst:111
 #, fuzzy
 msgid "**Service**"
 msgstr "run\\_supernode"
 
-#: ../../source/how-to-run-flower-on-azure.rst:111
+#: ../../source/how-to-run-flower-on-azure.rst:112
 #, fuzzy
 msgid "``custom``"
 msgstr "``DISTRO``"
 
-#: ../../source/how-to-run-flower-on-azure.rst:112
-#: ../../source/how-to-run-flower-on-azure.rst:135
-#: ../../source/how-to-run-flower-on-azure.rst:147
+#: ../../source/how-to-run-flower-on-azure.rst:113
+#: ../../source/how-to-run-flower-on-azure.rst:136
+#: ../../source/how-to-run-flower-on-azure.rst:148
 msgid "**Destination port ranges**"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:113
+#: ../../source/how-to-run-flower-on-azure.rst:114
 msgid "``9092``"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:114
+#: ../../source/how-to-run-flower-on-azure.rst:115
 msgid "**Protocol**"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:115
+#: ../../source/how-to-run-flower-on-azure.rst:116
 #, fuzzy
 msgid "``TCP``"
 msgstr "``DISTRO``"
 
-#: ../../source/how-to-run-flower-on-azure.rst:117
+#: ../../source/how-to-run-flower-on-azure.rst:118
 msgid ""
 "Finally, we need to also open port 9093 to allow receiving and executing "
 "incoming application requests. To enable this we just need to repeat the "
@@ -6840,31 +6840,31 @@ msgid ""
 " source to ``Any``."
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:125
+#: ../../source/how-to-run-flower-on-azure.rst:126
 msgid ""
 "To be more precise, if we know the Public IP of our machine, then we make"
 " the following changes:"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:134
+#: ../../source/how-to-run-flower-on-azure.rst:135
 msgid "add machine's Public IP"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:136
-#: ../../source/how-to-run-flower-on-azure.rst:148
+#: ../../source/how-to-run-flower-on-azure.rst:137
+#: ../../source/how-to-run-flower-on-azure.rst:149
 msgid "``9093``"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:138
+#: ../../source/how-to-run-flower-on-azure.rst:139
 msgid "Otherwise, we change the properties as follows:"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:151
+#: ../../source/how-to-run-flower-on-azure.rst:152
 #, fuzzy
 msgid "Flower Environment"
 msgstr "Flower 개발 환경 만들기"
 
-#: ../../source/how-to-run-flower-on-azure.rst:153
+#: ../../source/how-to-run-flower-on-azure.rst:154
 msgid ""
 "Assuming we have been able to login to each VM, and create a Python "
 "environment with Flower and all its dependencies installed (``pip install"
@@ -6874,19 +6874,19 @@ msgid ""
 "the Flower Framework we want to run, e.g., ``numpy``."
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:161
+#: ../../source/how-to-run-flower-on-azure.rst:162
 msgid ""
 "An alternative approach would be to use Docker in each VM, with each "
 "image containing the necessary environment and dependencies. For more "
 "details please refer to the |flower_docker_index|_ guide."
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:166
+#: ../../source/how-to-run-flower-on-azure.rst:167
 #, fuzzy
 msgid "Server Initialization"
 msgstr "설치 확인"
 
-#: ../../source/how-to-run-flower-on-azure.rst:168
+#: ../../source/how-to-run-flower-on-azure.rst:169
 msgid ""
 "After configuring the Flower application environment, we proceed by "
 "starting the Flower long-running processes (i.e., ``SuperLink`` and "
@@ -6895,19 +6895,19 @@ msgid ""
 "client (``SuperNode``)."
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:175
+#: ../../source/how-to-run-flower-on-azure.rst:176
 msgid ""
 "To enable authentication and encrypted communication during the execution"
 " lifecycle of the Flower application, please have a look at the following"
 " resources: |authenticate_supernodes|_, |enable_tls_connections|_"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:197
+#: ../../source/how-to-run-flower-on-azure.rst:198
 #, fuzzy
 msgid "Run Flower App"
 msgstr "Flower 서버."
 
-#: ../../source/how-to-run-flower-on-azure.rst:199
+#: ../../source/how-to-run-flower-on-azure.rst:200
 msgid ""
 "Finally, after all running Flower processes have been initialized on the "
 "Microsoft Azure cluster, in our local machine, we first need to install "
@@ -6917,17 +6917,17 @@ msgid ""
 "``pyproject.toml`` file, and then add the following sections:"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:214
+#: ../../source/how-to-run-flower-on-azure.rst:215
 msgid "Then from our local machine we need to run ``flwr run . my-federation``."
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:221
+#: ../../source/how-to-run-flower-on-azure.rst:222
 msgid ""
 "This guide is not suitable for production environments due to missing "
 "authentication and TLS security."
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:224
+#: ../../source/how-to-run-flower-on-azure.rst:225
 msgid ""
 "To enable authentication and establish secure connections, please refer "
 "to the following resources: |authenticate_supernodes|_, "
@@ -8451,6 +8451,186 @@ msgstr ""
 msgid "Enjoy building a more robust and flexible ``ClientApp`` with mods!"
 msgstr "Mods를 통해 더욱 강력하고 유연한 ``ClientApp``을 구축해 보세요!"
 
+#: ../../source/how-to-use-cli-json-output.rst:2
+msgid "Use CLI JSON output"
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:4
+msgid ""
+"The `Flower CLIs <ref-api-cli.html>`_ come with a built-in JSON output "
+"mode. This mode is useful when you want to consume the output of a Flower"
+" CLI programmatically. For example, you might want to use the output of "
+"the ``flwr`` CLI in a script or a continuous integration pipeline."
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:11
+msgid ""
+"The JSON output mode is currently only available when using the Flower "
+"CLIs with a `SuperLink <ref-api-cli.html#flower-superlink>`_. Learn more "
+"about the `SuperLink` in the `Flower Architecture Overview <explanation-"
+"flower-architecture.html>`_ page."
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:15
+msgid ""
+"In this guide, we'll show you how to specify a JSON output with the "
+"``flwr run``, ``flwr ls``, and ``flwr stop`` commands. We will also "
+"provide examples of the JSON output for each of these commands."
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:32
+msgid "``flwr run`` JSON output"
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:34
+msgid ""
+"The |flwr_run|_ command runs a Flower app from a provided directory. Note"
+" that if the app path argument is not passed to ``flwr run``, the current"
+" working directory is used as the default Flower app directory. By "
+"default, executing the ``flwr run`` command prints the status of the app "
+"build and run process as follows:"
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:47
+msgid ""
+"To get the output in JSON format, pass an additional ``--format json`` "
+"flag:"
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:62
+#, fuzzy
+msgid "The JSON output for ``flwr run`` contains the following fields:"
+msgstr "다음 변경 사항이 포함된 pull request를 만듭니다:"
+
+#: ../../source/how-to-use-cli-json-output.rst:64
+msgid "``success``: A boolean indicating whether the command was successful."
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:65
+msgid "``run-id``: The ID of the run."
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:66
+#, fuzzy
+msgid "``fab-id``: The ID of the Flower app."
+msgstr "Flower 기본 이미지의 태그."
+
+#: ../../source/how-to-use-cli-json-output.rst:67
+#, fuzzy
+msgid "``fab-name``: The name of the Flower app."
+msgstr "Flower 기본 이미지의 태그."
+
+#: ../../source/how-to-use-cli-json-output.rst:68
+#, fuzzy
+msgid "``fab-version``: The version of the Flower app."
+msgstr "Flower 기본 이미지의 태그."
+
+#: ../../source/how-to-use-cli-json-output.rst:69
+#, fuzzy
+msgid "``fab-hash``: The short hash of the Flower app."
+msgstr "Flower 기본 이미지의 태그."
+
+#: ../../source/how-to-use-cli-json-output.rst:70
+#, fuzzy
+msgid "``fab-filename``: The filename of the Flower app."
+msgstr "Flower 기본 이미지의 태그."
+
+#: ../../source/how-to-use-cli-json-output.rst:72
+msgid ""
+"If the command fails, the JSON output will contain two fields, "
+"``success`` with the value of ``false`` and ``error-message``. For "
+"example, if the command fails to find the name of the federation on the "
+"SuperLink, the output will look like this:"
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:87
+msgid "``flwr ls`` JSON output"
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:89
+msgid ""
+"The |flwr_ls|_ command lists all the runs in the current project. Similar"
+" to ``flwr run``, if the app path argument is not passed to ``flwr ls``, "
+"the current working directory is used as the Flower app directory. By "
+"default, the command list the details of all runs in a Flower federation "
+"in a tabular format:"
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:110
+#: ../../source/how-to-use-cli-json-output.rst:181
+msgid "To get the output in JSON format, simply pass the ``--format json`` flag:"
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:145
+msgid ""
+"The JSON output for ``flwr ls`` contains similar fields as ``flwr run`` "
+"with the addition of the ``status``, ``elapsed``, ``created-at``, "
+"``running-at``, and ``finished-at`` fields. The ``runs`` key contains a "
+"list of dictionaries, each representing a run. The additional fields are:"
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:150
+msgid ""
+"``status``: The status of the run, either pending, starting, running, or "
+"finished."
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:151
+msgid ""
+"``elapsed``: The time elapsed since the run started, formatted as "
+"``HH:MM:SS``."
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:152
+msgid "``created-at``: The time the run was created."
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:153
+msgid "``running-at``: The time the run started running."
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:154
+msgid "``finished-at``: The time the run finished."
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:156
+msgid ""
+"All timestamps adhere to ISO 8601, UTC and are formatted as ``YYYY-MM-DD "
+"HH:MM:SSZ``."
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:158
+msgid ""
+"You can also use the ``--run-id`` flag to list the details for one run. "
+"In this case, the JSON output will have the same structure as above with "
+"only one entry in the ``runs`` key. For more details of this command, see"
+" the |flwr_ls|_ documentation. If the command fails, the JSON output will"
+" return two fields, ``success`` and ``error-message``, as shown in "
+":ref:`the above example <json_error_output>`. Note that the content of "
+"the error message will be different depending on the error that occurred."
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:166
+msgid "``flwr stop`` JSON output"
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:168
+msgid ""
+"The |flwr_stop|_ command stops a running Flower app for a provided run "
+"ID. Similar to ``flwr run``, if the app path argument is not passed to "
+"``flwr stop``, the current working directory is used as the Flower app "
+"directory. By default, the command prints the status of the stop process "
+"as follows:"
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:191
+msgid ""
+"If the command fails, the JSON output will contain two fields ``success``"
+" with the value of ``false`` and ``error-message``, as shown in :ref:`the"
+" above example <json_error_output>`. Note that the content of the error "
+"message will be different depending on the error that occurred."
+msgstr ""
+
 #: ../../source/how-to-use-differential-privacy.rst:2
 msgid "Use Differential Privacy"
 msgstr "차분 개인정보 보호 사용"
@@ -8793,7 +8973,7 @@ msgstr "빠른 시작 튜토리얼"
 msgid "How-to guides"
 msgstr "사용 방법 가이드"
 
-#: ../../source/index.rst:108 ../../source/index.rst:113
+#: ../../source/index.rst:109 ../../source/index.rst:114
 msgid "Explanations"
 msgstr "설명"
 
@@ -8801,23 +8981,23 @@ msgstr "설명"
 msgid "API reference"
 msgstr "API 참조"
 
-#: ../../source/index.rst:139
+#: ../../source/index.rst:140
 msgid "Reference docs"
 msgstr "참조 문서"
 
-#: ../../source/index.rst:154
+#: ../../source/index.rst:155
 msgid "Contributor tutorials"
 msgstr "기여자 튜토리얼"
 
-#: ../../source/index.rst:161
+#: ../../source/index.rst:162
 msgid "Contributor how-to guides"
 msgstr "기여자 사용법 가이드"
 
-#: ../../source/index.rst:173
+#: ../../source/index.rst:174
 msgid "Contributor explanations"
 msgstr "기여자 설명"
 
-#: ../../source/index.rst:179
+#: ../../source/index.rst:180
 msgid "Contributor references"
 msgstr "기여자 참조"
 
@@ -8914,33 +9094,33 @@ msgid ""
 "specific goal."
 msgstr "문제 중심의 방법 가이드는 특정 목표를 달성하는 방법을 단계별로 보여줍니다."
 
-#: ../../source/index.rst:110
+#: ../../source/index.rst:111
 msgid ""
 "Understanding-oriented concept guides explain and discuss key topics and "
 "underlying ideas behind Flower and collaborative AI."
 msgstr "이해 중심의 개념 가이드에서는 Flower와 협업 AI의 주요 주제와 기본 아이디어를 설명하고 토론합니다."
 
-#: ../../source/index.rst:122
+#: ../../source/index.rst:123
 msgid "References"
 msgstr "참조"
 
-#: ../../source/index.rst:124
+#: ../../source/index.rst:125
 msgid "Information-oriented API reference and other reference material."
 msgstr "정보 지향 API 참조 및 기타 참고 자료."
 
-#: ../../source/index.rst:133:<autosummary>:1
+#: ../../source/index.rst:134:<autosummary>:1
 msgid ":py:obj:`flwr <flwr>`\\"
 msgstr ":py:obj:`flwr <flwr>`\\"
 
-#: ../../source/index.rst:133:<autosummary>:1 flwr:1 of
+#: ../../source/index.rst:134:<autosummary>:1 flwr:1 of
 msgid "Flower main package."
 msgstr "Flower 메인 패키지."
 
-#: ../../source/index.rst:149
+#: ../../source/index.rst:150
 msgid "Contributor docs"
 msgstr "기여자 문서"
 
-#: ../../source/index.rst:151
+#: ../../source/index.rst:152
 msgid ""
 "The Flower community welcomes contributions. The following docs are "
 "intended to help along the way."
@@ -9065,7 +9245,7 @@ msgstr ""
 msgid "Flag to stream or print logs from the Flower run"
 msgstr ""
 
-#: ../../flwr log ls run
+#: ../../flwr log ls run stop
 msgid "default"
 msgstr ""
 
@@ -9107,7 +9287,54 @@ msgid "Name of the federation to login into."
 msgstr ""
 
 #: ../../flwr ls:1
-msgid "List runs."
+msgid ""
+"List the details of one provided run ID or all runs in a Flower "
+"federation."
+msgstr ""
+
+#: ../../flwr ls:1
+msgid "The following details are displayed:"
+msgstr ""
+
+#: ../../flwr ls:1
+#, fuzzy
+msgid "**Run ID:** Unique identifier for the run."
+msgstr "현재 실행에 대한 식별자입니다."
+
+#: ../../flwr ls:1
+msgid ""
+"**FAB:** Name of the FAB associated with the run (``{FAB_ID} "
+"(v{FAB_VERSION})``)."
+msgstr ""
+
+#: ../../flwr ls:1
+msgid ""
+"**Status:** Current status of the run (pending, starting, running, "
+"finished)."
+msgstr ""
+
+#: ../../flwr ls:1
+msgid "**Elapsed:** Time elapsed since the run started (``HH:MM:SS``)."
+msgstr ""
+
+#: ../../flwr ls:1
+#, fuzzy
+msgid "**Created At:** Timestamp when the run was created."
+msgstr "메시지가 생성된 때의 Unix timestamp입니다."
+
+#: ../../flwr ls:1
+#, fuzzy
+msgid "**Running At:** Timestamp when the run started running."
+msgstr "메시지가 생성된 때의 Unix timestamp입니다."
+
+#: ../../flwr ls:1
+msgid "**Finished At:** Timestamp when the run finished."
+msgstr ""
+
+#: ../../flwr ls:1
+msgid ""
+"All timestamps follow ISO 8601, UTC and are formatted as ``YYYY-MM-DD "
+"HH:MM:SSZ``."
 msgstr ""
 
 #: ../../flwr ls:1
@@ -9123,11 +9350,11 @@ msgstr "``flwr/base``"
 msgid "Specific run ID to display"
 msgstr ""
 
-#: ../../flwr ls:1 run:1
+#: ../../flwr ls:1 run:1 stop:1
 msgid "Format output using 'default' view or 'json'"
 msgstr ""
 
-#: ../../flwr ls:1 run:1
+#: ../../flwr ls:1 run:1 stop:1
 #, fuzzy
 msgid "``'default'``"
 msgstr "``flwr/base``"
@@ -9482,120 +9709,55 @@ msgstr "Bases: :py:class:`~abc.ABC`"
 msgid "Methods"
 msgstr "메소드"
 
-#: ../../source/ref-api/flwr.client.Client.rst:44:<autosummary>:1
+#: flwr.client.client.Client.evaluate:1:<autosummary>:1 of
 msgid ":py:obj:`evaluate <flwr.client.Client.evaluate>`\\ \\(ins\\)"
 msgstr ":py:obj:`evaluate <flwr.client.Client.evaluate>`\\ \\(ins\\)"
 
-#: ../../source/ref-api/flwr.client.Client.rst:44:<autosummary>:1
-#: ../../source/ref-api/flwr.client.NumPyClient.rst:44:<autosummary>:1
 #: flwr.client.client.Client.evaluate:1
-#: flwr.client.numpy_client.NumPyClient.evaluate:1 of
+#: flwr.client.client.Client.evaluate:1:<autosummary>:1
+#: flwr.client.numpy_client.NumPyClient.evaluate:1
+#: flwr.client.numpy_client.NumPyClient.evaluate:1:<autosummary>:1 of
 msgid "Evaluate the provided parameters using the locally held dataset."
 msgstr "로컬로 보유한 데이터 세트를 사용하여 제공된 매개변수를 평가합니다."
 
-#: ../../source/ref-api/flwr.client.Client.rst:44:<autosummary>:1
+#: flwr.client.client.Client.evaluate:1:<autosummary>:1 of
 msgid ":py:obj:`fit <flwr.client.Client.fit>`\\ \\(ins\\)"
 msgstr ":py:obj:`fit <flwr.client.Client.fit>`\\ \\(ins\\)"
 
-#: ../../source/ref-api/flwr.client.Client.rst:44:<autosummary>:1
+#: flwr.client.client.Client.evaluate:1:<autosummary>:1
 #: flwr.client.client.Client.fit:1 of
 msgid "Refine the provided parameters using the locally held dataset."
 msgstr "로컬로 보유한 데이터 세트를 사용하여 제공된 매개변수를 구체화합니다."
 
-#: ../../source/ref-api/flwr.client.Client.rst:44:<autosummary>:1
-msgid ":py:obj:`get_context <flwr.client.Client.get_context>`\\ \\(\\)"
-msgstr ":py:obj:`get_context <flwr.client.Client.get_context>`\\ \\(\\)"
-
-#: ../../source/ref-api/flwr.client.Client.rst:44:<autosummary>:1
-#: ../../source/ref-api/flwr.client.NumPyClient.rst:44:<autosummary>:1
-#: flwr.client.client.Client.get_context:1
-#: flwr.client.numpy_client.NumPyClient.get_context:1 of
-msgid "Get the run context from this client."
-msgstr "이 클라이언트에서 실행 컨텍스트를 가져옵니다."
-
-#: ../../source/ref-api/flwr.client.Client.rst:44:<autosummary>:1
+#: flwr.client.client.Client.evaluate:1:<autosummary>:1 of
 msgid ":py:obj:`get_parameters <flwr.client.Client.get_parameters>`\\ \\(ins\\)"
 msgstr ":py:obj:`get_parameters <flwr.client.Client.get_parameters>`\\ \\(ins\\)"
 
-#: ../../source/ref-api/flwr.client.Client.rst:44:<autosummary>:1
-#: ../../source/ref-api/flwr.client.NumPyClient.rst:44:<autosummary>:1
+#: flwr.client.client.Client.evaluate:1:<autosummary>:1
 #: flwr.client.client.Client.get_parameters:1
+#: flwr.client.numpy_client.NumPyClient.evaluate:1:<autosummary>:1
 #: flwr.client.numpy_client.NumPyClient.get_parameters:1 of
 msgid "Return the current local model parameters."
 msgstr "현재 로컬 모델 파라미터를 반환합니다."
 
-#: ../../source/ref-api/flwr.client.Client.rst:44:<autosummary>:1
+#: flwr.client.client.Client.evaluate:1:<autosummary>:1 of
 msgid ":py:obj:`get_properties <flwr.client.Client.get_properties>`\\ \\(ins\\)"
 msgstr ":py:obj:`get_properties <flwr.client.Client.get_properties>`\\ \\(ins\\)"
 
-#: ../../source/ref-api/flwr.client.Client.rst:44:<autosummary>:1
+#: flwr.client.client.Client.evaluate:1:<autosummary>:1
 #: flwr.client.client.Client.get_properties:1 of
 msgid "Return set of client's properties."
 msgstr "클라이언트의 속성 집합을 반환합니다."
 
-#: ../../source/ref-api/flwr.client.Client.rst:44:<autosummary>:1
-msgid ":py:obj:`set_context <flwr.client.Client.set_context>`\\ \\(context\\)"
-msgstr ":py:obj:`set_context <flwr.client.Client.set_context>`\\ \\(context\\)"
-
-#: ../../source/ref-api/flwr.client.Client.rst:44:<autosummary>:1
-#: ../../source/ref-api/flwr.client.NumPyClient.rst:44:<autosummary>:1
-#: flwr.client.client.Client.set_context:1
-#: flwr.client.numpy_client.NumPyClient.set_context:1 of
-msgid "Apply a run context to this client."
-msgstr "이 클라이언트에 실행 컨텍스트를 적용합니다."
-
-#: ../../source/ref-api/flwr.client.Client.rst:44:<autosummary>:1
+#: flwr.client.client.Client.evaluate:1:<autosummary>:1 of
 msgid ":py:obj:`to_client <flwr.client.Client.to_client>`\\ \\(\\)"
 msgstr ":py:obj:`to_client <flwr.client.Client.to_client>`\\ \\(\\)"
 
-#: ../../source/ref-api/flwr.client.Client.rst:44:<autosummary>:1
+#: flwr.client.client.Client.evaluate:1:<autosummary>:1
 #: flwr.client.client.Client.to_client:1 of
 msgid "Return client (itself)."
 msgstr "클라이언트(자체)를 반환합니다."
 
-#: ../../source/ref-api/flwr.client.Client.rst:46
-#: ../../source/ref-api/flwr.client.NumPyClient.rst:46
-#: ../../source/ref-api/flwr.common.Array.rst:28
-#: ../../source/ref-api/flwr.common.ClientMessage.rst:25
-#: ../../source/ref-api/flwr.common.Code.rst:19
-#: ../../source/ref-api/flwr.common.Context.rst:25
-#: ../../source/ref-api/flwr.common.DisconnectRes.rst:25
-#: ../../source/ref-api/flwr.common.Error.rst:25
-#: ../../source/ref-api/flwr.common.EvaluateIns.rst:25
-#: ../../source/ref-api/flwr.common.EvaluateRes.rst:25
-#: ../../source/ref-api/flwr.common.EventType.rst:165
-#: ../../source/ref-api/flwr.common.FitIns.rst:25
-#: ../../source/ref-api/flwr.common.FitRes.rst:25
-#: ../../source/ref-api/flwr.common.GetParametersIns.rst:25
-#: ../../source/ref-api/flwr.common.GetParametersRes.rst:25
-#: ../../source/ref-api/flwr.common.GetPropertiesIns.rst:25
-#: ../../source/ref-api/flwr.common.GetPropertiesRes.rst:25
-#: ../../source/ref-api/flwr.common.Message.rst:37
-#: ../../source/ref-api/flwr.common.MessageType.rst:25
-#: ../../source/ref-api/flwr.common.MessageTypeLegacy.rst:25
-#: ../../source/ref-api/flwr.common.Metadata.rst:25
-#: ../../source/ref-api/flwr.common.Parameters.rst:25
-#: ../../source/ref-api/flwr.common.ReconnectIns.rst:25
-#: ../../source/ref-api/flwr.common.RecordSet.rst:25
-#: ../../source/ref-api/flwr.common.ServerMessage.rst:25
-#: ../../source/ref-api/flwr.common.Status.rst:25
-#: ../../source/ref-api/flwr.server.Driver.rst:43
-#: ../../source/ref-api/flwr.server.LegacyContext.rst:25
-#: ../../source/ref-api/flwr.server.ServerAppComponents.rst:25
-#: ../../source/ref-api/flwr.server.ServerConfig.rst:25
-msgid "Attributes"
-msgstr "속성"
-
-#: flwr.client.Client.context:1:<autosummary>:1 of
-msgid ":py:obj:`context <flwr.client.Client.context>`\\"
-msgstr ":py:obj:`context <flwr.client.Client.context>`\\"
-
-#: flwr.client.Client.context:1 flwr.client.Client.context:1:<autosummary>:1
-#: flwr.client.NumPyClient.context:1
-#: flwr.client.NumPyClient.context:1:<autosummary>:1 of
-msgid "Getter for `Context` client attribute."
-msgstr ""
-
 #: ../../source/ref-api/flwr.common.Parameters.rst:2
 #: flwr.client.app.start_client flwr.client.app.start_numpy_client
 #: flwr.client.client.Client.evaluate flwr.client.client.Client.fit
@@ -9849,7 +10011,7 @@ msgstr "클라이언트 앱에 train fn을 등록하는 데코레이터를 반
 msgid "NumPyClient"
 msgstr "NumPyClient"
 
-#: ../../source/ref-api/flwr.client.NumPyClient.rst:44:<autosummary>:1
+#: flwr.client.numpy_client.NumPyClient.evaluate:1:<autosummary>:1 of
 msgid ""
 ":py:obj:`evaluate <flwr.client.NumPyClient.evaluate>`\\ \\(parameters\\, "
 "config\\)"
@@ -9857,20 +10019,16 @@ msgstr ""
 ":py:obj:`evaluate <flwr.client.NumPyClient.evaluate>`\\ \\(parameters\\, "
 "config\\)"
 
-#: ../../source/ref-api/flwr.client.NumPyClient.rst:44:<autosummary>:1
+#: flwr.client.numpy_client.NumPyClient.evaluate:1:<autosummary>:1 of
 msgid ":py:obj:`fit <flwr.client.NumPyClient.fit>`\\ \\(parameters\\, config\\)"
 msgstr ":py:obj:`fit <flwr.client.NumPyClient.fit>`\\ \\(parameters\\, config\\)"
 
-#: ../../source/ref-api/flwr.client.NumPyClient.rst:44:<autosummary>:1
+#: flwr.client.numpy_client.NumPyClient.evaluate:1:<autosummary>:1
 #: flwr.client.numpy_client.NumPyClient.fit:1 of
 msgid "Train the provided parameters using the locally held dataset."
 msgstr "로컬로 보유한 데이터 세트를 사용하여 제공된 파라미터를 학습합니다."
 
-#: ../../source/ref-api/flwr.client.NumPyClient.rst:44:<autosummary>:1
-msgid ":py:obj:`get_context <flwr.client.NumPyClient.get_context>`\\ \\(\\)"
-msgstr ":py:obj:`get_context <flwr.client.NumPyClient.get_context>`\\ \\(\\)"
-
-#: ../../source/ref-api/flwr.client.NumPyClient.rst:44:<autosummary>:1
+#: flwr.client.numpy_client.NumPyClient.evaluate:1:<autosummary>:1 of
 msgid ""
 ":py:obj:`get_parameters <flwr.client.NumPyClient.get_parameters>`\\ "
 "\\(config\\)"
@@ -9878,7 +10036,7 @@ msgstr ""
 ":py:obj:`get_parameters <flwr.client.NumPyClient.get_parameters>`\\ "
 "\\(config\\)"
 
-#: ../../source/ref-api/flwr.client.NumPyClient.rst:44:<autosummary>:1
+#: flwr.client.numpy_client.NumPyClient.evaluate:1:<autosummary>:1 of
 msgid ""
 ":py:obj:`get_properties <flwr.client.NumPyClient.get_properties>`\\ "
 "\\(config\\)"
@@ -9886,32 +10044,20 @@ msgstr ""
 ":py:obj:`get_properties <flwr.client.NumPyClient.get_properties>`\\ "
 "\\(config\\)"
 
-#: ../../source/ref-api/flwr.client.NumPyClient.rst:44:<autosummary>:1
+#: flwr.client.numpy_client.NumPyClient.evaluate:1:<autosummary>:1
 #: flwr.client.numpy_client.NumPyClient.get_properties:1 of
 msgid "Return a client's set of properties."
 msgstr "클라이언트의 속성 집합을 반환합니다."
 
-#: ../../source/ref-api/flwr.client.NumPyClient.rst:44:<autosummary>:1
-msgid ""
-":py:obj:`set_context <flwr.client.NumPyClient.set_context>`\\ "
-"\\(context\\)"
-msgstr ""
-":py:obj:`set_context <flwr.client.NumPyClient.set_context>`\\ "
-"\\(context\\)"
-
-#: ../../source/ref-api/flwr.client.NumPyClient.rst:44:<autosummary>:1
+#: flwr.client.numpy_client.NumPyClient.evaluate:1:<autosummary>:1 of
 msgid ":py:obj:`to_client <flwr.client.NumPyClient.to_client>`\\ \\(\\)"
 msgstr ":py:obj:`to_client <flwr.client.NumPyClient.to_client>`\\ \\(\\)"
 
-#: ../../source/ref-api/flwr.client.NumPyClient.rst:44:<autosummary>:1
+#: flwr.client.numpy_client.NumPyClient.evaluate:1:<autosummary>:1
 #: flwr.client.numpy_client.NumPyClient.to_client:1 of
 msgid "Convert to object to Client type and return it."
 msgstr "객체를 클라이언트 유형으로 변환하고 반환합니다."
 
-#: flwr.client.NumPyClient.context:1:<autosummary>:1 of
-msgid ":py:obj:`context <flwr.client.NumPyClient.context>`\\"
-msgstr ":py:obj:`context <flwr.client.NumPyClient.context>`\\"
-
 #: flwr.client.numpy_client.NumPyClient.evaluate:3
 #: flwr.client.numpy_client.NumPyClient.fit:3
 #: flwr.server.strategy.dpfedavg_fixed.DPFedAvgFixed.configure_evaluate:5
@@ -10916,6 +11062,37 @@ msgstr ":py:obj:`numpy <flwr.common.Array.numpy>`\\ \\(\\)"
 msgid "Return the array as a NumPy array."
 msgstr "배열을 NumPy 배열로 반환합니다."
 
+#: ../../source/ref-api/flwr.common.Array.rst:28
+#: ../../source/ref-api/flwr.common.ClientMessage.rst:25
+#: ../../source/ref-api/flwr.common.Code.rst:19
+#: ../../source/ref-api/flwr.common.Context.rst:25
+#: ../../source/ref-api/flwr.common.DisconnectRes.rst:25
+#: ../../source/ref-api/flwr.common.Error.rst:25
+#: ../../source/ref-api/flwr.common.EvaluateIns.rst:25
+#: ../../source/ref-api/flwr.common.EvaluateRes.rst:25
+#: ../../source/ref-api/flwr.common.EventType.rst:165
+#: ../../source/ref-api/flwr.common.FitIns.rst:25
+#: ../../source/ref-api/flwr.common.FitRes.rst:25
+#: ../../source/ref-api/flwr.common.GetParametersIns.rst:25
+#: ../../source/ref-api/flwr.common.GetParametersRes.rst:25
+#: ../../source/ref-api/flwr.common.GetPropertiesIns.rst:25
+#: ../../source/ref-api/flwr.common.GetPropertiesRes.rst:25
+#: ../../source/ref-api/flwr.common.Message.rst:37
+#: ../../source/ref-api/flwr.common.MessageType.rst:25
+#: ../../source/ref-api/flwr.common.MessageTypeLegacy.rst:25
+#: ../../source/ref-api/flwr.common.Metadata.rst:25
+#: ../../source/ref-api/flwr.common.Parameters.rst:25
+#: ../../source/ref-api/flwr.common.ReconnectIns.rst:25
+#: ../../source/ref-api/flwr.common.RecordSet.rst:25
+#: ../../source/ref-api/flwr.common.ServerMessage.rst:25
+#: ../../source/ref-api/flwr.common.Status.rst:25
+#: ../../source/ref-api/flwr.server.Driver.rst:43
+#: ../../source/ref-api/flwr.server.LegacyContext.rst:25
+#: ../../source/ref-api/flwr.server.ServerAppComponents.rst:25
+#: ../../source/ref-api/flwr.server.ServerConfig.rst:25
+msgid "Attributes"
+msgstr "속성"
+
 #: flwr.common.record.parametersrecord.Array.numpy:1:<autosummary>:1 of
 msgid ":py:obj:`dtype <flwr.common.Array.dtype>`\\"
 msgstr ":py:obj:`dtype <flwr.common.Array.dtype>`\\"
@@ -26312,7 +26489,7 @@ msgstr ""
 " 수도 있습니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:41
-msgid "|ae2337ba61dd4efc818e63933fd81666|"
+msgid "|31d9fb7c284a414ba34e32ced3b17b11|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:109
@@ -26329,7 +26506,7 @@ msgstr ""
 " 바둑과 같은 게임을 하는 것일 수 있습니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:53
-msgid "|14a8d3feda794591a601daaaaa79d0b6|"
+msgid "|32af43ffb54a421d8cfe59939c34206b|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:111
@@ -26355,7 +26532,7 @@ msgstr ""
 "부르리는 것을 듣는 스마트 스피커에서 비롯됩니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:67
-msgid "|c67497f1afa84a30a3901418c6c0bb62|"
+msgid "|34c462a3cde341389422badb2077fc36|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:113
@@ -26373,7 +26550,7 @@ msgstr ""
 "있습니다. 하지만 여러 조직이 모두 같은 작업을 위해 데이터를 생성하는 것일 수도 있습니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:79
-msgid "|d4ce55da082146d7ad13ec4f73d427a2|"
+msgid "|3a2ded531a9a4b86af3e743490e78172|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:115
@@ -26392,7 +26569,7 @@ msgstr ""
 "서버는 데이터 센터 어딘가에 있을 수도 있고 클라우드 어딘가에 있을 수도 있습니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:91
-msgid "|0a0c4ca9de6549c1b35225c6e1183bc0|"
+msgid "|52e91c4927884d7293956a379489d8c3|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:117
@@ -26409,7 +26586,7 @@ msgstr ""
 " 우리가 기본적으로 사용해 온 머신러닝 방법입니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:103
-msgid "|f2f5e8cc5594472c842192ec38ab9bbe|"
+msgid "|2bb7af14de844e40bd4186c902800ff5|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:119
@@ -26432,7 +26609,7 @@ msgstr ""
 "트래픽을 분석하는 것이 있습니다. 이러한 사례에서 모든 데이터는 자연스럽게 중앙 서버에 존재합니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:138
-msgid "|4e7b0cd854064aab9895573a612a0f06|"
+msgid "|c7538d5f23f142e693a8879fb03e3932|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:173
@@ -26449,7 +26626,7 @@ msgstr ""
 "좋은 모델을 훈련하기에 충분하지 않을 수 있습니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:150
-msgid "|e121faa35b114a0da17cf4bc42e74ce9|"
+msgid "|44f9182037b141868306b5c7d2d7bdf6|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:175
@@ -26628,7 +26805,7 @@ msgstr ""
 "체크포인트에서 모델 매개변수를 초기화합니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:210
-msgid "|e7a57a83812c4dc8933fbb93cd0e46dc|"
+msgid "|e198f643aecc4cd58ca665e6979b5bb3|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:307
@@ -26656,7 +26833,7 @@ msgstr ""
 "개의 연결 노드만 사용합니다. 그 이유는 점점 더 많은 클라이언트 노드를 선택하면 학습의 효율성이 감소하기 때문입니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:225
-msgid "|a0283fe3cd0c4f3cb5d119f424c657fd|"
+msgid "|3e52791d62db46e0b0485e4f05a71070|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:309
@@ -26683,7 +26860,7 @@ msgstr ""
 "데이터에서 한 단계 정도로 짧거나 몇 단계(mini-batches)에 불과할 수 있습니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:240
-msgid "|debbe320f2c741388902ebabfb6fc705|"
+msgid "|eeb43ec811934701963187e3822826ae|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:311
@@ -26709,7 +26886,7 @@ msgstr ""
 "보냅니다. 보내는 모델 업데이트는 전체 모델 파라미터거나 로컬 교육 중에 누적된 그레디언트(gradient)일 수 있습니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:255
-msgid "|8be6ce669d3148f9af6272ca27a98197|"
+msgid "|b1642f82fc774ff3a1f7b2f077844291|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:313
@@ -26759,7 +26936,7 @@ msgstr ""
 "많은 영향을 미칩니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:273
-msgid "|47c4a06eafbb4e2fa1c62b5ca47d3411|"
+msgid "|17ab6ee928b54a02afcac8d896a3a637|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:315
@@ -26879,7 +27056,7 @@ msgstr ""
 "사용자는 모든 워크로드, 머신러닝 프레임워크 및 모든 프로그래밍 언어를 통합할 수 있습니다."
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:334
-msgid "|5e84b181879b4bcda37b672215325b30|"
+msgid "|1bd7ba9475d44bdbb4d4a4a40d3e2267|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:340
@@ -33933,3 +34110,113 @@ msgstr ""
 #~ msgid "|e4adf0f92ebf4c3d9e6e64355204f897|"
 #~ msgstr ""
 
+#~ msgid ""
+#~ "There are many ways to deploy "
+#~ "Flower on Microst Azure. The "
+#~ "instructions provided in this guide is"
+#~ " just a basic walkthrough, step-"
+#~ "by-step guide on how to quickly "
+#~ "setup and run a Flower application "
+#~ "on a Federated Learning environment on"
+#~ " Microst Azure."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "In this how-to guide, we want "
+#~ "to create a Federated Learning "
+#~ "environment on Microst Azure using three"
+#~ " Virtual Machines (VMs). From the "
+#~ "three machines, one machine will be "
+#~ "used as the Federation server and "
+#~ "two as the Federation clients. Our "
+#~ "goal is to create a Flower "
+#~ "federation on Microst Azure where we "
+#~ "can run Flower apps from our local"
+#~ " machine, e.g., laptop."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "Assuming we are already inside the "
+#~ "Microst Azure portal, we navigate to "
+#~ "the ``Create`` page and we select "
+#~ "``Azure virtual machine``. In the new"
+#~ " page, for each VM we edit the"
+#~ " properties as follows:"
+#~ msgstr ""
+
+#~ msgid "List runs."
+#~ msgstr ""
+
+#~ msgid ":py:obj:`get_context <flwr.client.Client.get_context>`\\ \\(\\)"
+#~ msgstr ":py:obj:`get_context <flwr.client.Client.get_context>`\\ \\(\\)"
+
+#~ msgid "Get the run context from this client."
+#~ msgstr "이 클라이언트에서 실행 컨텍스트를 가져옵니다."
+
+#~ msgid ":py:obj:`set_context <flwr.client.Client.set_context>`\\ \\(context\\)"
+#~ msgstr ":py:obj:`set_context <flwr.client.Client.set_context>`\\ \\(context\\)"
+
+#~ msgid "Apply a run context to this client."
+#~ msgstr "이 클라이언트에 실행 컨텍스트를 적용합니다."
+
+#~ msgid ":py:obj:`context <flwr.client.Client.context>`\\"
+#~ msgstr ":py:obj:`context <flwr.client.Client.context>`\\"
+
+#~ msgid "Getter for `Context` client attribute."
+#~ msgstr ""
+
+#~ msgid ":py:obj:`get_context <flwr.client.NumPyClient.get_context>`\\ \\(\\)"
+#~ msgstr ":py:obj:`get_context <flwr.client.NumPyClient.get_context>`\\ \\(\\)"
+
+#~ msgid ""
+#~ ":py:obj:`set_context <flwr.client.NumPyClient.set_context>`\\"
+#~ " \\(context\\)"
+#~ msgstr ""
+#~ ":py:obj:`set_context <flwr.client.NumPyClient.set_context>`\\"
+#~ " \\(context\\)"
+
+#~ msgid ":py:obj:`context <flwr.client.NumPyClient.context>`\\"
+#~ msgstr ":py:obj:`context <flwr.client.NumPyClient.context>`\\"
+
+#~ msgid "|ae2337ba61dd4efc818e63933fd81666|"
+#~ msgstr ""
+
+#~ msgid "|14a8d3feda794591a601daaaaa79d0b6|"
+#~ msgstr ""
+
+#~ msgid "|c67497f1afa84a30a3901418c6c0bb62|"
+#~ msgstr ""
+
+#~ msgid "|d4ce55da082146d7ad13ec4f73d427a2|"
+#~ msgstr ""
+
+#~ msgid "|0a0c4ca9de6549c1b35225c6e1183bc0|"
+#~ msgstr ""
+
+#~ msgid "|f2f5e8cc5594472c842192ec38ab9bbe|"
+#~ msgstr ""
+
+#~ msgid "|4e7b0cd854064aab9895573a612a0f06|"
+#~ msgstr ""
+
+#~ msgid "|e121faa35b114a0da17cf4bc42e74ce9|"
+#~ msgstr ""
+
+#~ msgid "|e7a57a83812c4dc8933fbb93cd0e46dc|"
+#~ msgstr ""
+
+#~ msgid "|a0283fe3cd0c4f3cb5d119f424c657fd|"
+#~ msgstr ""
+
+#~ msgid "|debbe320f2c741388902ebabfb6fc705|"
+#~ msgstr ""
+
+#~ msgid "|8be6ce669d3148f9af6272ca27a98197|"
+#~ msgstr ""
+
+#~ msgid "|47c4a06eafbb4e2fa1c62b5ca47d3411|"
+#~ msgstr ""
+
+#~ msgid "|5e84b181879b4bcda37b672215325b30|"
+#~ msgstr ""
+
diff --git a/framework/docs/locales/pt_BR/LC_MESSAGES/framework-docs.po b/framework/docs/locales/pt_BR/LC_MESSAGES/framework-docs.po
index 4104ae260fc0..20a43baa893d 100644
--- a/framework/docs/locales/pt_BR/LC_MESSAGES/framework-docs.po
+++ b/framework/docs/locales/pt_BR/LC_MESSAGES/framework-docs.po
@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Flower main\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-13 00:33+0000\n"
+"POT-Creation-Date: 2024-12-18 00:32+0000\n"
 "PO-Revision-Date: 2024-05-25 11:09+0000\n"
 "Last-Translator: Gustavo Bertoli <gubertoli@gmail.com>\n"
 "Language: pt_BR\n"
@@ -5638,7 +5638,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/how-to-implement-fedbn.rst:99
-#: ../../source/how-to-run-flower-on-azure.rst:217
+#: ../../source/how-to-run-flower-on-azure.rst:218
 msgid "Next Steps"
 msgstr ""
 
@@ -6013,23 +6013,23 @@ msgstr ""
 
 #: ../../source/how-to-run-flower-on-azure.rst:22
 msgid ""
-"There are many ways to deploy Flower on Microst Azure. The instructions "
-"provided in this guide is just a basic walkthrough, step-by-step guide on"
-" how to quickly setup and run a Flower application on a Federated "
-"Learning environment on Microst Azure."
+"There are many ways to deploy Flower on Microsoft Azure. The instructions"
+" provided in this guide is just a basic walkthrough, step-by-step guide "
+"on how to quickly setup and run a Flower application on a Federated "
+"Learning environment on Microsoft Azure."
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:26
+#: ../../source/how-to-run-flower-on-azure.rst:27
 msgid ""
 "In this how-to guide, we want to create a Federated Learning environment "
-"on Microst Azure using three Virtual Machines (VMs). From the three "
+"on Microsoft Azure using three Virtual Machines (VMs). From the three "
 "machines, one machine will be used as the Federation server and two as "
 "the Federation clients. Our goal is to create a Flower federation on "
-"Microst Azure where we can run Flower apps from our local machine, e.g., "
-"laptop."
+"Microsoft Azure where we can run Flower apps from our local machine, "
+"e.g., laptop."
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:32
+#: ../../source/how-to-run-flower-on-azure.rst:33
 msgid ""
 "On the Federation server VM we will deploy the long-running Flower server"
 " (``SuperLink``) and on the two Federation client VMs we will deploy the "
@@ -6038,59 +6038,59 @@ msgid ""
 "see the |flower_architecture_link|_ ."
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:38
+#: ../../source/how-to-run-flower-on-azure.rst:39
 msgid "Azure VMs"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:40
+#: ../../source/how-to-run-flower-on-azure.rst:41
 msgid ""
 "First we need to create the three VMs configure their Python "
 "environments, and inbound networking rules to allow cross-VM "
 "communication."
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:44
+#: ../../source/how-to-run-flower-on-azure.rst:45
 msgid "VM Create"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:46
+#: ../../source/how-to-run-flower-on-azure.rst:47
 msgid ""
-"Assuming we are already inside the Microst Azure portal, we navigate to "
-"the ``Create`` page and we select ``Azure virtual machine``. In the new "
+"Assuming we are already inside the Microsoft Azure portal, we navigate to"
+" the ``Create`` page and we select ``Azure virtual machine``. In the new "
 "page, for each VM we edit the properties as follows:"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:55
+#: ../../source/how-to-run-flower-on-azure.rst:56
 msgid "**Virtual machine name**"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:56
+#: ../../source/how-to-run-flower-on-azure.rst:57
 msgid ""
 "for server machine we can use ``flower-server`` and for clients, "
 "``flower-client-1`` and ``flower-client-2``"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:58
+#: ../../source/how-to-run-flower-on-azure.rst:59
 msgid "**Image**"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:59
+#: ../../source/how-to-run-flower-on-azure.rst:60
 msgid "in this guide, we use ``Ubuntu Server 24.04 - x64 Gen2 LTS``"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:60
+#: ../../source/how-to-run-flower-on-azure.rst:61
 msgid "**Size**"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:61
+#: ../../source/how-to-run-flower-on-azure.rst:62
 msgid "in this guide, we use ``Standard_D2s_v3 - 2 vcpus, 8GiB memory``"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:65
+#: ../../source/how-to-run-flower-on-azure.rst:66
 msgid "For resource group, we can create a new group and assign it to all VMs."
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:67
+#: ../../source/how-to-run-flower-on-azure.rst:68
 msgid ""
 "When each VM instance has been created the portal will allow you to "
 "download the public key (.pem) of each instance. Make sure you save this "
@@ -6098,7 +6098,7 @@ msgid ""
 " the ``chmod 400 <PATH_TO_PEM_FILE>`` command for every .pem file."
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:72
+#: ../../source/how-to-run-flower-on-azure.rst:73
 msgid ""
 "Once all three VMs are created then navigate to the overview page where "
 "all three VMs are listed and open every other VM, and copy its Public IP "
@@ -6108,11 +6108,11 @@ msgid ""
 "``azureuser``):"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:83
+#: ../../source/how-to-run-flower-on-azure.rst:84
 msgid "VM Networking"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:85
+#: ../../source/how-to-run-flower-on-azure.rst:86
 msgid ""
 "During the execution of the Flower application, the server VM "
 "(``SuperLink``) will be responsible to orchestrate the execution of the "
@@ -6123,7 +6123,7 @@ msgid ""
 "applications."
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:92
+#: ../../source/how-to-run-flower-on-azure.rst:93
 msgid ""
 "Therefore, to enable this communication we need to allow inbound traffic "
 "to the server VM instance. To achieve this, we need to navigate to the "
@@ -6132,67 +6132,67 @@ msgid ""
 "appears, we edit the rule properties as follows:"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:97
+#: ../../source/how-to-run-flower-on-azure.rst:98
 msgid "The rest of the fields can be left at their default values."
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:104
-#: ../../source/how-to-run-flower-on-azure.rst:145
+#: ../../source/how-to-run-flower-on-azure.rst:105
+#: ../../source/how-to-run-flower-on-azure.rst:146
 msgid "**Source**"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:105
+#: ../../source/how-to-run-flower-on-azure.rst:106
 msgid "``IP Addresses``"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:106
-#: ../../source/how-to-run-flower-on-azure.rst:133
+#: ../../source/how-to-run-flower-on-azure.rst:107
+#: ../../source/how-to-run-flower-on-azure.rst:134
 msgid "**Source IP addresses/CIDR ranges**"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:107
+#: ../../source/how-to-run-flower-on-azure.rst:108
 msgid "add client VMs' Public IP (separated by comma)"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:108
+#: ../../source/how-to-run-flower-on-azure.rst:109
 #, fuzzy
 msgid "**Destination**"
 msgstr "Descrição"
 
-#: ../../source/how-to-run-flower-on-azure.rst:109
-#: ../../source/how-to-run-flower-on-azure.rst:146
+#: ../../source/how-to-run-flower-on-azure.rst:110
+#: ../../source/how-to-run-flower-on-azure.rst:147
 #, fuzzy
 msgid "``Any``"
 msgstr "``FLWR_VERSION``"
 
-#: ../../source/how-to-run-flower-on-azure.rst:110
+#: ../../source/how-to-run-flower-on-azure.rst:111
 msgid "**Service**"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:111
+#: ../../source/how-to-run-flower-on-azure.rst:112
 #, fuzzy
 msgid "``custom``"
 msgstr "``UBUNTU_VERSION``"
 
-#: ../../source/how-to-run-flower-on-azure.rst:112
-#: ../../source/how-to-run-flower-on-azure.rst:135
-#: ../../source/how-to-run-flower-on-azure.rst:147
+#: ../../source/how-to-run-flower-on-azure.rst:113
+#: ../../source/how-to-run-flower-on-azure.rst:136
+#: ../../source/how-to-run-flower-on-azure.rst:148
 msgid "**Destination port ranges**"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:113
+#: ../../source/how-to-run-flower-on-azure.rst:114
 msgid "``9092``"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:114
+#: ../../source/how-to-run-flower-on-azure.rst:115
 msgid "**Protocol**"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:115
+#: ../../source/how-to-run-flower-on-azure.rst:116
 msgid "``TCP``"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:117
+#: ../../source/how-to-run-flower-on-azure.rst:118
 msgid ""
 "Finally, we need to also open port 9093 to allow receiving and executing "
 "incoming application requests. To enable this we just need to repeat the "
@@ -6204,31 +6204,31 @@ msgid ""
 " source to ``Any``."
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:125
+#: ../../source/how-to-run-flower-on-azure.rst:126
 msgid ""
 "To be more precise, if we know the Public IP of our machine, then we make"
 " the following changes:"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:134
+#: ../../source/how-to-run-flower-on-azure.rst:135
 msgid "add machine's Public IP"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:136
-#: ../../source/how-to-run-flower-on-azure.rst:148
+#: ../../source/how-to-run-flower-on-azure.rst:137
+#: ../../source/how-to-run-flower-on-azure.rst:149
 msgid "``9093``"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:138
+#: ../../source/how-to-run-flower-on-azure.rst:139
 msgid "Otherwise, we change the properties as follows:"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:151
+#: ../../source/how-to-run-flower-on-azure.rst:152
 #, fuzzy
 msgid "Flower Environment"
 msgstr "``FLWR_VERSION``"
 
-#: ../../source/how-to-run-flower-on-azure.rst:153
+#: ../../source/how-to-run-flower-on-azure.rst:154
 msgid ""
 "Assuming we have been able to login to each VM, and create a Python "
 "environment with Flower and all its dependencies installed (``pip install"
@@ -6238,18 +6238,18 @@ msgid ""
 "the Flower Framework we want to run, e.g., ``numpy``."
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:161
+#: ../../source/how-to-run-flower-on-azure.rst:162
 msgid ""
 "An alternative approach would be to use Docker in each VM, with each "
 "image containing the necessary environment and dependencies. For more "
 "details please refer to the |flower_docker_index|_ guide."
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:166
+#: ../../source/how-to-run-flower-on-azure.rst:167
 msgid "Server Initialization"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:168
+#: ../../source/how-to-run-flower-on-azure.rst:169
 msgid ""
 "After configuring the Flower application environment, we proceed by "
 "starting the Flower long-running processes (i.e., ``SuperLink`` and "
@@ -6258,19 +6258,19 @@ msgid ""
 "client (``SuperNode``)."
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:175
+#: ../../source/how-to-run-flower-on-azure.rst:176
 msgid ""
 "To enable authentication and encrypted communication during the execution"
 " lifecycle of the Flower application, please have a look at the following"
 " resources: |authenticate_supernodes|_, |enable_tls_connections|_"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:197
+#: ../../source/how-to-run-flower-on-azure.rst:198
 #, fuzzy
 msgid "Run Flower App"
 msgstr "O nome do repositório da imagem base."
 
-#: ../../source/how-to-run-flower-on-azure.rst:199
+#: ../../source/how-to-run-flower-on-azure.rst:200
 msgid ""
 "Finally, after all running Flower processes have been initialized on the "
 "Microsoft Azure cluster, in our local machine, we first need to install "
@@ -6280,17 +6280,17 @@ msgid ""
 "``pyproject.toml`` file, and then add the following sections:"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:214
+#: ../../source/how-to-run-flower-on-azure.rst:215
 msgid "Then from our local machine we need to run ``flwr run . my-federation``."
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:221
+#: ../../source/how-to-run-flower-on-azure.rst:222
 msgid ""
 "This guide is not suitable for production environments due to missing "
 "authentication and TLS security."
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:224
+#: ../../source/how-to-run-flower-on-azure.rst:225
 msgid ""
 "To enable authentication and establish secure connections, please refer "
 "to the following resources: |authenticate_supernodes|_, "
@@ -7601,6 +7601,185 @@ msgstr ""
 msgid "Enjoy building a more robust and flexible ``ClientApp`` with mods!"
 msgstr ""
 
+#: ../../source/how-to-use-cli-json-output.rst:2
+msgid "Use CLI JSON output"
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:4
+msgid ""
+"The `Flower CLIs <ref-api-cli.html>`_ come with a built-in JSON output "
+"mode. This mode is useful when you want to consume the output of a Flower"
+" CLI programmatically. For example, you might want to use the output of "
+"the ``flwr`` CLI in a script or a continuous integration pipeline."
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:11
+msgid ""
+"The JSON output mode is currently only available when using the Flower "
+"CLIs with a `SuperLink <ref-api-cli.html#flower-superlink>`_. Learn more "
+"about the `SuperLink` in the `Flower Architecture Overview <explanation-"
+"flower-architecture.html>`_ page."
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:15
+msgid ""
+"In this guide, we'll show you how to specify a JSON output with the "
+"``flwr run``, ``flwr ls``, and ``flwr stop`` commands. We will also "
+"provide examples of the JSON output for each of these commands."
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:32
+msgid "``flwr run`` JSON output"
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:34
+msgid ""
+"The |flwr_run|_ command runs a Flower app from a provided directory. Note"
+" that if the app path argument is not passed to ``flwr run``, the current"
+" working directory is used as the default Flower app directory. By "
+"default, executing the ``flwr run`` command prints the status of the app "
+"build and run process as follows:"
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:47
+msgid ""
+"To get the output in JSON format, pass an additional ``--format json`` "
+"flag:"
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:62
+msgid "The JSON output for ``flwr run`` contains the following fields:"
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:64
+msgid "``success``: A boolean indicating whether the command was successful."
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:65
+msgid "``run-id``: The ID of the run."
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:66
+#, fuzzy
+msgid "``fab-id``: The ID of the Flower app."
+msgstr "O nome do repositório da imagem base."
+
+#: ../../source/how-to-use-cli-json-output.rst:67
+#, fuzzy
+msgid "``fab-name``: The name of the Flower app."
+msgstr "O nome do repositório da imagem base."
+
+#: ../../source/how-to-use-cli-json-output.rst:68
+#, fuzzy
+msgid "``fab-version``: The version of the Flower app."
+msgstr "O nome do repositório da imagem base."
+
+#: ../../source/how-to-use-cli-json-output.rst:69
+#, fuzzy
+msgid "``fab-hash``: The short hash of the Flower app."
+msgstr "O nome do repositório da imagem base."
+
+#: ../../source/how-to-use-cli-json-output.rst:70
+#, fuzzy
+msgid "``fab-filename``: The filename of the Flower app."
+msgstr "O nome do repositório da imagem base."
+
+#: ../../source/how-to-use-cli-json-output.rst:72
+msgid ""
+"If the command fails, the JSON output will contain two fields, "
+"``success`` with the value of ``false`` and ``error-message``. For "
+"example, if the command fails to find the name of the federation on the "
+"SuperLink, the output will look like this:"
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:87
+msgid "``flwr ls`` JSON output"
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:89
+msgid ""
+"The |flwr_ls|_ command lists all the runs in the current project. Similar"
+" to ``flwr run``, if the app path argument is not passed to ``flwr ls``, "
+"the current working directory is used as the Flower app directory. By "
+"default, the command list the details of all runs in a Flower federation "
+"in a tabular format:"
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:110
+#: ../../source/how-to-use-cli-json-output.rst:181
+msgid "To get the output in JSON format, simply pass the ``--format json`` flag:"
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:145
+msgid ""
+"The JSON output for ``flwr ls`` contains similar fields as ``flwr run`` "
+"with the addition of the ``status``, ``elapsed``, ``created-at``, "
+"``running-at``, and ``finished-at`` fields. The ``runs`` key contains a "
+"list of dictionaries, each representing a run. The additional fields are:"
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:150
+msgid ""
+"``status``: The status of the run, either pending, starting, running, or "
+"finished."
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:151
+msgid ""
+"``elapsed``: The time elapsed since the run started, formatted as "
+"``HH:MM:SS``."
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:152
+msgid "``created-at``: The time the run was created."
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:153
+msgid "``running-at``: The time the run started running."
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:154
+msgid "``finished-at``: The time the run finished."
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:156
+msgid ""
+"All timestamps adhere to ISO 8601, UTC and are formatted as ``YYYY-MM-DD "
+"HH:MM:SSZ``."
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:158
+msgid ""
+"You can also use the ``--run-id`` flag to list the details for one run. "
+"In this case, the JSON output will have the same structure as above with "
+"only one entry in the ``runs`` key. For more details of this command, see"
+" the |flwr_ls|_ documentation. If the command fails, the JSON output will"
+" return two fields, ``success`` and ``error-message``, as shown in "
+":ref:`the above example <json_error_output>`. Note that the content of "
+"the error message will be different depending on the error that occurred."
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:166
+msgid "``flwr stop`` JSON output"
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:168
+msgid ""
+"The |flwr_stop|_ command stops a running Flower app for a provided run "
+"ID. Similar to ``flwr run``, if the app path argument is not passed to "
+"``flwr stop``, the current working directory is used as the Flower app "
+"directory. By default, the command prints the status of the stop process "
+"as follows:"
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:191
+msgid ""
+"If the command fails, the JSON output will contain two fields ``success``"
+" with the value of ``false`` and ``error-message``, as shown in :ref:`the"
+" above example <json_error_output>`. Note that the content of the error "
+"message will be different depending on the error that occurred."
+msgstr ""
+
 #: ../../source/how-to-use-differential-privacy.rst:2
 msgid "Use Differential Privacy"
 msgstr ""
@@ -7872,7 +8051,7 @@ msgstr ""
 msgid "How-to guides"
 msgstr ""
 
-#: ../../source/index.rst:108 ../../source/index.rst:113
+#: ../../source/index.rst:109 ../../source/index.rst:114
 msgid "Explanations"
 msgstr ""
 
@@ -7880,23 +8059,23 @@ msgstr ""
 msgid "API reference"
 msgstr ""
 
-#: ../../source/index.rst:139
+#: ../../source/index.rst:140
 msgid "Reference docs"
 msgstr ""
 
-#: ../../source/index.rst:154
+#: ../../source/index.rst:155
 msgid "Contributor tutorials"
 msgstr ""
 
-#: ../../source/index.rst:161
+#: ../../source/index.rst:162
 msgid "Contributor how-to guides"
 msgstr ""
 
-#: ../../source/index.rst:173
+#: ../../source/index.rst:174
 msgid "Contributor explanations"
 msgstr ""
 
-#: ../../source/index.rst:179
+#: ../../source/index.rst:180
 msgid "Contributor references"
 msgstr ""
 
@@ -7980,33 +8159,33 @@ msgid ""
 "specific goal."
 msgstr ""
 
-#: ../../source/index.rst:110
+#: ../../source/index.rst:111
 msgid ""
 "Understanding-oriented concept guides explain and discuss key topics and "
 "underlying ideas behind Flower and collaborative AI."
 msgstr ""
 
-#: ../../source/index.rst:122
+#: ../../source/index.rst:123
 msgid "References"
 msgstr ""
 
-#: ../../source/index.rst:124
+#: ../../source/index.rst:125
 msgid "Information-oriented API reference and other reference material."
 msgstr ""
 
-#: ../../source/index.rst:133:<autosummary>:1
+#: ../../source/index.rst:134:<autosummary>:1
 msgid ":py:obj:`flwr <flwr>`\\"
 msgstr ""
 
-#: ../../source/index.rst:133:<autosummary>:1 flwr:1 of
+#: ../../source/index.rst:134:<autosummary>:1 flwr:1 of
 msgid "Flower main package."
 msgstr ""
 
-#: ../../source/index.rst:149
+#: ../../source/index.rst:150
 msgid "Contributor docs"
 msgstr ""
 
-#: ../../source/index.rst:151
+#: ../../source/index.rst:152
 msgid ""
 "The Flower community welcomes contributions. The following docs are "
 "intended to help along the way."
@@ -8127,7 +8306,7 @@ msgstr ""
 msgid "Flag to stream or print logs from the Flower run"
 msgstr ""
 
-#: ../../flwr log ls run
+#: ../../flwr log ls run stop
 msgid "default"
 msgstr ""
 
@@ -8167,7 +8346,51 @@ msgid "Name of the federation to login into."
 msgstr ""
 
 #: ../../flwr ls:1
-msgid "List runs."
+msgid ""
+"List the details of one provided run ID or all runs in a Flower "
+"federation."
+msgstr ""
+
+#: ../../flwr ls:1
+msgid "The following details are displayed:"
+msgstr ""
+
+#: ../../flwr ls:1
+msgid "**Run ID:** Unique identifier for the run."
+msgstr ""
+
+#: ../../flwr ls:1
+msgid ""
+"**FAB:** Name of the FAB associated with the run (``{FAB_ID} "
+"(v{FAB_VERSION})``)."
+msgstr ""
+
+#: ../../flwr ls:1
+msgid ""
+"**Status:** Current status of the run (pending, starting, running, "
+"finished)."
+msgstr ""
+
+#: ../../flwr ls:1
+msgid "**Elapsed:** Time elapsed since the run started (``HH:MM:SS``)."
+msgstr ""
+
+#: ../../flwr ls:1
+msgid "**Created At:** Timestamp when the run was created."
+msgstr ""
+
+#: ../../flwr ls:1
+msgid "**Running At:** Timestamp when the run started running."
+msgstr ""
+
+#: ../../flwr ls:1
+msgid "**Finished At:** Timestamp when the run finished."
+msgstr ""
+
+#: ../../flwr ls:1
+msgid ""
+"All timestamps follow ISO 8601, UTC and are formatted as ``YYYY-MM-DD "
+"HH:MM:SSZ``."
 msgstr ""
 
 #: ../../flwr ls:1
@@ -8183,11 +8406,11 @@ msgstr "``FLWR_VERSION``"
 msgid "Specific run ID to display"
 msgstr ""
 
-#: ../../flwr ls:1 run:1
+#: ../../flwr ls:1 run:1 stop:1
 msgid "Format output using 'default' view or 'json'"
 msgstr ""
 
-#: ../../flwr ls:1 run:1
+#: ../../flwr ls:1 run:1 stop:1
 #, fuzzy
 msgid "``'default'``"
 msgstr "``FLWR_VERSION``"
@@ -8525,120 +8748,55 @@ msgstr ""
 msgid "Methods"
 msgstr ""
 
-#: ../../source/ref-api/flwr.client.Client.rst:44:<autosummary>:1
+#: flwr.client.client.Client.evaluate:1:<autosummary>:1 of
 msgid ":py:obj:`evaluate <flwr.client.Client.evaluate>`\\ \\(ins\\)"
 msgstr ""
 
-#: ../../source/ref-api/flwr.client.Client.rst:44:<autosummary>:1
-#: ../../source/ref-api/flwr.client.NumPyClient.rst:44:<autosummary>:1
 #: flwr.client.client.Client.evaluate:1
-#: flwr.client.numpy_client.NumPyClient.evaluate:1 of
+#: flwr.client.client.Client.evaluate:1:<autosummary>:1
+#: flwr.client.numpy_client.NumPyClient.evaluate:1
+#: flwr.client.numpy_client.NumPyClient.evaluate:1:<autosummary>:1 of
 msgid "Evaluate the provided parameters using the locally held dataset."
 msgstr ""
 
-#: ../../source/ref-api/flwr.client.Client.rst:44:<autosummary>:1
+#: flwr.client.client.Client.evaluate:1:<autosummary>:1 of
 msgid ":py:obj:`fit <flwr.client.Client.fit>`\\ \\(ins\\)"
 msgstr ""
 
-#: ../../source/ref-api/flwr.client.Client.rst:44:<autosummary>:1
+#: flwr.client.client.Client.evaluate:1:<autosummary>:1
 #: flwr.client.client.Client.fit:1 of
 msgid "Refine the provided parameters using the locally held dataset."
 msgstr ""
 
-#: ../../source/ref-api/flwr.client.Client.rst:44:<autosummary>:1
-msgid ":py:obj:`get_context <flwr.client.Client.get_context>`\\ \\(\\)"
-msgstr ""
-
-#: ../../source/ref-api/flwr.client.Client.rst:44:<autosummary>:1
-#: ../../source/ref-api/flwr.client.NumPyClient.rst:44:<autosummary>:1
-#: flwr.client.client.Client.get_context:1
-#: flwr.client.numpy_client.NumPyClient.get_context:1 of
-msgid "Get the run context from this client."
-msgstr ""
-
-#: ../../source/ref-api/flwr.client.Client.rst:44:<autosummary>:1
+#: flwr.client.client.Client.evaluate:1:<autosummary>:1 of
 msgid ":py:obj:`get_parameters <flwr.client.Client.get_parameters>`\\ \\(ins\\)"
 msgstr ""
 
-#: ../../source/ref-api/flwr.client.Client.rst:44:<autosummary>:1
-#: ../../source/ref-api/flwr.client.NumPyClient.rst:44:<autosummary>:1
+#: flwr.client.client.Client.evaluate:1:<autosummary>:1
 #: flwr.client.client.Client.get_parameters:1
+#: flwr.client.numpy_client.NumPyClient.evaluate:1:<autosummary>:1
 #: flwr.client.numpy_client.NumPyClient.get_parameters:1 of
 msgid "Return the current local model parameters."
 msgstr ""
 
-#: ../../source/ref-api/flwr.client.Client.rst:44:<autosummary>:1
+#: flwr.client.client.Client.evaluate:1:<autosummary>:1 of
 msgid ":py:obj:`get_properties <flwr.client.Client.get_properties>`\\ \\(ins\\)"
 msgstr ""
 
-#: ../../source/ref-api/flwr.client.Client.rst:44:<autosummary>:1
+#: flwr.client.client.Client.evaluate:1:<autosummary>:1
 #: flwr.client.client.Client.get_properties:1 of
 msgid "Return set of client's properties."
 msgstr ""
 
-#: ../../source/ref-api/flwr.client.Client.rst:44:<autosummary>:1
-msgid ":py:obj:`set_context <flwr.client.Client.set_context>`\\ \\(context\\)"
-msgstr ""
-
-#: ../../source/ref-api/flwr.client.Client.rst:44:<autosummary>:1
-#: ../../source/ref-api/flwr.client.NumPyClient.rst:44:<autosummary>:1
-#: flwr.client.client.Client.set_context:1
-#: flwr.client.numpy_client.NumPyClient.set_context:1 of
-msgid "Apply a run context to this client."
-msgstr ""
-
-#: ../../source/ref-api/flwr.client.Client.rst:44:<autosummary>:1
+#: flwr.client.client.Client.evaluate:1:<autosummary>:1 of
 msgid ":py:obj:`to_client <flwr.client.Client.to_client>`\\ \\(\\)"
 msgstr ""
 
-#: ../../source/ref-api/flwr.client.Client.rst:44:<autosummary>:1
+#: flwr.client.client.Client.evaluate:1:<autosummary>:1
 #: flwr.client.client.Client.to_client:1 of
 msgid "Return client (itself)."
 msgstr ""
 
-#: ../../source/ref-api/flwr.client.Client.rst:46
-#: ../../source/ref-api/flwr.client.NumPyClient.rst:46
-#: ../../source/ref-api/flwr.common.Array.rst:28
-#: ../../source/ref-api/flwr.common.ClientMessage.rst:25
-#: ../../source/ref-api/flwr.common.Code.rst:19
-#: ../../source/ref-api/flwr.common.Context.rst:25
-#: ../../source/ref-api/flwr.common.DisconnectRes.rst:25
-#: ../../source/ref-api/flwr.common.Error.rst:25
-#: ../../source/ref-api/flwr.common.EvaluateIns.rst:25
-#: ../../source/ref-api/flwr.common.EvaluateRes.rst:25
-#: ../../source/ref-api/flwr.common.EventType.rst:165
-#: ../../source/ref-api/flwr.common.FitIns.rst:25
-#: ../../source/ref-api/flwr.common.FitRes.rst:25
-#: ../../source/ref-api/flwr.common.GetParametersIns.rst:25
-#: ../../source/ref-api/flwr.common.GetParametersRes.rst:25
-#: ../../source/ref-api/flwr.common.GetPropertiesIns.rst:25
-#: ../../source/ref-api/flwr.common.GetPropertiesRes.rst:25
-#: ../../source/ref-api/flwr.common.Message.rst:37
-#: ../../source/ref-api/flwr.common.MessageType.rst:25
-#: ../../source/ref-api/flwr.common.MessageTypeLegacy.rst:25
-#: ../../source/ref-api/flwr.common.Metadata.rst:25
-#: ../../source/ref-api/flwr.common.Parameters.rst:25
-#: ../../source/ref-api/flwr.common.ReconnectIns.rst:25
-#: ../../source/ref-api/flwr.common.RecordSet.rst:25
-#: ../../source/ref-api/flwr.common.ServerMessage.rst:25
-#: ../../source/ref-api/flwr.common.Status.rst:25
-#: ../../source/ref-api/flwr.server.Driver.rst:43
-#: ../../source/ref-api/flwr.server.LegacyContext.rst:25
-#: ../../source/ref-api/flwr.server.ServerAppComponents.rst:25
-#: ../../source/ref-api/flwr.server.ServerConfig.rst:25
-msgid "Attributes"
-msgstr ""
-
-#: flwr.client.Client.context:1:<autosummary>:1 of
-msgid ":py:obj:`context <flwr.client.Client.context>`\\"
-msgstr ""
-
-#: flwr.client.Client.context:1 flwr.client.Client.context:1:<autosummary>:1
-#: flwr.client.NumPyClient.context:1
-#: flwr.client.NumPyClient.context:1:<autosummary>:1 of
-msgid "Getter for `Context` client attribute."
-msgstr ""
-
 #: ../../source/ref-api/flwr.common.Parameters.rst:2
 #: flwr.client.app.start_client flwr.client.app.start_numpy_client
 #: flwr.client.client.Client.evaluate flwr.client.client.Client.fit
@@ -8888,61 +9046,47 @@ msgstr ""
 msgid "NumPyClient"
 msgstr ""
 
-#: ../../source/ref-api/flwr.client.NumPyClient.rst:44:<autosummary>:1
+#: flwr.client.numpy_client.NumPyClient.evaluate:1:<autosummary>:1 of
 msgid ""
 ":py:obj:`evaluate <flwr.client.NumPyClient.evaluate>`\\ \\(parameters\\, "
 "config\\)"
 msgstr ""
 
-#: ../../source/ref-api/flwr.client.NumPyClient.rst:44:<autosummary>:1
+#: flwr.client.numpy_client.NumPyClient.evaluate:1:<autosummary>:1 of
 msgid ":py:obj:`fit <flwr.client.NumPyClient.fit>`\\ \\(parameters\\, config\\)"
 msgstr ""
 
-#: ../../source/ref-api/flwr.client.NumPyClient.rst:44:<autosummary>:1
+#: flwr.client.numpy_client.NumPyClient.evaluate:1:<autosummary>:1
 #: flwr.client.numpy_client.NumPyClient.fit:1 of
 msgid "Train the provided parameters using the locally held dataset."
 msgstr ""
 
-#: ../../source/ref-api/flwr.client.NumPyClient.rst:44:<autosummary>:1
-msgid ":py:obj:`get_context <flwr.client.NumPyClient.get_context>`\\ \\(\\)"
-msgstr ""
-
-#: ../../source/ref-api/flwr.client.NumPyClient.rst:44:<autosummary>:1
+#: flwr.client.numpy_client.NumPyClient.evaluate:1:<autosummary>:1 of
 msgid ""
 ":py:obj:`get_parameters <flwr.client.NumPyClient.get_parameters>`\\ "
 "\\(config\\)"
 msgstr ""
 
-#: ../../source/ref-api/flwr.client.NumPyClient.rst:44:<autosummary>:1
+#: flwr.client.numpy_client.NumPyClient.evaluate:1:<autosummary>:1 of
 msgid ""
 ":py:obj:`get_properties <flwr.client.NumPyClient.get_properties>`\\ "
 "\\(config\\)"
 msgstr ""
 
-#: ../../source/ref-api/flwr.client.NumPyClient.rst:44:<autosummary>:1
+#: flwr.client.numpy_client.NumPyClient.evaluate:1:<autosummary>:1
 #: flwr.client.numpy_client.NumPyClient.get_properties:1 of
 msgid "Return a client's set of properties."
 msgstr ""
 
-#: ../../source/ref-api/flwr.client.NumPyClient.rst:44:<autosummary>:1
-msgid ""
-":py:obj:`set_context <flwr.client.NumPyClient.set_context>`\\ "
-"\\(context\\)"
-msgstr ""
-
-#: ../../source/ref-api/flwr.client.NumPyClient.rst:44:<autosummary>:1
+#: flwr.client.numpy_client.NumPyClient.evaluate:1:<autosummary>:1 of
 msgid ":py:obj:`to_client <flwr.client.NumPyClient.to_client>`\\ \\(\\)"
 msgstr ""
 
-#: ../../source/ref-api/flwr.client.NumPyClient.rst:44:<autosummary>:1
+#: flwr.client.numpy_client.NumPyClient.evaluate:1:<autosummary>:1
 #: flwr.client.numpy_client.NumPyClient.to_client:1 of
 msgid "Convert to object to Client type and return it."
 msgstr ""
 
-#: flwr.client.NumPyClient.context:1:<autosummary>:1 of
-msgid ":py:obj:`context <flwr.client.NumPyClient.context>`\\"
-msgstr ""
-
 #: flwr.client.numpy_client.NumPyClient.evaluate:3
 #: flwr.client.numpy_client.NumPyClient.fit:3
 #: flwr.server.strategy.dpfedavg_fixed.DPFedAvgFixed.configure_evaluate:5
@@ -9832,6 +9976,37 @@ msgstr ""
 msgid "Return the array as a NumPy array."
 msgstr ""
 
+#: ../../source/ref-api/flwr.common.Array.rst:28
+#: ../../source/ref-api/flwr.common.ClientMessage.rst:25
+#: ../../source/ref-api/flwr.common.Code.rst:19
+#: ../../source/ref-api/flwr.common.Context.rst:25
+#: ../../source/ref-api/flwr.common.DisconnectRes.rst:25
+#: ../../source/ref-api/flwr.common.Error.rst:25
+#: ../../source/ref-api/flwr.common.EvaluateIns.rst:25
+#: ../../source/ref-api/flwr.common.EvaluateRes.rst:25
+#: ../../source/ref-api/flwr.common.EventType.rst:165
+#: ../../source/ref-api/flwr.common.FitIns.rst:25
+#: ../../source/ref-api/flwr.common.FitRes.rst:25
+#: ../../source/ref-api/flwr.common.GetParametersIns.rst:25
+#: ../../source/ref-api/flwr.common.GetParametersRes.rst:25
+#: ../../source/ref-api/flwr.common.GetPropertiesIns.rst:25
+#: ../../source/ref-api/flwr.common.GetPropertiesRes.rst:25
+#: ../../source/ref-api/flwr.common.Message.rst:37
+#: ../../source/ref-api/flwr.common.MessageType.rst:25
+#: ../../source/ref-api/flwr.common.MessageTypeLegacy.rst:25
+#: ../../source/ref-api/flwr.common.Metadata.rst:25
+#: ../../source/ref-api/flwr.common.Parameters.rst:25
+#: ../../source/ref-api/flwr.common.ReconnectIns.rst:25
+#: ../../source/ref-api/flwr.common.RecordSet.rst:25
+#: ../../source/ref-api/flwr.common.ServerMessage.rst:25
+#: ../../source/ref-api/flwr.common.Status.rst:25
+#: ../../source/ref-api/flwr.server.Driver.rst:43
+#: ../../source/ref-api/flwr.server.LegacyContext.rst:25
+#: ../../source/ref-api/flwr.server.ServerAppComponents.rst:25
+#: ../../source/ref-api/flwr.server.ServerConfig.rst:25
+msgid "Attributes"
+msgstr ""
+
 #: flwr.common.record.parametersrecord.Array.numpy:1:<autosummary>:1 of
 msgid ":py:obj:`dtype <flwr.common.Array.dtype>`\\"
 msgstr ""
@@ -24972,7 +25147,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:41
-msgid "|ae2337ba61dd4efc818e63933fd81666|"
+msgid "|31d9fb7c284a414ba34e32ced3b17b11|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:109
@@ -24987,7 +25162,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:53
-msgid "|14a8d3feda794591a601daaaaa79d0b6|"
+msgid "|32af43ffb54a421d8cfe59939c34206b|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:111
@@ -25009,7 +25184,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:67
-msgid "|c67497f1afa84a30a3901418c6c0bb62|"
+msgid "|34c462a3cde341389422badb2077fc36|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:113
@@ -25025,7 +25200,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:79
-msgid "|d4ce55da082146d7ad13ec4f73d427a2|"
+msgid "|3a2ded531a9a4b86af3e743490e78172|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:115
@@ -25041,7 +25216,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:91
-msgid "|0a0c4ca9de6549c1b35225c6e1183bc0|"
+msgid "|52e91c4927884d7293956a379489d8c3|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:117
@@ -25056,7 +25231,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:103
-msgid "|f2f5e8cc5594472c842192ec38ab9bbe|"
+msgid "|2bb7af14de844e40bd4186c902800ff5|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:119
@@ -25076,7 +25251,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:138
-msgid "|4e7b0cd854064aab9895573a612a0f06|"
+msgid "|c7538d5f23f142e693a8879fb03e3932|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:173
@@ -25091,7 +25266,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:150
-msgid "|e121faa35b114a0da17cf4bc42e74ce9|"
+msgid "|44f9182037b141868306b5c7d2d7bdf6|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:175
@@ -25231,7 +25406,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:210
-msgid "|e7a57a83812c4dc8933fbb93cd0e46dc|"
+msgid "|e198f643aecc4cd58ca665e6979b5bb3|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:307
@@ -25255,7 +25430,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:225
-msgid "|a0283fe3cd0c4f3cb5d119f424c657fd|"
+msgid "|3e52791d62db46e0b0485e4f05a71070|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:309
@@ -25279,7 +25454,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:240
-msgid "|debbe320f2c741388902ebabfb6fc705|"
+msgid "|eeb43ec811934701963187e3822826ae|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:311
@@ -25302,7 +25477,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:255
-msgid "|8be6ce669d3148f9af6272ca27a98197|"
+msgid "|b1642f82fc774ff3a1f7b2f077844291|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:313
@@ -25340,7 +25515,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:273
-msgid "|47c4a06eafbb4e2fa1c62b5ca47d3411|"
+msgid "|17ab6ee928b54a02afcac8d896a3a637|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:315
@@ -25434,7 +25609,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:334
-msgid "|5e84b181879b4bcda37b672215325b30|"
+msgid "|1bd7ba9475d44bdbb4d4a4a40d3e2267|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:340
@@ -37944,3 +38119,111 @@ msgstr ""
 #~ msgid "|e4adf0f92ebf4c3d9e6e64355204f897|"
 #~ msgstr ""
 
+#~ msgid ""
+#~ "There are many ways to deploy "
+#~ "Flower on Microst Azure. The "
+#~ "instructions provided in this guide is"
+#~ " just a basic walkthrough, step-"
+#~ "by-step guide on how to quickly "
+#~ "setup and run a Flower application "
+#~ "on a Federated Learning environment on"
+#~ " Microst Azure."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "In this how-to guide, we want "
+#~ "to create a Federated Learning "
+#~ "environment on Microst Azure using three"
+#~ " Virtual Machines (VMs). From the "
+#~ "three machines, one machine will be "
+#~ "used as the Federation server and "
+#~ "two as the Federation clients. Our "
+#~ "goal is to create a Flower "
+#~ "federation on Microst Azure where we "
+#~ "can run Flower apps from our local"
+#~ " machine, e.g., laptop."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "Assuming we are already inside the "
+#~ "Microst Azure portal, we navigate to "
+#~ "the ``Create`` page and we select "
+#~ "``Azure virtual machine``. In the new"
+#~ " page, for each VM we edit the"
+#~ " properties as follows:"
+#~ msgstr ""
+
+#~ msgid "List runs."
+#~ msgstr ""
+
+#~ msgid ":py:obj:`get_context <flwr.client.Client.get_context>`\\ \\(\\)"
+#~ msgstr ""
+
+#~ msgid "Get the run context from this client."
+#~ msgstr ""
+
+#~ msgid ":py:obj:`set_context <flwr.client.Client.set_context>`\\ \\(context\\)"
+#~ msgstr ""
+
+#~ msgid "Apply a run context to this client."
+#~ msgstr ""
+
+#~ msgid ":py:obj:`context <flwr.client.Client.context>`\\"
+#~ msgstr ""
+
+#~ msgid "Getter for `Context` client attribute."
+#~ msgstr ""
+
+#~ msgid ":py:obj:`get_context <flwr.client.NumPyClient.get_context>`\\ \\(\\)"
+#~ msgstr ""
+
+#~ msgid ""
+#~ ":py:obj:`set_context <flwr.client.NumPyClient.set_context>`\\"
+#~ " \\(context\\)"
+#~ msgstr ""
+
+#~ msgid ":py:obj:`context <flwr.client.NumPyClient.context>`\\"
+#~ msgstr ""
+
+#~ msgid "|ae2337ba61dd4efc818e63933fd81666|"
+#~ msgstr ""
+
+#~ msgid "|14a8d3feda794591a601daaaaa79d0b6|"
+#~ msgstr ""
+
+#~ msgid "|c67497f1afa84a30a3901418c6c0bb62|"
+#~ msgstr ""
+
+#~ msgid "|d4ce55da082146d7ad13ec4f73d427a2|"
+#~ msgstr ""
+
+#~ msgid "|0a0c4ca9de6549c1b35225c6e1183bc0|"
+#~ msgstr ""
+
+#~ msgid "|f2f5e8cc5594472c842192ec38ab9bbe|"
+#~ msgstr ""
+
+#~ msgid "|4e7b0cd854064aab9895573a612a0f06|"
+#~ msgstr ""
+
+#~ msgid "|e121faa35b114a0da17cf4bc42e74ce9|"
+#~ msgstr ""
+
+#~ msgid "|e7a57a83812c4dc8933fbb93cd0e46dc|"
+#~ msgstr ""
+
+#~ msgid "|a0283fe3cd0c4f3cb5d119f424c657fd|"
+#~ msgstr ""
+
+#~ msgid "|debbe320f2c741388902ebabfb6fc705|"
+#~ msgstr ""
+
+#~ msgid "|8be6ce669d3148f9af6272ca27a98197|"
+#~ msgstr ""
+
+#~ msgid "|47c4a06eafbb4e2fa1c62b5ca47d3411|"
+#~ msgstr ""
+
+#~ msgid "|5e84b181879b4bcda37b672215325b30|"
+#~ msgstr ""
+
diff --git a/framework/docs/locales/zh_Hans/LC_MESSAGES/framework-docs.po b/framework/docs/locales/zh_Hans/LC_MESSAGES/framework-docs.po
index 5d5d94fcc8d9..05ad09a99575 100644
--- a/framework/docs/locales/zh_Hans/LC_MESSAGES/framework-docs.po
+++ b/framework/docs/locales/zh_Hans/LC_MESSAGES/framework-docs.po
@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Flower main\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-12-13 00:33+0000\n"
+"POT-Creation-Date: 2024-12-18 00:32+0000\n"
 "PO-Revision-Date: 2024-06-12 10:09+0000\n"
 "Last-Translator: Yan Gao <y.gaogy@gmail.com>\n"
 "Language: zh_Hans\n"
@@ -6152,7 +6152,7 @@ msgid ""
 msgstr ""
 
 #: ../../source/how-to-implement-fedbn.rst:99
-#: ../../source/how-to-run-flower-on-azure.rst:217
+#: ../../source/how-to-run-flower-on-azure.rst:218
 msgid "Next Steps"
 msgstr "下一步工作"
 
@@ -6629,23 +6629,23 @@ msgstr "Flower 服务器。"
 
 #: ../../source/how-to-run-flower-on-azure.rst:22
 msgid ""
-"There are many ways to deploy Flower on Microst Azure. The instructions "
-"provided in this guide is just a basic walkthrough, step-by-step guide on"
-" how to quickly setup and run a Flower application on a Federated "
-"Learning environment on Microst Azure."
+"There are many ways to deploy Flower on Microsoft Azure. The instructions"
+" provided in this guide is just a basic walkthrough, step-by-step guide "
+"on how to quickly setup and run a Flower application on a Federated "
+"Learning environment on Microsoft Azure."
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:26
+#: ../../source/how-to-run-flower-on-azure.rst:27
 msgid ""
 "In this how-to guide, we want to create a Federated Learning environment "
-"on Microst Azure using three Virtual Machines (VMs). From the three "
+"on Microsoft Azure using three Virtual Machines (VMs). From the three "
 "machines, one machine will be used as the Federation server and two as "
 "the Federation clients. Our goal is to create a Flower federation on "
-"Microst Azure where we can run Flower apps from our local machine, e.g., "
-"laptop."
+"Microsoft Azure where we can run Flower apps from our local machine, "
+"e.g., laptop."
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:32
+#: ../../source/how-to-run-flower-on-azure.rst:33
 msgid ""
 "On the Federation server VM we will deploy the long-running Flower server"
 " (``SuperLink``) and on the two Federation client VMs we will deploy the "
@@ -6654,61 +6654,61 @@ msgid ""
 "see the |flower_architecture_link|_ ."
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:38
+#: ../../source/how-to-run-flower-on-azure.rst:39
 msgid "Azure VMs"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:40
+#: ../../source/how-to-run-flower-on-azure.rst:41
 msgid ""
 "First we need to create the three VMs configure their Python "
 "environments, and inbound networking rules to allow cross-VM "
 "communication."
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:44
+#: ../../source/how-to-run-flower-on-azure.rst:45
 msgid "VM Create"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:46
+#: ../../source/how-to-run-flower-on-azure.rst:47
 msgid ""
-"Assuming we are already inside the Microst Azure portal, we navigate to "
-"the ``Create`` page and we select ``Azure virtual machine``. In the new "
+"Assuming we are already inside the Microsoft Azure portal, we navigate to"
+" the ``Create`` page and we select ``Azure virtual machine``. In the new "
 "page, for each VM we edit the properties as follows:"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:55
+#: ../../source/how-to-run-flower-on-azure.rst:56
 msgid "**Virtual machine name**"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:56
+#: ../../source/how-to-run-flower-on-azure.rst:57
 msgid ""
 "for server machine we can use ``flower-server`` and for clients, "
 "``flower-client-1`` and ``flower-client-2``"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:58
+#: ../../source/how-to-run-flower-on-azure.rst:59
 #, fuzzy
 msgid "**Image**"
 msgstr "**进行修改**"
 
-#: ../../source/how-to-run-flower-on-azure.rst:59
+#: ../../source/how-to-run-flower-on-azure.rst:60
 msgid "in this guide, we use ``Ubuntu Server 24.04 - x64 Gen2 LTS``"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:60
+#: ../../source/how-to-run-flower-on-azure.rst:61
 #, fuzzy
 msgid "**Size**"
 msgstr "**success**"
 
-#: ../../source/how-to-run-flower-on-azure.rst:61
+#: ../../source/how-to-run-flower-on-azure.rst:62
 msgid "in this guide, we use ``Standard_D2s_v3 - 2 vcpus, 8GiB memory``"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:65
+#: ../../source/how-to-run-flower-on-azure.rst:66
 msgid "For resource group, we can create a new group and assign it to all VMs."
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:67
+#: ../../source/how-to-run-flower-on-azure.rst:68
 msgid ""
 "When each VM instance has been created the portal will allow you to "
 "download the public key (.pem) of each instance. Make sure you save this "
@@ -6716,7 +6716,7 @@ msgid ""
 " the ``chmod 400 <PATH_TO_PEM_FILE>`` command for every .pem file."
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:72
+#: ../../source/how-to-run-flower-on-azure.rst:73
 msgid ""
 "Once all three VMs are created then navigate to the overview page where "
 "all three VMs are listed and open every other VM, and copy its Public IP "
@@ -6726,11 +6726,11 @@ msgid ""
 "``azureuser``):"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:83
+#: ../../source/how-to-run-flower-on-azure.rst:84
 msgid "VM Networking"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:85
+#: ../../source/how-to-run-flower-on-azure.rst:86
 msgid ""
 "During the execution of the Flower application, the server VM "
 "(``SuperLink``) will be responsible to orchestrate the execution of the "
@@ -6741,7 +6741,7 @@ msgid ""
 "applications."
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:92
+#: ../../source/how-to-run-flower-on-azure.rst:93
 msgid ""
 "Therefore, to enable this communication we need to allow inbound traffic "
 "to the server VM instance. To achieve this, we need to navigate to the "
@@ -6750,70 +6750,70 @@ msgid ""
 "appears, we edit the rule properties as follows:"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:97
+#: ../../source/how-to-run-flower-on-azure.rst:98
 msgid "The rest of the fields can be left at their default values."
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:104
-#: ../../source/how-to-run-flower-on-azure.rst:145
+#: ../../source/how-to-run-flower-on-azure.rst:105
+#: ../../source/how-to-run-flower-on-azure.rst:146
 #, fuzzy
 msgid "**Source**"
 msgstr "**success**"
 
-#: ../../source/how-to-run-flower-on-azure.rst:105
+#: ../../source/how-to-run-flower-on-azure.rst:106
 msgid "``IP Addresses``"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:106
-#: ../../source/how-to-run-flower-on-azure.rst:133
+#: ../../source/how-to-run-flower-on-azure.rst:107
+#: ../../source/how-to-run-flower-on-azure.rst:134
 msgid "**Source IP addresses/CIDR ranges**"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:107
+#: ../../source/how-to-run-flower-on-azure.rst:108
 msgid "add client VMs' Public IP (separated by comma)"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:108
+#: ../../source/how-to-run-flower-on-azure.rst:109
 #, fuzzy
 msgid "**Destination**"
 msgstr "停用"
 
-#: ../../source/how-to-run-flower-on-azure.rst:109
-#: ../../source/how-to-run-flower-on-azure.rst:146
+#: ../../source/how-to-run-flower-on-azure.rst:110
+#: ../../source/how-to-run-flower-on-azure.rst:147
 #, fuzzy
 msgid "``Any``"
 msgstr "``FLWR_VERSION``"
 
-#: ../../source/how-to-run-flower-on-azure.rst:110
+#: ../../source/how-to-run-flower-on-azure.rst:111
 #, fuzzy
 msgid "**Service**"
 msgstr "flower-superlink"
 
-#: ../../source/how-to-run-flower-on-azure.rst:111
+#: ../../source/how-to-run-flower-on-azure.rst:112
 #, fuzzy
 msgid "``custom``"
 msgstr "``UBUNTU_VERSION``"
 
-#: ../../source/how-to-run-flower-on-azure.rst:112
-#: ../../source/how-to-run-flower-on-azure.rst:135
-#: ../../source/how-to-run-flower-on-azure.rst:147
+#: ../../source/how-to-run-flower-on-azure.rst:113
+#: ../../source/how-to-run-flower-on-azure.rst:136
+#: ../../source/how-to-run-flower-on-azure.rst:148
 msgid "**Destination port ranges**"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:113
+#: ../../source/how-to-run-flower-on-azure.rst:114
 msgid "``9092``"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:114
+#: ../../source/how-to-run-flower-on-azure.rst:115
 msgid "**Protocol**"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:115
+#: ../../source/how-to-run-flower-on-azure.rst:116
 #, fuzzy
 msgid "``TCP``"
 msgstr "配置日志记录"
 
-#: ../../source/how-to-run-flower-on-azure.rst:117
+#: ../../source/how-to-run-flower-on-azure.rst:118
 msgid ""
 "Finally, we need to also open port 9093 to allow receiving and executing "
 "incoming application requests. To enable this we just need to repeat the "
@@ -6825,31 +6825,31 @@ msgid ""
 " source to ``Any``."
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:125
+#: ../../source/how-to-run-flower-on-azure.rst:126
 msgid ""
 "To be more precise, if we know the Public IP of our machine, then we make"
 " the following changes:"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:134
+#: ../../source/how-to-run-flower-on-azure.rst:135
 msgid "add machine's Public IP"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:136
-#: ../../source/how-to-run-flower-on-azure.rst:148
+#: ../../source/how-to-run-flower-on-azure.rst:137
+#: ../../source/how-to-run-flower-on-azure.rst:149
 msgid "``9093``"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:138
+#: ../../source/how-to-run-flower-on-azure.rst:139
 msgid "Otherwise, we change the properties as follows:"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:151
+#: ../../source/how-to-run-flower-on-azure.rst:152
 #, fuzzy
 msgid "Flower Environment"
 msgstr "创建/删除虚拟环境"
 
-#: ../../source/how-to-run-flower-on-azure.rst:153
+#: ../../source/how-to-run-flower-on-azure.rst:154
 msgid ""
 "Assuming we have been able to login to each VM, and create a Python "
 "environment with Flower and all its dependencies installed (``pip install"
@@ -6859,19 +6859,19 @@ msgid ""
 "the Flower Framework we want to run, e.g., ``numpy``."
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:161
+#: ../../source/how-to-run-flower-on-azure.rst:162
 msgid ""
 "An alternative approach would be to use Docker in each VM, with each "
 "image containing the necessary environment and dependencies. For more "
 "details please refer to the |flower_docker_index|_ guide."
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:166
+#: ../../source/how-to-run-flower-on-azure.rst:167
 #, fuzzy
 msgid "Server Initialization"
 msgstr "验证安装"
 
-#: ../../source/how-to-run-flower-on-azure.rst:168
+#: ../../source/how-to-run-flower-on-azure.rst:169
 msgid ""
 "After configuring the Flower application environment, we proceed by "
 "starting the Flower long-running processes (i.e., ``SuperLink`` and "
@@ -6880,19 +6880,19 @@ msgid ""
 "client (``SuperNode``)."
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:175
+#: ../../source/how-to-run-flower-on-azure.rst:176
 msgid ""
 "To enable authentication and encrypted communication during the execution"
 " lifecycle of the Flower application, please have a look at the following"
 " resources: |authenticate_supernodes|_, |enable_tls_connections|_"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:197
+#: ../../source/how-to-run-flower-on-azure.rst:198
 #, fuzzy
 msgid "Run Flower App"
 msgstr "Flower 服务器。"
 
-#: ../../source/how-to-run-flower-on-azure.rst:199
+#: ../../source/how-to-run-flower-on-azure.rst:200
 msgid ""
 "Finally, after all running Flower processes have been initialized on the "
 "Microsoft Azure cluster, in our local machine, we first need to install "
@@ -6902,17 +6902,17 @@ msgid ""
 "``pyproject.toml`` file, and then add the following sections:"
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:214
+#: ../../source/how-to-run-flower-on-azure.rst:215
 msgid "Then from our local machine we need to run ``flwr run . my-federation``."
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:221
+#: ../../source/how-to-run-flower-on-azure.rst:222
 msgid ""
 "This guide is not suitable for production environments due to missing "
 "authentication and TLS security."
 msgstr ""
 
-#: ../../source/how-to-run-flower-on-azure.rst:224
+#: ../../source/how-to-run-flower-on-azure.rst:225
 msgid ""
 "To enable authentication and establish secure connections, please refer "
 "to the following resources: |authenticate_supernodes|_, "
@@ -8430,6 +8430,186 @@ msgstr ""
 msgid "Enjoy building a more robust and flexible ``ClientApp`` with mods!"
 msgstr "使用 mods 构建更强大、更灵活的 \"客户端应用程序\"！"
 
+#: ../../source/how-to-use-cli-json-output.rst:2
+msgid "Use CLI JSON output"
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:4
+msgid ""
+"The `Flower CLIs <ref-api-cli.html>`_ come with a built-in JSON output "
+"mode. This mode is useful when you want to consume the output of a Flower"
+" CLI programmatically. For example, you might want to use the output of "
+"the ``flwr`` CLI in a script or a continuous integration pipeline."
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:11
+msgid ""
+"The JSON output mode is currently only available when using the Flower "
+"CLIs with a `SuperLink <ref-api-cli.html#flower-superlink>`_. Learn more "
+"about the `SuperLink` in the `Flower Architecture Overview <explanation-"
+"flower-architecture.html>`_ page."
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:15
+msgid ""
+"In this guide, we'll show you how to specify a JSON output with the "
+"``flwr run``, ``flwr ls``, and ``flwr stop`` commands. We will also "
+"provide examples of the JSON output for each of these commands."
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:32
+msgid "``flwr run`` JSON output"
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:34
+msgid ""
+"The |flwr_run|_ command runs a Flower app from a provided directory. Note"
+" that if the app path argument is not passed to ``flwr run``, the current"
+" working directory is used as the default Flower app directory. By "
+"default, executing the ``flwr run`` command prints the status of the app "
+"build and run process as follows:"
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:47
+msgid ""
+"To get the output in JSON format, pass an additional ``--format json`` "
+"flag:"
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:62
+#, fuzzy
+msgid "The JSON output for ``flwr run`` contains the following fields:"
+msgstr "创建包含以下更改的拉取请求："
+
+#: ../../source/how-to-use-cli-json-output.rst:64
+msgid "``success``: A boolean indicating whether the command was successful."
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:65
+msgid "``run-id``: The ID of the run."
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:66
+#, fuzzy
+msgid "``fab-id``: The ID of the Flower app."
+msgstr "基础镜像的存储库名称。"
+
+#: ../../source/how-to-use-cli-json-output.rst:67
+#, fuzzy
+msgid "``fab-name``: The name of the Flower app."
+msgstr "基础镜像的存储库名称。"
+
+#: ../../source/how-to-use-cli-json-output.rst:68
+#, fuzzy
+msgid "``fab-version``: The version of the Flower app."
+msgstr "基础镜像的存储库名称。"
+
+#: ../../source/how-to-use-cli-json-output.rst:69
+#, fuzzy
+msgid "``fab-hash``: The short hash of the Flower app."
+msgstr "基础镜像的存储库名称。"
+
+#: ../../source/how-to-use-cli-json-output.rst:70
+#, fuzzy
+msgid "``fab-filename``: The filename of the Flower app."
+msgstr "基础镜像的存储库名称。"
+
+#: ../../source/how-to-use-cli-json-output.rst:72
+msgid ""
+"If the command fails, the JSON output will contain two fields, "
+"``success`` with the value of ``false`` and ``error-message``. For "
+"example, if the command fails to find the name of the federation on the "
+"SuperLink, the output will look like this:"
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:87
+msgid "``flwr ls`` JSON output"
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:89
+msgid ""
+"The |flwr_ls|_ command lists all the runs in the current project. Similar"
+" to ``flwr run``, if the app path argument is not passed to ``flwr ls``, "
+"the current working directory is used as the Flower app directory. By "
+"default, the command list the details of all runs in a Flower federation "
+"in a tabular format:"
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:110
+#: ../../source/how-to-use-cli-json-output.rst:181
+msgid "To get the output in JSON format, simply pass the ``--format json`` flag:"
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:145
+msgid ""
+"The JSON output for ``flwr ls`` contains similar fields as ``flwr run`` "
+"with the addition of the ``status``, ``elapsed``, ``created-at``, "
+"``running-at``, and ``finished-at`` fields. The ``runs`` key contains a "
+"list of dictionaries, each representing a run. The additional fields are:"
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:150
+msgid ""
+"``status``: The status of the run, either pending, starting, running, or "
+"finished."
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:151
+msgid ""
+"``elapsed``: The time elapsed since the run started, formatted as "
+"``HH:MM:SS``."
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:152
+msgid "``created-at``: The time the run was created."
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:153
+msgid "``running-at``: The time the run started running."
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:154
+msgid "``finished-at``: The time the run finished."
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:156
+msgid ""
+"All timestamps adhere to ISO 8601, UTC and are formatted as ``YYYY-MM-DD "
+"HH:MM:SSZ``."
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:158
+msgid ""
+"You can also use the ``--run-id`` flag to list the details for one run. "
+"In this case, the JSON output will have the same structure as above with "
+"only one entry in the ``runs`` key. For more details of this command, see"
+" the |flwr_ls|_ documentation. If the command fails, the JSON output will"
+" return two fields, ``success`` and ``error-message``, as shown in "
+":ref:`the above example <json_error_output>`. Note that the content of "
+"the error message will be different depending on the error that occurred."
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:166
+msgid "``flwr stop`` JSON output"
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:168
+msgid ""
+"The |flwr_stop|_ command stops a running Flower app for a provided run "
+"ID. Similar to ``flwr run``, if the app path argument is not passed to "
+"``flwr stop``, the current working directory is used as the Flower app "
+"directory. By default, the command prints the status of the stop process "
+"as follows:"
+msgstr ""
+
+#: ../../source/how-to-use-cli-json-output.rst:191
+msgid ""
+"If the command fails, the JSON output will contain two fields ``success``"
+" with the value of ``false`` and ``error-message``, as shown in :ref:`the"
+" above example <json_error_output>`. Note that the content of the error "
+"message will be different depending on the error that occurred."
+msgstr ""
+
 #: ../../source/how-to-use-differential-privacy.rst:2
 #, fuzzy
 msgid "Use Differential Privacy"
@@ -8768,7 +8948,7 @@ msgstr "快速入门教程"
 msgid "How-to guides"
 msgstr "操作指南"
 
-#: ../../source/index.rst:108 ../../source/index.rst:113
+#: ../../source/index.rst:109 ../../source/index.rst:114
 msgid "Explanations"
 msgstr "说明"
 
@@ -8776,23 +8956,23 @@ msgstr "说明"
 msgid "API reference"
 msgstr "应用程序接口参考"
 
-#: ../../source/index.rst:139
+#: ../../source/index.rst:140
 msgid "Reference docs"
 msgstr "参考文档"
 
-#: ../../source/index.rst:154
+#: ../../source/index.rst:155
 msgid "Contributor tutorials"
 msgstr "贡献者教程"
 
-#: ../../source/index.rst:161
+#: ../../source/index.rst:162
 msgid "Contributor how-to guides"
 msgstr "投稿指南"
 
-#: ../../source/index.rst:173
+#: ../../source/index.rst:174
 msgid "Contributor explanations"
 msgstr "贡献者解释"
 
-#: ../../source/index.rst:179
+#: ../../source/index.rst:180
 msgid "Contributor references"
 msgstr "贡献者参考资料"
 
@@ -8889,35 +9069,35 @@ msgid ""
 "specific goal."
 msgstr "以问题为导向的 \"如何做 \"指南逐步展示如何实现特定目标。"
 
-#: ../../source/index.rst:110
+#: ../../source/index.rst:111
 msgid ""
 "Understanding-oriented concept guides explain and discuss key topics and "
 "underlying ideas behind Flower and collaborative AI."
 msgstr "以理解为导向的概念指南解释并讨论了Flower和协作式人工智能背后的关键主题和基本思想。"
 
-#: ../../source/index.rst:122
+#: ../../source/index.rst:123
 msgid "References"
 msgstr "参考资料"
 
-#: ../../source/index.rst:124
+#: ../../source/index.rst:125
 msgid "Information-oriented API reference and other reference material."
 msgstr "以信息为导向的 API 参考资料和其他参考资料。"
 
-#: ../../source/index.rst:133:<autosummary>:1
+#: ../../source/index.rst:134:<autosummary>:1
 #, fuzzy
 msgid ":py:obj:`flwr <flwr>`\\"
 msgstr ":py:obj:`flwr <flwr>`\\"
 
-#: ../../source/index.rst:133:<autosummary>:1 flwr:1 of
+#: ../../source/index.rst:134:<autosummary>:1 flwr:1 of
 #, fuzzy
 msgid "Flower main package."
 msgstr "Flower 主包装。"
 
-#: ../../source/index.rst:149
+#: ../../source/index.rst:150
 msgid "Contributor docs"
 msgstr "贡献者文档"
 
-#: ../../source/index.rst:151
+#: ../../source/index.rst:152
 msgid ""
 "The Flower community welcomes contributions. The following docs are "
 "intended to help along the way."
@@ -9043,7 +9223,7 @@ msgstr ""
 msgid "Flag to stream or print logs from the Flower run"
 msgstr ""
 
-#: ../../flwr log ls run
+#: ../../flwr log ls run stop
 #, fuzzy
 msgid "default"
 msgstr "工作流程"
@@ -9085,7 +9265,54 @@ msgid "Name of the federation to login into."
 msgstr ""
 
 #: ../../flwr ls:1
-msgid "List runs."
+msgid ""
+"List the details of one provided run ID or all runs in a Flower "
+"federation."
+msgstr ""
+
+#: ../../flwr ls:1
+msgid "The following details are displayed:"
+msgstr ""
+
+#: ../../flwr ls:1
+#, fuzzy
+msgid "**Run ID:** Unique identifier for the run."
+msgstr "当前运行的标识符。"
+
+#: ../../flwr ls:1
+msgid ""
+"**FAB:** Name of the FAB associated with the run (``{FAB_ID} "
+"(v{FAB_VERSION})``)."
+msgstr ""
+
+#: ../../flwr ls:1
+msgid ""
+"**Status:** Current status of the run (pending, starting, running, "
+"finished)."
+msgstr ""
+
+#: ../../flwr ls:1
+msgid "**Elapsed:** Time elapsed since the run started (``HH:MM:SS``)."
+msgstr ""
+
+#: ../../flwr ls:1
+#, fuzzy
+msgid "**Created At:** Timestamp when the run was created."
+msgstr "创建信息时的 Unix 时间戳。"
+
+#: ../../flwr ls:1
+#, fuzzy
+msgid "**Running At:** Timestamp when the run started running."
+msgstr "创建信息时的 Unix 时间戳。"
+
+#: ../../flwr ls:1
+msgid "**Finished At:** Timestamp when the run finished."
+msgstr ""
+
+#: ../../flwr ls:1
+msgid ""
+"All timestamps follow ISO 8601, UTC and are formatted as ``YYYY-MM-DD "
+"HH:MM:SSZ``."
 msgstr ""
 
 #: ../../flwr ls:1
@@ -9101,11 +9328,11 @@ msgstr "``FLWR_VERSION``"
 msgid "Specific run ID to display"
 msgstr ""
 
-#: ../../flwr ls:1 run:1
+#: ../../flwr ls:1 run:1 stop:1
 msgid "Format output using 'default' view or 'json'"
 msgstr ""
 
-#: ../../flwr ls:1 run:1
+#: ../../flwr ls:1 run:1 stop:1
 #, fuzzy
 msgid "``'default'``"
 msgstr "工作流程"
@@ -9476,131 +9703,60 @@ msgstr "Bases: :py:class:`~abc.ABC`"
 msgid "Methods"
 msgstr "方法"
 
-#: ../../source/ref-api/flwr.client.Client.rst:44:<autosummary>:1
+#: flwr.client.client.Client.evaluate:1:<autosummary>:1 of
 #, fuzzy
 msgid ":py:obj:`evaluate <flwr.client.Client.evaluate>`\\ \\(ins\\)"
 msgstr ":py:obj:`evaluate <flwr.client.Client.evaluate>`\\ \\(ins\\)"
 
-#: ../../source/ref-api/flwr.client.Client.rst:44:<autosummary>:1
-#: ../../source/ref-api/flwr.client.NumPyClient.rst:44:<autosummary>:1
 #: flwr.client.client.Client.evaluate:1
-#: flwr.client.numpy_client.NumPyClient.evaluate:1 of
+#: flwr.client.client.Client.evaluate:1:<autosummary>:1
+#: flwr.client.numpy_client.NumPyClient.evaluate:1
+#: flwr.client.numpy_client.NumPyClient.evaluate:1:<autosummary>:1 of
 msgid "Evaluate the provided parameters using the locally held dataset."
 msgstr "使用本地数据集评估所提供的参数。"
 
-#: ../../source/ref-api/flwr.client.Client.rst:44:<autosummary>:1
+#: flwr.client.client.Client.evaluate:1:<autosummary>:1 of
 #, fuzzy
 msgid ":py:obj:`fit <flwr.client.Client.fit>`\\ \\(ins\\)"
 msgstr ":py:obj:`fit <flwr.client.Client.fit>`\\ \\(ins\\)"
 
-#: ../../source/ref-api/flwr.client.Client.rst:44:<autosummary>:1
+#: flwr.client.client.Client.evaluate:1:<autosummary>:1
 #: flwr.client.client.Client.fit:1 of
 msgid "Refine the provided parameters using the locally held dataset."
 msgstr "利用本地数据集完善所提供的参数。"
 
-#: ../../source/ref-api/flwr.client.Client.rst:44:<autosummary>:1
-#, fuzzy
-msgid ":py:obj:`get_context <flwr.client.Client.get_context>`\\ \\(\\)"
-msgstr ":py:obj:`get_context <flwr.client.Client.get_context>`\\ \\(\\)"
-
-#: ../../source/ref-api/flwr.client.Client.rst:44:<autosummary>:1
-#: ../../source/ref-api/flwr.client.NumPyClient.rst:44:<autosummary>:1
-#: flwr.client.client.Client.get_context:1
-#: flwr.client.numpy_client.NumPyClient.get_context:1 of
-#, fuzzy
-msgid "Get the run context from this client."
-msgstr "评估客户端的反应。"
-
-#: ../../source/ref-api/flwr.client.Client.rst:44:<autosummary>:1
+#: flwr.client.client.Client.evaluate:1:<autosummary>:1 of
 #, fuzzy
 msgid ":py:obj:`get_parameters <flwr.client.Client.get_parameters>`\\ \\(ins\\)"
 msgstr ":py:obj:`get_parameters <flwr.client.Client.get_parameters>`\\ \\(ins\\)"
 
-#: ../../source/ref-api/flwr.client.Client.rst:44:<autosummary>:1
-#: ../../source/ref-api/flwr.client.NumPyClient.rst:44:<autosummary>:1
+#: flwr.client.client.Client.evaluate:1:<autosummary>:1
 #: flwr.client.client.Client.get_parameters:1
+#: flwr.client.numpy_client.NumPyClient.evaluate:1:<autosummary>:1
 #: flwr.client.numpy_client.NumPyClient.get_parameters:1 of
 msgid "Return the current local model parameters."
 msgstr "返回当前本地模型参数。"
 
-#: ../../source/ref-api/flwr.client.Client.rst:44:<autosummary>:1
+#: flwr.client.client.Client.evaluate:1:<autosummary>:1 of
 #, fuzzy
 msgid ":py:obj:`get_properties <flwr.client.Client.get_properties>`\\ \\(ins\\)"
 msgstr ":py:obj:`get_properties <flwr.client.Client.get_properties>`\\ \\(ins\\)"
 
-#: ../../source/ref-api/flwr.client.Client.rst:44:<autosummary>:1
+#: flwr.client.client.Client.evaluate:1:<autosummary>:1
 #: flwr.client.client.Client.get_properties:1 of
 msgid "Return set of client's properties."
 msgstr "返回客户端的属性集。"
 
-#: ../../source/ref-api/flwr.client.Client.rst:44:<autosummary>:1
-#, fuzzy
-msgid ":py:obj:`set_context <flwr.client.Client.set_context>`\\ \\(context\\)"
-msgstr ":py:obj:`set_context <flwr.client.Client.set_context>`\\ \\(context\\)"
-
-#: ../../source/ref-api/flwr.client.Client.rst:44:<autosummary>:1
-#: ../../source/ref-api/flwr.client.NumPyClient.rst:44:<autosummary>:1
-#: flwr.client.client.Client.set_context:1
-#: flwr.client.numpy_client.NumPyClient.set_context:1 of
-#, fuzzy
-msgid "Apply a run context to this client."
-msgstr "将运行上下文应用于该客户端。"
-
-#: ../../source/ref-api/flwr.client.Client.rst:44:<autosummary>:1
+#: flwr.client.client.Client.evaluate:1:<autosummary>:1 of
 #, fuzzy
 msgid ":py:obj:`to_client <flwr.client.Client.to_client>`\\ \\(\\)"
 msgstr ":py:obj:`to_client <flwr.client.Client.to_client>`\\ \\(\\)"
 
-#: ../../source/ref-api/flwr.client.Client.rst:44:<autosummary>:1
+#: flwr.client.client.Client.evaluate:1:<autosummary>:1
 #: flwr.client.client.Client.to_client:1 of
 msgid "Return client (itself)."
 msgstr "返回客户端（本身）。"
 
-#: ../../source/ref-api/flwr.client.Client.rst:46
-#: ../../source/ref-api/flwr.client.NumPyClient.rst:46
-#: ../../source/ref-api/flwr.common.Array.rst:28
-#: ../../source/ref-api/flwr.common.ClientMessage.rst:25
-#: ../../source/ref-api/flwr.common.Code.rst:19
-#: ../../source/ref-api/flwr.common.Context.rst:25
-#: ../../source/ref-api/flwr.common.DisconnectRes.rst:25
-#: ../../source/ref-api/flwr.common.Error.rst:25
-#: ../../source/ref-api/flwr.common.EvaluateIns.rst:25
-#: ../../source/ref-api/flwr.common.EvaluateRes.rst:25
-#: ../../source/ref-api/flwr.common.EventType.rst:165
-#: ../../source/ref-api/flwr.common.FitIns.rst:25
-#: ../../source/ref-api/flwr.common.FitRes.rst:25
-#: ../../source/ref-api/flwr.common.GetParametersIns.rst:25
-#: ../../source/ref-api/flwr.common.GetParametersRes.rst:25
-#: ../../source/ref-api/flwr.common.GetPropertiesIns.rst:25
-#: ../../source/ref-api/flwr.common.GetPropertiesRes.rst:25
-#: ../../source/ref-api/flwr.common.Message.rst:37
-#: ../../source/ref-api/flwr.common.MessageType.rst:25
-#: ../../source/ref-api/flwr.common.MessageTypeLegacy.rst:25
-#: ../../source/ref-api/flwr.common.Metadata.rst:25
-#: ../../source/ref-api/flwr.common.Parameters.rst:25
-#: ../../source/ref-api/flwr.common.ReconnectIns.rst:25
-#: ../../source/ref-api/flwr.common.RecordSet.rst:25
-#: ../../source/ref-api/flwr.common.ServerMessage.rst:25
-#: ../../source/ref-api/flwr.common.Status.rst:25
-#: ../../source/ref-api/flwr.server.Driver.rst:43
-#: ../../source/ref-api/flwr.server.LegacyContext.rst:25
-#: ../../source/ref-api/flwr.server.ServerAppComponents.rst:25
-#: ../../source/ref-api/flwr.server.ServerConfig.rst:25
-#, fuzzy
-msgid "Attributes"
-msgstr "属性"
-
-#: flwr.client.Client.context:1:<autosummary>:1 of
-#, fuzzy
-msgid ":py:obj:`context <flwr.client.Client.context>`\\"
-msgstr ":py:obj:`context <flwr.client.Client.context>`\\"
-
-#: flwr.client.Client.context:1 flwr.client.Client.context:1:<autosummary>:1
-#: flwr.client.NumPyClient.context:1
-#: flwr.client.NumPyClient.context:1:<autosummary>:1 of
-msgid "Getter for `Context` client attribute."
-msgstr ""
-
 #: ../../source/ref-api/flwr.common.Parameters.rst:2
 #: flwr.client.app.start_client flwr.client.app.start_numpy_client
 #: flwr.client.client.Client.evaluate flwr.client.client.Client.fit
@@ -9862,7 +10018,7 @@ msgstr "返回一个装饰器，用于在客户端应用程序中注册火车 fn
 msgid "NumPyClient"
 msgstr "NumPyClient"
 
-#: ../../source/ref-api/flwr.client.NumPyClient.rst:44:<autosummary>:1
+#: flwr.client.numpy_client.NumPyClient.evaluate:1:<autosummary>:1 of
 #, fuzzy
 msgid ""
 ":py:obj:`evaluate <flwr.client.NumPyClient.evaluate>`\\ \\(parameters\\, "
@@ -9871,22 +10027,17 @@ msgstr ""
 ":py:obj:`evaluate <flwr.client.NumPyClient.evaluate>`\\ \\(parameters\\, "
 "config\\)"
 
-#: ../../source/ref-api/flwr.client.NumPyClient.rst:44:<autosummary>:1
+#: flwr.client.numpy_client.NumPyClient.evaluate:1:<autosummary>:1 of
 #, fuzzy
 msgid ":py:obj:`fit <flwr.client.NumPyClient.fit>`\\ \\(parameters\\, config\\)"
 msgstr ":py:obj:`fit <flwr.client.NumPyClient.fit>`\\ \\(parameters\\, config\\)"
 
-#: ../../source/ref-api/flwr.client.NumPyClient.rst:44:<autosummary>:1
+#: flwr.client.numpy_client.NumPyClient.evaluate:1:<autosummary>:1
 #: flwr.client.numpy_client.NumPyClient.fit:1 of
 msgid "Train the provided parameters using the locally held dataset."
 msgstr "使用本地数据集训练所提供的参数。"
 
-#: ../../source/ref-api/flwr.client.NumPyClient.rst:44:<autosummary>:1
-#, fuzzy
-msgid ":py:obj:`get_context <flwr.client.NumPyClient.get_context>`\\ \\(\\)"
-msgstr ":py:obj:`get_context <flwr.client.NumPyClient.get_context>`\\ \\(\\)"
-
-#: ../../source/ref-api/flwr.client.NumPyClient.rst:44:<autosummary>:1
+#: flwr.client.numpy_client.NumPyClient.evaluate:1:<autosummary>:1 of
 #, fuzzy
 msgid ""
 ":py:obj:`get_parameters <flwr.client.NumPyClient.get_parameters>`\\ "
@@ -9895,7 +10046,7 @@ msgstr ""
 ":py:obj:`get_parameters <flwr.client.NumPyClient.get_parameters>`\\ "
 "\\(config\\)"
 
-#: ../../source/ref-api/flwr.client.NumPyClient.rst:44:<autosummary>:1
+#: flwr.client.numpy_client.NumPyClient.evaluate:1:<autosummary>:1 of
 #, fuzzy
 msgid ""
 ":py:obj:`get_properties <flwr.client.NumPyClient.get_properties>`\\ "
@@ -9904,35 +10055,21 @@ msgstr ""
 ":py:obj:`get_properties <flwr.client.NumPyClient.get_properties>`\\ "
 "\\(config\\)"
 
-#: ../../source/ref-api/flwr.client.NumPyClient.rst:44:<autosummary>:1
+#: flwr.client.numpy_client.NumPyClient.evaluate:1:<autosummary>:1
 #: flwr.client.numpy_client.NumPyClient.get_properties:1 of
 msgid "Return a client's set of properties."
 msgstr "返回客户端的属性集。"
 
-#: ../../source/ref-api/flwr.client.NumPyClient.rst:44:<autosummary>:1
-#, fuzzy
-msgid ""
-":py:obj:`set_context <flwr.client.NumPyClient.set_context>`\\ "
-"\\(context\\)"
-msgstr ""
-":py:obj:`set_context <flwr.client.NumPyClient.set_context>`\\ "
-"\\(context\\)"
-
-#: ../../source/ref-api/flwr.client.NumPyClient.rst:44:<autosummary>:1
+#: flwr.client.numpy_client.NumPyClient.evaluate:1:<autosummary>:1 of
 #, fuzzy
 msgid ":py:obj:`to_client <flwr.client.NumPyClient.to_client>`\\ \\(\\)"
 msgstr ":py:obj:`to_client <flwr.client.NumPyClient.to_client>`\\ \\(\\)"
 
-#: ../../source/ref-api/flwr.client.NumPyClient.rst:44:<autosummary>:1
+#: flwr.client.numpy_client.NumPyClient.evaluate:1:<autosummary>:1
 #: flwr.client.numpy_client.NumPyClient.to_client:1 of
 msgid "Convert to object to Client type and return it."
 msgstr "将对象转换为客户类型并返回。"
 
-#: flwr.client.NumPyClient.context:1:<autosummary>:1 of
-#, fuzzy
-msgid ":py:obj:`context <flwr.client.NumPyClient.context>`\\"
-msgstr ":py:obj:`context <flwr.client.NumPyClient.context>`\\"
-
 #: flwr.client.numpy_client.NumPyClient.evaluate:3
 #: flwr.client.numpy_client.NumPyClient.fit:3
 #: flwr.server.strategy.dpfedavg_fixed.DPFedAvgFixed.configure_evaluate:5
@@ -10995,6 +11132,38 @@ msgstr "server.strategy.Strategy"
 msgid "Return the array as a NumPy array."
 msgstr "以 NumPy ndarrays 列表形式返回模型参数"
 
+#: ../../source/ref-api/flwr.common.Array.rst:28
+#: ../../source/ref-api/flwr.common.ClientMessage.rst:25
+#: ../../source/ref-api/flwr.common.Code.rst:19
+#: ../../source/ref-api/flwr.common.Context.rst:25
+#: ../../source/ref-api/flwr.common.DisconnectRes.rst:25
+#: ../../source/ref-api/flwr.common.Error.rst:25
+#: ../../source/ref-api/flwr.common.EvaluateIns.rst:25
+#: ../../source/ref-api/flwr.common.EvaluateRes.rst:25
+#: ../../source/ref-api/flwr.common.EventType.rst:165
+#: ../../source/ref-api/flwr.common.FitIns.rst:25
+#: ../../source/ref-api/flwr.common.FitRes.rst:25
+#: ../../source/ref-api/flwr.common.GetParametersIns.rst:25
+#: ../../source/ref-api/flwr.common.GetParametersRes.rst:25
+#: ../../source/ref-api/flwr.common.GetPropertiesIns.rst:25
+#: ../../source/ref-api/flwr.common.GetPropertiesRes.rst:25
+#: ../../source/ref-api/flwr.common.Message.rst:37
+#: ../../source/ref-api/flwr.common.MessageType.rst:25
+#: ../../source/ref-api/flwr.common.MessageTypeLegacy.rst:25
+#: ../../source/ref-api/flwr.common.Metadata.rst:25
+#: ../../source/ref-api/flwr.common.Parameters.rst:25
+#: ../../source/ref-api/flwr.common.ReconnectIns.rst:25
+#: ../../source/ref-api/flwr.common.RecordSet.rst:25
+#: ../../source/ref-api/flwr.common.ServerMessage.rst:25
+#: ../../source/ref-api/flwr.common.Status.rst:25
+#: ../../source/ref-api/flwr.server.Driver.rst:43
+#: ../../source/ref-api/flwr.server.LegacyContext.rst:25
+#: ../../source/ref-api/flwr.server.ServerAppComponents.rst:25
+#: ../../source/ref-api/flwr.server.ServerConfig.rst:25
+#, fuzzy
+msgid "Attributes"
+msgstr "属性"
+
 #: flwr.common.record.parametersrecord.Array.numpy:1:<autosummary>:1 of
 #, fuzzy
 msgid ":py:obj:`dtype <flwr.common.Array.dtype>`\\"
@@ -30131,7 +30300,7 @@ msgid ""
 msgstr "在机器学习中，我们有一个模型和数据。模型可以是一个神经网络（如图所示），也可以是其他东西，比如经典的线性回归。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:41
-msgid "|ae2337ba61dd4efc818e63933fd81666|"
+msgid "|31d9fb7c284a414ba34e32ced3b17b11|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:109
@@ -30146,7 +30315,7 @@ msgid ""
 msgstr "我们使用数据来训练模型，以完成一项有用的任务。任务可以是检测图像中的物体、转录音频或玩围棋等游戏。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:53
-msgid "|14a8d3feda794591a601daaaaa79d0b6|"
+msgid "|32af43ffb54a421d8cfe59939c34206b|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:111
@@ -30170,7 +30339,7 @@ msgid ""
 msgstr "它源于智能手机上用户与应用程序的交互、汽车上传感器数据的收集、笔记本电脑上键盘输入的接收，或者智能扬声器上某人试着唱的歌。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:67
-msgid "|c67497f1afa84a30a3901418c6c0bb62|"
+msgid "|34c462a3cde341389422badb2077fc36|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:113
@@ -30188,7 +30357,7 @@ msgstr ""
 "\"通常不只是一个地方，而是很多地方。它可能是多个运行同一应用程序的设备。但也可能是多个组织，都在为同一任务生成数据。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:79
-msgid "|d4ce55da082146d7ad13ec4f73d427a2|"
+msgid "|3a2ded531a9a4b86af3e743490e78172|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:115
@@ -30205,7 +30374,7 @@ msgid ""
 msgstr "因此，要使用机器学习或任何类型的数据分析，过去使用的方法是在中央服务器上收集所有数据。这个服务器可以在数据中心的某个地方，也可以在云端的某个地方。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:91
-msgid "|0a0c4ca9de6549c1b35225c6e1183bc0|"
+msgid "|52e91c4927884d7293956a379489d8c3|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:117
@@ -30220,7 +30389,7 @@ msgid ""
 msgstr "一旦所有数据都收集到一处，我们最终就可以使用机器学习算法在数据上训练我们的模型。这就是我们基本上一直依赖的机器学习方法。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:103
-msgid "|f2f5e8cc5594472c842192ec38ab9bbe|"
+msgid "|2bb7af14de844e40bd4186c902800ff5|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:119
@@ -30241,7 +30410,7 @@ msgid ""
 msgstr "我们刚刚看到的经典机器学习方法可以在某些情况下使用。很好的例子包括对假日照片进行分类或分析网络流量。在这些案例中，所有数据自然都可以在中央服务器上获得。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:138
-msgid "|4e7b0cd854064aab9895573a612a0f06|"
+msgid "|c7538d5f23f142e693a8879fb03e3932|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:173
@@ -30256,7 +30425,7 @@ msgid ""
 msgstr "但这种方法并不适用于许多其他情况。例如，集中服务器上没有数据，或者一台服务器上的数据不足以训练出一个好的模型。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:150
-msgid "|e121faa35b114a0da17cf4bc42e74ce9|"
+msgid "|44f9182037b141868306b5c7d2d7bdf6|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:175
@@ -30416,7 +30585,7 @@ msgid ""
 msgstr "我们首先在服务器上初始化模型。这与经典的集中式学习完全相同：我们随机或从先前保存的检查点初始化模型参数。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:210
-msgid "|e7a57a83812c4dc8933fbb93cd0e46dc|"
+msgid "|e198f643aecc4cd58ca665e6979b5bb3|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:307
@@ -30441,7 +30610,7 @@ msgid ""
 msgstr "接下来，我们会将全局模型的参数发送到连接的客户端节点（如智能手机等边缘设备或企业的服务器）。这是为了确保每个参与节点都使用相同的模型参数开始本地训练。我们通常只使用几个连接节点，而不是所有节点。这样做的原因是，选择越来越多的客户端节点会导致收益递减。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:225
-msgid "|a0283fe3cd0c4f3cb5d119f424c657fd|"
+msgid "|3e52791d62db46e0b0485e4f05a71070|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:309
@@ -30467,7 +30636,7 @@ msgstr ""
 "（mini-batches）。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:240
-msgid "|debbe320f2c741388902ebabfb6fc705|"
+msgid "|eeb43ec811934701963187e3822826ae|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:311
@@ -30490,7 +30659,7 @@ msgid ""
 msgstr "经过本地训练后，每个客户节点最初收到的模型参数都会略有不同。参数之所以不同，是因为每个客户端节点的本地数据集中都有不同的数据。然后，客户端节点将这些模型更新发回服务器。它们发送的模型更新既可以是完整的模型参数，也可以只是本地训练过程中积累的梯度。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:255
-msgid "|8be6ce669d3148f9af6272ca27a98197|"
+msgid "|b1642f82fc774ff3a1f7b2f077844291|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:313
@@ -30537,7 +30706,7 @@ msgstr ""
 " 100 个示例的 10 倍。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:273
-msgid "|47c4a06eafbb4e2fa1c62b5ca47d3411|"
+msgid "|17ab6ee928b54a02afcac8d896a3a637|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:315
@@ -30645,7 +30814,7 @@ msgstr ""
 "为联邦学习、分析和评估提供了一种统一的方法。它允许用户联邦化任何工作负载、任何 ML 框架和任何编程语言。"
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:334
-msgid "|5e84b181879b4bcda37b672215325b30|"
+msgid "|1bd7ba9475d44bdbb4d4a4a40d3e2267|"
 msgstr ""
 
 #: ../../source/tutorial-series-what-is-federated-learning.ipynb:340
@@ -38276,3 +38445,113 @@ msgstr ""
 #~ msgid "|e4adf0f92ebf4c3d9e6e64355204f897|"
 #~ msgstr ""
 
+#~ msgid ""
+#~ "There are many ways to deploy "
+#~ "Flower on Microst Azure. The "
+#~ "instructions provided in this guide is"
+#~ " just a basic walkthrough, step-"
+#~ "by-step guide on how to quickly "
+#~ "setup and run a Flower application "
+#~ "on a Federated Learning environment on"
+#~ " Microst Azure."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "In this how-to guide, we want "
+#~ "to create a Federated Learning "
+#~ "environment on Microst Azure using three"
+#~ " Virtual Machines (VMs). From the "
+#~ "three machines, one machine will be "
+#~ "used as the Federation server and "
+#~ "two as the Federation clients. Our "
+#~ "goal is to create a Flower "
+#~ "federation on Microst Azure where we "
+#~ "can run Flower apps from our local"
+#~ " machine, e.g., laptop."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "Assuming we are already inside the "
+#~ "Microst Azure portal, we navigate to "
+#~ "the ``Create`` page and we select "
+#~ "``Azure virtual machine``. In the new"
+#~ " page, for each VM we edit the"
+#~ " properties as follows:"
+#~ msgstr ""
+
+#~ msgid "List runs."
+#~ msgstr ""
+
+#~ msgid ":py:obj:`get_context <flwr.client.Client.get_context>`\\ \\(\\)"
+#~ msgstr ":py:obj:`get_context <flwr.client.Client.get_context>`\\ \\(\\)"
+
+#~ msgid "Get the run context from this client."
+#~ msgstr "评估客户端的反应。"
+
+#~ msgid ":py:obj:`set_context <flwr.client.Client.set_context>`\\ \\(context\\)"
+#~ msgstr ":py:obj:`set_context <flwr.client.Client.set_context>`\\ \\(context\\)"
+
+#~ msgid "Apply a run context to this client."
+#~ msgstr "将运行上下文应用于该客户端。"
+
+#~ msgid ":py:obj:`context <flwr.client.Client.context>`\\"
+#~ msgstr ":py:obj:`context <flwr.client.Client.context>`\\"
+
+#~ msgid "Getter for `Context` client attribute."
+#~ msgstr ""
+
+#~ msgid ":py:obj:`get_context <flwr.client.NumPyClient.get_context>`\\ \\(\\)"
+#~ msgstr ":py:obj:`get_context <flwr.client.NumPyClient.get_context>`\\ \\(\\)"
+
+#~ msgid ""
+#~ ":py:obj:`set_context <flwr.client.NumPyClient.set_context>`\\"
+#~ " \\(context\\)"
+#~ msgstr ""
+#~ ":py:obj:`set_context <flwr.client.NumPyClient.set_context>`\\"
+#~ " \\(context\\)"
+
+#~ msgid ":py:obj:`context <flwr.client.NumPyClient.context>`\\"
+#~ msgstr ":py:obj:`context <flwr.client.NumPyClient.context>`\\"
+
+#~ msgid "|ae2337ba61dd4efc818e63933fd81666|"
+#~ msgstr ""
+
+#~ msgid "|14a8d3feda794591a601daaaaa79d0b6|"
+#~ msgstr ""
+
+#~ msgid "|c67497f1afa84a30a3901418c6c0bb62|"
+#~ msgstr ""
+
+#~ msgid "|d4ce55da082146d7ad13ec4f73d427a2|"
+#~ msgstr ""
+
+#~ msgid "|0a0c4ca9de6549c1b35225c6e1183bc0|"
+#~ msgstr ""
+
+#~ msgid "|f2f5e8cc5594472c842192ec38ab9bbe|"
+#~ msgstr ""
+
+#~ msgid "|4e7b0cd854064aab9895573a612a0f06|"
+#~ msgstr ""
+
+#~ msgid "|e121faa35b114a0da17cf4bc42e74ce9|"
+#~ msgstr ""
+
+#~ msgid "|e7a57a83812c4dc8933fbb93cd0e46dc|"
+#~ msgstr ""
+
+#~ msgid "|a0283fe3cd0c4f3cb5d119f424c657fd|"
+#~ msgstr ""
+
+#~ msgid "|debbe320f2c741388902ebabfb6fc705|"
+#~ msgstr ""
+
+#~ msgid "|8be6ce669d3148f9af6272ca27a98197|"
+#~ msgstr ""
+
+#~ msgid "|47c4a06eafbb4e2fa1c62b5ca47d3411|"
+#~ msgstr ""
+
+#~ msgid "|5e84b181879b4bcda37b672215325b30|"
+#~ msgstr ""
+

From eac7696bf8c9ce9aec650f4326423cd4343ba02b Mon Sep 17 00:00:00 2001
From: Chong Shen Ng <chong.shen@flower.ai>
Date: Wed, 18 Dec 2024 10:49:38 +0000
Subject: [PATCH 100/104] fix(examples) Update `flwr` version for XGBoost
 quickstart example and add `libomp` command for MacOSX (#4740)

---
 examples/xgboost-quickstart/README.md      | 3 +++
 examples/xgboost-quickstart/pyproject.toml | 4 ++--
 2 files changed, 5 insertions(+), 2 deletions(-)

diff --git a/examples/xgboost-quickstart/README.md b/examples/xgboost-quickstart/README.md
index a7b047c090f0..da207d2af2ef 100644
--- a/examples/xgboost-quickstart/README.md
+++ b/examples/xgboost-quickstart/README.md
@@ -46,6 +46,9 @@ Install the dependencies defined in `pyproject.toml` as well as the `xgboost_qui
 pip install -e .
 ```
 
+> \[!NOTE\]
+> For MacOSX users, you may need to additionally run `brew install libomp` to install OpenMP runtime.
+
 ## Run the project
 
 You can run your Flower project in both _simulation_ and _deployment_ mode without making changes to the code. If you are starting with Flower, we recommend you using the _simulation_ mode as it requires fewer components to be launched manually. By default, `flwr run` will make use of the Simulation Engine.
diff --git a/examples/xgboost-quickstart/pyproject.toml b/examples/xgboost-quickstart/pyproject.toml
index 3bfedb6b1d58..e904e7833447 100644
--- a/examples/xgboost-quickstart/pyproject.toml
+++ b/examples/xgboost-quickstart/pyproject.toml
@@ -8,8 +8,8 @@ version = "1.0.0"
 description = "Federated Learning with XGBoost and Flower (Quickstart Example)"
 license = "Apache-2.0"
 dependencies = [
-    "flwr-nightly[simulation]==1.11.0.dev20240826",
-    "flwr-datasets>=0.3.0",
+    "flwr[simulation]>=1.13.1",
+    "flwr-datasets>=0.4.0",
     "xgboost>=2.0.0",
 ]
 

From 0ecf0f0975fb7006435b3dc6c912c224df3a9fe6 Mon Sep 17 00:00:00 2001
From: Adam Narozniak <51029327+adam-narozniak@users.noreply.github.com>
Date: Wed, 18 Dec 2024 12:10:22 +0100
Subject: [PATCH 101/104] refactor(framework) Update flwr version in quickstart
 hf (#4741)

---
 examples/quickstart-huggingface/pyproject.toml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/examples/quickstart-huggingface/pyproject.toml b/examples/quickstart-huggingface/pyproject.toml
index f13c48d96cae..6d4b012483d2 100644
--- a/examples/quickstart-huggingface/pyproject.toml
+++ b/examples/quickstart-huggingface/pyproject.toml
@@ -12,7 +12,7 @@ authors = [
     { name = "Kaushik Amar Das", email = "kaushik.das@iiitg.ac.in" },
 ]
 dependencies = [
-    "flwr[simulation]==1.12.0",
+    "flwr[simulation]>=1.13.1",
     "flwr-datasets>=0.3.0",
     "torch==2.4.0",
     "transformers>=4.30.0,<5.0",

From d3aea24d554e60d7241d5470cb8a2f1f69e0c606 Mon Sep 17 00:00:00 2001
From: Adam Narozniak <51029327+adam-narozniak@users.noreply.github.com>
Date: Wed, 18 Dec 2024 16:28:45 +0100
Subject: [PATCH 102/104] feat(datasets) Add missing Python classifiers (#4743)

---
 datasets/pyproject.toml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/datasets/pyproject.toml b/datasets/pyproject.toml
index 2d699c5e901b..497f89a2f7ca 100644
--- a/datasets/pyproject.toml
+++ b/datasets/pyproject.toml
@@ -34,6 +34,8 @@ classifiers = [
     "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
     "Programming Language :: Python :: Implementation :: CPython",
     "Topic :: Scientific/Engineering",
     "Topic :: Scientific/Engineering :: Artificial Intelligence",

From 35973cd86c3efe596a44ba2344e0bd3e8248def2 Mon Sep 17 00:00:00 2001
From: Adam Narozniak <51029327+adam-narozniak@users.noreply.github.com>
Date: Wed, 18 Dec 2024 16:44:36 +0100
Subject: [PATCH 103/104] feat(datasets) Update installation guide (#4731)

---
 .../source/how-to-install-flwr-datasets.rst   | 35 ++++++++++++++++---
 1 file changed, 31 insertions(+), 4 deletions(-)

diff --git a/datasets/docs/source/how-to-install-flwr-datasets.rst b/datasets/docs/source/how-to-install-flwr-datasets.rst
index 3f79daceb753..5f89261f0b29 100644
--- a/datasets/docs/source/how-to-install-flwr-datasets.rst
+++ b/datasets/docs/source/how-to-install-flwr-datasets.rst
@@ -4,7 +4,7 @@ Installation
 Python Version
 --------------
 
-Flower Datasets requires `Python 3.8 <https://docs.python.org/3.8/>`_ or above.
+Flower Datasets requires `Python 3.9 <https://docs.python.org/3.9/>`_ or above.
 
 
 Install stable release (pip)
@@ -20,14 +20,41 @@ For vision datasets (e.g. MNIST, CIFAR10) ``flwr-datasets`` should be installed
 
 .. code-block:: bash
 
-  python -m pip install flwr_datasets[vision]
+  python -m pip install "flwr-datasets[vision]"
 
 For audio datasets (e.g. Speech Command) ``flwr-datasets`` should be installed with the ``audio`` extra
 
 .. code-block:: bash
 
-  python -m pip install flwr_datasets[audio]
+  python -m pip install "flwr-datasets[audio]"
 
+Install directly from GitHub (pip)
+----------------------------------
+
+Installing Flower Datasets directly from GitHub ensures you have access to the most up-to-date version. 
+If you encounter any issues or bugs, you may be directed to a specific branch containing a fix before 
+it becomes part of an official release.
+
+.. code-block:: bash
+
+  python -m pip install "flwr-datasets@git+https://github.com/adap/flower.git"\
+  "@TYPE-HERE-BRANCH-NAME#subdirectory=datasets"
+
+Similarly to the situation before, you can specify the ``vision`` or ``audio`` extra after the name of the library.
+
+.. code-block:: bash
+
+  python -m pip install "flwr-datasets[vision]@git+https://github.com/adap/flower.git"\
+  "@TYPE-HERE-BRANCH-NAME#subdirectory=datasets"
+
+e.g. for the main branch:
+
+.. code-block:: bash
+
+  python -m pip install "flwr-datasets@git+https://github.com/adap/flower.git"\
+  "@main#subdirectory=datasets"
+
+Since `flwr-datasets` is a part of the Flower repository, the `subdirectory` parameter (at the end of the URL) is used to specify the package location in the GitHub repo.
 
 Verify installation
 -------------------
@@ -38,7 +65,7 @@ The following command can be used to verify if Flower Datasets was successfully
 
   python -c "import flwr_datasets;print(flwr_datasets.__version__)"
 
-If everything worked, it should print the version of Flower Datasets to the command line:
+If everything works, it should print the version of Flower Datasets to the command line:
 
 .. code-block:: none
 

From 0a27cc4b35d640a38106f6c52bfada57be087e5b Mon Sep 17 00:00:00 2001
From: Adam Narozniak <51029327+adam-narozniak@users.noreply.github.com>
Date: Wed, 18 Dec 2024 18:11:50 +0100
Subject: [PATCH 104/104] feat(datasets) Add VerticalSizePartitioner (#4699)

Co-authored-by: jafermarq <javier@flower.ai>
---
 .../flwr_datasets/partitioner/__init__.py     |   2 +
 .../partitioner/vertical_partitioner_utils.py | 103 ++++++
 .../vertical_partitioner_utils_test.py        | 144 ++++++++
 .../partitioner/vertical_size_partitioner.py  | 312 ++++++++++++++++++
 .../vertical_size_partitioner_test.py         | 206 ++++++++++++
 5 files changed, 767 insertions(+)
 create mode 100644 datasets/flwr_datasets/partitioner/vertical_partitioner_utils.py
 create mode 100644 datasets/flwr_datasets/partitioner/vertical_partitioner_utils_test.py
 create mode 100644 datasets/flwr_datasets/partitioner/vertical_size_partitioner.py
 create mode 100644 datasets/flwr_datasets/partitioner/vertical_size_partitioner_test.py

diff --git a/datasets/flwr_datasets/partitioner/__init__.py b/datasets/flwr_datasets/partitioner/__init__.py
index a14efa1cc905..8770d5b8b76e 100644
--- a/datasets/flwr_datasets/partitioner/__init__.py
+++ b/datasets/flwr_datasets/partitioner/__init__.py
@@ -29,6 +29,7 @@
 from .shard_partitioner import ShardPartitioner
 from .size_partitioner import SizePartitioner
 from .square_partitioner import SquarePartitioner
+from .vertical_size_partitioner import VerticalSizePartitioner
 
 __all__ = [
     "DirichletPartitioner",
@@ -45,4 +46,5 @@
     "ShardPartitioner",
     "SizePartitioner",
     "SquarePartitioner",
+    "VerticalSizePartitioner",
 ]
diff --git a/datasets/flwr_datasets/partitioner/vertical_partitioner_utils.py b/datasets/flwr_datasets/partitioner/vertical_partitioner_utils.py
new file mode 100644
index 000000000000..e9e7e3855ef4
--- /dev/null
+++ b/datasets/flwr_datasets/partitioner/vertical_partitioner_utils.py
@@ -0,0 +1,103 @@
+# Copyright 2024 Flower Labs GmbH. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# ==============================================================================
+"""VerticalPartitioner utils.py."""
+# flake8: noqa: E501
+# pylint: disable=C0301
+from typing import Any, Literal, Union
+
+
+def _list_split(lst: list[Any], num_sublists: int) -> list[list[Any]]:
+    """Split a list into n nearly equal-sized sublists.
+
+    Parameters
+    ----------
+    lst : list[Any]
+        The list to split.
+    num_sublists : int
+        Number of sublists to create.
+
+    Returns
+    -------
+    subslist: list[list[Any]]
+        A list containing num_sublists sublists.
+    """
+    if num_sublists <= 0:
+        raise ValueError("Number of splits must be greater than 0")
+    chunk_size, remainder = divmod(len(lst), num_sublists)
+    sublists = []
+    start_index = 0
+    for i in range(num_sublists):
+        end_index = start_index + chunk_size
+        if i < remainder:
+            end_index += 1
+        sublists.append(lst[start_index:end_index])
+        start_index = end_index
+    return sublists
+
+
+def _add_active_party_columns(
+    active_party_columns: list[str],
+    active_party_columns_mode: Union[
+        Literal[
+            "add_to_first",
+            "add_to_last",
+            "create_as_first",
+            "create_as_last",
+            "add_to_all",
+        ],
+        int,
+    ],
+    partition_columns: list[list[str]],
+) -> list[list[str]]:
+    """Add active party columns to the partition columns based on the mode.
+
+    Parameters
+    ----------
+    active_party_columns : list[str]
+        List of active party columns.
+    active_party_columns_mode : Union[Literal["add_to_first", "add_to_last", "create_as_first", "create_as_last", "add_to_all"], int]
+        Mode to add active party columns to partition columns.
+
+    Returns
+    -------
+    partition_columns: list[list[str]]
+        List of partition columns after the modyfication.
+    """
+    if isinstance(active_party_columns_mode, int):
+        partition_id = active_party_columns_mode
+        if partition_id < 0 or partition_id >= len(partition_columns):
+            raise ValueError(
+                f"Invalid partition index {partition_id} for active_party_columns_mode."
+                f"Must be in the range [0, {len(partition_columns) - 1}]"
+                f"but given {partition_id}"
+            )
+        for column in active_party_columns:
+            partition_columns[partition_id].append(column)
+    else:
+        if active_party_columns_mode == "add_to_first":
+            for column in active_party_columns:
+                partition_columns[0].append(column)
+        elif active_party_columns_mode == "add_to_last":
+            for column in active_party_columns:
+                partition_columns[-1].append(column)
+        elif active_party_columns_mode == "create_as_first":
+            partition_columns.insert(0, active_party_columns)
+        elif active_party_columns_mode == "create_as_last":
+            partition_columns.append(active_party_columns)
+        elif active_party_columns_mode == "add_to_all":
+            for column in active_party_columns:
+                for partition in partition_columns:
+                    partition.append(column)
+    return partition_columns
diff --git a/datasets/flwr_datasets/partitioner/vertical_partitioner_utils_test.py b/datasets/flwr_datasets/partitioner/vertical_partitioner_utils_test.py
new file mode 100644
index 000000000000..f85d027fe444
--- /dev/null
+++ b/datasets/flwr_datasets/partitioner/vertical_partitioner_utils_test.py
@@ -0,0 +1,144 @@
+# Copyright 2024 Flower Labs GmbH. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# ==============================================================================
+"""Tests for vertical partitioner utilities."""
+import unittest
+from typing import Any, Literal
+
+from flwr_datasets.partitioner.vertical_partitioner_utils import (
+    _add_active_party_columns,
+    _list_split,
+)
+
+
+class TestVerticalPartitionerUtils(unittest.TestCase):
+    """Tests for _list_split and _add_active_party_columns utilities."""
+
+    def test_list_split_basic_splitting(self) -> None:
+        """Check equal splitting with divisible lengths."""
+        lst = [1, 2, 3, 4, 5, 6]
+        result = _list_split(lst, 3)
+        expected = [[1, 2], [3, 4], [5, 6]]
+        self.assertEqual(result, expected)
+
+    def test_list_split_uneven_splitting(self) -> None:
+        """Check uneven splitting with non-divisible lengths."""
+        lst = [10, 20, 30, 40, 50]
+        result = _list_split(lst, 2)
+        expected = [[10, 20, 30], [40, 50]]
+        self.assertEqual(result, expected)
+
+    def test_list_split_single_sublist(self) -> None:
+        """Check that single sublist returns the full list."""
+        lst = [1, 2, 3]
+        result = _list_split(lst, 1)
+        expected = [[1, 2, 3]]
+        self.assertEqual(result, expected)
+
+    def test_list_split_more_sublists_than_elements(self) -> None:
+        """Check extra sublists are empty when count exceeds length."""
+        lst = [42]
+        result = _list_split(lst, 3)
+        expected = [[42], [], []]
+        self.assertEqual(result, expected)
+
+    def test_list_split_empty_list(self) -> None:
+        """Check splitting empty list produces empty sublists."""
+        lst: list[Any] = []
+        result = _list_split(lst, 3)
+        expected: list[list[Any]] = [[], [], []]
+        self.assertEqual(result, expected)
+
+    def test_list_split_invalid_num_sublists(self) -> None:
+        """Check ValueError when sublist count is zero or negative."""
+        lst = [1, 2, 3]
+        with self.assertRaises(ValueError):
+            _list_split(lst, 0)
+
+    def test_add_to_first(self) -> None:
+        """Check adding active cols to the first partition."""
+        partition_columns = [["col1", "col2"], ["col3"], ["col4"]]
+        active_party_columns = ["active1", "active2"]
+        mode: Literal["add_to_first"] = "add_to_first"
+        result = _add_active_party_columns(
+            active_party_columns, mode, partition_columns
+        )
+        self.assertEqual(
+            result, [["col1", "col2", "active1", "active2"], ["col3"], ["col4"]]
+        )
+
+    def test_add_to_last(self) -> None:
+        """Check adding active cols to the last partition."""
+        partition_columns = [["col1", "col2"], ["col3"], ["col4"]]
+        active_party_columns = ["active"]
+        mode: Literal["add_to_last"] = "add_to_last"
+        result = _add_active_party_columns(
+            active_party_columns, mode, partition_columns
+        )
+        self.assertEqual(result, [["col1", "col2"], ["col3"], ["col4", "active"]])
+
+    def test_create_as_first(self) -> None:
+        """Check creating a new first partition for active cols."""
+        partition_columns = [["col1"], ["col2"]]
+        active_party_columns = ["active1", "active2"]
+        mode: Literal["create_as_first"] = "create_as_first"
+        result = _add_active_party_columns(
+            active_party_columns, mode, partition_columns
+        )
+        self.assertEqual(result, [["active1", "active2"], ["col1"], ["col2"]])
+
+    def test_create_as_last(self) -> None:
+        """Check creating a new last partition for active cols."""
+        partition_columns = [["col1"], ["col2"]]
+        active_party_columns = ["active1", "active2"]
+        mode: Literal["create_as_last"] = "create_as_last"
+        result = _add_active_party_columns(
+            active_party_columns, mode, partition_columns
+        )
+        self.assertEqual(result, [["col1"], ["col2"], ["active1", "active2"]])
+
+    def test_add_to_all(self) -> None:
+        """Check adding active cols to all partitions."""
+        partition_columns = [["col1"], ["col2", "col3"], ["col4"]]
+        active_party_columns = ["active"]
+        mode: Literal["add_to_all"] = "add_to_all"
+        result = _add_active_party_columns(
+            active_party_columns, mode, partition_columns
+        )
+        self.assertEqual(
+            result, [["col1", "active"], ["col2", "col3", "active"], ["col4", "active"]]
+        )
+
+    def test_add_to_specific_partition_valid_index(self) -> None:
+        """Check adding active cols to a specific valid partition."""
+        partition_columns = [["col1"], ["col2"], ["col3"]]
+        active_party_columns = ["active1", "active2"]
+        mode: int = 1
+        result = _add_active_party_columns(
+            active_party_columns, mode, partition_columns
+        )
+        self.assertEqual(result, [["col1"], ["col2", "active1", "active2"], ["col3"]])
+
+    def test_add_to_specific_partition_invalid_index(self) -> None:
+        """Check ValueError when partition index is invalid."""
+        partition_columns = [["col1"], ["col2"]]
+        active_party_columns = ["active"]
+        mode: int = 5
+        with self.assertRaises(ValueError) as context:
+            _add_active_party_columns(active_party_columns, mode, partition_columns)
+        self.assertIn("Invalid partition index", str(context.exception))
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/datasets/flwr_datasets/partitioner/vertical_size_partitioner.py b/datasets/flwr_datasets/partitioner/vertical_size_partitioner.py
new file mode 100644
index 000000000000..462a76a2e3f5
--- /dev/null
+++ b/datasets/flwr_datasets/partitioner/vertical_size_partitioner.py
@@ -0,0 +1,312 @@
+# Copyright 2024 Flower Labs GmbH. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# ==============================================================================
+"""VerticalSizePartitioner class."""
+# flake8: noqa: E501
+# pylint: disable=C0301, R0902, R0913
+from math import floor
+from typing import Literal, Optional, Union, cast
+
+import numpy as np
+
+import datasets
+from flwr_datasets.partitioner.partitioner import Partitioner
+from flwr_datasets.partitioner.vertical_partitioner_utils import (
+    _add_active_party_columns,
+)
+
+
+class VerticalSizePartitioner(Partitioner):
+    """Creates vertical partitions by spliting features (columns) based on sizes.
+
+    The sizes refer to the number of columns after the `drop_columns` are
+    dropped. `shared_columns` and `active_party_column` are excluded and
+    added only after the size-based division.
+
+    Enables selection of "active party" column(s) and palcement into
+    a specific partition or creation of a new partition just for it.
+    Also enables droping columns and sharing specified columns across
+    all partitions.
+
+    Parameters
+    ----------
+    partition_sizes : Union[list[int], list[float]]
+        A list where each value represents the size of a partition.
+        list[int] -> each value represent an absolute number of columns. Size zero is
+        allowed and will result in an empty partition if no shared columns are present.
+        A list of floats -> each value represent a fraction total number of columns.
+        Note that these values apply to collums without `active_party_columns`, `shared_columns`.
+        They are additionally included in to the partition(s). `drop_columns` are also not counted
+        toward the partition sizes.
+        In case fo list[int]: sum(partition_sizes) == len(columns) - len(drop_columns) -
+        len(shared_columns)  - len(active_party_columns)
+    active_party_column : Optional[Union[str, list[str]]]
+        Column(s) (typically representing labels) associated with the
+        "active party" (which can be the server).
+    active_party_columns_mode : Union[Literal[["add_to_first", "add_to_last", "create_as_first", "create_as_last", "add_to_all"], int]
+        Determines how to assign the active party columns:
+
+        - `"add_to_first"`: Append active party columns to the first partition.
+        - `"add_to_last"`: Append active party columns to the last partition.
+        - `"create_as_first"`: Create a new partition at the start containing only these columns.
+        - `"create_as_last"`: Create a new partition at the end containing only these columns.
+        - `"add_to_all"`: Append active party columns to all partitions.
+        - int: Append active party columns to the specified partition index.
+    drop_columns : Optional[list[str]]
+        Columns to remove entirely from the dataset before partitioning.
+    shared_columns : Optional[list[str]]
+        Columns to duplicate into every partition after initial partitioning.
+    shuffle : bool
+        Whether to shuffle the order of columns before partitioning.
+    seed : Optional[int]
+        Random seed for shuffling columns. Has no effect if `shuffle=False`.
+
+    Examples
+    --------
+    >>> from flwr_datasets import FederatedDataset
+    >>> from flwr_datasets.partitioner import VerticalSizePartitioner
+    >>>
+    >>> partitioner = VerticalSizePartitioner(
+    ...     partition_sizes=[8, 4, 2],
+    ...     active_party_column="income",
+    ...     active_party_columns_mode="create_as_last"
+    ... )
+    >>> fds = FederatedDataset(
+    ...     dataset="scikit-learn/adult-census-income",
+    ...     partitioners={"train": partitioner}
+    ... )
+    >>> partitions = [fds.load_partition(i) for i in range(fds.partitioners["train"].num_partitions)]
+    >>> print([partition.column_names for partition in partitions])
+    """
+
+    def __init__(
+        self,
+        partition_sizes: Union[list[int], list[float]],
+        active_party_column: Optional[Union[str, list[str]]] = None,
+        active_party_columns_mode: Union[
+            Literal[
+                "add_to_first",
+                "add_to_last",
+                "create_as_first",
+                "create_as_last",
+                "add_to_all",
+            ],
+            int,
+        ] = "add_to_last",
+        drop_columns: Optional[list[str]] = None,
+        shared_columns: Optional[list[str]] = None,
+        shuffle: bool = True,
+        seed: Optional[int] = 42,
+    ) -> None:
+        super().__init__()
+
+        self._partition_sizes = partition_sizes
+        self._active_party_columns = self._init_active_party_column(active_party_column)
+        self._active_party_columns_mode = active_party_columns_mode
+        self._drop_columns = drop_columns or []
+        self._shared_columns = shared_columns or []
+        self._shuffle = shuffle
+        self._seed = seed
+        self._rng = np.random.default_rng(seed=self._seed)
+
+        self._partition_columns: Optional[list[list[str]]] = None
+        self._partitions_determined = False
+
+        self._validate_parameters_in_init()
+
+    def _determine_partitions_if_needed(self) -> None:
+        if self._partitions_determined:
+            return
+
+        if self.dataset is None:
+            raise ValueError("No dataset is set for this partitioner.")
+
+        all_columns = list(self.dataset.column_names)
+        self._validate_parameters_while_partitioning(
+            all_columns, self._shared_columns, self._active_party_columns
+        )
+        columns = [column for column in all_columns if column not in self._drop_columns]
+        columns = [column for column in columns if column not in self._shared_columns]
+        columns = [
+            column for column in columns if column not in self._active_party_columns
+        ]
+
+        if self._shuffle:
+            self._rng.shuffle(columns)
+        if all(isinstance(fraction, float) for fraction in self._partition_sizes):
+            partition_columns = _fraction_split(
+                columns, cast(list[float], self._partition_sizes)
+            )
+        else:
+            partition_columns = _count_split(
+                columns, cast(list[int], self._partition_sizes)
+            )
+
+        partition_columns = _add_active_party_columns(
+            self._active_party_columns,
+            self._active_party_columns_mode,
+            partition_columns,
+        )
+
+        # Add shared columns to all partitions
+        for partition in partition_columns:
+            for column in self._shared_columns:
+                partition.append(column)
+
+        self._partition_columns = partition_columns
+        self._partitions_determined = True
+
+    def load_partition(self, partition_id: int) -> datasets.Dataset:
+        """Load a partition based on the partition index.
+
+        Parameters
+        ----------
+        partition_id : int
+            The index that corresponds to the requested partition.
+
+        Returns
+        -------
+        dataset_partition : Dataset
+            Single partition of a dataset.
+        """
+        self._determine_partitions_if_needed()
+        assert self._partition_columns is not None
+        if partition_id < 0 or partition_id >= len(self._partition_columns):
+            raise IndexError(
+                f"partition_id: {partition_id} out of range <0, {self.num_partitions - 1}>."
+            )
+        columns = self._partition_columns[partition_id]
+        return self.dataset.select_columns(columns)
+
+    @property
+    def num_partitions(self) -> int:
+        """Number of partitions."""
+        self._determine_partitions_if_needed()
+        assert self._partition_columns is not None
+        return len(self._partition_columns)
+
+    def _validate_parameters_in_init(self) -> None:
+        if not isinstance(self._partition_sizes, list):
+            raise ValueError("partition_sizes must be a list.")
+        if all(isinstance(fraction, float) for fraction in self._partition_sizes):
+            fraction_sum = sum(self._partition_sizes)
+            if fraction_sum != 1.0:
+                raise ValueError("Float ratios in `partition_sizes` must sum to 1.0.")
+            if any(
+                fraction < 0.0 or fraction > 1.0 for fraction in self._partition_sizes
+            ):
+                raise ValueError(
+                    "All floats in `partition_sizes` must be >= 0.0 and <= 1.0."
+                )
+        elif all(
+            isinstance(coulumn_count, int) for coulumn_count in self._partition_sizes
+        ):
+            if any(coulumn_count < 0 for coulumn_count in self._partition_sizes):
+                raise ValueError("All integers in `partition_sizes` must be >= 0.")
+        else:
+            raise ValueError("`partition_sizes` list must be all floats or all ints.")
+
+        # Validate columns lists
+        for parameter_name, parameter_list in [
+            ("drop_columns", self._drop_columns),
+            ("shared_columns", self._shared_columns),
+            ("active_party_columns", self._active_party_columns),
+        ]:
+            if not all(isinstance(column, str) for column in parameter_list):
+                raise ValueError(f"All entries in {parameter_name} must be strings.")
+
+        valid_modes = {
+            "add_to_first",
+            "add_to_last",
+            "create_as_first",
+            "create_as_last",
+            "add_to_all",
+        }
+        if not (
+            isinstance(self._active_party_columns_mode, int)
+            or self._active_party_columns_mode in valid_modes
+        ):
+            raise ValueError(
+                "active_party_columns_mode must be an int or one of "
+                "'add_to_first', 'add_to_last', 'create_as_first', 'create_as_last', "
+                "'add_to_all'."
+            )
+
+    def _validate_parameters_while_partitioning(
+        self,
+        all_columns: list[str],
+        shared_columns: list[str],
+        active_party_columns: list[str],
+    ) -> None:
+        # Shared columns existance check
+        for column in shared_columns:
+            if column not in all_columns:
+                raise ValueError(f"Shared column '{column}' not found in the dataset.")
+        # Active party columns existence check
+        for column in active_party_columns:
+            if column not in all_columns:
+                raise ValueError(
+                    f"Active party column '{column}' not found in the dataset."
+                )
+        num_columns = len(all_columns)
+        num_cols_unused_in_core_div = 0
+        if self._active_party_columns is not None:
+            num_cols_unused_in_core_div += len(self._active_party_columns)
+        if self._shared_columns is not None:
+            num_cols_unused_in_core_div += len(self._shared_columns)
+        if self._drop_columns is not None:
+            num_cols_unused_in_core_div += len(self._drop_columns)
+        num_core_div_columns = num_columns - num_cols_unused_in_core_div
+        if all(isinstance(size, int) for size in self._partition_sizes):
+            if sum(self._partition_sizes) != num_core_div_columns:
+                raise ValueError(
+                    "Sum of partition sizes cannot differ from the total number of columns "
+                    "used in the division. Note that shared_columns, drop_columns and"
+                    "active_party_columns are not included in the division."
+                )
+
+    def _init_active_party_column(
+        self, active_party_column: Optional[Union[str, list[str]]]
+    ) -> list[str]:
+        if active_party_column is None:
+            return []
+        if isinstance(active_party_column, str):
+            return [active_party_column]
+        if isinstance(active_party_column, list):
+            return active_party_column
+        raise ValueError("active_party_column must be a string or a list of strings.")
+
+
+def _count_split(columns: list[str], counts: list[int]) -> list[list[str]]:
+    partition_columns = []
+    start = 0
+    for count in counts:
+        end = start + count
+        partition_columns.append(columns[start:end])
+        start = end
+    return partition_columns
+
+
+def _fraction_split(columns: list[str], fractions: list[float]) -> list[list[str]]:
+    num_columns = len(columns)
+    partitions = []
+    cumulative = 0
+    for index, fraction in enumerate(fractions):
+        count = int(floor(fraction * num_columns))
+        if index == len(fractions) - 1:
+            # Last partition takes the remainder
+            count = num_columns - cumulative
+        partitions.append(columns[cumulative : cumulative + count])
+        cumulative += count
+    return partitions
diff --git a/datasets/flwr_datasets/partitioner/vertical_size_partitioner_test.py b/datasets/flwr_datasets/partitioner/vertical_size_partitioner_test.py
new file mode 100644
index 000000000000..d2c483c2be88
--- /dev/null
+++ b/datasets/flwr_datasets/partitioner/vertical_size_partitioner_test.py
@@ -0,0 +1,206 @@
+# Copyright 2024 Flower Labs GmbH. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# ==============================================================================
+"""VerticalSizePartitioner class tests."""
+# mypy: disable-error-code=arg-type
+# pylint: disable=R0902, R0913
+import unittest
+
+import numpy as np
+
+from datasets import Dataset
+from flwr_datasets.partitioner.vertical_size_partitioner import VerticalSizePartitioner
+
+
+def _create_dummy_dataset(column_names: list[str], num_rows: int = 100) -> Dataset:
+    """Create a dataset with random integer data."""
+    rng = np.random.default_rng(seed=42)
+    data = {col: rng.integers(0, 100, size=num_rows).tolist() for col in column_names}
+    return Dataset.from_dict(data)
+
+
+class TestVerticalSizePartitioner(unittest.TestCase):
+    """Tests for VerticalSizePartitioner."""
+
+    def test_init_invalid_partition_sizes_type(self) -> None:
+        """Check ValueError if partition_sizes is not a list."""
+        with self.assertRaises(ValueError):
+            VerticalSizePartitioner(partition_sizes="not_a_list")
+
+    def test_init_mixed_partition_sizes_types(self) -> None:
+        """Check ValueError if partition_sizes mix int and float."""
+        with self.assertRaises(ValueError):
+            VerticalSizePartitioner(partition_sizes=[0.5, 1])
+
+    def test_init_float_partitions_sum_not_one(self) -> None:
+        """Check ValueError if float partitions do not sum to 1."""
+        with self.assertRaises(ValueError):
+            VerticalSizePartitioner(partition_sizes=[0.3, 0.3])
+
+    def test_init_float_partitions_out_of_range(self) -> None:
+        """Check ValueError if any float partition <0 or >1."""
+        with self.assertRaises(ValueError):
+            VerticalSizePartitioner(partition_sizes=[-0.5, 1.5])
+
+    def test_init_int_partitions_negative(self) -> None:
+        """Check ValueError if any int partition size is negative."""
+        with self.assertRaises(ValueError):
+            VerticalSizePartitioner(partition_sizes=[5, -1])
+
+    def test_init_invalid_mode(self) -> None:
+        """Check ValueError if active_party_columns_mode is invalid."""
+        with self.assertRaises(ValueError):
+            VerticalSizePartitioner(
+                partition_sizes=[2, 2], active_party_columns_mode="invalid"
+            )
+
+    def test_init_active_party_column_invalid_type(self) -> None:
+        """Check ValueError if active_party_column is not str/list."""
+        with self.assertRaises(ValueError):
+            VerticalSizePartitioner(partition_sizes=[2, 2], active_party_column=123)
+
+    def test_partitioning_with_int_sizes(self) -> None:
+        """Check correct partitioning with integer sizes."""
+        columns = ["f1", "f2", "f3", "f4", "f5"]
+        dataset = _create_dummy_dataset(columns)
+        partitioner = VerticalSizePartitioner(partition_sizes=[2, 3], shuffle=False)
+        partitioner.dataset = dataset
+        p0 = partitioner.load_partition(0)
+        p1 = partitioner.load_partition(1)
+        self.assertEqual(len(p0.column_names), 2)
+        self.assertEqual(len(p1.column_names), 3)
+
+    def test_partitioning_with_fraction_sizes(self) -> None:
+        """Check correct partitioning with fraction sizes."""
+        columns = ["f1", "f2", "f3", "f4"]
+        dataset = _create_dummy_dataset(columns)
+        partitioner = VerticalSizePartitioner(partition_sizes=[0.5, 0.5], shuffle=False)
+        partitioner.dataset = dataset
+        p0 = partitioner.load_partition(0)
+        p1 = partitioner.load_partition(1)
+        self.assertEqual(len(p0.column_names), 2)
+        self.assertEqual(len(p1.column_names), 2)
+
+    def test_partitioning_with_drop_columns(self) -> None:
+        """Check dropping specified columns before partitioning."""
+        columns = ["f1", "drop_me", "f2", "f3"]
+        dataset = _create_dummy_dataset(columns)
+        partitioner = VerticalSizePartitioner(
+            partition_sizes=[2, 1], drop_columns=["drop_me"], shuffle=False
+        )
+        partitioner.dataset = dataset
+        p0 = partitioner.load_partition(0)
+        p1 = partitioner.load_partition(1)
+        all_cols = p0.column_names + p1.column_names
+        self.assertNotIn("drop_me", all_cols)
+
+    def test_partitioning_with_shared_columns(self) -> None:
+        """Check shared columns added to every partition."""
+        columns = ["f1", "f2", "shared"]
+        dataset = _create_dummy_dataset(columns)
+        partitioner = VerticalSizePartitioner(
+            partition_sizes=[1, 1], shared_columns=["shared"], shuffle=False
+        )
+        partitioner.dataset = dataset
+        p0 = partitioner.load_partition(0)
+        p1 = partitioner.load_partition(1)
+        self.assertIn("shared", p0.column_names)
+        self.assertIn("shared", p1.column_names)
+
+    def test_partitioning_with_active_party_add_to_last(self) -> None:
+        """Check active party columns added to the last partition."""
+        columns = ["f1", "f2", "label"]
+        dataset = _create_dummy_dataset(columns)
+        partitioner = VerticalSizePartitioner(
+            partition_sizes=[2],
+            active_party_column="label",
+            active_party_columns_mode="add_to_last",
+            shuffle=False,
+        )
+        partitioner.dataset = dataset
+        p0 = partitioner.load_partition(0)
+        self.assertIn("label", p0.column_names)
+
+    def test_partitioning_with_active_party_create_as_first(self) -> None:
+        """Check creating a new first partition for active party cols."""
+        columns = ["f1", "f2", "label"]
+        dataset = _create_dummy_dataset(columns)
+        partitioner = VerticalSizePartitioner(
+            partition_sizes=[2],
+            active_party_column="label",
+            active_party_columns_mode="create_as_first",
+            shuffle=False,
+        )
+        partitioner.dataset = dataset
+        self.assertEqual(partitioner.num_partitions, 2)
+        p0 = partitioner.load_partition(0)
+        p1 = partitioner.load_partition(1)
+        self.assertEqual(p0.column_names, ["label"])
+        self.assertIn("f1", p1.column_names)
+        self.assertIn("f2", p1.column_names)
+
+    def test_partitioning_with_nonexistent_shared_column(self) -> None:
+        """Check ValueError if shared column does not exist."""
+        columns = ["f1", "f2"]
+        dataset = _create_dummy_dataset(columns)
+        partitioner = VerticalSizePartitioner(
+            partition_sizes=[1], shared_columns=["nonexistent"], shuffle=False
+        )
+        partitioner.dataset = dataset
+        with self.assertRaises(ValueError):
+            partitioner.load_partition(0)
+
+    def test_partitioning_with_nonexistent_active_party_column(self) -> None:
+        """Check ValueError if active party column does not exist."""
+        columns = ["f1", "f2"]
+        dataset = _create_dummy_dataset(columns)
+        partitioner = VerticalSizePartitioner(
+            partition_sizes=[1], active_party_column="missing_label", shuffle=False
+        )
+        partitioner.dataset = dataset
+        with self.assertRaises(ValueError):
+            partitioner.load_partition(0)
+
+    def test_sum_of_int_partition_sizes_exceeds_num_columns(self) -> None:
+        """Check ValueError if sum of int sizes > total columns."""
+        columns = ["f1", "f2"]
+        dataset = _create_dummy_dataset(columns)
+        partitioner = VerticalSizePartitioner(partition_sizes=[3], shuffle=False)
+        partitioner.dataset = dataset
+        with self.assertRaises(ValueError):
+            partitioner.load_partition(0)
+
+    def test_sum_of_int_partition_sizes_indirectly_exceeds_num_columns(self) -> None:
+        """Check ValueError if sum of int sizes > total columns."""
+        columns = ["f1", "f2", "f3"]
+        dataset = _create_dummy_dataset(columns)
+        partitioner = VerticalSizePartitioner(
+            partition_sizes=[1, 1], drop_columns=["f3", "f2"], shuffle=False
+        )
+        partitioner.dataset = dataset
+        with self.assertRaises(ValueError):
+            partitioner.load_partition(0)
+
+    def test_sum_of_int_partition_sizes_is_smaller_than_num_columns(self) -> None:
+        """Check ValueError if sum of int sizes < total columns."""
+        columns = ["f1", "f2", "f3"]
+        dataset = _create_dummy_dataset(columns)
+        partitioner = VerticalSizePartitioner(partition_sizes=[2], shuffle=False)
+        partitioner.dataset = dataset
+        with self.assertRaises(ValueError):
+            partitioner.load_partition(0)
+
+
+if __name__ == "__main__":
+    unittest.main()