Details
-
Documentation
-
Status: Closed
-
Trivial
-
Resolution: Fixed
-
None
Description
I suspect the following error in the documentation at http://jena.apache.org/tutorials/rdf_api.html
Nearly 1/2 way down the page:
> We see that the rdf namespace is declared automatically, since it is required for tags such as <RDF:rdf> and <rdf:resource>. Namespace declarations are also needed for using the two properties P and Q, but since their namespaces have not been introduced to the model, they get invented namespace names: j.0 and j.1.
1. The XML tag <RDF:rdf> should have the cases swapped to <rdf:RDF>.
2. The concepts of namespaces and prefixes could be more clearly differentiated.
For example:
> We see that the rdf namespace prefix is declared automatically, since it is required for tags such as <rdf:RDF> and <rdf:resource>. Namespace prefix declarations are also needed for using the two properties P and Q, but since their namespace prefixes have not been introduced to the model, they get invented ones: j.0 and j.1.
Change number 2 isn't my area of expertise, but I think the concept of namespace is inherent in the URIs in the example. So, to say that "Namespace declarations are also needed..." is ambiguous, since Jena implicitly knows about the namespace "http://somewhere/else#" by virtue of the URIs of properties P and Q. Hence the change to "Namespace prefix declarations are also needed..." since explicit declarations are required for Jena to know about the prefix "nsA" and its correspondence to the aforementioned namespace.