i3 installation from testing repository

See https://github.com/QubesOS/qubes-desktop-linux-i3/pull/1

customization/i3.md

@@ -9,19 +9,27 @@ redirect_from:
 - "/wiki/UserDoc/i3/"
 ---
 
-i3 installation in dom0
-========================
+# i3 installation in dom0
 
-Note that all of the work in this document is done in a Fedora based domU (could
+i3 is part of the testing repository (as of Qubes R3.1) and can be installed from there
+using the dom0 update mechanism.
+
+    $ qubes-dom0-update --enablerepo=qubes-dom0-current-testing i3
+    
+Qubes-specific configuation is available in a separate package and can be installed
+optionally. Otherwise you can write your own configuration (see below).
+
+    $ qubes-dom0-update --enablerepo=qubes-dom0-current-testing i3-settings-qubes
+    
+That's it. After logging out, you can select i3 in the login manager.
+
+## Compilation and installation from source
+
+Note that the compilation from source is done in a Fedora based domU (could
 be dispvm). The end result is always an `.rpm` that is copied to dom0 and then
 installed through the package manager.
 
-**Warning:** Installing software in dom0 is inherently risky, and the method
-described in this guide circumvents the usual security mechanisms for [updating
-software in dom0](/doc/software-update-dom0/).
-
-Getting the code
-----------------
+### Getting the code
 
 Clone the i3-qubes repository here:
 
@@ -36,8 +44,7 @@ OS and changes some defaults so the user can't override decisions.
 If you want to make any changes to the package, this is the time and place to do
 it.
 
-Building
---------
+### Building
 
 You'll need to install the build dependencies, which are listed in
 build-deps.list. You can verify them and then install them with
@@ -50,8 +57,9 @@ you get the sources and start off the build:
 
     $ make rpms
 
-Installing
-----------
+### Installing
+
+**Warning**: Manually installing software in dom0 is inherently risky, and the method described here circumvents the usual security mechanisms of qubes-dom0-update.
 
 You should now have your i3 rpm in `./rpm/x86_64/i3-4.8-3.fc20.x86_64.rpm`.
 Protip: copying this file to `~/i3.rpm` now will save you some typing in the
@@ -74,8 +82,9 @@ After that you can just install the generated rpm like any other local package
 
 Log out, select i3, then log in again.
 
-Configuration
--------------
+### Configuration
+
+**Warning**: Be careful when writing configuration/scripts for the dom0. A script which communicates with the qubes VMs could potentially open a security hole.
 
 Things needed/recommended to be done: