some technical documentation updates