drafting vars, defs and docs