Add more detail comments for each field

[haorenfsa]

The compiler will compile the comments into the target languages.
Take golang as example, the godoc is generated by comments. This will make it look prettier.

I'm writing the documents for RESTful APIs. And I'm using swagger for document generation.
Swagger generates field description by golang comment as well. So more comments would helps a lot.