diff --git a/packages/samples/hello/README.md b/packages/samples/hello/README.md
new file mode 100644
index 0000000000..5e4edb207c
--- /dev/null
+++ b/packages/samples/hello/README.md
@@ -0,0 +1,28 @@
+# Hello sample
+
+## Register
+
+```ts
+yarn pm add sample-hello
+```
+
+## Activate
+
+```bash
+yarn pm enable sample-hello
+```
+
+## Launch the app
+
+```bash
+# for development
+yarn dev
+
+# for production
+yarn build samples/hello
+yarn start
+```
+
+## Demo
+
+[gif]
diff --git a/packages/samples/shop-modeling/README.md b/packages/samples/shop-modeling/README.md
index 68cbc0adc9..896e25b263 100644
--- a/packages/samples/shop-modeling/README.md
+++ b/packages/samples/shop-modeling/README.md
@@ -1,21 +1,30 @@
 # Modeling for simple shop scenario
 
-## Installation
+## Register
 
-```bash
-yarn build samples/shop-modeling
+```ts
 yarn pm add sample-shop-modeling
-yarn enable sample-shop-modeling
 ```
 
-## Test
-
-Start the local development server:
+## Activate
 
 ```bash
-yarn dev --server
+yarn pm enable sample-shop-modeling
 ```
 
+## Launch the app
+
+```bash
+# for development
+yarn dev
+
+# for production
+yarn build samples/shop-modeling
+yarn start
+```
+
+## Connect to the API
+
 ### Products API
 
 ```bash