diff --git a/README.md b/README.md
index 55d0a4ad28..32c7da0331 100644
--- a/README.md
+++ b/README.md
@@ -49,3 +49,39 @@ rushx run-local assign-workspace user1 ws1 # Assign worksapce to user
 ```
 
 Following URL http://localhost:8081/login:component:LoginApp will lead us to app.
+
+## Update project structure and database
+
+If projects structure is updated it might be needed to relink and rebuild projects.
+
+```bash
+rush update
+rush build
+```
+
+It also might be required to upgrade running database.
+```bash
+cd ./dev/tool
+rushx upgrade
+```
+
+## Tests
+
+### Unit tests
+
+```bash
+rush lint
+```
+
+### UI tests
+
+```bash
+cd ./tests
+rush build
+rush bundle
+rush docker:build
+## creates test docker containers and setups test database
+./prepare.sh
+## runs UI tests 
+rushx uitest
+```
\ No newline at end of file