finalized flashmob draft 1 and updated docs
small tweaks