Mailing-List: contact jena-dev-help@incubator.apache.org; run by ezmlm
Precedence: bulk
Reply-To: jena-dev@incubator.apache.org
Received-SPF: pass (athena.apache.org: domain of castagna.lists@googlemail.com
 designates 209.85.210.175 as permitted sender)
Message-ID: <4EBD30BC.8000909@googlemail.com>
Date: Fri, 11 Nov 2011 06:27:08 -0800
From: Paolo Castagna <castagna.lists@googlemail.com>
User-Agent: Thunderbird 2.0.0.24 (X11/20101027)
MIME-Version: 1.0
To: jena-dev@incubator.apache.org
Subject: Re: svn commit: r1200892 - /incubator/jena/README
References: <20111111140613.D47F3238897A@eris.apache.org>
In-Reply-To: <20111111140613.D47F3238897A@eris.apache.org>
Content-Type: text/plain; charset=UTF-8; format=flowed
Content-Transfer-Encoding: 7bit

Yeah! Thanks.

A proposal for a small addition to this README file:

"""
The Experimental/ directory contains prototypes which might or might not become 
supported Jena modules/contributions.
The Import/ directory contains the Jena CVS and SVN imports from SourceForge, 
it's here just for historical/archival reasons but we do not expect you to look 
at it.
The Scratch/ directory is our little|small|personal playground on the Apache SVN 
repository, this stuff might or might not made it into Jena code base. A sort of 
micro Apache Labs (http://labs.apache.org/) for tiny things related to Apache 
Jena. Some of us use also GitHub for this.
Last but not least, the site/ directory contains the sources for the Apache Jena 
website and... yes! You can check it out and submit patches for it. Patches on 
documentation are as welcome as patches for code.
"""

Feel free to change/improve as you wish.

The aim is to clearly tell people:

  - do not waste your time on Import/
  - you can submit patches for site/ and they are welcome!
  - if you are curious and not afraid to experiment, feel free to look at
    Experimental/ and/or Scratch/ but, please, be aware that this is
    "unsupported" and "unreleased" stuff until it's moved elsewhere.

Paolo

andy@apache.org wrote:
> Author: andy
> Date: Fri Nov 11 14:06:13 2011
> New Revision: 1200892
> 
> URL: http://svn.apache.org/viewvc?rev=1200892&view=rev
> Log:
> Add a README for the Jena svn repository
> 
> Added:
>     incubator/jena/README
> 
> Added: incubator/jena/README
> URL: http://svn.apache.org/viewvc/incubator/jena/README?rev=1200892&view=auto
> ==============================================================================
> --- incubator/jena/README (added)
> +++ incubator/jena/README Fri Nov 11 14:06:13 2011
> @@ -0,0 +1,18 @@
> +Jena README
> +===========
> +
> +Welcome to Apache Jena,  a Java framework 
> +for writing Semantic Web applications.
> +
> +The Jena Framework includes:
> +
> ++ an API for reading, processing and writing RDF data in XML, N-triples and Turtle formats;
> ++ an ontology API for handling OWL and RDFS ontologies;
> ++ a rule-based inference engine for reasoning with RDF and OWL data sources;
> ++ stores to allow large numbers of RDF triples to be efficiently stored on disk;
> ++ a query engine compliant with the latest SPARQL specification
> ++ servers to allow RDF data to be published to other applications using SPARQL
> +
> +The codebase for the active modules is to be found under:
> +
> +https://svn.apache.org/repos/asf/incubator/jena/Jena2/
> 
>