Differences

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

Link to this comparison view

Next revision		Previous revision
fi:member_s_guide:issue_tracking [09.12.2023 22:38] – created an introduction to the Lab's issue tracking Holly Poerfi:member_s_guide:issue_tracking [20.10.2025 17:02] (current) – external edit 127.0.0.1
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 47: Line 48:
 ====== 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.+ 
 +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 
 + 
 +''github status'' 
 + 
 +If it replies "You are not authenticated, please login.", then type a second message to the bot 
 + 
 +''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.  You will see a message, "Your github account has been bridged."  Then come back to Matrix and message the bot again 
 + 
 +''github status'' 
 + 
 +It should reply "You are logged in as YourName".  Now you are ready to move on to the next step. 
 + 
 + 
 + 
 +====== 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.