updated docs, still work in progress