Fix Markdown link paths

These should be relative to the current file.
Add note about API adapter for publishing API.
Merge pull request #56 from alphagov/more-doc-improvements

More doc improvements