{"action":"closed","issue":{"url":"https://api.github.com/repos/mochajs/mocha/issues/787","labels_url":"https://api.github.com/repos/mochajs/mocha/issues/787/labels{/name}","comments_url":"https://api.github.com/repos/mochajs/mocha/issues/787/comments","events_url":"https://api.github.com/repos/mochajs/mocha/issues/787/events","html_url":"https://github.com/mochajs/mocha/issues/787","id":12520283,"number":787,"title":"Add ability to add \"comment\" specs","user":{"login":"tel","id":1141,"avatar_url":"https://avatars.githubusercontent.com/u/1141?v=3","gravatar_id":"","url":"https://api.github.com/users/tel","html_url":"https://github.com/tel","followers_url":"https://api.github.com/users/tel/followers","following_url":"https://api.github.com/users/tel/following{/other_user}","gists_url":"https://api.github.com/users/tel/gists{/gist_id}","starred_url":"https://api.github.com/users/tel/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/tel/subscriptions","organizations_url":"https://api.github.com/users/tel/orgs","repos_url":"https://api.github.com/users/tel/repos","events_url":"https://api.github.com/users/tel/events{/privacy}","received_events_url":"https://api.github.com/users/tel/received_events","type":"User","site_admin":false},"labels":[],"state":"closed","locked":false,"assignee":null,"milestone":null,"comments":1,"created_at":"2013-03-27T16:29:01Z","updated_at":"2015-03-14T20:16:00Z","closed_at":"2015-03-14T20:16:00Z","body":"Sometimes, especially when viewing test output in the browser or using the `spec` or `list` reporter, it'd be good for documentation to provide commentary on the stories being spec'd. For this reason, Id' like to be able to have a function `because` that could be used like\r\n\r\n```javascript\r\ndescribe('Some major feature', function () {\r\n  it('ought to do this')\r\n  because('but because sometimes X')\r\n  it('ought to do this when X')\r\n})\r\n```\r\n\r\nOr something to that regard. I can currently do that using a pending test case via `it`, but that's clearly the wrong semantics. Possible names/semantics are \"because\", \"why\", or \"commentary\"."}}