some decent docs in place