Autoadd user stories and samples to sphinx

  2 scrips that build rst files and indexes and
  append them to sphinx

  also some markup fixes to treat toctree look

Change-Id: Ibeac44a79e60dc6b2d82259a199856ad67c5fc36