first pass docs and code

do not merge, for discussion only (JNAP)