let's make a markdown readme as well.
breaking down the methods and spec them