I've just recently started using Jena and Fuseki, and although I believe
I've worked it out now, I struggled at first making sense of the fuseki
configuration file. There is some documentation about it at
<http://jena.apache.org/documentation/serving_data/#fuseki-configuration-file>,
but I think for new users like me, it could be a clearer, and make fewer
assumptions about your existing level of knowledge.
As an example, the term <http://jena.apache.org/fuseki#services> is a
collection of resources which are instances of the class
<http://jena.apache.org/fuseki#Service>, but what actually IS a service?
The same web page also talks about the "service endpoints" which are not
the same thing (I initially took them to mean the same thing). It seems
to me now that a fuseki:Service actually means something like an
"accessible dataset", and the different service endpoints (what I would
normally think of as "services") are actually attributes of that
fuseki:Service.
Similarly, the way that the various endpoints of a fuseki:Service are
configured (by specifying a relative URI component as the value of that
endpoint's property) is not that clear. It took trial and error to
discover that the actual URI of the service endpoint is relative to a
base URI defined by the fuseki:name of the fuseki:Service. It's not that
hard to understand once you know, but working it out from the
documentation is not as easy as it could be, I think.
What I would have found really helpful would be documentation organised
specifically around the configuration vocabulary itself. And
particularly if the URIs defining the Fuseki configuration vocabulary
had been resolvable to some documentation. The URI of the namespace is
<http://jena.apache.org/fuseki#> which currently returns a 404. Would it
be possible to put up a page at that address, with sections documenting
all the terms in the Fuseki configuration vocabulary? I would be happy
to contribute to the documentation!
Thanks
Conal
--
Conal Tuohy
eResearch Business Analyst
Victorian eResearch Strategic Initiative
+61-466324297
