docs: added more notes about --machine-readable and replaced all changes about -...