Editorial suggestions for draft-ietf-trans-rfc6962-bis. Section 4.1 defines "base URL", but section 5 uses "<log server>". One term should be used.
Section 5 has lines such as: https://<log server>/ct/v2/submit-entry That makes it look like <log server> is a domain name. Its not quite obvious enough that it can include a path as well. The "https://"; portion is part of "base URL"/"<log server>". Suggestion: In section 4.1: Base URL: The prefix used to construct URLs for requests. The base URL MUST be an "https" URL. It MAY contain a port. It MAY contain a path with any number of segments. It MUST NOT contain a query string, nor a fragment. A base URL with or without a trailing "/" MUST be treated as equivalent. That is, constructing a URL for a request always involved appending a path component that starts with a "/" so any trailing "/" in the base URL MUST be dropped. Example: "https://ct.example.org/blue";. In section 5: Replace "log server" with "base URL" in a few places. Drop the sentence saying "MAY include a path as well as a server name" as it should be in section 4.1 with the definition of base URL (as above). In sections 5.1, 5.2, 5.3, 5.4, 5.5, 5.6, 5.7: Replace "https://<log server>/ct/v2/" with "<base URL>/ct/v2/" -- James Manger _______________________________________________ Trans mailing list [email protected] https://www.ietf.org/mailman/listinfo/trans
