improved documentation, added example project, simplified use in tests