Re: ACTION-308 Review QRG

On 24 Mar 2009, at 18:21, Jie Bao wrote:

> Hi Bijan
>
> Thanks for the review. That's very helpful.
>
> I need to apologize to you and other reviewers of QRG for not being
> able to respond promptly, as I'm traveling for the whole week. Below
> is some of my initial response to your comment. I will try to
> incorporate them into the wiki once I get back to office on next
> Monday.

No worries!

> On Mon, Mar 23, 2009 at 5:25 AM, Bijan Parsia  
> <bparsia@cs.man.ac.uk> wrote:
>> My review is predicated on one condition: that the HTML layout  
>> ends up in 3
>> column, two page format. That was my understanding when we agreed  
>> to this
>> document, and that continues to be my understanding. If that is  
>> going to be
>> changed, we need a WG decision.
>>
> Yes, you have shown 3-column HTML is possible, and I'd like to try the
> formatting once the content is finalized.

I'm happy to help out.

> Whether it will be 2-page,
> that's only hope for now, as when I print it out from wiki, it's 10
> pages long. We have to use some layout tricks to reduce its length.

Indeed :)

[snip]
>> Second, it'd be nice if when I moused over "C" I got a tooltip  
>> saying "C is
>> a class expression".
>>
> Good idea, although I don't know how exactly for this moment. Some
> javascript may be in need. Actually Ivan has other suggestions that
> require javascript. I will try out.

You don't need javascript. I'll put together some css for you.

[snip]
>> For the highlighting of new stuff, I'd prefer if the whole line were
>> highlighted.
>>
> Ivan has suggested not using highlighting, but using other tricks like
> color or font. Would you be happy with that?

Yep.

[snip]
>> I think a little diagram or example would maybe work better for  
>> the global
>> restricitons. Otherwise, I'd just make a pointer to the full  
>> account..I'm
>> skeptical that people can follow it. Esp. as the conditions mix in  
>> property
>> and non property ones.
>>
> Diagram or example may be too much for  a guide. The ideal place would
> be in Syntax or in Primer. If you believe it is too dense for usual
> users, I'm happy to remove this section, simply say "some global
> restrictions apply, please refer to Syntax"

Yes. that would be, IMHO, better and free up some space.

[snip]

>> I think that the facets and the datatypes might be meaningfully  
>> combined. I
>> think it's more important to show what the facets *are* rather  
>> than the
>> syntax of the facets.
>>
> Maybe one or two mini example on facets?

Perhaps....I'm not sure. Can you give me an example of what you had  
in mind?

Have fun traveling.


Cheers,
Bijan.

Received on Tuesday, 24 March 2009 18:29:38 UTC