update docblock, fix typos, improve composer.json