docs #3

add @docs for all the public facing apis
add @moduledoc for all the public facing modules

add @doc false for all the internal apis
make sure internal apis that might need testing has @doc false and @spec

read and look at here to learn how to write good docs
https://hexdocs.pm/elixir/writing-documentation.html#recommendations