fullfilling README and documentation