updated readme, added annotation to scripts.js