validation and documentation fixes
Moved codebooks to branch