fixed for dev center docs

commands/authorizations/create.js

@@ -34,7 +34,6 @@ module.exports = {
   topic: 'authorizations',
   command: 'create',
   description: 'create a new OAuth authorization',
-  help: 'This creates an authorization with access to your Heroku account.',
   needsAuth: true,
   flags: [
     {char: 'd', name: 'description', hasValue: true, description: 'set a custom authorization description'},
@@ -44,4 +43,15 @@ module.exports = {
     {name: 'json', description: 'output in json format'}
   ],
   run: cli.command(co.wrap(run))
+  help: `This creates an authorization with access to your Heroku account.
+
+  Example:
+
+    $ heroku authorizations:create
+    Creating OAuth Authorization... done
+    Client:      <none>
+    ID:         -3614-b8d5ff7a84e-febdfc45b1832-5698
+    Description: Long-lived user authorization
+    Scope:       global
+    Token:       2-434e9-b-1e5de876512a-ad49f3f8f8f62`
 }

commands/authorizations/index.js

@@ -31,5 +31,11 @@ module.exports = {
   flags: [
     {name: 'json', description: 'output in json format'}
   ],
-  run: cli.command(co.wrap(run))
+  run: cli.command(co.wrap(run)),
+  help: `Example:
+
+    $ heroku authorizations
+    Heroku CLI                                                                                            48e44c6bbeded530997-e284866-d6-971-9  global
+    Heroku CLI login from shinobi at Tue Jul 18 2017 14:30:40 GMT-0500 (CDT)                              d-97-de93859d-d4c904d1bcd3-650423695  global
+    Heroku CLI login from aragami at Mon Jun 19 2017 14:36:09 GMT-0500 (CDT)                              6a83a-3b0443--de5074943feb047-aaefb9  global`
 }

commands/authorizations/info.js

@@ -22,5 +22,13 @@ module.exports = {
     {name: 'json', description: 'output in json format'}
   ],
   args: [{name: 'id'}],
-  run: cli.command(co.wrap(run))
+  run: cli.command(co.wrap(run)),
+  help: `Example:
+
+    $ heroku authorizations:info 93614-b8d5ff7a84e-febdfc45b1832-5698
+    Client:      <none>
+    ID:         -3614-b8d5ff7a84e-febdfc45b1832-5698
+    Description: Long-lived user authorization
+    Scope:       global
+    Token:       2-434e9-b-1e5de876512a-ad49f3f8f8f62`
 }

commands/authorizations/revoke.js

@@ -17,5 +17,10 @@ module.exports = {
   description: 'revoke OAuth authorization',
   needsAuth: true,
   args: [{name: 'id'}],
-  run: cli.command(co.wrap(run))
+  run: cli.command(co.wrap(run)),
+  help: `Example:
+
+    $ heroku authorizations:revoke 3614-b8d5ff7a84e-febdfc45b1832-5698
+    Revoking OAuth Authorization...
+    done, revoked authorization from Long-lived user authorization`
 }

commands/clients/create.js

@@ -40,5 +40,8 @@ module.exports = {
     {name: 'shell', char: 's', description: 'output in shell format'},
     {name: 'json', description: 'output in json format'}
   ],
-  run: cli.command(co.wrap(run))
+  run: cli.command(co.wrap(run)),
+  help: `Example:
+
+  $ heroku clients:create DEVAUTH https://my.authurl.suffix`
 }

commands/clients/destroy.js

@@ -18,5 +18,9 @@ module.exports = {
   description: 'delete client by ID',
   needsAuth: true,
   args: [{name: 'id'}],
-  run: cli.command(co.wrap(run))
+  run: cli.command(co.wrap(run)),
+  help: `Example:
+
+    $ heroku clients:destroy DEVAUTH
+    Destroying DEVAUTH... done`
 }

commands/clients/index.js

@@ -31,5 +31,8 @@ module.exports = {
   flags: [
     {name: 'json', description: 'output in json format'}
   ],
-  run: cli.command(co.wrap(run))
+  run: cli.command(co.wrap(run)),
+  help: `Example:
+
+    $ heroku clients`
 }

commands/clients/info.js

@@ -26,5 +26,8 @@ module.exports = {
     {name: 'json', description: 'output in json format'},
     {name: 'shell', char: 's', description: 'output in shell format'}
   ],
-  run: cli.command(co.wrap(run))
+  run: cli.command(co.wrap(run)),
+  help: `Example:
+
+    $ heroku clients:info DEVAUTH`
 }

commands/clients/update.js

@@ -37,5 +37,8 @@ module.exports = {
     {name: 'url', hasValue: true, description: 'change the client redirect URL'}
   ],
   needsAuth: true,
-  run: cli.command(co.wrap(run))
+  run: cli.command(co.wrap(run)),
+  help: `Example:
+
+  $ heroku clients:update DEVAUTH -n NEW_DEVAUTH` 
 }

commands/sessions/destroy.js

@@ -19,5 +19,9 @@ module.exports = {
   description: 'delete (logout) OAuth session by ID',
   needsAuth: true,
   args: [{name: 'id'}],
-  run: cli.command(co.wrap(run))
+  run: cli.command(co.wrap(run)),
+  help: `Example:
+
+    $ heroku sessions:destroy e4-c4f6b98d0d-57ca40279ef36c4-d-312b
+    Destroying 2e3eac53-b82c-4a46-8c0e-e2edd404c1c8... done`
 }

commands/sessions/index.js

@@ -30,5 +30,14 @@ module.exports = {
   flags: [
     {name: 'json', description: 'output in json format'}
   ],
-  run: cli.command(co.wrap(run))
+  run: cli.command(co.wrap(run)),
+  help: `Example:
+
+   $ heroku sessions
+    Session @ 12.34.56.789 e4-c4f6b98d0d-57ca40279ef36c4-d-310
+    Session @ 12.34.56.789 e4-c4f6b98d0d-57ca40279ef36c4-d-312
+    Session @ 12.34.56.789 e4-c4f6b98d0d-57ca40279ef36c4-d-313
+    Session @ 12.34.56.789 e4-c4f6b98d0d-57ca40279ef36c4-d-314
+    Session @ 12.34.56.789 e4-c4f6b98d0d-57ca40279ef36c4-d-319
+    Session @ 12.34.56.789 e4-c4f6b98d0d-57ca40279ef36c4-d-311`
 }