diff --git a/README.md b/README.md index 9f083c5..f374cb8 100644 --- a/README.md +++ b/README.md @@ -142,7 +142,9 @@ accomplish this as follows: ``` 1. The `Sec-CH-UA-Bitness` header field represents the underlying architecture's bitness - (i.e., the size in bits of an integer or memory address). + (i.e., the size in bits of an integer or memory address). This could be used to determine + which binary to serve for downloads. + For example: ```http diff --git a/index.bs b/index.bs index cc5a883..7efdddb 100644 --- a/index.bs +++ b/index.bs @@ -184,24 +184,24 @@ given [=user agent=], which servers can opt-into receiving via the Client Hints defined in [[!RFC8942]]. The definitions below assume that each [=user agent=] has defined a number of properties for itself: -* brand - The [=user agent=]'s commercial name (for example: +* brand - The [=user agent=]'s commercial name (e.g., "cURL", "Edge", "The World's Best Web Browser") * significant version - The [=user agent=]'s marketing version, - which includes distinguishable web-exposed features (for example: "72", "3", or "12.1") -* full version - The [=user agent=]'s build version (for - example: "72.0.3245.12", "3.14159", or "297.70E04154A") + which includes distinguishable web-exposed features (e.g., "72", "3", or "12.1") +* full version - The [=user agent=]'s build version (e.g., + "72.0.3245.12", "3.14159", or "297.70E04154A") * platform brand - The [=user agent=]'s operating system's - commercial name. (for example: "Windows", "iOS", or "AmazingOS") + commercial name. (e.g., "Windows", "iOS", or "AmazingOS") * platform version - The [=user agent=]'s operating system's - version. (for example: "NT 6.0", "15", or "17G") + version. (e.g., "NT 6.0", "15", or "17G") * platform architecture - The [=user agent=]'s underlying CPU - architecture (for example: "ARM", or "x86") + architecture (e.g., "ARM", or "x86") * platform bitness - The [=user agent=]'s underlying CPU - architecture bitness (for example: "32", or "64") -* model - The [=user agent=]'s device model (for example: "", - or "Pixel 2 XL") + architecture bitness (e.g., "32" or "64") +* model - The [=user agent=]'s device model (e.g., "", or + "Pixel 2 XL") * mobileness - A boolean indicating if the [=user agent=]'s - device is a mobile device. (for example: ?0 or ?1) + device is a mobile device. (e.g., ?0 or ?1) [=User agents=] SHOULD keep these strings short and to the point, but servers MUST accept arbitrary @@ -219,7 +219,7 @@ mapped to the empty string. or [=platform bitness=] unless the user's platform is one where both the following conditions apply: * Binary download of executables is likely. * Different CPU architectures are likely to require different binary executable resources, and - different binary exeutable resources are likely to be available. + different binary executable resources are likely to be available. [=User Agents=] MUST return the empty string for [=model=] if [=mobileness=] is false. [=User Agents=] MUST return the empty string for [=model=] even if [=mobileness=] is true, except on