Merge pull request #244 from numfocus/update-docs

Update repository texts

Author: kain88-de

2017/proposals/skeleton.md

@@ -1,27 +1,69 @@
-# Contributing Guide for Mentors
+# Contributing Guide for Mentors and Sub Orgs
+## Organizations Eligible Under NumFOCUS Umbrella
 
-To be a mentor go to [GSoC homepage][GSoC] and create your profile.
-If you need help, please check
-http://en.flossmanuals.net/melange/creating-and-editing/.
+Organizations either financially supported or affiliated with NumFOCUS can
+participate under the NumFOCUS umbrella. The organization must also have:
 
-**After creating your profile, open an [issue][issues] requesting that your
-username be added at [organization/team.md][OT] or send a pull request with
-your addition.**
+1. One sub-org admin
+   and at least two mentors (**the sub-org admin can be one of the mentors**)
+   who are willing to commit for the full GSoC period.
+2. Must be a NumFOCUS sponsored or affiliated project
+3. Have a good ideas page (**NumFOCUS Admins will help with that**).
 
-### Proposal summary (Mentors)
+The sub org administrator and has the responsibility to communicate with
+NumFOCUS and advertise GSoC to the community of their organization.
 
-**Short Version**
+You can signup as a participating org with us until the application deadline for
+the current year or up to 3 days after Google announces that NumFOCUS is
+participating as a umbrella org.
 
-If you have a proposal, please create an [issue][issues] for it. 
-Please make sure that the project can be partly completed during the summer so that students pass the final evaluation. 
-See the expectations in the [student guide][CS].
+When you sign-up with us you should also tell us your preferred way for students
+to contact you and a link to your new contributor page if you have one.
 
-Please also
-read the [student guide][CS] 
+## Sub Org Administrators
 
-**Long Version**
+Each project/organization under NumFOCUS umbrella for GSoC should have one
+administrator.
 
-If you have a proposal,
+The **sub-org admins** are responsible for
+
+- provide a list of projects ideas to **organization administrator**
+- advertise the application to the project/organization they represent
+- signup mentors with NumFOCUS
+- connect users with NumFOCUS profile
+- request to **organization administrator** a minimum and a maximum number of
+  slots
+- assign mentors and students to available slots
+- ensure evaluations for accepted projects are submitted on time
+- Try to have the whole community engage with the students in their project
+
+## Mentors
+
+To be a mentor please tell your sub-org administrator so he can give you all the
+information you need to sign up.
+
+## Projects
+
+Please make sure that the project can be partly completed during the summer so
+that students pass the final evaluation. Please also read
+the [student guide][CS], especially our requirements from students.
+
+To ensure a project can be completed we recommend as a guideline that the
+project should be possible to complete by the mentor in about one week of full
+time work. This doesn't sound like a lot of time but students generally take
+much longer then a long-time developer. They have to get familiar with the code
+and have to acquire a huge amount of domain knowledge.
+
+There has to be at least one primary mentor and one backup mentor per project.
+This means you should have at least 2 mentors available. A mentor can only be
+'primary' for one student but a backup for as many as he likes. The sub org
+admin can also be a mentor.
+
+If you have a proposal you can use our [proposal templates][template] and
+publish the ideas list here or you can link to an ideas list on one of your own
+websites/repositories.
+
+To publish your project ideas here follow this guide.
 
 1.  copy `YYYY/ideas/skeleton.md` to `YYYY/ideas/title-of-my-proposal.md`
     where `YYYY` is the currently year
@@ -31,7 +73,5 @@ If you have a proposal,
 4.  [create an issue](https://github.com/numfocus/gsoc/issues/new)
     where students can ask questions.
 
-[GSoC]: https://www.google-melange.com/gsoc/homepage/google/gsoc2015
-[issues]: https://github.com/numfocus/gsoc/issues
-[OT]: organization/team.md
 [CS]: CONTRIBUTING-students.md
+[template]: templates/ideas-page.md