{"action":"opened","issue":{"url":"https://api.github.com/repos/VasiliyLysokobylko/raml-js-parser2-issues/issues/46","repository_url":"https://api.github.com/repos/VasiliyLysokobylko/raml-js-parser2-issues","labels_url":"https://api.github.com/repos/VasiliyLysokobylko/raml-js-parser2-issues/issues/46/labels{/name}","comments_url":"https://api.github.com/repos/VasiliyLysokobylko/raml-js-parser2-issues/issues/46/comments","events_url":"https://api.github.com/repos/VasiliyLysokobylko/raml-js-parser2-issues/issues/46/events","html_url":"https://github.com/VasiliyLysokobylko/raml-js-parser2-issues/issues/46","id":146541663,"number":46,"title":"Use tables and links to specific section instead of text only","user":{"login":"VasiliyLysokobylko","id":13314242,"avatar_url":"https://avatars.githubusercontent.com/u/13314242?v=3","gravatar_id":"","url":"https://api.github.com/users/VasiliyLysokobylko","html_url":"https://github.com/VasiliyLysokobylko","followers_url":"https://api.github.com/users/VasiliyLysokobylko/followers","following_url":"https://api.github.com/users/VasiliyLysokobylko/following{/other_user}","gists_url":"https://api.github.com/users/VasiliyLysokobylko/gists{/gist_id}","starred_url":"https://api.github.com/users/VasiliyLysokobylko/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/VasiliyLysokobylko/subscriptions","organizations_url":"https://api.github.com/users/VasiliyLysokobylko/orgs","repos_url":"https://api.github.com/users/VasiliyLysokobylko/repos","events_url":"https://api.github.com/users/VasiliyLysokobylko/events{/privacy}","received_events_url":"https://api.github.com/users/VasiliyLysokobylko/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/VasiliyLysokobylko/raml-js-parser2-issues/labels/content","name":"content","color":"ededed"},{"url":"https://api.github.com/repos/VasiliyLysokobylko/raml-js-parser2-issues/labels/raml10-rc2","name":"raml10-rc2","color":"ededed"}],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":0,"created_at":"2016-04-07T08:11:28Z","updated_at":"2016-04-07T08:11:28Z","closed_at":null,"body":"Currently, the spec has tables, text, and only few links. We want to improve the content by introducing a better table structure that basically contains the key name of a property, the value type (with link to the specific section), and a description. \r\n\r\nFor example, the value of the `documentation` node should look like the following:\r\n\r\n| Key Name  | Value Type | Description |\r\n|:----------|:----------:|:----------|\r\n| title | `string` | Non-empty string that represents the title of an individual document.\r\n| content | `string` | Non-empty markdown string that contains the content of an individual document.\r\n\r\nThat approach has to be applied consistently throughout the spec. Any redundant text should be also removed."}}