[IMP] a few howto improvements

* better use of website APIs
* edition of some pieces and bits of texts which don't work/make sense anymore
  in the new API (or w/ git)