More doc improvements

* Fix markdown links to relative doc content
* Mention the API adapter for writing content.
corrected.