Skip to content

Commit 91a20e5

Browse files
committed
Add General-Application-Information.md
1 parent 2e64a61 commit 91a20e5

File tree

1 file changed

+124
-0
lines changed

1 file changed

+124
-0
lines changed

General-Application-Information.md

Lines changed: 124 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,124 @@
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

Comments
 (0)