/Hacktoberfest-2k19

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

Primary LanguageJava

Micro Club does Hacktoberfest 2019!

🚀✨ Contribution friendly for Begginers & First timers✨🚀

(open to public contribution)

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, profesionals and open source enthousiasts while having a fun challenge !!

What is Hacktoberfest?

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

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!

  • Hacktoberfest is open to everyone in our 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
  • 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 juste to get the challenge completed faster.
  • If the PR doesnt aligne with the event and the repo's rules then it will be marked as invalid.
  • Keep your progress on check on the Hacktoberfest website

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):

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.

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.

Commit changes

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

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 - Difficult (using Git terminal)

Get git for your machine and install it.

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 donwload** button and copy the https url link

3) Head to your Git Bash terminal and specify the derictory 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 tasks bellow)

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

git add . this commande adds all different changes u made to the branch.

7) Commit your changes with a short comment

git commit -m "update some fiels 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 your contributed.

That's it, you just completed yout first contribution and got your first Pull Request! All PRs will be merged asap.

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

CHALLENEGS 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.
  • Add specific feature upgrades you'd like people to add to your projects. (specify it in a labeled issue)
  • Fix or add a personal feature to someone's project. ------------------------------------------------------------------

3. 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: