This Hacktoberfest in Aba webpage is hosted on GitHub Pages and the live version can be accessed here.
More about GitHub Pages: https://pages.github.com/
As a means of encouraging participation during Hacktoberfest 2018, this project targets those relatively new to the open source ecosystem and programming in general, but are eager to learn and improve their creative skills by contributing to projects on GitHub.
By creating issues that require easy to complete tasks, we are providing a platform where beginners can readily join the open source movement without being overwhelmed with the restrictions and complexities that plague already established open source projects. We hope that contributors will continue to confidence as they continue to contribute to this project.
Welcome to the world of Open Source.
Aiming to be very beginner friendly and to advocate simplicity and clarity, these instructions will get you a copy of this project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system. Fork this repository and get started.
- Use Pull requests, do not commit to the Master branch or we risk running into conflicting commits.
- Changes must be confirmed.
- Project maintainers will be in charge of monitoring issues, reviewing submitted patches and merging pull requests.
- Member contributors will be responsible for collaborating with external contributors to tackle project issues and submit patches via pull requests.
- Please update this readme as needed.
Hacktoberfest is an event celebrated in October by Github and DigitalOcean based on the German festivity Oktoberfest. The main purpose of this event is to stimulate open source contributions on Github by rewarding users tha participate with at least 5 Pull Requests with a T-Shirt.
Hacktoberfest is open to everyone in our global community. Whether you’re a seasoned contributor or looking for projects to contribute to for the first time, you’re welcome to participate. Pull requests can be made in any GitHub-hosted repositories/projects. As long as the project is public and GitHub-hosted, your PRs will count towards your participation You can sign up anytime between October 1 and October 31. Just be sure to sign up on the official Hacktoberfest website for your PRs to count.
To get a shirt, you must make five pull requests (PRs) between October 1–31 in any timezone. PRs can be to any public repo on GitHub, not just the ones highlighted. The PR must contain commits you made yourself. PRs reported by maintainers as spam or that are automated will be marked as invalid and won’t count towards the shirt. This year, the first 50,000 of you can earn a T-shirt (compared with 30,000 in 2017).
Quality Standards In line with Hacktoberfest value #2 (Quantity is fun, Quality is key), we have provided examples of the quality standards we encourage. This applies mainly to beginners.
- PRs that are automated e.g. scripted opening PRs to remove whitespace / optimize images.
- PRs that are disruptive e.g. taking someone else's branch/commits and making a PR.
- PRs that are regarded by a project maintainer as a hindrance vs. helping.
Something that's clearly an attempt to simply +1 your PR count for October. Last but not least, one PR to fix a typo is fine. 5 PRs to remove a stray whitespace... not cool.
To work on this project from your local machine, you would need basic understanding of Git and the GitHub Workflow. Also, experience with web technologies (HTML, CSS, JavaScript) is recommended but not necessary a Text Editor/Web IDE, and a recent version of any popular web browser.
Note: The dollar sign '$' represents input interface of Mac and Linux machines. Windows users may consider installing Git-Bash.
On your local machine, navigate to the folder you want to hold your project.
$ cd /path-to-folder
Clone the forked repository from GitHub.
$ git clone https://github.com/<yourusername>/HacktoberfestinAba.github.io
Navigate into the cloned repository.
$ cd project
Create a new branch.
$ git branch dev-<yourusername>
Switch to your new branch.
$ git checkout dev-<yourusername>
Make the changes you want on your new branch and when you are done, you can verify the changes using git status.
To commit your changes, first stage the files for commit.
$ git add <filename1> <filename2>
Verify that the files have been staged.
$ git status
Then make your commit.
$ git commit -m 'commit message'
To merge your modifications from the development branch, first switch to the master branch.
$ git checkout master
Merge the development branch with the master branch.
$ git merge dev-<yourusername>
Finally, push your changes to your GitHub repository.
$ git push origin master
This project doesn't require you running a live server on your local machine. Simply navigate to the project folder and open the index.html file to get started.
- HTML, CSS & Javascript - Web Technologies
- Git - Version Control System
Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.
We use Git for versioning. For the versions available, see the tags on this repository.
- David C. Onoh davidconoh
- Prosper Opara OPARA-PROSPER
This project is licensed under the MIT License - see the LICENSE file for details.
😉