Migration guide entries for removed deprecated functions
Signed-off-by: Gilles Peskine <Gilles.Peskine@arm.com>
diff --git a/docs/4.0-migration-guide/deprecated-removals.md b/docs/4.0-migration-guide/deprecated-removals.md
new file mode 100644
index 0000000..e74b1ad
--- /dev/null
+++ b/docs/4.0-migration-guide/deprecated-removals.md
@@ -0,0 +1,14 @@
+## Removal of deprecated functions
+
+### Removal of deprecated X.509 functions
+
+The deprecated function `mbedtls_x509write_crt_set_serial()` has been removed. The function was superseded by `mbedtls_x509write_crt_set_serial_raw()`.
+
+### Removal of deprecated SSL functions
+
+The deprecated function `mbedtls_ssl_conf_curves()` has been removed.
+The function was superseded by `mbedtls_ssl_conf_groups()`.
+
+### Removal of `compat-2.x.h`
+
+The header `compat-2.x.h`, containing some definitions for backward compatibility with Mbed TLS 2.x, has been removed.