diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 521286f3c88..7e97eedb52f 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -97,12 +97,16 @@ print(d['small']) In above example, `l1` contains identifiers (keys of dict `d`) while others are English words/phrases. In the dict declaration, keys are single-quoted but values are double-quoted. -Otherwise, choose whichever limit the number of escaped characters. - -Note: URIs (and paths used in URIs) should be, in general, enclosed in double quotes, +URIs (and paths used in URIs) should be, in general, enclosed in double quotes, mainly because single quotes can appear in URI, unencoded, as sub-delimiters as specified by [RFC3986](https://www.rfc-editor.org/rfc/rfc3986#section-2.2). +HTML/XML code often contains attributes that are enclosed by double quotes, so in this case, +better use single quotes, e.g. `html = 'text'`. + +In doubt, choose whichever limit the number of escaped characters. +Typically single quote strings that are meant to contain double quotes (e.g. `'The file is "{file}"'`). + ## Git Work-flow