User_stories and feature requests appended to sphinx

  also some markup fixes to treat toctree look

Change-Id: Ibeac44a79e60dc6b2d82259a199856ad67c5fc36
Doc samples to rst

  Added 2 scripts for generating rst from samples
  Added tox env section for this operation
  Edited some README files to improve appearance

Change-Id: I55fbf74744286b9582d78693fa21556fda5300fe