add some documentation, fix card references