reviewed, updated, and added comments to public folder and specs