|Version 25 (modified by 7 years ago) ( diff ),|
Table of Contents
Google Code In 2014 - 2015
Information for GCI Participants
Instructions and Guidelines
- Please sign our Contributor License Agreement before claiming or completing any tasks (even non-coding tasks).
- Please set your expectations from our mentors:
- We may take up to 24 hours to respond to task claim requests.
- We may take up to 36 hours to review submitted completed tasks.
- Please use our public mailing list (http://groups.google.com/group/sahana-eden) or IRC channel (#sahana-eden on irc.freenode.net or http://webchat.freenode.net/?channels=sahana-eden&uio=d4) for all communications - no private messaging please - our mentors wil redirect you back to our public channels. This also lets you introduce yourself to the community. And if you post questions to the mailing list for the project you're working on, then many people will be available to answer, not just your mentor.
- Speaking of the mailing list...please do join the mailing list, as we will use it to post useful information. Look for [GCI] in the subject line, for messages about GCI. When you post, please use [GCI] in the subject as well, so that folks who are not participating know which to read.
- Note that Melange does notify mentors assigned to a task by e-mail whenever there is a status change or a comment made on a task. So you do not need to send an email to our lists when you claim or complete a task.
- Please be patient....
- The mentor for your project may be in a different timezone. They may be asleep, having dinner...
- Our mentors have lives, spouses, children, jobs, hobbies, exams...
- See the times above -- that gives the maximum response time, and a response might take that long.
How to do well in GCI
- Focus on adding value & helping rather than just completing tasks.
- If the mentors give you feedback (which we should be!) be sure that you action it!
- Students who make the extra effort, e.g. improve the wiki, help other students, will be more highly regarded than students who just complete tasks.
- GCI is for you to learn, and get a start in working on open source projects. It's a safe space for trying out things you don't yet know how to do.
- Get enough sleep! Don't neglect your schoolwork! Have fun!
Admins and Mentors
- GCI admins:
- Arnav Kumar Agrawal (IRC: knowing42)
- Ramindu Deshapriya (IRC: ramindu)
- GCI mentors:
- Daniel Klischies (IRC: Nostraa)
- Hitesh Sharma (IRC: hitesh96db)
- Pat Tressel (IRC: ptressel)
- Lolitha Ratnayake (IRC: Lolitha)
- Arnav Kumar Agrawal (IRC: knowing42)
- Somay Jain (IRC: Somay)
- Vishrut Mehta (IRC: vishrut009)
- Hardik Juneja (IRC: hardikj)
- Anirudh Tewari (IRC: anirudh)
- Robby O'Connor (IRC: robbyoconnor, shared with OpenMRS)
Please read this, about how to use git and GitHub, but we have some differences for GCI, which are explained below. http://eden.sahanafoundation.org/wiki/DeveloperGuidelines/Git
We will be using a GitHub repository just for GCI, rather than submitting code directly to the main repository. This will help us conserve the time of the (very busy) folks who have to approve submissions to the main repository.
This is the repository to use for pull requests. You should still fork the main repository to create your own repository.
Also, we will use several branches in that GCI repository to receive the pull requests, to make it simpler and faster to get them merged, as we can review and merge them in parallel.
So, there will be two changes to the procedure for submitting code.
When you have code ready for review by a mentor, ask which branch in the GCI repository you should send your pull request to. The mentor will make sure this branch is up to date.
The first steps to submit your work are the same as in the wiki page linked above.
- "Squash" your commits into one.
- Rebase from the main repository, so your branch is fully up to date, and has no conflicts.
- Push your commit to your Eden repository on GitHub.
- Open the GitHub page for your Eden repository.
- Click the "Compare and Create Pull Request" button shown on that commit.
The next step is where the change comes in:
- The pull request page will have a line that shows which repository and branch you are sending the pull request too.
You will need to change both, to the GCI repository and the branch name supplied by the mentor.
- There will be a down-arrow next to the repository -- that will give you a list of repositories. Select the GCI repository.
- Then use the down-arrow on the branch -- select your branch.
- Create the pull request.
- Continue with the code review as usual.
After the mentor accepts your pull request, the GCI admins will collect your commits and those of other students into one pull request each day (or every few days) and submit that to the main repository. Your commits will have your name on the, and will show up in the main repository.
Here is a list of mentors with their IRC nicknames and timezones:
|Arnav Kumar Agrawal||knowing42||UTC+0530|
|Hardik Juneja||hardikj||UTC +0530|
|Pat Tressel||ptressel||UTC -0800|
|Hitesh Sharma||hitesh96db||UTC +0530|
|Vishrut Mehta||vishrut009||UTC +0530|
|Anirudh Tewari||anirudh||UTC +0530|
|Arnav Sharma||iamas||UTC +0530|
|Lolitha Ratnayake||Lolitha||UTC +0530|
Mentors: Adding New GCI Tasks
A Google Code-In task should be a small unit of work in one of the categories listed below. They should be clearly and well documented so that they are easy for students to complete (and should link to all the information which the student should need to complete the task) and give a full criteria for completion so it is easy for mentors to evaluation.
Tasks must be added to Sunflower under the following projects:
- Code : Sahana Eden Trunk Code
- Documentation : Sahana Eden Documentation
- Outreach-Research : Sahana Outreach
- UI : Sahana Eden User Interface
- Quality Assurance : Sahana Quality Assurance
When adding tasks, ensure that you have used the 'New' and 'GCI Task' tags upon creation.