* ngclient and Metadata API are production ready: start with them, then
  mention legacy
* link to API reference instead of code
* link to examples instead of (legacy) getting started document

Signed-off-by: Jussi Kukkonen <jkukkonen@vmware.com>