[development] Schema API documentation updated

[Barry Jaspan]

beerfan <beerfan at gmail.com> writes:
> > I have updated and reorganized the Schema API documentation,
> 
> I don't see any provision for table or field comments. Am I just blind
> or this is an oversight?

It's an oversight.  In fact, you can put any additional keys into the
schema structure you want, but of course we should specify the keys
and format to use so everyone does the same thing.  I'll add this.

Thanks,

Barry