--- ,intro.txt	2006-10-11 09:22:24.000000000 -0500
+++ ,spec.txt	2006-10-11 09:21:57.000000000 -0500
@@ -22,9 +22,9 @@
    The Resource Description Framework[33][RDFC04] provides a standard for
    making statements about resources in the form of a
    subject-predicate-object expression. One way to represent the fact "The
-   Stand's author is Stephen King" in RDF would be as a triple whose subject
+   Stand's author is Stephen King" is RDF would be as a triple whose subject
    is "The Stand," whose predicate is "has the author," and whose object is
-   "Stephen King," The predicate, "has the author" expresses a relationship
+   "Stephen King." The predicate, "has the author" expresses a relationship
    between the subject (The Stand) and the object (Stephen King). Using URIs
    to uniquely identify the book, the author and even the relationship would
    facilitate software design because not everyone knows Stephen King or even
@@ -54,6 +54,9 @@
    documents. Content authors can nominate the transformations for producing
    RDF from their content and use GRDDL to refer to them.
 
+   @@TODO: consider a different hello-world example, synced with primer/use
+   cases.
+
   For example:
 
    Dublin Core meta-data can be written in an HTML dialect[34][RFC2731] that
@@ -73,15 +76,18 @@
  </rdf:RDF>
 
    The correspondence between the source and result forms of this example is
-   expressed as an algorithm in an XSLT transformation, [36]dc-extract.xsl:
+   expressed as an algorithm in an XSLT transformation, [36]dc-extract.xsl.
 
   Transformations
 
    Transformations are currently commonly expressed using XSLT 1.0, although
-   other methods are permissible. Generally, if the transformation can be
+   other formats are permissible. Generally, if the transformation can be
    fully expressed in XSLT 1.0 then it is preferable to use that format since
-   all GRDDL processors should be capable of interpreting an XSLT 1.0
-   document.
+   most GRDDL implementation experience to date involves XSLT 1.0
+   transformations.
+
+   not clear to DanC how this next para fits in the introduction... re-work
+   cross-spec link as citation, at least...
 
    [37]XProc: An XML Pipeline Language, a language for describing operations
    to be performed on XML documents, has recently been published as a W3C
@@ -92,9 +98,9 @@
    transformation to a document, aborting if the result or an intermediate
    stage is not valid.
 
-  GRDDL WD
+  GRDDL Specification
 
-   This GRDDL Working Draft is a concise technical specification of the GRDDL
+   This GRDDL specification is a concise technical specification of the GRDDL
    mechanism and its XML syntax. It specifies the GRDDL syntax to use in
    valid XHTML and well-formed XML documents, as well as how to encode GRDDL
    into namespaces and HTML profiles. Discussions of the GRDDL transformation
@@ -119,19 +125,5 @@
    can be decorated with [39]microformat, [40]Embedded RDF or [41]RDFa
    statements to support [42]GRDDL transformations in charge of extracting
    valuable data that can then be used to automate a variety of tasks.
+   @@TODO: fix or remove broken citation refs.