Uploaded image for project: 'Apache Jena'
  1. Apache Jena
  2. JENA-453

Typo and wording error in "An Introduction to RDF and the Jena RDF API"

    XMLWordPrintableJSON

    Details

    • Type: Documentation
    • Status: Closed
    • Priority: Trivial
    • Resolution: Fixed
    • Affects Version/s: None
    • Fix Version/s: Jena 2.11.0
    • Component/s: Web site
    • Labels:

      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.

        Attachments

          Activity

            People

            • Assignee:
              andy Andy Seaborne
              Reporter:
              kdbanman Kirby Banman
            • Votes:
              0 Vote for this issue
              Watchers:
              2 Start watching this issue

              Dates

              • Created:
                Updated:
                Resolved: