more readme + some var renaming