Please make the bob.examples uptodate

  • should go through migration guide
  • update to new doc style both in Python and cpp
  • explain how to write documentation properly with examples and guides