|
| 1 | +--- |
| 2 | +layout: default |
| 3 | +title: General Application Information |
| 4 | +--- |
| 5 | + |
| 6 | +This is the page where people who want to apply to the Git project for |
| 7 | +the Google Summer of Code (GSoC), Outreachy, or other such mentoring |
| 8 | +programs can get information about what the Git project would like to |
| 9 | +see in an application. |
| 10 | + |
| 11 | +*Please read this page completely before focusing on a project or a |
| 12 | + microproject ideas, or microproject general information.* |
| 13 | + |
| 14 | + |
| 15 | +## Microproject (required) |
| 16 | + |
| 17 | +It is required that applicants who want to apply to the Git |
| 18 | +project for the GSoC or Outreachy complete a tiny, code-related |
| 19 | +"microproject" as part of their application. Please refer to our |
| 20 | +[general guidelines and suggestions for microprojects](https://git.github.io/General-Microproject-Information) |
| 21 | +for more information. Completing a microproject is not only an important |
| 22 | +way for us to get experience with applicants, but it will also help |
| 23 | +applicants become familiar with Git's development and submission |
| 24 | +process. |
| 25 | + |
| 26 | +## Reviewing (not required but appreciated) |
| 27 | + |
| 28 | +Also, working in Git project is not only about writing your own |
| 29 | +patches. Constructively critiquing design and implementation of |
| 30 | +patches by other people is also an important skill you need to learn |
| 31 | +in order to effectively collaborate with others. So, if you have time |
| 32 | +and inclination, it would be beneficial to read and understand other |
| 33 | +applicants' patches (or any other patch submitted to the mailing-list), |
| 34 | +think if you agree that the problem they are trying to solve is worth |
| 35 | +solving, the approach they are taking is the best way (or if you think |
| 36 | +of a better way to solve it), etc., and respond to their patches with |
| 37 | +the result of your thinking as a review. |
| 38 | + |
| 39 | +## Application (required) |
| 40 | + |
| 41 | +A complete application should include a presentation of yourself |
| 42 | +(include any argument that may convince mentors that you are able to |
| 43 | +complete the project) and detailed explanations about your project. |
| 44 | + |
| 45 | +Project ideas are just ... ideas! The list we provide is not |
| 46 | +exhaustive, and more importantly each idea only includes a summary of |
| 47 | +what is to be done. An application must include detailed plans on the |
| 48 | +design, timeline ... A typical application takes several pages. |
| 49 | + |
| 50 | +If you are applying for the GSoC, you should already have read |
| 51 | +[the GSoC Student Guide](http://write.flossmanuals.net/gsocstudentguide/writing-a-proposal/) |
| 52 | +by now, but re-read it if needed. |
| 53 | + |
| 54 | +If you are applying for Outreachy there is very likely similar |
| 55 | +documentation on their web site that you should follow. |
| 56 | + |
| 57 | +Please, include link(s) to the mailing-list discussion(s) related to |
| 58 | +your microproject in your application (e.g. linking to |
| 59 | +[lore.kernel.org](https://lore.kernel.org/git/)). If you |
| 60 | +participate in the review of other patches, then you may also include |
| 61 | +links to discussions that would support your application. |
| 62 | + |
| 63 | +Applicants must send drafts of their proposal on the mailing-list |
| 64 | +before submitting it officially to GSoC or Outreachy to get feedback |
| 65 | +from the community. They are strongly encouraged to publish a draft on |
| 66 | +the official GSoC or Outreachy website *and* post it to the mailing |
| 67 | +list for discussion. |
| 68 | + |
| 69 | +Getting your proposal right can follow the same process as usual patch |
| 70 | +submission for Git, as described in the |
| 71 | +[microprojects](https://git.github.io/SoC-2020-Microprojects) page and |
| 72 | +in `Documentation/SubmittingPatches` in Git's source code. It is also |
| 73 | +expected that you will send several versions of your draft, responding |
| 74 | +to comments on the list. Please plan to send the first draft early |
| 75 | +enough so that a number of reviews and improvements cycles can happen. |
| 76 | + |
| 77 | +If you are not sure about your proposal, you can discuss that in the |
| 78 | +same email where you introduce yourself or in separate emails. Please |
| 79 | +use "[GSoC]" or "[Outreachy]" at the beginning of the subject of such |
| 80 | +emails. |
| 81 | + |
| 82 | +## Summary |
| 83 | + |
| 84 | +In summary, all applicants must (not necessarily in this order): |
| 85 | + |
| 86 | +* Complete a [microproject](https://git.github.io/SoC-2020-Microprojects). |
| 87 | + |
| 88 | +* Write a detailed application explaining their project. |
| 89 | + |
| 90 | +* Discuss their project by posting drafts of their application on the |
| 91 | + mailing-list long before the deadline. |
| 92 | + |
| 93 | +In your application, and in the discussions related to projects you |
| 94 | +are interested in, it is a good idea to: |
| 95 | + |
| 96 | +* Include link(s) to the mailing-list discussion(s) related to the |
| 97 | + project you chose in your application or you are interested in, for |
| 98 | + example previous discussions or patch series about the topic. There |
| 99 | + might be interesting discussions about the topics that are several |
| 100 | + year old. It is also a good idea to summarize them. |
| 101 | + |
| 102 | +* Include link(s) to the mailing-list discussion(s) related to the |
| 103 | + previous drafts of your application itself. |
| 104 | + |
| 105 | +* Include link(s) to the mailing-list discussion(s) related to your |
| 106 | + microproject. If your microproject patches have been merged, please |
| 107 | + give the merge commits. Otherwise give their branch names and |
| 108 | + current status in the last "What's cooking in git.git" email from |
| 109 | + Junio. |
| 110 | + |
| 111 | +* Include what is suggested in |
| 112 | + [the GSoC Student Guide](http://write.flossmanuals.net/gsocstudentguide/writing-a-proposal/) |
| 113 | + or the equivalent guidelines for Outreachy. |
| 114 | + |
| 115 | +([lore.kernel.org](https://lore.kernel.org/git/) can be |
| 116 | +used for searching the mailing list and linking to previous |
| 117 | +discussions.) |
| 118 | + |
| 119 | +## Note about the number of slots |
| 120 | + |
| 121 | +The Git organization usually has very limited mentoring capacity. |
| 122 | +These days we usually accept between 0 and 3 students per season |
| 123 | +(Winter or Summer). |
| 124 | + |
0 commit comments