The Gnucash mentor students

Gnucash, a free accounting program for Linux, Microsoft Windows, and Apple Macintosh OSX, had its second opportunity to mentor students in the Google Summer of Code program this summer. Two of our three students successfully completed their projects.

Muslim Chochlov wrote unit tests for several critical modules of Gnucash’s core Query Object Framework. This is an important first step to some necessary refactoring of the framework so that Gnucash can move from an in-memory processing model to a transactional database model allowing simultaneous multiple user access.

Nitish Dodagetta extended the experimental Qt GUI “Cutecash” (Gnucash’s primary GUI is Gtk+) by writing a unified accounting transaction entry window. The Gnucash development team is investigating Qt and C++ as a future direction for Gnucash, and this struck a chord for Google Summer of Code students: half of the proposals we received from the student applicants prior to the start of the program were for Cutecash projects.
Overall we were pleased with the progress we made this summer; we found that the successful students leveraged the work of their mentors and moved forward some important aspects of the project. We’re continuing to work with the students this fall, integrating them into the regular development team. Mentoring up-and-coming programmers is very rewarding, and we enjoy encouraging them to use their skills for altruistic goals.

Google Map Maker & Chicago

(Cross-posted from the Student Blog)

The Google Map Maker campus tour recently visited the Windy City to talk to students about how they can use Map Maker to map their campuses and make updates to places they care about on Google Maps. While in town, we also hosted a Map Maker event at the Google Chicago office to share the tool with folks working in the public sector. We had a great time meeting so many enthusiastic mappers from the area, and look forward to seeing how they put Chicago on the map.

Our first stop was the University of Chicago campus, a beautifully historic area with architectural gems galore. Students who attended this event were excited to map not only their campus, but neighborhoods near the university, showing the diversity and development of the population and culture.

Our second stop was Northwestern University, where a packed room of students learned about mapping while sampling some traditional Chicago style deep dish pizza. Delicious! Students were particularly interested in adding details to their campus, naming the buildings, adding locations of the sororities and fraternities, and marking the building outlines or footprints of their favorite restaurants and stores nearby.

 

Our Google Map Maker team loved partnering with Google Student Ambassadors from these campuses, who creatively and passionately helped plan these events. You guys did an amazing job! The Google Student Ambassadors from Northwestern University had this to say about the Map Maker visit:

“Our event brought together over 120 Northwestern students who were eager and excited to learn about how they could make an impact by adding to Google Maps using Map Maker … Map Maker was a welcome product that put the power to shape the map in our hands. All in all, it was an incredibly fun and engaging experience!”

-Sourya and Minjae, Google Student Ambassadors at Northwestern University

The last event—a meeting with public sector officials at the Google office in Chicago—gave us some great insights about how Map Maker can be used for large metropolitan areas. University educators, Department of Transportation employees, Census Bureau representatives, Chicago Health Department folks, and many more shared how they would like to see Map Maker applied to what they do. We really appreciate all their feedback and suggestions, as well as their enthusiasm for how this tool can help them share their work with each other and the public.

Chicago and the surrounding areas were such enjoyable places to visit, full of vibrant and passionate people. We look forward to visiting other campuses in the fall, but don’t wait until then to leave your mark on your campus!

The DO’s and DON’Ts of Google Summer of Code: Student Edition

As Google Summer of Code mentoring organization administrators, we are the people who ensure Google Summer of Code runs smoothly within our organizations. Over the past 6 years, contributors to our four open-source projects (Gentoo, KDE, XMPP, and X.Org) have read more than 1,000 student applications and mentored hundreds of successful, and unsuccessful, students.

Based on our experience with Google Summer of Code, we’ve built cultural and community practices that strongly favor successful student projects, integration of code, and conversion of students to long-term contributors. We’ve also seen a lot of things go wrong—repeatedly. We’d like to share these tips and antipatterns with you to raise awareness and help students avoid the same mistakes when taking part in the program. For even more advice, check out the student guide.

