updated documentation and example cards