Hi,

For our upcoming 0.1 release I have created a user guide:

http://commonsrdf.incubator.apache.org/userguide.html


I think this could be a useful way to show outsiders what Commons RDF
is about and how the methods are meant to be used together, with a few
caveats and features highlighted.


The user guide should be true for the current SNAPSHOT

to test it see
https://gist.github.com/stain/3c310f87c4465541be66


Improvements and suggestions desired!


I think I have covered everything except Graph.close() - perhaps
someone who understand that better could draft out an example of its
usecase? I'm thinking something like:

try (Graph g2 = new BarGraph("localhost", 1337)) {
   g2.add(...);
}



I've indicated with Jira issues the sections I think are subject to
change, e.g. COMMONSRDF-6, COMMONSRDF-7, COMMONSRDF-15.





The only things that I think would need to be updated for the 0.1 release are:

1) Outcome of COMMONSRDF-6 for 0.1 - search-replace
"internalIdentifier()" if needed.

2) Version number of Maven dependency - This should be the latest
released version and not need snapshot repository.

(I did not find a way to inject ${project.version} into Markdown
templates with Doxia. Mentors - do you know any tricks? Ideally single
page we could link to - but I'm not sure if this would be
download.html with the Apache Commons download.cgi system)


-- 
Stian Soiland-Reyes
Apache Taverna (incubating), Apache Commons RDF (incubating)
http://orcid.org/0000-0001-9842-9718

Reply via email to