diff --git a/HISTORY.md b/HISTORY.md
index 2fa8d19c02..33f872b04a 100644
--- a/HISTORY.md
+++ b/HISTORY.md
@@ -3,7 +3,7 @@
 ## 1.25.0 (2022-12-01)
 
 AEA:
-- Fixes the mechanism to convert the `json` path the environment variable string
+- Fixes the mechanism to convert the `json` path to environment variable string
 - Updates the process of agent subprocess termination to make sure we properly terminate agents across the various operating systems
 - Introduces `reraise_as_click_exception` to re-raise exceptions as `click.ClickExceptions` on command definitions
 - Extends `CliRunner` to allow usage of `capfd` to capture test output
@@ -13,7 +13,7 @@ AEA:
   - Update the hashes for third party packages with a warning
   - Update the dependency hashes when locking packages
   - Verifying the dependency hashes when verifying packages
-- Adds deprecation warning for `aea hash all` command
+- Adds deprecation warning for `aea hash all` command since the same functionality is now being provided by `aea packages lock` command
 
 Tests:
 - Updates `libp2p` tests to use `capsys` to read `stdout` instead of patching `sys.stdout`
diff --git a/docs/upgrading.md b/docs/upgrading.md
index 0848c0c6c7..8bb189f049 100644
--- a/docs/upgrading.md
+++ b/docs/upgrading.md
@@ -15,6 +15,8 @@ No backwards incompatible changes.
 
 Plugins from previous versions are not compatible anymore.
 
+The usage of `aea hash all` command has been deprecated and will be removed on `v2.0.0`, use `aea packages lock` command to perform hash updates for package dependencies.
+
 ## `v1.23.0` to `v1.24.0`
 
 No backwards incompatible changes.