A bunch of changes that I hope will help in understanding it
better for first-time readers.
Signed-off-by: NKonrad Rzeszutek Wilk <konrad.wilk@oracle.com>
Signed-off-by: NDan Williams <dan.j.williams@intel.com>