manwar / perlweeklychallenge-club

The Weekly Challenge Club This is the central repository for the members of **The Weekly Challenge**. The members can submit the solution to the challenge each week in their favorite programming languages, although the preferred languages are **Perl** and **Raku**. EZPWC - Easy Perl Weekly Challenges Script **Saif Ahmed**, respected member of **Team PWC**, created the tool **EZPWC** to help you with contributing to the weekly challenge. We highly recommend you give it a try. If you have any questions/suggestions, then please raise an issue against the tool. How to contribute? Just submit a Pull Request with your solutions. First, find the latest challenge folder. The highest numbered folder is the latest challenge folder, e.g. challenge-002. You will probably find a folder by your name if you are an existing member. For example, if your name is **"Joe Blog"**, there would be a folder called **"joe-blog"**. Under your named folder, you will find a file **README**. Depending on your choice of language, you should create a folder here e.g. **perl** for **Perl** and **raku** for **Raku**. Inside each of these folders, you can save your solutions. If it is a Perl script for **Task #1**, call it **ch-1.pl**. Similarly, if it is a Perl script for **Task #2**, call it **ch-2.pl**. For **Raku** solutions, call it **ch-1.raku** and **ch-2.raku** respectively. And if you are writing a one-liner, call it **ch-1.sh** or **ch-2.sh**. If you are contributing for the first time, please create your named folder as described above. Also, let us know what name you would like us to use. If you have created a blog about your solutions, then create a file called **blog.txt** and add the link. If you have more than one blog, create another file called **blog1.txt** and add your link there. Step-by-step instructions Let us assume you want to submit solutions for **Challenge 002**, and your GitHub user name is **joe-blog**. • If you are submitting the solution for the first time, then you have to **Fork** the repository **https://github.com/manwar/perlweeklychallenge-club** by clicking the **"Fork"** button in the top right corner and should have the repository, e.g. **https://github.com/joe-blog/perlweeklychallenge-club**. • Go to your favorite terminal and **clone** your repository. • Create a new branch for the solution • Go to the **Challenge 002** folder. • If you find a folder with your name in the current folder, you can just go ahead and skip to the next step; otherwise, create a new folder. • Change into your named folder. • If you just created the folder, you should add a file **README** and add a line **Solution by Joe Blog** otherwise, skip to the next step. • If you want to submit **Perl 5** solutions, you should create a folder **perl** (if you still need to). Similarly, if you want to submit **Raku** solutions, then you should create a folder **raku** (if not already). • Change into your relevant folder depending on your choice **cd perl** or **cd raku**. • Now you are ready to add your solutions. If it is for the first challenge, create a file named **ch-1.pl** or **ch-1.raku** or **ch-1.sh**. Similarly, if it is for the second challenge, create a file named **ch-2.pl** or **ch-2.raku** or **ch-2.sh**. • Once you are happy with your solutions, add them to the repository. First, go back to **root** of the repository and then fire the command • Commit your changes. • Push your changes. • Now go to your fork repository in the GitHub web portal **https://github.com/joe-blog/perlweeklychallenge-club** • You should see a button to submit **Pull Request**. How to add a new solution when you already have the forked repository? Let us assume you already have the repository forked. If this is the first time you use the same forked repository for submitting subsequent challenges solution. I also assume your GitHub user name is **joe-blog**. • Checkout out the **master** branch first. • Check if you have set up **upstream**. You should see something similar: If you don't see **upstream** as above, then you need to set up your **upstream** like below: Check if you have everything set up correctly. If you see a similar output as above, you have set up **upstream** correctly. Just so you know, you only need to do it **once**. • Now we need to **fetch** latest changes from the **upstream**. • We will merge the changes into your local **master** branch. • Push your **master** changes back to the repository. • Now it is time to create a new branch for a new challenge • Once you have a new **branch** ready, you can add your solutions or blog information. Test your script now. • Commit your changes. • Now push the newly created branch **branch-for-challenge-005** • Time to submit your changes as **Pull Request**. Go to the GitHub web profile https://github.com/joe-blog/perlweeklychallenge-club You should see a button to create **Pull Request**. wrote a very detailed **blog post** covering the minimum knowledge of and needed to start contributing. Highly Recommended. If you have any trouble with the above instructions then please get in touch with me anytime .