docs: fix syntax highlighting of code blocks

And various other cleanups

Change-Id: I240badc5358c09f006c2a22d4706ce373f2dd188
diff --git a/docs/FAQ.rst b/docs/FAQ.rst
index 2be26bf..21efead 100644
--- a/docs/FAQ.rst
+++ b/docs/FAQ.rst
@@ -59,22 +59,18 @@
 channels. These settings will **NOT** work without root or without setting the
 appropriate permissions.
 
-**Ubuntu:**
-
-::
+- On **Ubuntu**::
 
     sudo apt install libcap2-bin
     sudo setcap cap_net_raw,cap_net_admin=eip /path/to/nfd
 
-**macOS:**
-
-::
+- On **macOS**::
 
     curl https://bugs.wireshark.org/bugzilla/attachment.cgi?id=3373 -o ChmodBPF.tar.gz
     tar zxvf ChmodBPF.tar.gz
     open ChmodBPF/Install\ ChmodBPF.app
 
-or manually::
+  or manually::
 
     sudo chgrp admin /dev/bpf*
     sudo chmod g+rw /dev/bpf*