Skip to content

Commit

Permalink
Merge pull request #37 from ise8933/main
Browse files Browse the repository at this point in the history
Contribution for Slack Bot
  • Loading branch information
MoralCode authored May 5, 2024
2 parents a93d0b0 + c3d9dc5 commit 5b2c767
Showing 1 changed file with 60 additions and 0 deletions.
60 changes: 60 additions & 0 deletions _posts/2024-05-03-slack-bot-docfix.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,60 @@
---
layout: post
# If your post title is longer or more complicated
# than can be represented in the filename, uncomment the following line
# and specify a custom title
# title: "CHAOSS Slack Bot Contribution"

# Uncomment only one of the below categories
categories:
#- Bug Fix
- Contribution


# Enter your name below
author: Isha Errande
---

For my contribution, I chose to contribute to the CHAOSS slack bot. The slack bot is built using bolt for javascript. The current main goal for this particular project is to make it easier for beginners to contribute.
I mainly did fixes to the main SETUP.md file and contributed ideas for the wiki.

## Introduction to Issue
Back when I was trying to make a contribution for my bug fix, I contacted CHAOSS both on slack and through their github to attempt to find an issue. I originally commented under issue [number 98](https://github.com/chaoss/chaoss-slack-bot/issues/98). I got a reply after after I completed my bug fix for a seperate project.

![image](https://github.com/ise8933/hfoss2024-blogs/assets/90360951/2913d295-d791-4eed-9048-551cf70da592)

The new issue consisted of adding a missing step within the setup doc. This is [issue 101](https://github.com/chaoss/chaoss-slack-bot/issues/101)
![image](https://github.com/ise8933/hfoss2024-blogs/assets/90360951/f950660a-2ff9-44af-9d85-75247e00b557)


## Solving the Issue

While trying to fix the issue, one of the main contributors closed the issue. I immediately double checked if the issue was fixed, and immediately messaged the main contributor to reopen the issue.

![image](https://github.com/ise8933/hfoss2024-blogs/assets/90360951/7f0d9fc9-d4eb-49c3-b1b6-cbfb227182aa)

After resolving this small hurdle, I was officially assigned the issue and started to go down the set up steps to see if anything was missing. While adding the step was an easy fix, I did end up finding other small issues
with the doc. For example, some of the scopes were in the wrong categories or missing in the wiki, leading to some confusion setting up the basic configurations. There were also a lack of images under some sections, and adding images would make it easier for a beginner to follow the instructions better.
The correct option to choose would be to choose "From Scatch" instead of "app Manifest". App manifest is for setting up scopes using a file that contains configurations for the user and bot scopes, name, etc for the bot app. In this case, the setup doc manually sets up the scopes, events, etc using Slack's existing UI. In the future, CHAOSS slack bot could have a new issue to make an app manifest which would save a considerable amount of time in the future. For now though, I added in the extra step below.


![image](https://github.com/ise8933/hfoss2024-blogs/assets/90360951/6989099d-ebcd-406c-8a4e-de25cd46f5f8)

In addition to this I also added extra images under the set up events section of SETUP.md
![image](https://github.com/ise8933/hfoss2024-blogs/assets/90360951/c4360600-3ddb-4fbc-b1aa-f28e8aa77106)


After finishing up this issue, I proceeded to add another section under the wiki for user scopes. There were tables for bot scopes and events, but having a table for user scopes would also help. I went back to issue [number 98](https://github.com/chaoss/chaoss-slack-bot/issues/98) and attempted to clone and contribute using the directions given. It failed to work for me, so I tagged the two contributors working on the section to add the table I made for the wiki section.

![image](https://github.com/ise8933/hfoss2024-blogs/assets/90360951/19f61f20-3377-41fc-bbc0-dce2a698344f)


## Resolution

In the end, the main issue I contributed to was accepted along with my corrections ! This was the first contribution I did which was accepted so it was a big accomplishment. I am still waiting for a reply for my wiki contribution.
![image](https://github.com/ise8933/hfoss2024-blogs/assets/90360951/bce487d0-d43d-420d-89df-616fe084d2a8)





0 comments on commit 5b2c767

Please sign in to comment.