docs/Update or kill obsolete documentation

[WilliamHPNielsen]

Fixes #839

Changes proposed in this pull request:

• Update the old and broken documentation

Documentation completed:

• Metadata.ipynb
• Metadata with instruments.ipynb
• Qcodes location-format example.ipynb
• index.rst

@QCoDeS/core

[codecov]

Codecov Report

Merging #918 into master will not change coverage.
The diff coverage is n/a.

@@           Coverage Diff           @@
##           master     #918   +/-   ##
=======================================
  Coverage   78.63%   78.63%           
=======================================
  Files          33       33           
  Lines        4536     4536           
=======================================
  Hits         3567     3567           
  Misses        969      969

[WilliamHPNielsen]

So I had some problems with the docs build. In markdown, you can have a line break by adding two whitespaces, so that this: Line␣one␣␣Line␣two turns into

Line one
Line two

which I used in a notebook, but that apparently leads to invalid .rst files. Shooks.

[WilliamHPNielsen]

This one is ready for review now.

[jenshnielsen]

@WilliamHPNielsen The annoying thing is that travis runs Ubuntu 14.04 which has a quite old version of Pandoc with lots of bugs that are fixed in newer versions (as the one that you are likely to have from Homebrew or any other source of install on your own computer)

[WilliamHPNielsen]

@jenshnielsen I see. I did indeed have some problems reproducing the results locally. That's also why I "reported" the problem here, just in case anyone else runs into it.

[jenshnielsen]

Looks like a clear improvement