added some design notes, moved things around
made testing work from browser