-
Resolution:
Show
https://www.oasis-open.org/committees/download.php/56709/odata-json-csdl-v4.0-wd01-2015-10-16.docx
Accepted: https://www.oasis-open.org/committees/download.php/56867/odata-meeting-112_on-20151105-minutes.html
JSON Schema defines keywords title and description, see
http://json-schema.org/latest/json-schema-validation.html#anchor98.
A "title" is short and seems to correspond to field labels or column headers, whereas "description" seems to correspond to an explanation shown as a tooltip. The latter seems in sync with use for Core.Description.
Currently the Core annotation Description is represented as an instance annotation:
"@Core.Description": "Some explanatory text explaining this model element and its use and/or restrictions"
Instead it could become a JSON Schema description:
"description": "Some explanatory text explaining this model element and its use and/or restrictions"
Pro:
- Recognizable by JSON Schema consumers
Con:
- Different representation as @Core.LongDescription which doesn't have a counterpart in JSON Schema
{"report":{"apdex":0.5,"isInitial":true,"journeyId":"a3cc1d2c-ad4c-43d1-b46b-0dc761d5b3e4","key":"jira.project.issue.view-issue","navigationType":0,"readyForUser":1038.6000003814697,"redirectCount":0,"resourceLoadedEnd":1777.7000002861023,"resourceLoadedStart":389.40000009536743,"resourceTiming":[{"duration":294.5,"initiatorType":"link","name":"https://issues.oasis-open.org/s/3edeca31ab9ba77980aae0809fbe7121-CDN/nu8zej/803004/aeedb5937bed650f2f0cc4ec9ceaa5d3/0a4716d29b2d5b1bdcdb168b4efc119e/_/download/contextbatch/css/_super/batch.css","startTime":389.40000009536743,"connectEnd":0,"connectStart":0,"domainLookupEnd":0,"domainLookupStart":0,"fetchStart":389.40000009536743,"redirectEnd":0,"redirectStart":0,"requestStart":0,"responseEnd":683.9000000953674,"responseStart":0,"secureConnectionStart":0},{"duration":294.5,"initiatorType":"link","name":"https://issues.oasis-open.org/s/7d2823769c2e7b66e860863fe879b7f8-CDN/nu8zej/803004/aeedb5937bed650f2f0cc4ec9ceaa5d3/9aebb1c0aaa4c36289529757ec9dbb54/_/download/contextbatch/css/project.issue.navigator,jira.view.issue,jira.global,atl.general,-_super/batch.css?agile_global_admin_condition=true&jag=true&jira.create.linked.issue=true&richediton=true","startTime":389.7000002861023,"connectEnd":0,"connectStart":0,"domainLookupEnd":0,"domainLookupStart":0,"fetchStart":389.7000002861023,"redirectEnd":0,"redirectStart":0,"requestStart":0,"responseEnd":684.2000002861023,"responseStart":0,"secureConnectionStart":0},{"duration":294.5,"initiatorType":"link","name":"https://issues.oasis-open.org/s/d41d8cd98f00b204e9800998ecf8427e-CDN/nu8zej/803004/aeedb5937bed650f2f0cc4ec9ceaa5d3/8.0.5/_/download/batch/com.atlassian.auiplugin:split_aui.pattern.label/com.atlassian.auiplugin:split_aui.pattern.label.css","startTime":389.90000009536743,"connectEnd":0,"connectStart":0,"domainLookupEnd":0,"domainLookupStart":0,"fetchStart":389.90000009536743,"redirectEnd":0,"redirectStart":0,"requestStart":0,"responseEnd":684.4000000953674,"responseStart":0,"secureConnectionStart":0},{"duration":294.3999996185303,"initiatorType":"link","name":"https://issues.oasis-open.org/s/645acc233eb869f48a571293b8358a7d-CDN/nu8zej/803004/aeedb5937bed650f2f0cc4ec9ceaa5d3/1.0/_/download/batch/jira.webresources:global-static-adgs/jira.webresources:global-static-adgs.css","startTime":390.1000003814697,"connectEnd":0,"connectStart":0,"domainLookupEnd":0,"domainLookupStart":0,"fetchStart":390.1000003814697,"redirectEnd":0,"redirectStart":0,"requestStart":0,"responseEnd":684.5,"responseStart":0,"secureConnectionStart":0},{"duration":294.19999980926514,"initiatorType":"link","name":"https://issues.oasis-open.org/s/a0dd6509771c1de0667aae5429c04cda-CDN/nu8zej/803004/aeedb5937bed650f2f0cc4ec9ceaa5d3/1.0/_/download/batch/jira.webresources:global-static/jira.webresources:global-static.css","startTime":390.30000019073486,"connectEnd":0,"connectStart":0,"domainLookupEnd":0,"domainLookupStart":0,"fetchStart":390.30000019073486,"redirectEnd":0,"redirectStart":0,"requestStart":0,"responseEnd":684.5,"responseStart":0,"secureConnectionStart":0},{"duration":332.6000003814697,"initiatorType":"script","name":"https://issues.oasis-open.org/s/e5479157e7a0c08b005e6522f2f04104-CDN/nu8zej/803004/aeedb5937bed650f2f0cc4ec9ceaa5d3/0a4716d29b2d5b1bdcdb168b4efc119e/_/download/contextbatch/js/_super/batch.js?locale=en-US","startTime":390.5,"connectEnd":390.5,"connectStart":390.5,"domainLookupEnd":390.5,"domainLookupStart":390.5,"fetchStart":390.5,"redirectEnd":0,"redirectStart":0,"requestStart":390.5,"responseEnd":723.1000003814697,"responseStart":723.1000003814697,"secureConnectionStart":390.5},{"duration":379.8999996185303,"initiatorType":"script","name":"https://issues.oasis-open.org/s/83514d5d4e8543747b02042eafcdc99c-CDN/nu8zej/803004/aeedb5937bed650f2f0cc4ec9ceaa5d3/9aebb1c0aaa4c36289529757ec9dbb54/_/download/contextbatch/js/project.issue.navigator,jira.view.issue,jira.global,atl.general,-_super/batch.js?agile_global_admin_condition=true&jag=true&jira.create.linked.issue=true&locale=en-US&richediton=true","startTime":391.1000003814697,"connectEnd":391.1000003814697,"connectStart":391.1000003814697,"domainLookupEnd":391.1000003814697,"domainLookupStart":391.1000003814697,"fetchStart":391.1000003814697,"redirectEnd":0,"redirectStart":0,"requestStart":391.1000003814697,"responseEnd":771,"responseStart":771,"secureConnectionStart":391.1000003814697},{"duration":382.19999980926514,"initiatorType":"script","name":"https://issues.oasis-open.org/s/70bb2263e59e7e1f04fbd137c80b895b-CDN/nu8zej/803004/aeedb5937bed650f2f0cc4ec9ceaa5d3/aae1242f5fc81cc6a5bb8bc963ccda29/_/download/contextbatch/js/atl.global,-_super/batch.js?locale=en-US","startTime":391.2000002861023,"connectEnd":391.2000002861023,"connectStart":391.2000002861023,"domainLookupEnd":391.2000002861023,"domainLookupStart":391.2000002861023,"fetchStart":391.2000002861023,"redirectEnd":0,"redirectStart":0,"requestStart":391.2000002861023,"responseEnd":773.4000000953674,"responseStart":773.4000000953674,"secureConnectionStart":391.2000002861023},{"duration":382.30000019073486,"initiatorType":"script","name":"https://issues.oasis-open.org/s/d41d8cd98f00b204e9800998ecf8427e-CDN/nu8zej/803004/aeedb5937bed650f2f0cc4ec9ceaa5d3/1.0/_/download/batch/jira.webresources:calendar-en/jira.webresources:calendar-en.js","startTime":391.40000009536743,"connectEnd":391.40000009536743,"connectStart":391.40000009536743,"domainLookupEnd":391.40000009536743,"domainLookupStart":391.40000009536743,"fetchStart":391.40000009536743,"redirectEnd":0,"redirectStart":0,"requestStart":391.40000009536743,"responseEnd":773.7000002861023,"responseStart":773.7000002861023,"secureConnectionStart":391.40000009536743},{"duration":382.69999980926514,"initiatorType":"script","name":"https://issues.oasis-open.org/s/d41d8cd98f00b204e9800998ecf8427e-CDN/nu8zej/803004/aeedb5937bed650f2f0cc4ec9ceaa5d3/1.0/_/download/batch/jira.webresources:calendar-localisation-moment/jira.webresources:calendar-localisation-moment.js","startTime":391.6000003814697,"connectEnd":391.6000003814697,"connectStart":391.6000003814697,"domainLookupEnd":391.6000003814697,"domainLookupStart":391.6000003814697,"fetchStart":391.6000003814697,"redirectEnd":0,"redirectStart":0,"requestStart":391.6000003814697,"responseEnd":774.3000001907349,"responseStart":774.3000001907349,"secureConnectionStart":391.6000003814697},{"duration":382.80000019073486,"initiatorType":"script","name":"https://issues.oasis-open.org/s/cda37faab827dbdf305de8efe8282062-CDN/nu8zej/803004/aeedb5937bed650f2f0cc4ec9ceaa5d3/8.0.5/_/download/batch/com.atlassian.auiplugin:split_aui.pattern.label/com.atlassian.auiplugin:split_aui.pattern.label.js?locale=en-US","startTime":391.80000019073486,"connectEnd":391.80000019073486,"connectStart":391.80000019073486,"domainLookupEnd":391.80000019073486,"domainLookupStart":391.80000019073486,"fetchStart":391.80000019073486,"redirectEnd":0,"redirectStart":0,"requestStart":391.80000019073486,"responseEnd":774.6000003814697,"responseStart":774.6000003814697,"secureConnectionStart":391.80000019073486},{"duration":472.6000003814697,"initiatorType":"link","name":"https://issues.oasis-open.org/s/07245784f53abc49bad9d9d4d36c577a-CDN/nu8zej/803004/aeedb5937bed650f2f0cc4ec9ceaa5d3/cadc4f20cc5c138dee060d42cf85f220/_/download/contextbatch/css/jira.global.look-and-feel,-_super/batch.css","startTime":392,"connectEnd":0,"connectStart":0,"domainLookupEnd":0,"domainLookupStart":0,"fetchStart":392,"redirectEnd":0,"redirectStart":0,"requestStart":0,"responseEnd":864.6000003814697,"responseStart":0,"secureConnectionStart":0},{"duration":382.90000009536743,"initiatorType":"script","name":"https://issues.oasis-open.org/rest/api/1.0/shortcuts/803004/a29179d70fa8562374ee16707692af77/shortcuts.js?context=issuenavigation&context=issueaction","startTime":392.2000002861023,"connectEnd":392.2000002861023,"connectStart":392.2000002861023,"domainLookupEnd":392.2000002861023,"domainLookupStart":392.2000002861023,"fetchStart":392.2000002861023,"redirectEnd":0,"redirectStart":0,"requestStart":392.2000002861023,"responseEnd":775.1000003814697,"responseStart":775.1000003814697,"secureConnectionStart":392.2000002861023},{"duration":447.59999990463257,"initiatorType":"link","name":"https://issues.oasis-open.org/s/f77fd89aa211a76b20e9b0e63564383c-CDN/nu8zej/803004/aeedb5937bed650f2f0cc4ec9ceaa5d3/4a9288299d147101bf66484f4be48925/_/download/contextbatch/css/com.atlassian.jira.projects.sidebar.init,-_super,-jira.view.issue,-project.issue.navigator/batch.css?jira.create.linked.issue=true&richediton=true","startTime":417.1000003814697,"connectEnd":0,"connectStart":0,"domainLookupEnd":0,"domainLookupStart":0,"fetchStart":417.1000003814697,"redirectEnd":0,"redirectStart":0,"requestStart":0,"responseEnd":864.7000002861023,"responseStart":0,"secureConnectionStart":0},{"duration":388.90000009536743,"initiatorType":"script","name":"https://issues.oasis-open.org/s/41525c48ddceeb9b11e54085268fc285-CDN/nu8zej/803004/aeedb5937bed650f2f0cc4ec9ceaa5d3/4a9288299d147101bf66484f4be48925/_/download/contextbatch/js/com.atlassian.jira.projects.sidebar.init,-_super,-jira.view.issue,-project.issue.navigator/batch.js?jira.create.linked.issue=true&locale=en-US&richediton=true","startTime":417.40000009536743,"connectEnd":417.40000009536743,"connectStart":417.40000009536743,"domainLookupEnd":417.40000009536743,"domainLookupStart":417.40000009536743,"fetchStart":417.40000009536743,"redirectEnd":0,"redirectStart":0,"requestStart":417.40000009536743,"responseEnd":806.3000001907349,"responseStart":806.3000001907349,"secureConnectionStart":417.40000009536743}],"threshold":1000,"fetchStart":0,"domainLookupStart":286,"domainLookupEnd":286,"connectStart":286,"connectEnd":335,"secureConnectionStart":310,"requestStart":335,"responseStart":381,"responseEnd":435,"domLoading":384,"domInteractive":1795,"domContentLoadedEventStart":1795,"domContentLoadedEventEnd":1836,"domComplete":2108,"loadEventStart":2108,"loadEventEnd":2110,"userAgent":"Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)","marks":[],"measures":[],"correlationId":"6942e1e3929019","effectiveType":"4g","downlink":9.2,"rtt":0,"serverDuration":75,"dbReadsTimeInMs":10,"dbConnsTimeInMs":12,"applicationHash":"4d4040e0714d65b7fffa4801569d014c0b16eaa9","experiments":[]}}
Resolved as proposed 2015-10-15.