initial competition framework
minor updates and fixes
minor documentation updates