Re: comments on RIF Primer

Thanks for your comments, Stella!

I'll get to adding the pointers later today, and I'll work on addressing
the other points as well.

Thanks especially for pointing out all the places where the text is
ambiguous or unclear.

Leora

On Sat, September 25, 2010 11:51 am, Stella Mitchell wrote:
> Dear WG,
>
> I found the Primer quite readable, clear and useful,  and just have some
> minor comments.
>
> Stella
>
>
> Section 2.2.2, 2nd para:
>        the last sentence reads to me as if the constant is called a
> predicate in both the last 2 of the 3 types of constants mentioned, but
> not
> sure if that's what's meant.
>
>  Section 3.2, 3rd para:
>        us --> use
>
>        also, I had to read that sentence a few times because I was
> thinking
> that "such information" referred to the lowercase letters and uppercase
> letters.
>
>  Section 4:
>        1st example:
>              the iris for imdb and dbpedia should match up with those in
> the
> section 2.3 rule that this example is combined with (and the prefixes
> might
> as well too).
>
>              missing space after the "char" prefix
>
>  Section 5:
>         In the second paragraph maybe add another sentence characterizing
> what a function is/does?  There's a specific example in the first
> paragraph,
> but it's a very brief introduction to functions.
>
> Section 5.2.2, Example:
>        does Film1 necessarily have to be different from Film2?
>
>        near the top, there's an extra space between dbpedia: and
> dateoffilm
>
> Section 6.1
>     2nd paragraph:
>          might as well say "C++ or Java" rather than "C++",  like it does
> in
> Section 6.2.
>
>    Example:
>         imdb and dbpedia prefixes and iris could be made consistent with
> earlier examples.
>         (same comment for the example in 7.1.1)
>
> Section 6.2
>         first example:  System.println --> System.out.println
>
>         second example: if it can be written with the less advanced syntax
>                    ex:e1 # Example
>                    ex:e1[...]
>                    ex:e1[...]
>              it may be easier to understand the RIF, and the parallel
> structure with the Java would be even more obvious.
>
> Section 7
>        there are some "add pointer"  notes/comments
>
> General:
>       some of the examples are extending outside the blue-colored box and
> require scrolling to the right.
>
> Appendix:
>      at the very end just before the last reference, there's a span
> element
> displayed.
>


-- 
Leora Morgenstern, Ph.D.

Received on Sunday, 26 September 2010 16:14:58 UTC