updated internal docs