[
https://issues.apache.org/jira/browse/JENA-453?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]
Kirby Banman updated JENA-453:
------------------------------
Summary: Typo and wording error in "An Introduction to RDF and the Jena RDF
API" (was: Error in "An Introduction to RDF and the Jena RDF API")
> Typo and wording 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
> Labels: documentation
>
> 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
