add a bit better docs, still more to come