update readme, doctest

@tomelm