diff --git a/ext/README.md b/ext/README.md
index e5cc0756..94eaede5 100644
--- a/ext/README.md
+++ b/ext/README.md
@@ -1,35 +1,47 @@
 # PHP extension development
 
-All the changes introduced by Fracker to Xdebug are self-contained in a single [patch file](./fracker.patch), to update it:
+All the changes introduced by Fracker to Xdebug are self-contained in a single [patch file](./fracker.patch), perform the following steps to to update it.
 
-1. first make sure to start from a fresh state with:
+1. Make sure to start from a fresh state with:
 
    ```
    make fetch-xdebug
    ```
 
-2. then load the existing patch with:
+2. Load the existing patch with:
 
     ```
     make apply-patch
     ```
 
-3. make the changes in the `./xdebug/` directory, each time building with:
+3. Make the changes in the `./xdebug/` directory, each time building with:
 
     ```
     make build
     ```
 
-4. try the extansion with:
+4. Try the extension with after starting Fracker as usual:
 
     ```
     php -d zend_extension=$PWD/xdebug/modules/xdebug.so -r 'var_dump("Hello Fracker!");'
     ```
 
-5. finally save the patch with:
+    The expected Fracker output should be:
+
+    ```
+    001 │ PHP ["Standard input code"]
+    001 │ {main}() Command line code +0
+    001 │ »  var_dump(value="Hello Fracker!", values=null) Command line code +1
+    ```
+
+5. Save the patch with:
 
     ```
     make format-patch
     ```
 
+6. Run the test suite as described in the [test](/test/) folder.
+
 To update the Xdebug version, change the `XDEBUG_VERSION` variable in the `Makefile` then repeat the above steps, conflicts and other issues must be addressed manually. Same goes for downgrading Xdebug in order to support older PHP versions, refer to [this](https://xdebug.org/docs/compat) page to find the right version.
+
+After any update commit using the `Update Xdebug to <XDEBUG_VERSION>` message and tag with `xdebug-<XDEBUG_VERSION>`.