Kirby Banman created JENA-453:
---------------------------------
Summary: Error in "An Introduction to RDF and the Jena RDF API"
Key: JENA-453
URL: https://issues.apache.org/jira/browse/JENA-453
Project: Apache Jena
Issue Type: Documentation
Components: Web site
Reporter: Kirby Banman
Priority: Trivial
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.
--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira
