You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@isis.apache.org by da...@apache.org on 2012/02/12 20:52:32 UTC
svn commit: r1243308 - in /incubator/isis/trunk/framework/src/site:
apt/newbie.apt site.xml
Author: danhaywood
Date: Sun Feb 12 19:52:31 2012
New Revision: 1243308
URL: http://svn.apache.org/viewvc?rev=1243308&view=rev
Log:
ISIS-188: updating site, adding reference to #newbie issues
Added:
incubator/isis/trunk/framework/src/site/apt/newbie.apt (with props)
Modified:
incubator/isis/trunk/framework/src/site/site.xml
Added: incubator/isis/trunk/framework/src/site/apt/newbie.apt
URL: http://svn.apache.org/viewvc/incubator/isis/trunk/framework/src/site/apt/newbie.apt?rev=1243308&view=auto
==============================================================================
--- incubator/isis/trunk/framework/src/site/apt/newbie.apt (added)
+++ incubator/isis/trunk/framework/src/site/apt/newbie.apt Sun Feb 12 19:52:31 2012
@@ -0,0 +1,97 @@
+~~ 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.
+
+
+For 'Newbie' Contributors
+
+ All the projects in Apache - Isis included - only succeed because of the involvement
+ of their community:
+
+ * For most, that means just using the software, and perhaps reporting the occasional
+ feature request or defect via JIRA.
+
+ * For some, it may also mean blogging or tweeting about using the software, explaining
+ to others (or maybe themselves) about how it solves their particular problems, and
+ in general helping to advertise its existence.
+
+ * And finally there are the contributors to the project: those who have a deep belief
+ in the value of the software, and want to bring their expertise to bear to in its
+ continued development.
+
+ []
+
+ So, suppose you find yourself in this latter group: you'd like to contribute back to
+ Isis, but you're not sure how. On the one hand, there's knowing what the process is;
+ on the other, there's just the difficulty of getting to grips with a large codebase.
+
+Process
+
+ From a process viewpoint, the way it works is:
+
+ * make sure you are subscribed to the isis-users mailing list and to the isis-dev mailing list
+
+ ... and start contributing to the conversation threads
+
+ * register yourself on Apache's {{{https://issues.apache.org/jira}JIRA}} ticket tracking system
+
+ * start contributing patches to existing JIRA issues
+
+ * or, if you have some existing code that you think would be of value to the project,
+ raise a new ticket and attach that code (eg as a zip)
+
+ []
+
+ After a little while, you may be invited to become a committer. Someone in the existing
+ community will ask you if you are interested; if you are, then a vote will be held by the
+ existing committers and project mentors. Assuming that it passes, you'll be granted
+ permission to start committing directly to the source code repository.
+
+JIRA tickets for 'Newbies'
+
+ As noted above, Isis' codebase is quite large, so navigating it and finding existing issues
+ that could you could tackle can be quite a challenge. To help, we've try to identify
+ simple issues with a #newbie label. These issues fall into one of two categories:
+
+ * either they are really relatively trivial to complete
+
+ * or, they represent stand-alone or new features that could be developed without necessarily
+ having to grok all the existing code.
+
+ []
+
+ You can find the current newbie issues by {{{https://issues.apache.org/jira/secure/IssueNavigator.jspa?mode=hide&requestId=12318871}following this link}}.
+
+ And, before you start, don't forget to consult the {{{./docbkx/html/guide/isis-contributors-guide.html}contributors guide}}
+ to describe how to build Isis from source, and how to configure your development environment.
+
+Not only code
+
+ There are more ways to contribute than to cut code! We'd also appreciate help with:
+
+ * improving documentation (from fixing typos thru to writing how-to guides)
+
+ * screencasts
+
+ * developing example apps
+
+ * writing blog posts
+
+ * writing articles
+
+ * taking part in mailing list discussions
+
+ []
Propchange: incubator/isis/trunk/framework/src/site/apt/newbie.apt
------------------------------------------------------------------------------
svn:eol-style = native
Modified: incubator/isis/trunk/framework/src/site/site.xml
URL: http://svn.apache.org/viewvc/incubator/isis/trunk/framework/src/site/site.xml?rev=1243308&r1=1243307&r2=1243308&view=diff
==============================================================================
--- incubator/isis/trunk/framework/src/site/site.xml (original)
+++ incubator/isis/trunk/framework/src/site/site.xml Sun Feb 12 19:52:31 2012
@@ -160,18 +160,7 @@
<item name="Gmane (NNTP)"
href="http://blog.gmane.org/gmane.comp.apache.incubator.isis.devel" />
</item>
- <item name="Dev Mailing List" href="mail-lists.html" >
- <item name="Post to"
- href="mailto:isis-dev@incubator.apache.org" />
- <item name="Archives"
- href="http://mail-archives.apache.org/mod_mbox/incubator-isis-dev/" />
- <item name="Subscribe"
- href="mailto:isis-dev-subscribe@incubator.apache.org" />
- <item name="Markmail (RSS)"
- href="http://incubator.markmail.org/search/?q=isis-dev" />
- <item name="Gmane (NNTP)"
- href="http://blog.gmane.org/gmane.comp.apache.incubator.isis.devel" />
- </item>
+ <item name="For Newbie Contributors" href="newbies.html"/>
</menu>
<menu name="Project Info" ref="reports"/>