W3C home > Mailing lists > Public > public-qt-comments@w3.org > June 2007

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

From: <bugzilla@wiggum.w3.org>
Date: Sat, 23 Jun 2007 09:58:10 +0000
To: public-qt-comments@w3.org
Message-Id: <E1I22Ne-0005LV-Pb@wiggum.w3.org>


           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

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.

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

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

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.

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"

para 11
"to the nodes in the respective RangeExprs"
    s/in/returned by/

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.

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

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/

para 17
"The expression ExprSingle assigned to the score variable"
    Delete "ExprSingle".

    s/assigned to/associated with/

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

"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.

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

    What is the effect of using an expression that is not supported?

    Are there any expressions that must be supported?
Received on Saturday, 23 June 2007 09:58:15 UTC

This archive was generated by hypermail 2.3.1 : Wednesday, 7 January 2015 15:45:33 UTC