diff --git a/README.md b/README.md
index 94af65e..b9c1f1c 100644
--- a/README.md
+++ b/README.md
@@ -14,6 +14,15 @@ Config.Jail_zfs_dataset = myzfspool/poudriere
 Config.Jail_zfs_mountpoint = none
 </code>
 
+Create jails
+------------
+For now, we can't pass config at creation time. We have to define config after creation:  
+<pre><code>
+gocage create jail1 -r 13.2-RELEASE
+gocage set Config.Ip4_addr="vnet0|192.168.1.91/24" Config.Vnet=1 jail1
+</code></pre>
+
+
 List jails
 ----------
 Nothing fancy, just use  
@@ -132,6 +141,14 @@ To update jail patch version, use gocage update :
 `gocage update test`
 
 
+Upgrade jails  
+----------
+To upgrade jail to newer release, use gocage upgrade :  
+`gocage upgrade -r 13.2-RELEASE test`
+  
+A pre-upgrade snapshot wil be made so we can rollback if needed.  
+
+
 Delete jails  
 ----------
 `gocage destroy test`
@@ -217,7 +234,6 @@ gocage fetch -r 12.3 -o iocage --from file:/iocage/download
 
 TODO
 ----------
-gocage upgrade  
-gocage create  
+gocage create from templates 
 gocage init  
   create default pool with defaults.json