{"action":"created","issue":{"url":"https://api.github.com/repos/postcss/postcss-cli/issues/1","repository_url":"https://api.github.com/repos/postcss/postcss-cli","labels_url":"https://api.github.com/repos/postcss/postcss-cli/issues/1/labels{/name}","comments_url":"https://api.github.com/repos/postcss/postcss-cli/issues/1/comments","events_url":"https://api.github.com/repos/postcss/postcss-cli/issues/1/events","html_url":"https://github.com/postcss/postcss-cli/issues/1","id":130035714,"number":1,"title":"Better API or docs","user":{"login":"ai","id":19343,"avatar_url":"https://avatars.githubusercontent.com/u/19343?v=3","gravatar_id":"","url":"https://api.github.com/users/ai","html_url":"https://github.com/ai","followers_url":"https://api.github.com/users/ai/followers","following_url":"https://api.github.com/users/ai/following{/other_user}","gists_url":"https://api.github.com/users/ai/gists{/gist_id}","starred_url":"https://api.github.com/users/ai/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ai/subscriptions","organizations_url":"https://api.github.com/users/ai/orgs","repos_url":"https://api.github.com/users/ai/repos","events_url":"https://api.github.com/users/ai/events{/privacy}","received_events_url":"https://api.github.com/users/ai/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":68,"created_at":"2016-01-30T20:59:45Z","updated_at":"2016-02-18T17:58:14Z","closed_at":null,"body":"Let’s think how we make CLI better."},"comment":{"url":"https://api.github.com/repos/postcss/postcss-cli/issues/comments/185835667","html_url":"https://github.com/postcss/postcss-cli/issues/1#issuecomment-185835667","issue_url":"https://api.github.com/repos/postcss/postcss-cli/issues/1","id":185835667,"user":{"login":"vitorgalvao","id":1699443,"avatar_url":"https://avatars.githubusercontent.com/u/1699443?v=3","gravatar_id":"","url":"https://api.github.com/users/vitorgalvao","html_url":"https://github.com/vitorgalvao","followers_url":"https://api.github.com/users/vitorgalvao/followers","following_url":"https://api.github.com/users/vitorgalvao/following{/other_user}","gists_url":"https://api.github.com/users/vitorgalvao/gists{/gist_id}","starred_url":"https://api.github.com/users/vitorgalvao/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/vitorgalvao/subscriptions","organizations_url":"https://api.github.com/users/vitorgalvao/orgs","repos_url":"https://api.github.com/users/vitorgalvao/repos","events_url":"https://api.github.com/users/vitorgalvao/events{/privacy}","received_events_url":"https://api.github.com/users/vitorgalvao/received_events","type":"User","site_admin":false},"created_at":"2016-02-18T17:58:14Z","updated_at":"2016-02-18T17:58:14Z","body":"I’m in agreement with @sindresorhus, for one simple important reason: clarity. I remember fighting with a tool (perhaps it was `postcss-cli`, even) some time ago while trying to figure out how to convert the examples in the a plugin pages to actual `--` commands (don’t remember the actual issue, perhaps there were nested commands, or something).\r\n\r\nI’m a heavy CLI user and build a lot of (mostly) `bash` and `ruby` scripts with flags. Even though `--` flags makes sense and is familiar, in this case we’re passing options to other tools, and at some point it just becomes confusing.\r\n\r\nTake [this autoprefixer example](https://github.com/postcss/autoprefixer#options). With @sindresorhus’ suggestion, it’d be trivial to convert. No need to transform their options into `--` flags, just copy and paste the example as is in the correct place.\r\n\r\nFrom the two examples, I think I prefer the first, but any of them seems like an improvement over the alternatives."}}