From 57750338fa9a8d354404512cdbc8c118930923d6 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ren=C3=A9=20Kijewski?= <rene.kijewski@fu-berlin.de>
Date: Tue, 22 Apr 2025 12:53:02 +0200
Subject: [PATCH] book: update `upgrading.md`

---
 book/src/upgrading.md | 23 ++++++++++++++++++-----
 1 file changed, 18 insertions(+), 5 deletions(-)

diff --git a/book/src/upgrading.md b/book/src/upgrading.md
index 8adedf2b..0afa589c 100644
--- a/book/src/upgrading.md
+++ b/book/src/upgrading.md
@@ -4,18 +4,27 @@ This file **only lists breaking changes** you need to be aware of when you upgra
 version. Please see [our release notes](<https://github.com/askama-rs/askama/releases>) to get a
 list of all changes and improvements that might be useful to you.
 
-Also have a look at our blog posts that highlight some of the best features of our releases, and
-give you more in-dept explanations:
+## From askama v0.13 to askama v0.14
 
-* [docs.rs switching jinja template framework from tera to rinja](
-  <https://blog.guillaume-gomez.fr/articles/2024-07-31+docs.rs+switching+jinja+template+framework+from+tera+to+rinja>)
+* The <abbr title="minimum supported rust version">MSRV</abbr> of this release is 1.83.
+
+* When assigning a new variable (`{% let var = … %}`) with a local variable was value,
+  it is moved or copied, not referenced.
+
+* Try expressions (`{{ expr? }}`) are not placed behind a reference.
+
+* [`FastWritable`](./doc/askama/trait.FastWritable.html) implementations have access to runtime values.
+
+* Custom filters have access to runtime values.
+
+* `|unique` is a built-in filter; `|titlecase` is an alias for `|title`.
 
 ## From askama v0.12 to askama v0.13
 
 A blog post summarizing changes and also explaining the merge of `rinja` and `askama` is
 available [here](https://blog.guillaume-gomez.fr/articles/2025-03-19+Askama+and+Rinja+merge).
 
-List of the changes:
+List of breaking changes:
 
 * The <abbr title="minimum supported rust version">MSRV</abbr> of this release is 1.81.
 
@@ -93,6 +102,10 @@ List of the changes:
 
 ## From askama v0.12 to rinja v0.2
 
+Have a look at our blog posts that highlight some of the best features of our releases, and
+give you more in-dept explanations: [docs.rs switching jinja template framework from tera to rinja](
+  <https://blog.guillaume-gomez.fr/articles/2024-07-31+docs.rs+switching+jinja+template+framework+from+tera+to+rinja>).
+
 * The <abbr title="minimum supported rust version">MSRV</abbr> of this release is 1.71.
 
 * You need to replace instances of `askama` with `rinja`, e.g.