From 12de990dee75632f88860fbd3d4d63c19f20d161 Mon Sep 17 00:00:00 2001
From: asonix <asonix@asonix.dog>
Date: Fri, 8 Dec 2023 23:02:11 -0600
Subject: [PATCH] Add notes about upgrade configuration to upgrade notes

---
 releases/0.5.0.md | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/releases/0.5.0.md b/releases/0.5.0.md
index 0c0c17e..0b04294 100644
--- a/releases/0.5.0.md
+++ b/releases/0.5.0.md
@@ -71,6 +71,26 @@ to 0.5 with postgres, rather than upgrading to 0.5 with sled and then making the
 This process is documented in the
 [pict-rs readme](https://git.asonix.dog/asonix/pict-rs#upgrading-directly-to-postgres).
 
+A notable addition in 0.5 is upgrade configuration. Since the migration accesses media from the
+configured store, increasing the concurrency can be beneficial. By default, pict-rs will attempt to
+migrate 32 records at a time, but this value can be increased.
+
+In the configuration file
+```toml
+[upgrade]
+concurrency = 32
+```
+
+With environment variables
+```bash
+PICTRS__UPGRADE__CONCURRENCY=32
+```
+
+On the commandline
+```bash
+pict-rs run --upgrade-concurrency 32
+```
+
 More information can be found in the
 [pict-rs 0.4 to 0.5 migration guide](https://git.asonix.dog/asonix/pict-rs#04-to-05-migration-guide).