example.rst: improve and fill out python documentation

Signed-off-by: Brendan Le Foll <brendan.le.foll@intel.com>