From ebe38e9fa5727b88cb9eb671a41f9575fbf3de4a Mon Sep 17 00:00:00 2001
From: Andrew David Wong <adw@qubes-os.org>
Date: Mon, 23 May 2016 15:50:02 -0700
Subject: [PATCH] Add warning, fix links, and fix formatting

---
 customization/i3.md | 21 +++++++++++----------
 1 file changed, 11 insertions(+), 10 deletions(-)

diff --git a/customization/i3.md b/customization/i3.md
index f9f5a70b..ebe6bff2 100644
--- a/customization/i3.md
+++ b/customization/i3.md
@@ -13,9 +13,13 @@ i3 installation in dom0
 ========================
 
 Note that all of the work in this document is done in a Fedora based domU (could
-be dispvm). The end result is always a .rpm that is copied to dom0 and then
+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
 ----------------
 
@@ -50,8 +54,8 @@ Installing
 ----------
 
 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 next
-step.
+Protip: copying this file to `~/i3.rpm` now will save you some typing in the
+next step.
 
 Now in dom0, copy in the rpm:
 
@@ -89,16 +93,13 @@ part of a normal Qubes installation, and bind the keys for you.
   5. Qubes does automatic screen locking and so should you. Install `xautolock`
      and `i3lock` in dom0 and then add
 
-        exec --no-startup-id "xautolock -detectsleep -time 3 -locker 'i3lock -d -c 000000' -notify 30 -notifier \"notify-send -t 2000 'Locking screen in 30 seconds'\""
+         exec --no-startup-id "xautolock -detectsleep -time 3 -locker 'i3lock -d -c 000000' -notify 30 -notifier \"notify-send -t 2000 'Locking screen in 30 seconds'\""
 
      to your i3 config to enable it.
   6. By default `$mod+Return` in i3 will open a new terminal in dom0. If you
      prefer to start a new terminal in the domain of the currently active
      window, use [a script like this][terminal_start_script].
 
-[xdg_autostart_script]:
-https://gist.github.com/SietsevanderMolen/7b4cc32ce7b4884513b0a639540e454f
-[i3bar_script]:
-https://gist.github.com/SietsevanderMolen/e7f594f209dfaa3596907e427b657e30
-[terminal_start_script]:
-https://gist.github.com/SietsevanderMolen/7c6f2b5773dbc0c08e1509e49abd1e96
+[xdg_autostart_script]:https://gist.github.com/SietsevanderMolen/7b4cc32ce7b4884513b0a639540e454f
+[i3bar_script]: https://gist.github.com/SietsevanderMolen/e7f594f209dfaa3596907e427b657e30
+[terminal_start_script]: https://gist.github.com/SietsevanderMolen/7c6f2b5773dbc0c08e1509e49abd1e96