making some progress on the docs