update docblock, fix typos, improve composer.json

rebased & removed