There are various bits of example code referenced from the current
documentation. There's more that I would like to add to support some of
the new content. What we don't have, at the moment, is a place to put it
(Paolo's github notwithstanding [1] :)
Proposal: create an svn module
https://svn.apache.org/repos/asf/incubator/jena/Jena2/Examples/
(with standard trunk/, tags/, branches/ layout). Use maven for
dependencies. For each example, e.g. the Ont API class hierarchy
example, create a Java package:
org.apache.jena.example.class_hierarchy
in src/main/java, and put necessary resources (*.rdf, assembler configs,
etc), in src/main/resources/example/class_hierarchy
Optionally, we could group examples together by theme:
org.apache.jena.example.ontology.class_hierarchy
but personally I'm in favour of a flat structure so that users can see
all of the examples at one level.
There should be some level of README documentation about each example in
the examples package somewhere.
Distribution could either be by just letting users check out the code
from svn or the git mirror (we could provide detailed instructions on
the web site), or we could add an assembly to zip up the contents of the
examples module.
Comments?
Ian
[1] https://github.com/castagna/Apache-Jena-Examples
--
____________________________________________________________
Ian Dickinson Epimorphics Ltd, Bristol, UK
mailto:[email protected] http://www.epimorphics.com
cell: +44-7786-850536 landline: +44-1275-399069
------------------------------------------------------------
Epimorphics Ltd. is a limited company registered in England
(no. 7016688). Registered address: Court Lodge, 105 High St,
Portishead, Bristol BS20 6PT, UK