Complete guidelines to get participated in the HACKTOBERFEST 2022

[Amit Gujarathi]

Hi All,

As you know we are in the month of October , and as always its time for HACKTOBERFEST 2022.

Its reallly great to see how tons of developers are participating and with the new comers in this domain , there are a lot of people who are actually new to GIT and HACKTOBERFEST also.

So in this article I will try to create an end to end guidelines based on all the queries in received.

So lets get started !!!!

Lets first understand what is this HACKTOBERFEST  and GIT

• HACKTOBERFEST :

Hacktoberfest is DigitalOcean’s annual event that encourages people to contribute to open source throughout October. Much of modern tech infrastructure—including some of DigitalOcean’s own products—relies on open-source projects built and maintained by passionate people who often don’t have the staff or budgets to do much more than keep the project alive. Hacktoberfest is all about giving back to those projects, sharpening skills, and celebrating all things open source, especially the people that make open source so special.

• GIT :

Git is a free and open source distributed version control system designed to handle everything from small to very large projects with speed and efficiency.

Now lets start how we can participate in the same

1. Create a account on GitHub
   1. Navigate to https://github.com/
   2. Sign up to the GitHub
   3. 
2. Create account on
   1. Navigate to https://hacktoberfest.com/
   2. 
   3. Sign up on hacktoberfest using Github
   4. 
3. Once this is done your account set up is done. Now you are ready to contribute to the HackoctoberFest
4. Open the ServiceNow blog link https://developer.servicenow.com/blog.do?p=/post/hacktoberfest-2022/#code-snippets to get the details of all the project for which you can contribute. The project list are as given below :
   1. Slacker Bot
   2. Recipes App
   3. Fleet Management App
   4. Code Snippets
   5. Plants App
   6. Integration Hub Spokes
   7. Instance Scan Checks
   8. Syntax Macros
   9. SWAG Portal
   10. Points Thing
5. Click on the project link where you wanna contribute, it will redirect to the logged in GitHub . In that to the project repository.
6. Now in the selected project check for 2 files
   1. CONTRIBUTING.md
   2. README.md
   3. 
7. This 2 files will give you complete understanding of below things :
   1. What this project is all about ?
   2. How you can contribute to this project ?
   3. What is expected contribution to the project ?
8. Based on above points you can take a call if you wanna contribute to that project or explore on others.
9. Once you finalize the project we can start for the set up
10. Generate PAT token for GIT for Authentication on ServiceNow
    
    1. For this log in to GitHub account
    2. 
    3. Navigate to Settings
    4. 
    5.  
    6. Navigate to Developer settings
    7. 
    8. Click on Personal access token
    9. 
    10. Click on Generate new token
    11. 
    12. Select all scope and Expiration and provide note
    13. 
    14. Click on Generate token
    15. 
    16. You will get the token . Just make a note of the same
11. Now click on the project link where you wanna contribute and it will route you to the Git project
12. Fork the repository
    1. Click on Fork
    2. Create a new Fork for the project
    3. 
    4. Copy the fork URL
13. Create a Branch
    1. Click on main branch
    2. Type the name of the new Sub Branch which you wanna create
    3. 
    4. Click on the "Create branch xyz from main"
    5. 
14. Once the Branch is completed Open your ServiceNow PDI
15. Create Credentials
    1. Navigate to Connection and Credentials >> Credentials
    2. 
    3. Create New
    4. 
    5. Select Type as Basic Auth Credentials
    6. 
    7. Fill the form and submit
       1. Name : Any name for credentials
       2. Username : UserName of your Git account
       3. Password : PAT token which you have generated in step 1
16. Now Navigate to Studio for importing the application
17. Import application from source control
    1. Open ServiceNow Studio
    2. Click on Import from Source Control
    3. 
    4. Provide the required details
       1. URL : URL of the forked repository on GitHub 12
       2. Credentials : Credentials created in step 15
       3. Click on  Import it will import the application files from copied repo to the ServiceNow PDI
       4. 
18. Now you can add your code Create , update, modify files the way you want to enhance the application
19. Once you are done with the contribution commit the changes
20. Commit changes
    1. Open studio
    2. Click on Source Control
    3. Commit Changes
    4. 
    5. Select the files which you want to commit
    6. Provide readme instructions for the same
21. The code is being commit
22. Open GitHub the forked repository
23. You will see create pull request option on banner
24. Create Pull request
25. Wait for the Pull Request to be reviewed and merged
26. 
27. Hurray you are done with the entire life
28. Create 4 such pull request and win Tshirt

Note : The Source control will be possible onlyb for application repository . For repositoy like code snippet and Syntax macros you have to upload the file at Git only. So skip steps after 13.

Hope you will find this article useful If yes please mark it HElpful or Correct.

Regards,

Amit Gujarathi

[Community Alums]

Thanks for sharing this article! Very helpful for first time contributor.

Cheers

Abhishek Pandey