clarify schema base on swagger1.2 specification