Update API docs

Kind is reserved for object level things

----- Original Message -----
> > -               ],
> > -               "owner": true
> > -             },
> > -             "labels": {
> > -               "name": "service-name"
> > -             }
> > +  "kind": "Template",
> > +  "id": "example1",
> > +  "name": "My awesome PHP app",
> > +  "description": "Example PHP application with PostgreSQL database",
> > +  "parameters": [
> > +    {
> > +      "name": "DB_PASSWORD",
> > +      "description": "PostgreSQL admin user password",
> > +      "type": "string",
> > +      "expression": "[a-zA-Z0-9]{8}"
> 
> ```
> {
> "name": "DB_PASSWORD",
> "generator": "generator_name",
> "value": "[a-zA-Z0-9]{8}"
> }
> ```
> 
> Maybe 'kind' instead of generator. @fabianofranz what do you think?
> 
> ---
> Reply to this email directly or view it on GitHub:
> https://github.com/openshift/origin/pull/97/files#r17776991