small updates to docs
fixup types to be paths (separated by %, not sure if I'll want to stick with that)