The gemfile had
gem 'raddocs', :github => "smartlogic/raddocs"
which loads over http not https so is insecure.

At present, only option is :open_api, but this does not
produce output that is easily readable by user.
When the problem with the :json option is fixed see issue
zipmark#382
I suggest that :json option is added as well, users can
see output using raddocs.

This has been altered to take out any open_api code. Given there
is only one example spec in the README document, my view is that it should
not be specifically open_api, but just use the most general options.
I have bumped the level of this section up by two levels, as it no longer fits
under the open_api section of the format section.
I have also taken out or re-factored instances of <response>, given
I could not understand what the code did in this instance.
I note that the example code in the repository is open_api, so there
is already an example of open_api code.

to indicated that it uses the :open_api format

Put back open_api example spec in same place but labelled
it clearly as being open_api specific.
Moved generic example of spec up in document.