Trace:

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
member_s_guide:issue_tracking [09.12.2023 23:27] – [Hookshot] added steps to set up the bridge Holly Poermember_s_guide:issue_tracking [11.12.2023 11:45] (current) – started a FAQ section. Added the "bridge" message to the Hookshot section. Holly Poer
Line 26: Line 26:
  
 First, log into your own account at https://github.com  First, log into your own account at https://github.com 
-If you don't have an account already, go ahead and make one, it's free.  Stay logged in while we continue to the next step.+If you don't have an account already, go ahead and make one, it's free (preferably on a desktop/laptop).  Stay logged in while we continue to the next step.
  
  
Line 39: Line 39:
  
 ====== Matrix ====== ====== Matrix ======
 +
  
 Third, log into your hacklab.fi Matrix account at https://app.element.io Third, log into your hacklab.fi Matrix account at https://app.element.io
Line 46: Line 47:
  
 ====== Hookshot ====== ====== Hookshot ======
 +
  
 Good, you are now logged into both Github and Hacklab.fi's Matrix.  Let's tell the bot about the machine trouble and let it do it's magic.  In Matrix (Element), use the "Start New Chat" option (found under People) to open a DM with @hookshot:hacklab.fi (our bot).  Type your message to the bot Good, you are now logged into both Github and Hacklab.fi's Matrix.  Let's tell the bot about the machine trouble and let it do it's magic.  In Matrix (Element), use the "Start New Chat" option (found under People) to open a DM with @hookshot:hacklab.fi (our bot).  Type your message to the bot
Line 55: Line 57:
 ''github login'' ''github login''
  
-and the bot will offer you a link to follow, to give access to your Github account (the one you are still logged into) to the Hookshot "bridge".  Do that.  Then come back to Matrix and message the bot again+and the bot will offer you a link to follow, to give access to your Github account (the one you are still logged into) to the Hookshot "bridge".  Do that.  You will see a message, "Your github account has been bridged."  Then come back to Matrix and message the bot again
  
 ''github status'' ''github status''
Line 63: Line 65:
  
  
 +====== Report the Issue ======
 +
 +
 +In Matrix, navigate to our "Asiakanava" channel located at [[https://chat.hacklab.fi/#/room/#tampere-asiakanava:hacklab.fi]]
 +There, in the chat, type
 +
 +<code>!gh create "ToolName is broken -- YourName" "ToolName has power, and it turns on, but the gears don't turn."
 +</code>
 +
 +If you are still logged into Hookshot, then it will reply, "Issue #42 1"
 +
 +Hookshot created a new issue in our GitHub issue tracker, gave it the title "ToolName is broken -- YourName" (include your name so that we know who we can ask about it), and gave it the description "ToolName has power, and it turns on, but the gears don't turn."
 +You can go have a look at it in GitHub at [[https://github.com/TampereHacklab/Inventaario/issues]]
 +
 +
 +====== Frequently Asked Questions ======
 +
 +How can I learn more about this Hookshot bridge?
 +
 +  * Right here --> https://github.com/hacklab-fi/itinfra/blob/master/matrix/matrix-hookshot.md
 +
 +Can I create new issues directly in GitHub and skip the bot?
 +
 +  * Yes  --> https://github.com/TampereHacklab/Inventaario
 +
 +The bot won't talk to me.  Why?
 +
 +  * Check your settings in Matrix (Security&Privacy, Cryptography) and be sure that the "Never send encrypted messages to unverified sessions from this session" option is switched off.  Hookshot can't verify and won't receive your messages if this switch is on.
 +  * Verify that you are using Matrix and not Telegram to message the bot.
 +  * Verify that the quotation marks used in the code are the straight kind and not the left/right kind.
  
  
  
Back to top