renaming some ambiguous interface names, fleshing out docs and other changes
massive update to README