Document api types wrt validation

Part 3 in a series of changes towards data validation.
Or make all of these be end-of-line comments (on multiple lines?  yick)


On Tue, Jul 1, 2014 at 9:14 AM, Daniel Smith <notifications@github.com>
wrote:

> In pkg/api/types.go:
>
> > @@ -16,34 +16,70 @@ limitations under the License.
> >
> >  package api
> >
> > +// Common string formats
>
> I would prefer that comments be in this file, so they show up in godoc.
> Maybe we could write a script to instead generate the RAML from here? ;)
>
> --
> Reply to this email directly or view it on GitHub
> <https://github.com/GoogleCloudPlatform/kubernetes/pull/312/files#r14413581>
> .
>