I am the assigned Gen-ART reviewer for this draft. For background on Gen-ART, please see the FAQ at http://wiki.tools.ietf.org/area/gen/trac/wiki/GenArtfaq .
Please resolve these comments along with any other Last Call comments you may receive. Document: draft-ietf-spfbis-4408bis-14 Reviewer: Meral Shirazipour Review Date: 2013-04-29 IETF LC End Date: 2013-04-30 IESG Telechat date: NA Summary: This draft is almost ready to be published as Informational RFC but I do have some comments. Nits/editorial comments: -[Page 6] Section "1.1.2. Imported Definitions" Please consider expanding acronyms and giving the section of the RFC where each term is defined. (Also throughout the document it would greatly help the readability if acronyms are expanded when first used.) -[Page 8] Section 2.2. Line 1: ""MAIL FROM" -> extra \" -[Page 13], Section 3.3. , first line: "sections 3.3.14 and 3.3". If both subsection and subsubsection are to be mentioned, please consider: "sections 3.3 and 3.3.14" -[Page 16], Section 4.3, paragraph 1, last sentence: extra text/typo to be removed: "on 2.3 of [RFC5890]." -[Page 16], Section 4.4, paragraph 3,"[RFC2308] suggests on an" --remove "on"--> "[RFC2308] suggests an" -[Page 21], Section 5.1, line 1, "This section defines two types of mechanisms." --for clarity--> "This section defines two types of mechanisms: basic and designated sender." -[Page 21], second paragraph before last, " both "AAAA" and "A" secords "--typo--> "records" -[Page 22], Section 5.2, point 3, please review "include: mechanism" and "\"fail ". Suggestion: instead of "gives a pass" or "gives a fail" is it better to say "signifies" or "represents" as pass/fail? -[Page 22], second paragraph before last, "Only the evaluated result of the referenced SPF record is used, rather than acting as if the referenced SPF record was literally included in the first." The part after the comma in this sentence is hard to understand. Please review if possible. -[Page 24], Section 5.4, "the evaluation terminated"--missing is-->"the evaluation is terminated" "has no MX records"--no s-->"has no MX record" -[Page 26], first paragraph, "and more reliable alternatives used instead"---->"and more reliable alternatives should be used instead" "still in use and part of"---->"still in use as part of" -[Page 29], paragraph 3, "is generally be"---->"will generally be" -[Page 30], paragraph 1, "such as shown in Section 2.6.4",- is this pointing to the correct section? -[Page 30], last sentence "Note: During recursion into an "include" mechanism, an exp= modifier from the <target-name> MUST NOT be used. In contrast, when executing a "redirect" modifier, an exp= modifier from the original domain MUST NOT be used. " Is it possible to add 1-2 sentence to explain why?(what is the expected consequence if this is not respected) -[Page 32], line 3, "p = the validated domain name of <ip> (do not use)" Is it possible to add a reference to section 5.5 which explains why? Suggested: "(do not use, see Section 5.5)" -[Page 33], third paragraph before last "was provide more than once"---->"was provided more than once" -[Page 34], last "Note": "....for as long as the shortest Time To Live (TTL) of all the DNS records involved." Please review this sentence ending. It is not clear. Suggestion: "as long as the DNS record involved with the shortest TTL has not expired" ? -[Page 36], sentence 2, "Terse definitions"--typo-->"The definitions" -[Page 36], paragraph 2,"be explicity"--typo-->"be explicitly" -[Page 36], Section 8.1,"checked idenity"--typo-->"checked identity" -[Page 37], Section 8.4, "the 5.7.1 enhanced status code", with reference to RFC3463. For better clarity please consider adding reference to Section 3.8 of the RFC3463. -[Page 38], Section 8.6, For better clarity please consider referring to Section 3.5 of RFC3463 -[Page 38], Section 8.8, For better clarity please consider referring to Section 3.6 of RFC3463 -[Page 39], Section 9 Title, "Recording The Result"---->"the" -[Page 44], Line 2, "carefully weight"---->"carefully weigh" -[Page 44], Section 10.1.2, ""ip4" and "ip6" over "a" or "a" or "mx"." The last part should suggest "mx' over "a" or the reverse? -[Page 46], Section 10.3 "User actor.[RFC5598]."---->"User actor [RFC5598]." -[Page 47], before last sentence, missing closing parenthesis:"(defined in Section 4.6.4." -[Page 49], Section 11.5.3, "It is necesary"--typo-->"It is necessary" -[Page 62], line 2, "to implmentation"--typo-->"to implementation" -[Page 62], second bullet before last, "Section 10 and Appendices D - H below.", is this part of the sentence refering to anything, below? -[Page 65], Section E.3, "Receving ADMDs"--typo-->"Receiving ADMDs" -[Page 66], last line, "mitiate"--typo-->"mitigate" -[Page 68], one line before last, "reliabilility"--typo-->"reliability" -[Page 70], paragraphe 2, "techincal"--typo-->"technical" "deplyment"--typo-->"deployment" -[Page 72], line 7, "obslete"--typo-->"obsolete" -[Page 72], 2 line before last, "text and figures from Alessandro Vesely", is it only to section 9.1, or 10.1.1. as well? -[Page 73], "Added new section 9 discussion on treatment of bounces", is it section 9 or section 10.1.3? -[Page 73], 1 line before last, "potental"--typo-->"potential" -Appendix J., please review the 'section references' pointing to various changes. -Throughout the draft, DNS "look up"---->"lookup" -Throughout the draft, DNS RCODEs are mentioned without any reference to RFC1035 (or RFC6195) -Throughout the draft, many cross references break the follow. I suggested revisiting some of them and adding a small text after each reference which introduces that section. Example :[Page 17], Section 4.6.2 "the result is specified in Section 4.7", suggested-->"the result is specified in Section 4.7 where Default results are discussed" -"Section 2.6 Results of Evaluation" lists the possible outputs of check_host(). Then "Section 8. Result Handling" continues the description with handling guidance. To avoid breaking the flow, please consider moving the descriptive content of Section 2.6 into Section 8. (unless there is another reason to keep them far apart). Best Regards, Meral --- Meral Shirazipour Ericsson Research www.ericsson.com
_______________________________________________ Gen-art mailing list [email protected] https://www.ietf.org/mailman/listinfo/gen-art
