expand documentation

add more docs here, to move away from docs on the wiki