Description of all IRC bots #711
Comments
It is working great! There's also However, I recommend you to wait a couple of days before writing about these bots. There are way too many commits in the last few days (see https://github.com/perl6/bisectbot/), it would be sad to have some information become outdated tomorrow. |
English is not my native(really, really not), so for a native reader of docs my writing skills are quite limited. Because of that, I opened this issue instead of commiting, since I hope someone else will write this out. |
If we have a description for some bots, there's probably no reason not to write about all other bots we have. I changed the title of this issue.
|
Added desc for my bots. I think it's useful to add both the source (if people want to run a copy somewhere) and the contact for the person(s) who's running the bot in case something needs to be changed about the way the bot runs. |
I wonder if this is the sort of thing that better belongs in the rakudo On Tuesday, July 26, 2016, Zoffix Znet notifications@github.com wrote:
Will "Coke" Coleda |
I don't think that it does. To me it seems that creating language/community is a very good idea. All things like bot descriptions will be moved there eventually (per #728). Anyway, it is not rakudo-specific, so I'm not sure why would it fit rakudo wiki better than language docs. |
Sorry, yes, I was trying to indicate non-spec, not rakudo-specific. |
Maybe this belongs on perl6.org/community |
Hmm would something like a spec that bots can implement would do to document them automatically in some way? I could imagine some other IRC doc bot querying these others for their description, function lists, example usage. and maybe author and source (for those who wish to run a copy,) so the doc bot can update a page somewhere (just like a logger bot.) This way, there's less issue about the bot list going out of date. |
@zakame I don't think we will ever manage to implement something like this. Not all bots are controlled by us, so it is unlikely that there'd be something all bots will adhere to. I think a simple page with short descriptions of all bots (+ links to their documentation) is all we need. |
Oh, the problem is that there's no clear place where we could put it. I was suggesting |
Providing a place to put such a description can be enough of an incentive to make bot authors fill it. |
I suppose in https://perl6.org/community/irc then? Perhaps there should be a note there on how bot authors can update the list (e.g. post a new issue on the perl6.org repo, or reach someone on IRC, etc.) |
Can someone please update the list? I see some "soon to be decomissioned", for instance. |
Also there are more bots now. |
It's possible the list on https://perl6.org/community/irc is more up-to-date than this Issue. (I was under the impression it was already closed)
|
He was a good dalek.
So. Close this issue for good?
|
reportable, notable, shareable are not mentioned on the website. I think we'll also have |
Puffer bot is already listed. I do notice we list three bots in Glossary in the docs tho https://docs.perl6.org/language/glossary#IRC |
Is someone up for this? If you add one at a time, it's not such a hard work... |
As an addendum: Bots camelia, dalek and yoleaux are mentioned with links in https://docs.perl6.org/language/glossary#Bot but none of the links work. If they are documented, that could be fixed as well. However, the links in @AlexDaniel's list point to the same non-existent anchors in the Glossary. PS: Sorry, I accidentally clicked somewhere on AlexDaniel's list and that committed something. I can't roll back that change nor understand the "diff" it shows me to undo it. |
@taboege fixed! Yeah, github comments are weird. |
They were not moved, far as I know... They should be fixed, I guess |
At the Glossary page we already have
dalek
,camelia
andyoleaux
, but also we havebisectbot
. Is it still working? If yes, I think we should write about it too.The text was updated successfully, but these errors were encountered: