json - JSON 模式中 "description"字段的用途是什么？

Question

我不确定 JSON 模式“描述”字段的目的是什么。该字段是否用作评论空间？该字段是否用作 ID？

{
    "id": "http://www.noodle.org/entry-schema#",
    "schema": "http://json-schema.org/draft-04/schema#",
    "description": "schema for online courses",
    "type": "object",
    "properties": {
        "institution": {
            "type": "object",
           "$ref" : "#/definitions/institution" 
        },
        "person": {
            "type": "object",
            "items": {
                "type": "object",
                "$ref": "#/definitions/person"
            }   
    "definitions": {        
        "institution": {
            "description": "University",
            "type": "object",
            "properties": {
                "name":{"type":"string"},
                "url":{
                    "format": "uri",
                    "type": "string"
                },
                "descriptionofinstitution":{"type":"string"},
                "location": {
                    "description": "location",
                "type": "string",
                "required": true
                }
        }

}

Answer 1

根据 JSON-Schema 规范 (http://json-schema.org/latest/json-schema-validation.html#anchor98)，“描述”(和“标题”)字段的目的是用有关该用户界面生成的数据的信息来装饰用户界面。标题最好是简短的，而描述将提供有关此模式描述的实例的目的的解释。