You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@jena.apache.org by ca...@apache.org on 2011/10/09 23:44:51 UTC
svn commit: r796819 - in /websites/production/jena: ./
content/jena/about_jena/roadmap.html content/jena/about_jena/team.html
content/jena/download/maven.html content/jena/getting_involved/index.html
content/jena/help_and_support/bugs_and_suggestions.html
Author: castagna
Date: Sun Oct 9 21:44:50 2011
New Revision: 796819
Log:
Minor and trivial changes here and there. Improvements to the getting involved page content.
Modified:
websites/production/jena/ (props changed)
websites/production/jena/content/jena/about_jena/roadmap.html
websites/production/jena/content/jena/about_jena/team.html
websites/production/jena/content/jena/download/maven.html
websites/production/jena/content/jena/getting_involved/index.html
websites/production/jena/content/jena/help_and_support/bugs_and_suggestions.html
Propchange: websites/production/jena/
------------------------------------------------------------------------------
--- svn:mergeinfo (original)
+++ svn:mergeinfo Sun Oct 9 21:44:50 2011
@@ -1 +1 @@
-/websites/staging/jena/trunk:782833-796699
+/websites/staging/jena/trunk:782833-796818
Modified: websites/production/jena/content/jena/about_jena/roadmap.html
==============================================================================
--- websites/production/jena/content/jena/about_jena/roadmap.html (original)
+++ websites/production/jena/content/jena/about_jena/roadmap.html Sun Oct 9 21:44:50 2011
@@ -138,16 +138,15 @@
<div id="content">
<h1 class="title">Jena Roadmap</h1>
- <p>The following work items are underway, with estimated due dates:</p>
-<ul>
-<li><em>none currently scheduled</em></li>
-</ul>
+ <p>There isn't an official roadmap yet. </p>
+<p>However, you can view a list of the <a href="https://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&jqlQuery=project+%3D+JENA+AND+status+%3D+Open+ORDER+BY+priority+DESC&mode=hide">open issues</a> on JIRA (sorted by priority) or the <a href="https://issues.apache.org/jira/browse/JENA#selectedTab=com.atlassian.jira.plugin.system.project%3Apopularissues-panel">popular issues</a> (sorted by votes).
+Or, you can look at the <a href="https://issues.apache.org/jira/secure/QuickSearch.jspa?searchString=jena+updated:-1w">last week activity</a> to get a sense of what people are working on.</p>
<p>The following features are desired or expected, but are not yet underway:</p>
<ul>
<li>OWL 2 support in ontology API</li>
<li>migrate package names from <code>com.hp</code> to <code>org.apache</code></li>
</ul>
-<p>Patches and other contribs welcome!</p>
+<p>Patches and other contributions welcome!</p>
</div>
<div id="footer">
Modified: websites/production/jena/content/jena/about_jena/team.html
==============================================================================
--- websites/production/jena/content/jena/about_jena/team.html (original)
+++ websites/production/jena/content/jena/about_jena/team.html Sun Oct 9 21:44:50 2011
@@ -142,12 +142,12 @@
<li>Andy Seaborne (andy) <strong>CP</strong></li>
<li>Bertrand Delacretaz (bdelacretaz) <strong>CPM</strong></li>
<li>Benson Margulies (bimargulies) <strong>CPM</strong></li>
-<li>Paolo Castagna (castagna) <strong>CP</strong></li>
<li>Chris Dollin (chrisdollin) <strong>CP</strong></li>
<li>Damian Steer (damian) <strong>CP</strong></li>
<li>Dave Reynolds (der) <strong>CP</strong></li>
<li>Ian Dickinson (ijd) <strong>CP</strong></li>
<li>Leo Simons (leosimons) <strong>CPM</strong></li>
+<li>Paolo Castagna (castagna) <strong>CP</strong></li>
<li>Ross Gardler (rgardler) <strong>CPM</strong>, project champion</li>
</ul>
<h3 id="key">Key</h3>
Modified: websites/production/jena/content/jena/download/maven.html
==============================================================================
--- websites/production/jena/content/jena/download/maven.html (original)
+++ websites/production/jena/content/jena/download/maven.html Sun Oct 9 21:44:50 2011
@@ -147,8 +147,8 @@ please read and follow <a href="http://m
<h3 id="repositories">Repositories</h3>
<p>The Jena repositories are:</p>
<ul>
-<li>http://openjena.org/repo (mirrored to the central Maven repository).</li>
-<li>http://openjena.org/repo-dev for development builds.</li>
+<li><a href="http://openjena.org/repo">http://openjena.org/repo</a> (mirrored to the central Maven repository).</li>
+<li><a href="http://openjena.org/repo-dev">http://openjena.org/repo-dev</a> for development builds.</li>
</ul>
<p>Stable Jena releases are automatically indexed by Maven central, so there will
normally be no need to add any extra repositories to your <code>pom.xml</code>.
@@ -167,6 +167,11 @@ to recent bug fixes, you should add the
</pre></div>
+<p>We are currently in the process to migrate SNAPSHOTs and releases to the Apache Maven repositories, if you want to help with the testing check here:</p>
+<ul>
+<li>https://repository.apache.org/content/repositories/releases/org/apache/jena</li>
+<li><a href="https://repository.apache.org/content/repositories/snapshots/org/apache/jena/">https://repository.apache.org/content/repositories/snapshots/org/apache/jena/</a></li>
+</ul>
<h3 id="specifying_jena_or_arq_as_a_dependency">Specifying Jena or ARQ as a dependency</h3>
<p>This is how to specify in your pom.xml file the dependency on the latest Jena and ARQ stable releases:</p>
<div class="codehilite"><pre><span class="nt"><dependency></span>
@@ -283,7 +288,7 @@ install them in your local Maven reposit
</pre></div>
-<p>Subversion projects also exist for ARQ, TDB, Fuseki and others.</p>
+<p>Subversion projects also exist for SDB, TDB, Fuseki and others modules, you can browse the subversion repository <a href="https://svn.apache.org/repos/asf/incubator/jena/Jena2/">here</a>.</p>
</div>
<div id="footer">
Modified: websites/production/jena/content/jena/getting_involved/index.html
==============================================================================
--- websites/production/jena/content/jena/getting_involved/index.html (original)
+++ websites/production/jena/content/jena/getting_involved/index.html Sun Oct 9 21:44:50 2011
@@ -138,20 +138,52 @@
<div id="content">
<h1 class="title">Getting involved in Apache Jena</h1>
- <p>The Jena project team welcomes contributions from the community towards making
-Jena a better platform for semantic web and linked data applications. We
-welcome feature suggestions, bug reports and patches for code or documentation.</p>
+ <p>We welcome your contribution towards making Jena a better platform for semantic web and linked data applications.
+We appreciate feature suggestions, bug reports and patches for code or documentation.</p>
<p>If you need help using Jena: please see our <a href="../help_and_support">getting help</a> page.</p>
<h3 id="how_to_contribute">How to contribute</h3>
-<p>Please add suggestions, bug reports, feature requests and code contributions (as patches)
-to the Jena issue tracker: <a href="https://issues.apache.org/jira/browse/JENA">issues.apache.org/jira/browse/JENA</a>.</p>
-<p>Feel free to discuss your contribution, before or after adding it to Jira, on
-the <a href="mailto:jena-dev@incubator.apache.org"><code>jena-dev@incubator.apache.org</code></a> mailing list.
+<p>You can help us sending your suggestions, feature requests and bug reports (as well as patches) using the Jena issue tracker:
+<a href="https://issues.apache.org/jira/browse/JENA">https://issues.apache.org/jira/browse/JENA</a>.</p>
+<p>You can discuss your contribution, before or after adding it to Jira, on the <a href="mailto:jena-dev@incubator.apache.org"><code>jena-dev@incubator.apache.org</code></a> mailing list.
+Or, you can help other users answering to their question on the <a href="mailto:jena-users@incubator.apache.org"><code>jena-users@incubator.apache.org</code></a> mailing list.
Subscription instructions <a href="../help_and_support">here</a>.</p>
<h3 id="subversion_repository">Subversion repository</h3>
-<p>The Jena source code repository be found in Subversion at <a href="http://svn.apache.org/repos/asf/incubator/jena/Jena2/">incubator/jena</a>.
-This is now the authoritative, active repository for Jena code. The historical Jena sources are still
-available from <a href="http://sf.net/projects/jena">SourceForge</a>.</p>
+<p>You can find the Jena source code in the Apache subversion repository: <a href="http://svn.apache.org/repos/asf/incubator/jena/Jena2/">http://svn.apache.org/repos/asf/incubator/jena/Jena2/</a>.
+This is now the authoritative, active repository for Jena code. The historical Jena sources are still available from <a href="http://sf.net/projects/jena">SourceForge</a>.</p>
+<p>Each Jena module uses Maven, here is how you can check out, build and test a Jena module:</p>
+<div class="codehilite"><pre><span class="n">svn</span> <span class="n">co</span> <span class="n">https:</span><span class="sr">//s</span><span class="n">vn</span><span class="o">.</span><span class="n">apache</span><span class="o">.</span><span class="n">org</span><span class="sr">/repos/</span><span class="n">asf</span><span class="sr">/incubator/</span><span class="n">jena</span><span class="sr">/Jena2/</span><span class="n">TDB</span><span class="o">/</span><span class="n">trunk</span> <span class="n">TDB</span>
+<span class="n">cd</span> <span class="n">TDB</span>
+<span class="n">mvn</span> <span class="n">clean</span> <span class="nb">package</span>
+</pre></div>
+
+
+<h3 id="open_issues">Open issues</h3>
+<p>You can find a list of the <a href="https://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&jqlQuery=project+%3D+JENA+AND+status+%3D+Open+ORDER+BY+priority+DESC&mode=hide">open issues</a> on JIRA (sorted by priority) or the <a href="https://issues.apache.org/jira/browse/JENA#selectedTab=com.atlassian.jira.plugin.system.project%3Apopularissues-panel">popular issues</a> (sorted by votes).
+Or, you can look at the <a href="https://issues.apache.org/jira/secure/QuickSearch.jspa?searchString=jena+updated:-1w">last week activity</a> to get a sense of what people are working on.</p>
+<h3 id="submit_your_patches">Submit your patches</h3>
+<p>Patches should be attached to issues in Jira (click on <code>More Actions > Attach Files</code>).
+To create a patch you can simply use the command: </p>
+<div class="codehilite"><pre><span class="n">svn</span> <span class="n">diff</span> <span class="o">></span> <span class="n">JENA</span><span class="o">-</span><span class="n">XYZ</span><span class="o">.</span><span class="n">patch</span>
+</pre></div>
+
+
+<p>Please, inspect your patch and make sure it includes all (and only) the relevant changes for a single issue. Don't forget tests!
+If you want to test if a patch applies cleanly you can use: </p>
+<div class="codehilite"><pre><span class="n">patch</span> <span class="o">-</span><span class="n">p0</span> <span class="o"><</span> <span class="n">JENA</span><span class="o">-</span><span class="n">XYZ</span><span class="o">.</span><span class="n">patch</span>
+</pre></div>
+
+
+<p>If you use Eclipse: right click on the project name in <code>Package Explorer</code>, select <code>Team > Create Patch</code> or <code>Team > Apply Patch</code>. </p>
+<h3 id="irc_channel">IRC channel</h3>
+<p>Some Jena developers hang out on #jena on irc.freenode.net.</p>
+<h3 id="how_apache_software_foundation_works">How Apache Software Foundation works</h3>
+<p>Apache Jena is an incubating Apache project and to better understand how to get involved and how the Apache Software Foundation works we recommend you read:<br />
+</p>
+<ul>
+<li><a href="http://www.apache.org/foundation/getinvolved.html">http://www.apache.org/foundation/getinvolved.html</a></li>
+<li><a href="http://www.apache.org/foundation/how-it-works.html">http://www.apache.org/foundation/how-it-works.html</a></li>
+<li><a href="http://www.apache.org/dev/contributors.html">http://www.apache.org/dev/contributors.html</a></li>
+</ul>
</div>
<div id="footer">
Modified: websites/production/jena/content/jena/help_and_support/bugs_and_suggestions.html
==============================================================================
--- websites/production/jena/content/jena/help_and_support/bugs_and_suggestions.html (original)
+++ websites/production/jena/content/jena/help_and_support/bugs_and_suggestions.html Sun Oct 9 21:44:50 2011
@@ -139,10 +139,22 @@
<div id="content">
<h1 class="title">Reporting bugs and making suggestions</h1>
<p>Please report bugs using ASF's <a href="https://issues.apache.org/jira/browse/JENA">JIRA instance for Jena</a>.
-General suggestions or requests for changes can also be discussed on the <a href="index.mdtext">user list</a>,
+General suggestions or requests for changes can also be discussed on the <a href="index.html">user list</a>,
but are less likely to be accidentally forgotten if you log them into JIRA.</p>
-<p>Patches and other code contributions should also be logged into JIRA. Please note that ASF requires
-that all contributions must be covered by an appropriate license.</p>
+<p>Patches and other code contributions should also be attached to issues in JIRA (click on <code>More Actions > Attach Files</code>).
+Please note that ASF requires that all contributions must be covered by an appropriate license.
+To create a patch you can simply use the command: </p>
+<div class="codehilite"><pre><span class="n">svn</span> <span class="n">diff</span> <span class="o">></span> <span class="n">JENA</span><span class="o">-</span><span class="n">XYZ</span><span class="o">.</span><span class="n">patch</span>
+</pre></div>
+
+
+<p>Please, inspect your patch and make sure it includes all (and only) the relevant changes for a single issue. Don't forget unit tests!
+If you want to test if a patch applies cleanly you can use: </p>
+<div class="codehilite"><pre><span class="n">patch</span> <span class="o">-</span><span class="n">p0</span> <span class="o"><</span> <span class="n">JENA</span><span class="o">-</span><span class="n">XYZ</span><span class="o">.</span><span class="n">patch</span>
+</pre></div>
+
+
+<p>If you use Eclipse: right click on the project name in <code>Package Explorer</code>, select <code>Team > Apply Patch</code>. </p>
</div>
<div id="footer">