You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@community.apache.org by rb...@apache.org on 2017/02/09 14:58:10 UTC
svn commit: r1782338 - in /comdev/site/trunk/content: TEMPLATE.mdtext about/
about/index.mdtext mentoring/committer.mdtext mentoring/firstpatch.mdtext
mentoring/index.mdtext mentoring/mentor.mdtext mentoring/pmc.mdtext
Author: rbowen
Date: Thu Feb 9 14:58:09 2017
New Revision: 1782338
URL: http://svn.apache.org/viewvc?rev=1782338&view=rev
Log:
Stubbing in some of the documentation that I'll be writing over the
coming weeks - areas that I think ComDev can and should be doing a
better job. And areas where we can engage more volunteers to help out,
if we are clear about what needs to be done.
Added:
comdev/site/trunk/content/TEMPLATE.mdtext
comdev/site/trunk/content/about/
comdev/site/trunk/content/about/index.mdtext
comdev/site/trunk/content/mentoring/committer.mdtext
comdev/site/trunk/content/mentoring/firstpatch.mdtext
comdev/site/trunk/content/mentoring/index.mdtext
comdev/site/trunk/content/mentoring/mentor.mdtext
comdev/site/trunk/content/mentoring/pmc.mdtext
Added: comdev/site/trunk/content/TEMPLATE.mdtext
URL: http://svn.apache.org/viewvc/comdev/site/trunk/content/TEMPLATE.mdtext?rev=1782338&view=auto
==============================================================================
--- comdev/site/trunk/content/TEMPLATE.mdtext (added)
+++ comdev/site/trunk/content/TEMPLATE.mdtext Thu Feb 9 14:58:09 2017
@@ -0,0 +1,20 @@
+Title: TITLE GOES HERE
+Notice: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+ .
+ http://www.apache.org/licenses/LICENSE-2.0
+ .
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+# TITLE GOES HERE
+
Added: comdev/site/trunk/content/about/index.mdtext
URL: http://svn.apache.org/viewvc/comdev/site/trunk/content/about/index.mdtext?rev=1782338&view=auto
==============================================================================
--- comdev/site/trunk/content/about/index.mdtext (added)
+++ comdev/site/trunk/content/about/index.mdtext Thu Feb 9 14:58:09 2017
@@ -0,0 +1,59 @@
+Title: Community Development: What we do
+Notice: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+ .
+ http://www.apache.org/licenses/LICENSE-2.0
+ .
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+## Community Development: What We Do
+
+"Community Development" Is a very broad term, and means different things
+to different people. Here are the services that the Community
+Development (ComDev) project offers to the participants and projects of
+the Apache Software Foundation.
+
+
+### Individual Mentorship
+- [GSoC](/gsoc.html)
+- [Contributors Guide](/newcomers/)
+- [Committers Guide](/committers)
+- Project Management Committees
+
+### Project Mentorship
+- Incubator Mentors
+- TLPs and sub-projects
+- Project Community Ombudsman
+
+### Education + Outreach
+- [ApacheCon](http://apachecon.com/)
+- Partnered Industry Events (FOSDEM etc.)
+- Apache-oriented industry events (Hadoop Summit)
+- MeetUps, BarCamps, etc.
+- Event Representatives (booth coverage, etc.)
+- Speaker Resources
+- Stock Presentations
+- Slide Templates
+- Speaker Guide
+
+### Diversity
+- [Code of Conduct](http://www.apache.org/foundation/policies/conduct.html)
+- Surveys
+- Women in Apache events (e.g., ApacheCon Luncheon, etc.)
+- ApacheCon family activities (e.g., kids programming challenge,
+ babysitting services, etc.)
+- ApacheCon diversity scholarship (e.g., free registration, access to
+ tutorials, etc.)
+
+### [TAC - Travel Assistance Committee](/travel)
+
Added: comdev/site/trunk/content/mentoring/committer.mdtext
URL: http://svn.apache.org/viewvc/comdev/site/trunk/content/mentoring/committer.mdtext?rev=1782338&view=auto
==============================================================================
--- comdev/site/trunk/content/mentoring/committer.mdtext (added)
+++ comdev/site/trunk/content/mentoring/committer.mdtext Thu Feb 9 14:58:09 2017
@@ -0,0 +1,31 @@
+Title: Mentoring a new committer
+Notice: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+ .
+ http://www.apache.org/licenses/LICENSE-2.0
+ .
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+# Mentoring a new committer
+
+So I'm a committer now. What's next? What rights do I have now that I
+didn't have before? What are the social conventions around making a
+commit?
+
+These things vary from one project to another, so clearly documenting
+them for your particular project is critical.
+
+Here's the basics that are true across (almost) all Apache projects.
+
+TODO
+
Added: comdev/site/trunk/content/mentoring/firstpatch.mdtext
URL: http://svn.apache.org/viewvc/comdev/site/trunk/content/mentoring/firstpatch.mdtext?rev=1782338&view=auto
==============================================================================
--- comdev/site/trunk/content/mentoring/firstpatch.mdtext (added)
+++ comdev/site/trunk/content/mentoring/firstpatch.mdtext Thu Feb 9 14:58:09 2017
@@ -0,0 +1,30 @@
+Title: Mentoring: First Patch
+Notice: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+ .
+ http://www.apache.org/licenses/LICENSE-2.0
+ .
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+# Mentoring: First Patch
+
+A beginner's first patch on a project can be an intimidating and
+frustrating experience. Clearly documenting the entire process from
+checkout to accepted patch greatly lowers the barrier for a new
+contributor, and makes it more likely that they'll come back for their
+second patch.
+
+Here's some tips on how to do that.
+
+
+
Added: comdev/site/trunk/content/mentoring/index.mdtext
URL: http://svn.apache.org/viewvc/comdev/site/trunk/content/mentoring/index.mdtext?rev=1782338&view=auto
==============================================================================
--- comdev/site/trunk/content/mentoring/index.mdtext (added)
+++ comdev/site/trunk/content/mentoring/index.mdtext Thu Feb 9 14:58:09 2017
@@ -0,0 +1,39 @@
+Title: Mentoring
+Notice: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+ .
+ http://www.apache.org/licenses/LICENSE-2.0
+ .
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+# Mentoring
+
+A major job of Community Development is mentoring. Mentoring is the
+process of actively bringing someone along in a discipline - investing
+your time into influencing the future. Time spent mentoring today will
+pay off for years to come.
+
+Anyone can be a mentor. You just have to take a moment to encourage
+someone else to participate.
+
+Here's some concrete ways you can provide mentoring to other members of
+your community.
+
+- [GSoC](/gsoc.html)
+- [Participate in the incubator](http://incubator.apache.org/)
+- [Walk a beginner through their first patch](/mentoring/firstpatch.html)
+- [Coach a new committer](/mentoring/committer.html)
+- [Take a new PMC member under your wing](/mentoring/pmc.html)
+- [Encourage someone to mentor someone else](/mentoring/mentor.html)
+
+
Added: comdev/site/trunk/content/mentoring/mentor.mdtext
URL: http://svn.apache.org/viewvc/comdev/site/trunk/content/mentoring/mentor.mdtext?rev=1782338&view=auto
==============================================================================
--- comdev/site/trunk/content/mentoring/mentor.mdtext (added)
+++ comdev/site/trunk/content/mentoring/mentor.mdtext Thu Feb 9 14:58:09 2017
@@ -0,0 +1,30 @@
+Title: Mentoring Mentors
+Notice: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+ .
+ http://www.apache.org/licenses/LICENSE-2.0
+ .
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+# Mentoring Mentors
+
+The job of a mentor is to reproduce - spread the work load. Once you've
+mentored someone, you need to encourage them to become a mentor
+themselves. Here's some ways you can do that.
+
+- Point out people that need a little help
+- Encourage them to answer a question rather than answering it yourself
+- ...
+
+TODO
+
Added: comdev/site/trunk/content/mentoring/pmc.mdtext
URL: http://svn.apache.org/viewvc/comdev/site/trunk/content/mentoring/pmc.mdtext?rev=1782338&view=auto
==============================================================================
--- comdev/site/trunk/content/mentoring/pmc.mdtext (added)
+++ comdev/site/trunk/content/mentoring/pmc.mdtext Thu Feb 9 14:58:09 2017
@@ -0,0 +1,35 @@
+Title: Mentoring a new PMC member
+Notice: Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+ .
+ http://www.apache.org/licenses/LICENSE-2.0
+ .
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+
+# Mentoring a new PMC member
+
+So I'm a PMC member now. What does this mean? What rights do I have now
+that I didn't have before? What conversations belong on the private
+list, as opposed to the public list.
+
+These things vary a little from one project to another, so clearly
+documenting them for your particular project is critical. And
+specifically assigning a PMC mentor to new PMC members can greatly help
+that new member get up to speed, and prevent problems in the future.
+
+Here's the basic things that a new PMC member needs to know, and how you
+can help them in their new job.
+
+TODO
+
+