This is an open source android project for Hackfest 2017 called "hubISM", which serves as a solution to all the daily life problems of IIT(ISM) students. The app is being developed to be usable in even offline mode. The app follows an open-source approach for further development, in addition to what the team does itself. The app would consist of these features -
1.Detailed map of IIT(ISM) including all the departments , lecture halls , event locations , labs , places of interest etc.
2.Timetable for all the courses. (Currently for only first year students)
3.Contacts containing photo & contact details of all the faculty and other important persons of IIT(ISM).
4.MIS hyperlink to directly access features such as attendence, grade sheet etc. (Currently opens in external browser window)
5.Academic calender including all the vacations, exam dates & other important dates.
6.Clubs - this featute consists of a brief introduction of every presently active club in IIT(ISM) Dhanbad with their logos (Further plan is to include posts made on their facebook page available at a single place will be known as "Club Feed").
Steps for contributing to this project -
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.
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/