Presentation of the definition of Triple Terms

afs commented 3 days ago

(Refers to RDF Concepts as of 2024-11-01)

There is no section for the definition of "Triple Term" - this stands out in the TOC for section 3. RDF Graphs.

3. RDF Graphs

3 subsections for RDF terms, no subsection for "Triple Term".

The definition of "triple term" is within section 3.1 ("Triples").

There is section 1.3 Triple Terms which discusses triple terms, reifying triples and reification.

Suggestion:

Rename 1.3 as "Triple Terms and Reification"
Create a new subsection "Triple Terms" in section 3 with the material from "A triple term is a 3-tuple that is defined recursively as follows:" to the end of the three notes.

The new "Triple terms" subsection could go after "Blank Nodes" before "Replacing Blank Nodes", to agree with the order in IRIs, literals, blank nodes, and triple terms are collectively known as RDF terms.

For consistency, maybe move the discussion "Initial Text Direction" (non-normative section ) to after the normative, defining sections for triples and the 4 RDF terms. "Replacing Blank Nodes with IRIs" is already a separate section. If keeping to the earlier term order style, "Initial Text Direction", then "Replacing Blank Nodes with IRIs".

afs commented 1 day ago

While working on this issue, I notices that the use of h2/h3 header levels is inconsistent. Teh indentation is consistent. It does not affect the rendered HTML.

Output of grep for <h.> with indent

```

Introduction

Graph-based Data Model

Resources and Statements

Triple Terms and Reification

The Referent of an IRI

RDF Vocabularies and Namespace IRIs

RDF and Change over Time

Working with Multiple RDF Graphs

Equivalence, Entailment and Inconsistency

RDF Documents and Syntaxes

Strings in RDF

RDF Graphs

Triples

IRIs

Literals

Blank Nodes

Triple Terms

Initial Text Direction

Replacing Blank Nodes with IRIs

Graph Comparison

RDF Datasets

RDF Dataset Comparison

Content Negotiation of RDF Datasets

Dataset as a Set of Quads

Datatypes

The XML Schema Built-in Datatypes

Datatype IRIs

Fragment Identifiers

Generalized RDF Triples, Graphs, and Datasets

Additional Datatypes

The `rdf:HTML` Datatype

The `rdf:XMLLiteral` Datatype

The `rdf:JSON` Datatype

Privacy Considerations

Security Considerations

Internationalization Considerations

IRI Grammar

Acknowledgments

Acknowledgments for RDF 1.0

Acknowledgments for RDF 1.1

Acknowledgments for RDF 1.2

Changes between RDF 1.1 and RDF 1.2

```

afs commented 1 day ago

The sections "The Referent of an IRI" and "RDF Vocabularies and Namespace IRIs" seem more generally important. The section order would be:

1.2 Resources and Statements
1.3 The Referent of an IRI
1.4 RDF Vocabularies and Namespace IRIs
1.5 Triple Terms and Reification
1.6 RDF and Change over Time

gkellogg commented 1 day ago

While working on this issue, I notices that the use of h2/h3 header levels is inconsistent. Teh indentation is consistent. It does not affect the rendered HTML.

Output of grep for <h.> with indent

While they should be consistent, ReSpec ignores which particular form is used, IIRC.

w3c / rdf-concepts