search

rit-sse / hubot

Our slack hubot
0 stars 0 forks source link

Improve 'list commands' Details #9

Closed wademauger closed 8 years ago

wademauger commented 8 years ago

[bot name] DM's a long list of commands, many of which are not self-explanatory. This could be improved by adding a description to each one, providing some detail of the command's function.

weswigham commented 8 years ago

We used to have a webpage it would tell you do go to that had descriptions, precisely because of this wall of text problem, afaik >.>

bbesmanoff commented 8 years ago

Hubot scripts, when properly formatted, have help. DMing help gives those, but not the ids for enable/disable

-----Original Message----- From: "Wesley Wigham" notifications@github.com Sent: ‎7/‎31/‎2015 15:32 To: "rit-sse/hubot" hubot@noreply.github.com Subject: Re: [hubot] Improve 'list commands' Details (#9)

We used to have a webpage it would tell you do go to that had descriptions, precisely because of this wall of text problem, afaik >.> — Reply to this email directly or view it on GitHub.

kristenmills commented 8 years ago

@weswigham http://web.ad.sofse.org:8765/zoidberg/help

And what brian says.

weswigham commented 8 years ago

aaayyyy, it still exists. Nice. Does the bot tell people about it in the reported help message? It probably should. We can enhance it with links to the command source and references to its ID.

kristenmills commented 8 years ago

I forgot to put it back in. I took it out because I didn't want people going to the wrong place then never put it back.

weswigham commented 8 years ago

:+1:

kristenmills commented 8 years ago

Actually what could be cool is a more organized help instead of list commands. It's not how hubot usually does it, but if you use listener metadata to store help text, we could get rid of list commands and the same functionality plus what wade wants can be a part of help.