improving docs as per tips from @clarete. Thanks brother.