doc & readme md updates