ISSUE-162 (Section 1.2), comments by Peter

shacl/index.html

@@ -428,7 +428,7 @@ <h3>Terminology</h3>
 				<div class="def">
 					<div class="term-def-header">Filter</div>
 					<div>
-						A <dfn data-lt="filter shape|filter shapes|filter">filter</dfn> is a <a>shape</a> in a <a>shapes graph</a> that limits the <a>nodes</a> that are
+						A <dfn data-lt="filter shape|filter shapes|filter|filters">filter</dfn> is a <a>shape</a> in a <a>shapes graph</a> that limits the <a>nodes</a> that are
 						validated against the constraints of another shape.
 						Only those <a>nodes</a> that validate against all the filters of a shape are validated against its constraints.
 					</div>
@@ -490,7 +490,8 @@ <h3>Document Conventions</h3>
 					</tr>
 				</table>
 				<p>
-					Throughout the document, color-coded boxes containing RDF in Turtle markup will appear.
+					Throughout the document, color-coded boxes containing RDF graphs in Turtle will appear.
+					These fragments of Turtle documents use the prefix bindings given above.
 				</p>
 				<pre class="example-shapes">
 # This box represents an input shapes graph
@@ -502,8 +503,9 @@ <h3>Document Conventions</h3>
 # This box represents an input data graph.
 # When highlighting is used in the examples:
 
-# Elements highlighted in blue are focus nodes that
-# are selected by shape <a href="#shapes">scopes and filters</a>
+# Elements highlighted in blue are <a>focus nodes</a> that are
+# selected by by some <a>scope</a> of a <a>shape</a> under discussion
+# and validate against the shape's <a>filters</a>, if any.
 <span class="focus-node-selected">ex:Bob</span> a ex:Person .
 
 # Elements highlighted in red are focus nodes that fail <a href="#validation">validation</a>