implementation details, notes and typos in readme