updated internal documentation