docs: improve the readme

closes #5