added doctest note
cleaned up api