architecture: added intro and notes on javascript files