update docblock, fix typos, improve composer.json

Hello,
And sorry for the delay,
Why these lines?