diff --git a/README.md b/README.md
index 4ff623b2..35ab4ca7 100644
--- a/README.md
+++ b/README.md
@@ -10,6 +10,8 @@ We introduce the following concepts:
 
 This dApp will be used as an educational demo hosted on [Aptos Learn](https://learn.aptoslabs.com/).
 
+You can find more instructions about the Move contract in move/README.md.
+
 ---
 
 This is a [Next.js](https://nextjs.org/) project bootstrapped with [`create-next-app`](https://github.com/vercel/next.js/tree/canary/packages/create-next-app).
@@ -21,10 +23,7 @@ This is a [Next.js](https://nextjs.org/) project bootstrapped with [`create-next
 First, run the development server:
 
 ```bash
-npm run dev
-# or
-yarn dev
-# or
+cd frontend
 pnpm dev
 ```
 
diff --git a/move/README.MD b/move/README.MD
index b13e7e77..9fcc4e09 100644
--- a/move/README.MD
+++ b/move/README.MD
@@ -1,18 +1,32 @@
 # Aptogotchi
 
-## Publish Modules
+## Publish and Upgrade Module
 
 ```shell
+# publish module
 ./sh_scripts/move_publish.sh
 ```
 
+After publishing, go to frontend directory to re-generate the ABI.
+
+```shell
+cd ../frontend
+pnpm generate
+```
+
+Upgrade published module, this only works when you don't have breaking change.
+If you have breaking change, you need to publish to a new address. 
+```shell
+./sh_scripts/move_upgrade.sh
+```
+
 ## Run unit tests
 
 ```shell
 ./sh_scripts/move_test.sh
 ```
 
-## Run move scripts
+## Run Move scripts
 
 Create gotchi.
 ```shell