docu: embedding the new examples in the docu