document some assumptions
add production mk.conf as it's been for a while