Fix issues with documentations

[alifbe]

There are a few issues when building Sphinx docs

• Missing/wrong file link (issue Documentation has "expand" sections that does not work #271):
  I have modified the file path to files generated by run_examples.sh script
• Missing spacing in code-blocks
  Add 1 line break make the code-blocks appear in the documentation
• Missing reference to ert library
  dataio.scripts.create_case_metadata module has reference to ert_shared (ert library) which is not specified in requirements

[alifbe]

@jcrivenaes @perolavsvendsen can you please check this PR?

[perolavsvendsen]

Is the ERT dependency actually needed or can it be mocked (just imported, never used)? https://stackoverflow.com/a/56918885/8381388

[perolavsvendsen]

I am fine with it 👍 But consider the comment about ert import. If it should be mocked.

[jcrivenaes]

Looks good 👍

[alifbe]

I am fine with it +1 But consider the comment about ert import. If it should be mocked.

Nice. I didn't know about autodoc mocking feature. I have now put it in and it works great.

I don't have write access to the repo. Can someone help me merge it?

[perolavsvendsen]

I don't have write access to the repo. Can someone help me merge it?

You should have write access now 👍

[alifbe]

I don't have write access to the repo. Can someone help me merge it?

You should have write access now 👍

Thanks @perolavsvendsen