README.md

This is a Java based open source android project for HackFest 2017 called "hubISM", which served as a solution to all the daily life problems of IIT(ISM) students. The app was made to be usable even in offline mode. The app follows an open-source approach for further development in addition to what the team did itself.

🤘 🎉 The app consists of these features -

1. Detailed map of IIT(ISM) Dhanbad including all the departments, lecture halls, event locations, labs, and places of interest.
2. Detailed timetable for all the courses. (currently for only first year of 2016-2020 batch)
3. Contacts containing photos and contact details of all the faculty and other important persons.
4. MIS hyperlink to directly access features such as attendance, grade sheets (currently opens in external browser window)
5. Academic calendar includes all the vacations, exam dates, and other important dates.
6. Clubs - this feature consists of a brief introduction of every presently active club in IIT(ISM) Dhanbad with their logos. It also includes posts made on their facebook page available at a single place, known as "Club Feed".

👍 Steps for contributing to this project (HTTPS Method) -

1.Firstly, Download & install git onto the system.
2.Next, Fork this repository to your GitHub account.
3.Then, Copy the URL of the forked repository and paste in place of [url] & do git clone [url] in git bash opened at the location where the repository is to be locally cloned.
4.Next, Disable any proxies running on the system.
5.Then, Open the git bash into newly cloned repository folder.
6.Next, To gain access to updates made on the original repository do git remote -v to see the status , git remote add upstream [url] & finally again git remote -v to see the updated status.
7.Then, Open the newly cloned repository folder in Android studio to make any changes.
8.Next, Open the git bash to the cloned repository directory.
9.Then, As changes have been made do git add -a , git commit -a -m "your commit message" & git push.
10.Then, To request the owner of the original repository to reflect your changes on the repository Goto your version of repository at Github.com on Web and click on "New pull request" & Open a pull request with proper message.
11.Next, Do git fetch upstream master whenever there is a need to see updates to the original repository by other contributers.
12.Finally, Do a git pull upstream master to pull changes like modifications , additions or deletions.

✨ Contributers : @shubham2320 @abhinavbajpai2012 @gitNavV @dranzerblaze @dattadebrup @androlover98

🚀 Further resources -

1.https://help.github.com/articles/fork-a-repo/
2.https://help.github.com/articles/creating-a-pull-request/
3.https://help.github.com/articles/syncing-a-fork/