Fixed run method
Added docstrings
Updated readme for `run` method. Thanks @berkerpeksag