Updates docs as per conversations on Github