add doco about automap and primitives