added references, refactored intro and some perfs