(#1255) - begin rewriting docs (do not merge yet)