core: updating README docs for more clarity