Re: [Uri-review] Request to review sieve URI scheme

Bjoern et al,

I am pleased that Alexey got a quick reply to his mailing, but it would be nice 
if someone could respond to the mail about the "oid:" URI/IRI scheme that was 
posted on 18 November.

Thanks

John L

Bjoern Hoehrmann wrote:

> * Alexey Melnikov wrote:
> 
>>I am finishing draft-ietf-sieve-managesieve-02.txt which defines the 
>>sieve: URI scheme. So I would like to ask people to review section 3 of 
>>the draft.
> 
> 
> You have a reference [IMAP4] but it's not part of the References in the
> document. I assume this should be [IMAP4rev1].
> 
> You should say upfront that `authority`, `unreserved`, etc. are defined
> in STD066 and included by reference. Right now you are using authority
> without defining it, and repeat the reference multiple times.
> 
> There is not much point in having the sub-delims-sh and uchar rules in
> the grammar, you could just use
> 
>   ochar = <pchar but not ";", "&", or "=">
> 
> or the equivalent (I assume)
> 
>   ochar = unreserved / pct-encoded / "!" / "$" / "'" / "(" / ")"
>                                    / "*" / "+" / ","
>                                    / ":" / "@"
> 
> That way readers would not have to read through the comments and expand
> the rules manually.
> 
> The difference between
> 
>   sieve://example/script  (owner absent)
>   sieve://example//script (owner empty)
> 
> should be explicitly called out somewhere. It would be better if this is
> done outside the grammar (the semantics of having an empty owner would
> also be better specified outside the grammar).
> 
> I don't think comments in the grammar are a good place to re-iterate en-
> coding requirements. It would be better if you just said once that chars
> other than those explicitly allowed above must be utf-8 encoded and %xx-
> escaped to be included.
> 
> When you point out facts, like that ' ' can only be included in URLs in
> its %xx encoded form, do not use RFC 2119 keywords.
> 
> In the "URI scheme semantics" it would be good to include some reference
> when it refers to "the REFERRAL response code".
> 
> As an aside, throughout the document in registration templates, it would
> be good to have a space between To: and Subject: headers, and the body.

-- 
    Prof John Larmouth
    Larmouth T&PDS Ltd
    (Training and Protocol Design Services Ltd)
    1 Blueberry Road
    Bowdon                               j.larmouth@btinternet.com
    Altrincham
    Cheshire
    WA14 3LS
    England
    Tel (Business): +44 161 408 3695        Fax: +44 161 928 8069
    Tel (Private): +44 161 928 1605
_______________________________________________
Uri-review mailing list
Uri-review@ietf.org
https://www.ietf.org/mailman/listinfo/uri-review