properly format user guide in RST
properly format user guide in RST

The user guide isn't formatted properly for RST. Cosmetically,
the lines are too long and some have extra non-printing characters.
Lists aren't formatted for RST.

This fixes the file so that the lines are no more than 80 characters
wide, removes the non-printing characters, and makes use of
RST-formatting for the lists.

The text itself is not modified.

Change-Id: I8d2f3e4723e619014c056946e4f226d9c0e8f48a
Partial-Bug: #1353688

SauloAislan/ironic,naterh/ironic,bacaldwell/ironic,dims/ironic,ionutbalutoiu/ironic,hpproliant/ironic,naototty/vagrant-lxc-ironic,debayanray/ironic_backup,faizan-barmawer/openstack_ironic,NaohiroTamura/ironic,bacaldwell/ironic,pshchelo/ironic,froyobin/ironic,openstack/ironic,openstack/ironic,naototty/vagrant-lxc-ironic,devananda/ironic,rdo-management/ironic,dims/ironic,pshchelo/ironic,Tehsmash/ironic,redhat-openstack/ironic,ionutbalutoiu/ironic,Tan0/ironic,rackerlabs/ironic,supermari0/ironic,SauloAislan/ironic,ramineni/myironic,NaohiroTamura/ironic