Add upstream-like Dockerfile for generating api docs

Add Makefile target:
  make api

https://github.com/openshift/kubernetes/commit/0a05574463f5084ec43d39392333f051a26d68b4
Fix api .raml file parse error
Merge pull request #80 from VojtechVitek/api_docgen

Merged by openshift-bot