update documentation, added examples