added explantory notes
added resource routes