[jira] [Commented] (JENA-453) Typo and wording error in "An Introduction to RDF and the Jena RDF API"

["Andy Seaborne (JIRA)" <ji...@apache.org>]

    [ https://issues.apache.org/jira/browse/JENA-453?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13661610#comment-13661610 ] 

Andy Seaborne commented on JENA-453:
------------------------------------

1 => correction applied to staging : http://jena.staging.apache.org/tutorials/rdf_api.html 

2 => The point is that XML namespace declarations are needed. 

The first example does say "no special prefixes defined" and the second "nsA defined"

Is this clearer?
"""
XML namespace declarations are also
needed for using the two properties P and Q, but since their
prefixes have not been introduced to the model in this example,
"""


                
> 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