cleans up the aspects to make them more flexible and adds documentation to the README