split up documentation, added examples