added link resource documentation
updated rspec syntax
Merge pull request #172 from firebelly/links_doc

added link resource documentation