Introduction

It seems the API-description for "fetch" does not match the actual behaviour and the changelog information.

Issue Description

In the API description for "fetch"

https://bookshelfjs.org/api.html#Collection-instance-fetch

it reads

If you wish to trigger an error if the fetched collection is empty, pass {require: true} as one of the options to the fetch call

If you look TopicController@show and UserController@shelf you will see we are setting ogImage param in the response to view. The image url is not set properly there since the social images are not appearing in the social card both for twitter and facebook.

Examples:

1. https://booknshelf.com/topics/software-engineering
   <img width="1035" alt="image 2017-10-19 at 3 49 32 pm" src="https

When both options are passed, shallow: true should take priority since it is a standard Bookshelf option. Furthermore it should cause all ensureRelationsLoaded behavior to be avoided, since there's no reason to do unnecessary work loading relations that aren't going to be serialized--unless plugin option ensureRelationsVisibleAndInvisible is passed.