I'm not sure if the documentation is broken, or the module itself. The docs are consistent with how Imager usually works (using "new" to make object and possibly load data, or using "read" on object to load data, then giving "file => $file" hash to write method). Patching the docs would get the current module working for people, whereas patching the module would make it conform to the docs and work like usual Imager code.

🤔

Raising your findings/concerns as an issue would be good, helpful to anyone else who may run into the same problem you did.