Google Summer of Code (GSoC) Student Application Guide

Hello and welcome to SageMath's (or Sage for short) GSoC guide for students!

We are glad that you are interested in participating in GSoC with Sage and we look forward to working with you. On this page, you will find numerous application details and links to resources that can help you quickly set up Sage and get started.

You can also explore the GSoC 2017 Ideas Page for information on potential projects.

What is GSoC?

Google Summer of Code is a program for university students aimed at introducing them to world of open source. Students typically begin by browsing the Ideas Pages of various participating open source organisations (orgs) such as Sage and communicate with mentors to write and submit well-defined project proposals. These proposals are reviewed by the respective orgs as well as Google and the selected students then spend 12 weeks in the summer writing code and receive a stipend from Google for their work.

Please ensure that you satisfy the Eligibility Criteria before applying and note the GSoC Timeline.

What is Sage?

Sage is a GPL open-source mathematical software system. It is designed to be not just a computer algebra system, but more like a complete environment for doing mathematics and related calculations. It is based on a vast collection of existing open-source software tools and libraries and ties them together via Python. Python is also the primary interface language for the user and its object-oriented way of expressing concepts is used to express calculations - of course, there are also many “normal” functions available. Behind the scenes, the Sage library executes the commands and calculations by its own algorithms or by accessing appropriate routines from the included software packages. On top of that, there are various ways for users to interact with Sage, most notably via a dynamic web-site called “Notebook”. Sage works hand-in-hand with other computational mathematics software systems, such as SymPy, GAP, etc, and can serve as an umbrella organisation for GSOC for those sister projects.

Please see the FAQ for more details.

Contacting Us

Sage maintains three primary mailing lists namely:

Apart from these, there are numerous other lists dedicated to specific modules of Sage such as sage-coding-theory. For further support in using Sage, there is also a vibrant Question-Answer forum at ask.sagemath.org.

All prospective students must join the sage-gsoc mailing list.

Interacting with the Sage Community

Sage, as an open source project, depends on a diverse community of volunteers to contribute and help move it forward. The mentors are here to help you and the rest of the community is eager to provide support as well. Please respect the time and efforts of the community and be courteous at all times. Following are some tips to keep in mind.

You may also want to peruse the The DOs and DON’Ts of Google Summer of Code published on GSoC's official blog.

Getting Started

Its always a good idea to get started early, even before the complete project ideas list is out. By becoming actively involved, you can significantly improve your GSoC proposal and also help us in deciding how you stand out from the rest of the applicants. But first, you should complete the checklist below to ensure that you are ready to contribute.

  1. Obtain Sage's Source Code - Sage uses Git for version control and the online repository at git.sagemath.org is a good way to study the code online. It is also available on Github. The developer version can be downloaded from here.

  2. Read the Sage Guide - Developer Documentation is the single best resource for everything related to Sage development and as such should be considered as required reading.

  3. Install Sage on your local system - Ensure that you have the prerequisites installed on your system and then start the installation procedure on the developer version (Note, running make the first time will take a few hours).

  4. Set up Trac - Sage uses Trac to create tickets, report bugs and manage every change that happens in Sage. You can read more about Trac and how to obtain a Trac account (which you will first need before contributing anything). Then make sure to link your Git with your Trac account to enable collaborative development.

  5. Read Sage's Conventions and Browse Tutorials - Sage follows various conventions and guidelines for writing code, building documentation and running automated tests. Please make sure to follow them. Further, there are numerous tutorials available for a guided view of various Sage modules.

Lastly, learn about the development workflow followed here at Sage. There is also a lovely one-page cheat sheet of Git and Trac commands needed while contributing available here.

First Contributions

There are two primary ways to contribute and acquaint yourself with the various aspects of Sage development namely, writing a ticket and reviewing a ticket. Beginner Tickets are issues that are interesting yet simple enough to complete and will take very little time. You should first figure out which module(s) of Sage you are interesting in contributing to (possibly through the list of available project ideas) and then find a suitable open easy ticket to resolve. Alternatively, if you don't find something specific, you can always ask on the sage-gsoc mailing list.

  1. Writing A Ticket - Developers, to put it simply, report on a bug or feature or enhancement that they wish to help and open a ticket on Trac. Then they discuss potential solution ideas through comments and based on that write code and submit it. If you are writing a ticket, you should follow standard git practices.

  2. Reviewing A Ticket - Once a developer submits code to resolve the ticket, it is reviewed independently by other developer(s) who may comment changes as deemed necessary. All recommendations must be incorporated before the new code can be merged into Sage. This is a very important component of Sage development which helps ensure quality control as well as constructive feedback. If you are reviewing a ticket, please complete the Reviewer's Checklist and ask for assistance if you are not sure how to evaluate items from the list. Tickets needing review are a good place to start.

GSoC Application Proposal

The Project Proposal is the most vital component of your application process and the primary resource available to the organization to judge your suitability for the program. Please spend time on crafting a detailed and well-thought proposal. It is a great idea to share your proposal with the respective mentors of the project you are applying to and obtain their feedback before the application deadline. Determining the scope and planning a schedule in particular, can be tricky tasks. The more you think about these and the more you discuss with the mentors, the easier it will be later on when the coding period begins. Please use the following application template and make sure to be as precise and detailed as possible.

Personal:

Background:

Project:

Note: All final applications must be submitted on the official GSoC website.

GSoC/Students (last edited 2017-02-10 10:26:10 by jsrn)