{"action":"created","issue":{"url":"https://api.github.com/repos/elasticsearch/elasticsearch/issues/9649","labels_url":"https://api.github.com/repos/elasticsearch/elasticsearch/issues/9649/labels{/name}","comments_url":"https://api.github.com/repos/elasticsearch/elasticsearch/issues/9649/comments","events_url":"https://api.github.com/repos/elasticsearch/elasticsearch/issues/9649/events","html_url":"https://github.com/elasticsearch/elasticsearch/issues/9649","id":57304339,"number":9649,"title":"Allow comments inside mapping","user":{"login":"drorata","id":2905978,"avatar_url":"https://avatars.githubusercontent.com/u/2905978?v=3","gravatar_id":"","url":"https://api.github.com/users/drorata","html_url":"https://github.com/drorata","followers_url":"https://api.github.com/users/drorata/followers","following_url":"https://api.github.com/users/drorata/following{/other_user}","gists_url":"https://api.github.com/users/drorata/gists{/gist_id}","starred_url":"https://api.github.com/users/drorata/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/drorata/subscriptions","organizations_url":"https://api.github.com/users/drorata/orgs","repos_url":"https://api.github.com/users/drorata/repos","events_url":"https://api.github.com/users/drorata/events{/privacy}","received_events_url":"https://api.github.com/users/drorata/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/elasticsearch/elasticsearch/labels/:Mapping","name":":Mapping","color":"009800"},{"url":"https://api.github.com/repos/elasticsearch/elasticsearch/labels/adoptme","name":"adoptme","color":"207de5"},{"url":"https://api.github.com/repos/elasticsearch/elasticsearch/labels/enhancement","name":"enhancement","color":"4a4ea8"}],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":6,"created_at":"2015-02-11T11:28:58Z","updated_at":"2015-02-13T12:49:07Z","closed_at":null,"body":"Currently, when invoking `GET indexname/_mapping` one gets a long list of the fields that can be expected in the index. All these have the form:\r\n\r\n```\r\n\"feed\": {\r\n            \"type\": \"string\",\r\n            \"index\": \"not_analyzed\"\r\n}\r\n```\r\n\r\nFor an end user, who normally cannot see the configuration, the name of the field and its properties might not be enough to understand what the field actually holds. Therefore, it would be very helpful to allow a comment field inside the object above. Here is an example:\r\n\r\n```\r\n\"feed\": {\r\n            \"type\": \"string\",\r\n            \"index\": \"not_analyzed\"\r\n            \"comment\": \"feed holds the name of the feed as provided by the client side\"\r\n}\r\n```\r\n\r\n"},"comment":{"url":"https://api.github.com/repos/elasticsearch/elasticsearch/issues/comments/74248703","html_url":"https://github.com/elasticsearch/elasticsearch/issues/9649#issuecomment-74248703","issue_url":"https://api.github.com/repos/elasticsearch/elasticsearch/issues/9649","id":74248703,"user":{"login":"dadoonet","id":274222,"avatar_url":"https://avatars.githubusercontent.com/u/274222?v=3","gravatar_id":"","url":"https://api.github.com/users/dadoonet","html_url":"https://github.com/dadoonet","followers_url":"https://api.github.com/users/dadoonet/followers","following_url":"https://api.github.com/users/dadoonet/following{/other_user}","gists_url":"https://api.github.com/users/dadoonet/gists{/gist_id}","starred_url":"https://api.github.com/users/dadoonet/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/dadoonet/subscriptions","organizations_url":"https://api.github.com/users/dadoonet/orgs","repos_url":"https://api.github.com/users/dadoonet/repos","events_url":"https://api.github.com/users/dadoonet/events{/privacy}","received_events_url":"https://api.github.com/users/dadoonet/received_events","type":"User","site_admin":false},"created_at":"2015-02-13T12:49:07Z","updated_at":"2015-02-13T12:49:07Z","body":"See also #1394. Though it was closed, I guess it was not really fixed? :)"}}