add exmaples on the interfaces.
increased having documentation, deprecated old methods.