Improve schema doc

@mhahn I've Improved schema docs. Take a look at it https://github.com/CodePath-MAF/SharedAssets/blob/improve-schema-doc/schemas.md

Please review.

/cc @NinjaSudo