included external documentation

modified some internal documentation