docs: improve readme with crucial details