updated readme
started documenting implementation details