Improvents and additions to the documentation

Change-Id: If6d56230c2df4325417b8abc638a372b8a24952b