Explain how to configure the bot with discord.

[coldcallbot-discord.git] / README

diff --git a/README b/README
index a972038157f8d3f73df874a8779bbfb5d20eefcf..611926e2c9bcf21523ebf7b615733c2ea0fd33d7 100644 (file)
--- a/README
+++ b/README
@@ -6,9 +6,22 @@ module available in PyPi and installable like:
 
     $ pip3 install discord
 
 
     $ pip3 install discord
 

-I don't have details on how I set up my own Discord bot and/or invited
-it to my server but I hope you'll add to this file as you do this and
-figure out what needs to happen.
+Setting up the Bot
+=====================================
+
+The documentation for the `discord` python package
+(https://discordpy.readthedocs.io/en/latest/discord.html) does a good
+job explaining how to set up a Discord bot with your server. Follow
+the steps there, with one important exception:
+
+1. On the "Bot" tab in the discord application configuration page you
+need to enable both "Privileged Gateway Intents."  This allows the bot
+to see who is present and active in the channel.
+
+Finally, you need to copy your bot'ss Token (also found on the "Bot" tab)
+into coldcallbot.py. Pass it as the argument to `ccb.run()`.
+
+

 
 Using the Cold Call Bot
 ======================================
 
 Using the Cold Call Bot
 ======================================


@@ -129,6 +142,12 @@ compute_final_case_grades.R:
     `myuw-COM_482_A_autumn_2020_students.csv`) which is described
     above.
 
     `myuw-COM_482_A_autumn_2020_students.csv`) which is described
     above.
 

+    To run this script, you will need to create the following subdirectories:
+
+    data/case_grades
+    data/case_grades/student_reports
+
+

 One final note: A bunch of things in these scripts assumes a UW 4.0
 grade scale. I don't think it should be hard to map these onto some
 other scale, but that's an exercise I'll leave up to those that want
 One final note: A bunch of things in these scripts assumes a UW 4.0
 grade scale. I don't think it should be hard to map these onto some
 other scale, but that's an exercise I'll leave up to those that want