Micro Club does Hacktoberfest 2019!

🚀✨ Contribution friendly for Beginners & First timers✨🚀

(open to public contribution)

README Translations

EN, FR, PT, ES, IND

Link to GithubPage: https://microclub-usthb.github.io/Hacktoberfest-2k19/

Micro Club does Hacktoberfest!

A Repository for Micro Club members dedicated for Hacktoberfest 6th edition (2k19). The purpose of this repo is getting MC members and any other begginers into the open source community and help them develop and share projects and knowledge with other students, professionals and open source enthousiasts while having a fun challenge !!

What is Hacktoberfest?

"Changing the open source community, one pull request at a time."- Digital Ocean.

Hacktoberfest is a month-long celebration from October 1st - 31st sponsored by Digital Ocean and GitHub to get people involved in Open Source. This year an all backgrounds and experience levels open source community platform 'DEV' has joined the party as an event partner! The first 50,000 people around the world to complete 4 pull requests contribution to any public repo will recieve a FREE LIMITED EDITON T-SHIRT & COOL SWAGS!

For more info about the event: Hacktoberfest event website

• Hacktoberfest is open to everyone in the global community!
• Pull requests can be made in any GitHub-hosted repositories/projects.
• Sign up anytime between October 1 and October 31.

How to participate and contribute to this project?

Create your very first Pull Request to any public repository on GitHub and contribute to the open source developer community.

Here are 3 quick guided ways to contribute to this project:

• Add a profile page to the /profiles directory.
• Upload a project of your own.
• Create your own customized Octocat and upload it to /my-Octocat directory with a chance to see it printed as sticker!

Choose one or all 3, make a pull request for your work and wait for it to be merged!

Rules:

• Make sure to sign up first to the event website using your GitHub account: https://hacktoberfest.digitalocean.com/
• Everyone is welcome! Begginers, veterans, non developpers all around the world!
• All uploaded projects should got into the /Projects folder inside their dedicated topic folder e.g: /Projects/Web/MyAmazingProject
• Always check the repo's issues to avoid duplicates
• Every contribution is welcome (project upload, code fix, design, tutorials, documentation, fixing typos ...etc) but we prefer quality over quantity so avoid making 5 PRs to fix 5 obvious grammar mistakes just to get the challenge completed faster.
• If the PR doesn't align with the event and the repo's rules then it will be marked as invalid. ❌

NOTE!

Please DO NOT submit random Pull Requests. First check if an issue already exists for the bugs you found or features you want to add and whether someone else is already working on it. If not, create an issue and assign it to yourself.

Happy hacking!!

------------------------------------------------------------------

Getting started - Easy (GitHub in-browser tutorial):

1) Fork this repository

Fork this repository by clicking on the fork button on the top of this page. This will create a copy of this repository in your account.

2) Make your changes

Open the files you want to edit and fix the issues or add features (see challenge tasks bellow). You can use drag&drop to add new files and new folders to the repo.

3) Commit changes

Commit your changes and add a short explanatory message on your contribution.

4) Do your Pull Request

Now click on the button Compare & pull request and compare between forks then add your pull request with a comment.

That's it, you've done your first contribution and you just got to wait for it to get merged! You can now do the two remaining challenge tasks!

------------------------------------------------------------------

Getting started - Advanced (using Git terminal)

First things first, go to get started & install it on your machine.

1) Fork this repo to your own account by clicking the Fork button.

2) Acess your new fork on your account and clone it -

Click Clone or Download button and copy the https url link

3) Head to your Git Bash terminal or normal terminal in mac and specify the directory where you want to clone your project:

cd /derictory e.g: cd C:/Users/Microclubist/Desktop

4) Clone your forked project to your local machine:

git clone "your project's url you just copied"

e.g: git clone https://github.com/your_username/Hacktoberfest-2k19.git

5) Add your changes (See challenges bellow)

6) Add the staged changes you made to the branch you're working in (master)

git add . This command adds all different changes you made to the branch.

7) Commit your changes with a short comment

eg. -> git commit -m "updated some files and fixed bugs"

8) Push your changes

git push origin master

9) Go back on your GitHub to finalize the work

• Check if changes were updated to your Fork on your GitHub account.
• Now submit the changes of your own fork to the original project repo with a Pull Request.
• Click button "Compare & pull request"
• Write a short comment about the changes you contributed to the repo.

That's it, you Git it!!!

If you liked this experience Star 🌟 the repo (click Star button near Fork button). That's it, you just completed your first contribution and got your first Pull Request! All PRs will be merged asap.

------------------------------------------------------------------

CHALLENGES TO COMPLETE::

1. Add a profile page

Add a Your_Full_Name.md file to the profiles directory. Use any combination of content and Markdown you'd like. Here is an example:

# Your Full Name (e.g: Microclubist)

### Location
Your City/Country

### Academics
e.g: Uiversity of Science and Technology Houari Boumediene, Algeria. (USTHB)
- Computer Science.

### Interests
- Things you like, e.g: cookies, video games and code.
- Something Else, e.g: more cookies...

### Development
- e.g: full stack developer.
- e.g: video games developer.
- e.g: I am not a developer, i'm a designer.

### Profile Link
[GitHib username](GitHub profile url link)
[Linkedin name](Linkedin profile url link)

### GitHub Page/Website (if availble)
[GitHib Page name](GitHub Page url)

### Other projects
[A magical cookies maker](project url)

------------------------------------------------------------------

2. Adding a personel project

• Add one of your personal projects to the repo.
• Ask people to add specific features to your projects as a challenge. (specify it in a labeled issue🔖📌)
• Fix a bug 🐛 in a project.
• Add a personal feature to someone's project.

------------------------------------------------------------------

Bonus task: My Octocat challenge!

Build your own Octocat!

• Step 1: Go to MyOctocat
• Step 2: Design your octocat
• Step 3: Style and accessorize
• Step 4: Save your Octocat, name the .png file username_OctocatName.png e.g: Microclubist_.png.
• Step 5: Share it! Upload the file to /myOctocat folder and do a pull request!

------------------------------------------------------------------

Want to do more PullRequests? Here's a quick list for other begginers friendly ressources:

• TeamOpenMinds - Oran Our awesome friends from University of Oran scientific club Team Open Minds are doing Hacktoberfest too!
• OpenMindsClub - USTHB Can't talk about open source without mentionning our friends at OpenMinds Club who joined Hacktoberfest 2019! 🎃
• Up for Grabs Explore open source projects and jump in!
• Issuehub.io Contribute to Open Source. Search issue labels to find the right project for you!
• First Timers Only Friendly Open Source projects should reserve specific issues for newbies.
• Awesome First PR Opportunities A list of awesome beginner-friendly projects.