fixes, refactorings, and comprehensive Readme on items