voltage icon indicating copy to clipboard operation
voltage copied to clipboard

add documentation for event listeners

Open williamcommu opened this issue 3 years ago • 34 comments

Summary

adding documentation for event listeners and what they listen for

What is the feature request for?

The documentation

The Problem

not annoying enoki when i dont know how to do something because of the lack of documentation on the subject

The Ideal Solution

adding documentation going into a short detail on how to listen for message edits, deletes, or sends and using them to create commands

The Current Solution

annoying enoki

Additional Context

No response

williamcommu avatar May 05 '22 13:05 williamcommu

I agree, that could be usefull. Because I don't know what are the possible events to use. The events name from the revolt.js page doesn't seems to work.

0x4c756e61 avatar May 15 '22 13:05 0x4c756e61

well atleast untill readthedocs stops being weird ~~or I stop being stupid~~ all the possible events can be found by going to internals/ws.py and searching for dispatch

EnokiUN avatar May 15 '22 14:05 EnokiUN

Thanks, that is usefull. Gonna list all of them:

  • onReady : "ready"
  • onMessage : "message"
  • onMessageEdit : "message_update"
  • onmessageDelete : "message_delete"
  • onChannelCreate : "channel_create"
  • oncChannelEdit : "channel_update"
  • onChannelDelete : "channel_delete"
  • onGroupChannelJoin : "group_channel_join"
  • onGroupChannelLeave : "group_channel_leave"
  • onUserStartsTyping : "channel_start_typing"
  • onUserStopsTyping : "channel_stop_typing"
  • onServerEdit : "server_update"
  • onServerDelete : "server_delete"
  • onServerMemberEdit : "server_member_update"
  • onMemberJoin : "member_join"
  • onMemberLeave : "member_leave"
  • onRoleEdit : "server_role_update"
  • onRoleDelete : "server_role_delete"
  • onUserEdit : "user_update"

That's all of it

0x4c756e61 avatar May 15 '22 15:05 0x4c756e61

well atleast untill readthedocs stops being weird ~or I stop being stupid~ all the possible events can be found by going to internals/ws.py and searching for dispatch

im as clueless as u are with the docs situation at this point it would be in our best interest to kind of factory reset the docs to see why they're failing

williamcommu avatar May 17 '22 13:05 williamcommu

Could be a solution

0x4c756e61 avatar May 17 '22 16:05 0x4c756e61

Could be a solution

best to try it if enoki ever gets online today

williamcommu avatar May 17 '22 17:05 williamcommu

well atleast untill readthedocs stops being weird ~or I stop being stupid~ all the possible events can be found by going to internals/ws.py and searching for dispatch

im as clueless as u are with the docs situation at this point it would be in our best interest to kind of factory reset the docs to see why they're failing

I've tried, I really have

EnokiUN avatar May 17 '22 17:05 EnokiUN

well atleast untill readthedocs stops being weird ~or I stop being stupid~ all the possible events can be found by going to internals/ws.py and searching for dispatch

im as clueless as u are with the docs situation at this point it would be in our best interest to kind of factory reset the docs to see why they're failing

I've tried, I really have

oh i know you've basically gone insane over the docs problem, at this point would it be in our best interest to just, make it? instead of using readthedocs.io, we can just make a website for it? it seems like it would be a quick fix, or maybe a permanent one? because we can basically have all the same items and more detail if we need it. plus no more rst

williamcommu avatar May 17 '22 17:05 williamcommu

well atleast untill readthedocs stops being weird ~or I stop being stupid~ all the possible events can be found by going to internals/ws.py and searching for dispatch

im as clueless as u are with the docs situation at this point it would be in our best interest to kind of factory reset the docs to see why they're failing

I've tried, I really have

well atleast untill readthedocs stops being weird ~or I stop being stupid~ all the possible events can be found by going to internals/ws.py and searching for dispatch

im as clueless as u are with the docs situation at this point it would be in our best interest to kind of factory reset the docs to see why they're failing

I've tried, I really have

oh i know you've basically gone insane over the docs problem, at this point would it be in our best interest to just, make it? instead of using readthedocs.io, we can just make a website for it? it seems like it would be a quick fix, or maybe a permanent one? because we can basically have all the same items and more detail if we need it. plus no more rst

I'm still going to use rst as it builds without any issue, even on my phone.

I've considered using a website but that requires getting a domain and hosting it.

Maybe github pages will bring us salvation?

EnokiUN avatar May 17 '22 17:05 EnokiUN

github pages is perfect, because we can just host the pages site in a folder unrelated to voltage, plus if u need css or just help with starting and styling the site :trollface: ask me

williamcommu avatar May 17 '22 17:05 williamcommu

We could just use markdown, also github as a wiki feature

0x4c756e61 avatar May 17 '22 17:05 0x4c756e61

yeah but that limits our options and our ability to style certain objects and to display and optimise

williamcommu avatar May 17 '22 17:05 williamcommu

we could use markdown, html, and rst, but html and rst are probably our best bet if we want the site to be "bearable"

williamcommu avatar May 17 '22 17:05 williamcommu

Issue isn't rst, infact it's making life easier. Issue is rtd not working with attributetable for some reason SPECIFICALLY for Voltage.

Maybe it's something stupid I did. idk

EnokiUN avatar May 17 '22 17:05 EnokiUN

lets just use gh pages with rst then, because without docs that will drive people away and also "limit" abilities (even thougbh they're a thing, they arent in the documentation, leaving people clueless)

williamcommu avatar May 17 '22 17:05 williamcommu

We could just setup a github pages running facebook's docusaurus That's what we did for our language project Swirl

0x4c756e61 avatar May 17 '22 17:05 0x4c756e61

good idea

williamcommu avatar May 17 '22 17:05 williamcommu

Let me try a thing

EnokiUN avatar May 17 '22 17:05 EnokiUN

make a new branch and start gh pages in there

williamcommu avatar May 17 '22 17:05 williamcommu

I started a gh page and uhhhh

css died?

EnokiUN avatar May 17 '22 17:05 EnokiUN

wat

williamcommu avatar May 17 '22 17:05 williamcommu

https://enokiun.github.io/voltage l

EnokiUN avatar May 17 '22 17:05 EnokiUN

i think we should start from scratch

williamcommu avatar May 17 '22 17:05 williamcommu

Both you and I know damn well that I no longer have the physical or mental requirements for that especially now that I'm coding on phone

EnokiUN avatar May 17 '22 18:05 EnokiUN

additionally, Leave this for the actual issue at hand, move to the docs discussion

EnokiUN avatar May 17 '22 18:05 EnokiUN

if someone is willing to, go to docs/source/api.rst and add a list of event names and the args they pass

EnokiUN avatar May 18 '22 13:05 EnokiUN

@ksIsCute @0x454d505459

EnokiUN avatar May 18 '22 13:05 EnokiUN

I would like to, but I don't know how to use the thing you used to generate docs using rst

0x4c756e61 avatar May 18 '22 13:05 0x4c756e61

to generate the docs you cd into docs and run make html tho rtd does that automatically for every commit

EnokiUN avatar May 18 '22 14:05 EnokiUN

🇧🇳

williamcommu avatar May 18 '22 14:05 williamcommu