changes order of parameters in constructor for easier usage, updates examples in docblock accordingly