[Bug 4701] [FT] editorial: 2.3 Score Variables

http://www.w3.org/Bugs/Public/show_bug.cgi?id=4701

           Summary: [FT] editorial: 2.3 Score Variables
           Product: XPath / XQuery / XSLT
           Version: Last Call drafts
          Platform: All
        OS/Version: All
            Status: NEW
          Severity: minor
          Priority: P2
         Component: Full Text
        AssignedTo: jim.melton@acm.org
        ReportedBy: jmdyck@ibiblio.org
         QAContact: public-qt-comments@w3.org


2.3 Score Variables

[1]
para 1
"[Definition: Scores express the relevance of those results to the
full-text search conditions.]"
    Not great as a standalone definition. Maybe:
        The score of a full-text search result expresses its relevance to
        the search conditions.

[2]
para 3
"The production for the extended 'for' clause follows."
    [2a]
    After "clause", insert something like "for XQuery 1.0".

    [2b]
    Then, after the productions, say:
        "In XPath 2.0, the SimpleForClause is extended similarly."
    (Or give it explicitly.)

[3]
para 7
"XPath 2.0 Full-Text extends the language of XPath 2.0 in the for
expression in the same way: with optional score variables."
    Given the above changes, you can delete this sentence.

[4]
para 9
"Note that the score applies to the entire 'for' expression."
    It's not clear what this means. Given the subsequent sentence, I think
    maybe you're talking about the expression that follows the "in"
    keyword (as opposed to the expression that contains the "for"
    keyword).

[5]
para 11
"to the nodes in the respective RangeExprs"
    s/nodes/items/
    s/in/returned by/

[6]
para 12
"The let variable may be dropped from the let clause, if the score
variable is present."
    s/may/must/, according to the EBNF.

[7]
para 14
"While when ..."
    Not a promising start for a sentence. How about:
        "When using ... the scores. However, it is possible..."

[8]
para 16
"more relevant than a book that does not contain either of both."
    "either of both" is presumably a typo.
    s/both/those phrases/

[9]
para 17
"The expression ExprSingle assigned to the score variable"
    [9a]
    Delete "ExprSingle".

    [9b]
    s/assigned to/associated with/

[10]
"is passed to the scoring algorithm and is not evaluated directly."
    Change to:
        "is passed to the scoring algorithm, which does not evaluate it
        directly"
    (That also covers the case of a score variable in a ForClause, where
    the expression *is* evaluated directly, but not by the scoring
    algorithm.)

[11]
"is not evaluated directly."
    But is it evaluated indirectly? If so, what are the semantics of
    indirect evaluation? What is its evaluation context? Does it raise
    errors? Certainly all the non-FT expressions within an FTContainsExpr
    have to evaluated, otherwise you have nothing to score and no criteria
    by which to score it.

[12]
"The set of supported expressions is implementation-defined."
    [12a]
    I think you'll need to be a bit more explicit. E.g.:
        "The set of expressions supported by the scoring algorithm..."

    [12b]
    What is the effect of using an expression that is not supported?

    [12c]
    Are there any expressions that must be supported?

Received on Saturday, 23 June 2007 09:58:15 UTC