DO DON’T
Be on your best behavior. Clear, respectful communication is just as important to success today as it was 100 years ago. When you write email or chat on IRC, use complete sentences without any SMS abbreviations (but acronyms are allowed, especially on IRC). If you are unsure about your English skills, there are tools available to help you, such as spell checkers and grammar checkers. On a related note, people want to work with others whose company they enjoy. Be friendly and polite; it’s hard to be too much of either. Make a bad first impression: SMS speech, extremely poor English, rudeness/hostility, etc. These fall into two major categories: failure to communicate and inability to get along with other people. Poor first impressions can seriously damage your chances because both of these problems derail collaboration, which is vital to a successful project. Entirely adequate programmers fail Google Summer of Code because of failures to communicate.
Read all the documentation, so you submit a useful application. Your application should provide all the detail necessary to convince people that you can accomplish your project, and you’re the best person to do it. That means showing you have experience, proving you’ve done research, and providing a concrete plan. Submit a useless application. Many varieties of entirely unhelpful applications exist: the one-sentence wonder, the proposal pasted directly from the ideas page, the free-form text that ignores an application template, and the application submitted to the wrong organization.
Be transparent about other commitments. When organizations know about your commitments in advance, you can work with them to develop a plan that deals with your schedule. For example, you could begin your work at a slower pace during the community-bonding period. If another commitment comes as a surprise to your mentor during the summer, you might not be able to compensate for it. Disappear. If your mentor thinks you have disappeared during the summer, this tends to quickly result in failure. The most common problem is failing to mention long family vacations or class schedules in the summer. Disappearing includes taking the initial payment and running with it; if you’re tempted to do this, you might want to consider the damage to your reputation, or the excited students missing out on a slot so you can waste yours.
Make Google Summer of Code your top priority. During the 12 weeks of coding time, nothing should take precedence over your project, and you should have no major distractions. If you have another job, decide whether you prefer it or Google Summer of Code and pick one. Make your choice early enough to leave your slot open for another student. Hold another major commitment. For example, if you have a second job without telling anyone until the start of coding, it’s a major problem. Anything outside of the program that takes more than 5–6 hours a week causes problems; this includes classes that extend through the coding period. Two simultaneous full-time jobs is unrealistic.
Be realistic about your skills. Think through your past experience. If you have trouble fairly assessing your abilities, just write about your coding experience instead and your org can make its own judgment. Additionally, some orgs will gladly provide small sample tasks that you can perform to judge how easy you’ll find the summer-long projects. Over- or under-rate your abilities. As long as you have some programming skill and are able to communicate well (see above), you should be suitable for some projects. This doesn’t mean that every student is equal if they meet these requirements. Overselling yourself leads to disappointment; underselling yourself the same.
Commit and publicize your code frequently. Discussing your code early and often, with your mentor and the broader community, is vital to the success of your project. Make small, easily recoverable mistakes early rather than huge ones when it’s too late to do anything about them. Make last-minute (or later) code drops. Showing your code in public can be scary. Some students wait until the very last minute to show their code to their mentor and other contributors to the project. Do this only if you have a burning desire to fail, because it’s too late for any review to fix holes in your code.
Submit code that’s ready to integrate. The best thing about an open source project is seeing your own code shipped in a release and used by thousands or even millions of people. This requires some effort on your part, however. You should closely track how other developers change related code so yours can be easily added to the latest development branch as soon as—or even before—the summer ends. During the last few weeks, make sure your code is polished enough so it’s ready to add to the project’s main repository; this may require documentation or test suites. Don’t let your summer’s work go to waste. Finish the summer with code that’s “almost ready” but will take forever to ship. Many students leave their project in a state that is very close to being shippable but isn’t quite there yet. Since the mentor tends to be too busy to finish it, these projects ship very slowly, if ever. It’s your project—you need to make it see the light of the day. This can require you to keep driving the project, and not trust that the mentor will keep on top of it once the summer is over.
Complete your project design before writing a line of code. Work with your mentor to define the architecture of your project before you begin coding. You don’t need to go as far as prototyping every function, but you should have a vision of how it will all eventually work at a reasonable level of detail, such as important data structures and algorithms. Determine the libraries and tools you’ll use, and be able to justify your choices. Start coding before finalizing design. You can hit major dead-ends when you haven’t yet finished working with your mentor to design the project, but you choose to begin coding anyway. For example, if you start coding for a NoSQL backend but your mentor and the rest of the community determine that a standard SQL database should be used, this can necessitate rewriting a lot of code for no reason. Changes on the architectural level can be even more disruptive to any code you’ve written prematurely.
Use your resources wisely. Help is just an email away. Don’t be afraid to ask questions when you get stuck; we don’t expect you to be an expert, and we’re happy to answer your questions. On the other hand, remember to do some basic research on your own before asking, such as searching the project documentation, the source code, and Google. Refuse to ask for help. Throughout the whole program, you will encounter problems that need to be solved—some of them small and some of them large. You can waste days stuck on a problem that can be solved in an hour by talking to other team members.
Remember that you’re part of a community. Very little in Google Summer of Code is 100% independent work. You may propose your project design, but you’ll develop it with the help of your mentor and community. You’ll write the code, but others will review it, and you’ll often build upon their previous work. Unlike school, where a grade could be your first feedback, in Google Summer of Code your grade (pass/fail) is your last feedback. By designing and developing your project in collaboration with your entire open-source community, you’ll get people excited about using your work and ready to integrate it. You’ll also give yourself the best chance of passing the program by receiving thorough reviews from your community and responding to them. Many students choose to continue contributing after the summer ends because of their interactions with the community. Consider it a solo project, like it often is in college. It’s not; you write the code, but your mentor is there to help with plans, designs etc. Your mentor is not like a lecturer or course leader at a college or university. There’s a whole community of people working on the project together, and you should interact with them as a whole. Don’t feel like you’re working for your mentor, you’re working for the community and your mentor is helping guide you, they are not your only point of contact. This has other implications too—other people will be working on the code base while you are, and you will see improvements happening around you as you code. You may need to keep your development branch up to date to take advantage of these.

Making Google Summer of Code the best possible program requires a commitment to excellence from participants at every level. In addition to committing to the program, you must also be thoroughly prepared.

In this post we’ve provided suggestions for students, and in later posts in this series we’ll cover mentors and admins. Whatever role you would like to play in Google Summer of Code or a similar program, read everything you can find so you know what you’re getting into. Good luck, and have fun in your endeavors.