From 30d03ed29bd93364fe173f1108a89f3ed92fd3bf Mon Sep 17 00:00:00 2001 From: wes-smith Date: Tue, 27 Feb 2024 12:49:45 -0500 Subject: [PATCH 1/5] Add general discussion of `options`. --- index.html | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/index.html b/index.html index 6bbddaa..84db9c7 100644 --- a/index.html +++ b/index.html @@ -645,6 +645,16 @@

OAuth 2.0

+
+

Options

+

+Some of the endpoints defined in the following sections accept an `options` object. +None of the properties in `options` are required for any endpoint, as these properties +are intended to meet per-configuration needs that may vary. However, configuration may +prohibit some options from being used in order to preclude clients from passing certain +data to a given configuration. +

+

Issuing

From 96c3804da363373e1eb60d9547e2ae1e0b8726ec Mon Sep 17 00:00:00 2001 From: Manu Sporny Date: Tue, 27 Feb 2024 15:28:18 -0500 Subject: [PATCH 2/5] Fix normative statements and grammar in options section. Co-authored-by: Ted Thibodeau Jr Co-authored-by: Dave Longley --- index.html | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/index.html b/index.html index 84db9c7..dd99b7f 100644 --- a/index.html +++ b/index.html @@ -650,9 +650,10 @@

Options

Some of the endpoints defined in the following sections accept an `options` object. None of the properties in `options` are required for any endpoint, as these properties -are intended to meet per-configuration needs that may vary. However, configuration may +are intended to meet per-configuration needs that might vary. However, instance configurations MAY prohibit some options from being used in order to preclude clients from passing certain -data to a given configuration. +data to a given instance. Some configurations MAY also require some options to +be passed.

From a07442843bb84090d776e715cc66d87c9ea5a871 Mon Sep 17 00:00:00 2001 From: Manu Sporny Date: Tue, 27 Feb 2024 15:31:10 -0500 Subject: [PATCH 3/5] Fix normative statement around options being OPTIONAL. --- index.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/index.html b/index.html index dd99b7f..1da5a33 100644 --- a/index.html +++ b/index.html @@ -649,7 +649,7 @@

OAuth 2.0

Options

Some of the endpoints defined in the following sections accept an `options` object. -None of the properties in `options` are required for any endpoint, as these properties +The `options` properties are OPTIONAL for every endpoint, as these properties are intended to meet per-configuration needs that might vary. However, instance configurations MAY prohibit some options from being used in order to preclude clients from passing certain data to a given instance. Some configurations MAY also require some options to From bfe6c7e8a0d0c8ab161f4c8d2c818e83ef033fc7 Mon Sep 17 00:00:00 2001 From: wes-smith Date: Wed, 28 Feb 2024 13:38:24 -0500 Subject: [PATCH 4/5] Clarify wording. Co-authored-by: Ted Thibodeau Jr --- index.html | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/index.html b/index.html index 1da5a33..18a2f8c 100644 --- a/index.html +++ b/index.html @@ -649,11 +649,12 @@

OAuth 2.0

Options

Some of the endpoints defined in the following sections accept an `options` object. -The `options` properties are OPTIONAL for every endpoint, as these properties -are intended to meet per-configuration needs that might vary. However, instance configurations MAY -prohibit some options from being used in order to preclude clients from passing certain -data to a given instance. Some configurations MAY also require some options to -be passed. +All properties of the `options` object are OPTIONAL when configuring each endpoint, +as these properties are intended to meet per-deployment needs that might vary. +Thus, any given endpoint configuration MAY prohibit client use of some `options` +properties in order to prevent clients from passing certain data to that endpoint. +Likewise, an endpoint configuration MAY require that clients include some `options` +properties.

From d72096273d0d266412b52373188cf4b808fa13c4 Mon Sep 17 00:00:00 2001 From: Manu Sporny Date: Tue, 5 Mar 2024 15:10:38 -0500 Subject: [PATCH 5/5] Change "endpoint" to "instance" in `options` discussion. --- index.html | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/index.html b/index.html index 18a2f8c..50ccfb6 100644 --- a/index.html +++ b/index.html @@ -649,11 +649,11 @@

OAuth 2.0

Options

Some of the endpoints defined in the following sections accept an `options` object. -All properties of the `options` object are OPTIONAL when configuring each endpoint, +All properties of the `options` object are OPTIONAL when configuring each instance, as these properties are intended to meet per-deployment needs that might vary. -Thus, any given endpoint configuration MAY prohibit client use of some `options` -properties in order to prevent clients from passing certain data to that endpoint. -Likewise, an endpoint configuration MAY require that clients include some `options` +Thus, any given instance configuration MAY prohibit client use of some `options` +properties in order to prevent clients from passing certain data to that instance. +Likewise, an instance configuration MAY require that clients include some `options` properties.