change log and migr. guide fixes and _DEPRECATED_REMOVED removed
Signed-off-by: TRodziewicz <tomasz.rodziewicz@mobica.com>
diff --git a/docs/3.0-migration-guide.d/rename_the__ret_functions.md b/docs/3.0-migration-guide.d/rename_the__ret_functions.md
index 513f167..c6fe714 100644
--- a/docs/3.0-migration-guide.d/rename_the__ret_functions.md
+++ b/docs/3.0-migration-guide.d/rename_the__ret_functions.md
@@ -1,7 +1,9 @@
-Rename mbedtls_*_ret() cryptography functions whose deprecated variants have been removed in #4029
---
+Rename mbedtls_*_ret() cryptography functions whose deprecated variants
+have been removed in #4029
+--------------------------
-This change affects users who were using the `mbedtls_*_ret()` criptography functions.
+This change affects users who were using the `mbedtls_*_ret()` cryptography
+functions.
Those functions were created based on now-deprecated functions according to a
requirement that a function needs to return a value. This change brings back the