Skip to content

Commit 9a922a7

Browse files
SECtimFragLegs
andauthored
Minor editorial nits (#146)
* Fix reference to discovery section The rendered text said "is specified in the Discovery Section 6 section." Aligned with other such references in the spec, it now says "is specified in the Discovery section (Section 6)." * Fix some typos * Fix a typo * Incorporate FragLegs' grammar fix Co-authored-by: Shayne Miel (he/him) <miel.shayne@gmail.com> --------- Co-authored-by: Shayne Miel (he/him) <miel.shayne@gmail.com>
1 parent 3b18e00 commit 9a922a7

File tree

1 file changed

+7
-7
lines changed

1 file changed

+7
-7
lines changed

openid-sharedsignals-framework-1_0.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -437,7 +437,7 @@ of these members are required and specified as such in the respective event
437437
types specs. If a Transmitter determines that it needs to include additional
438438
members that are not specified in the event types spec, then the name of such
439439
members MUST be a URI. The discoverability of all additional members is
440-
specified in the Discovery {{discovery}} section.
440+
specified in the Discovery section ({{discovery}}).
441441

442442
# Example SETs that conform to the Shared Signals Framework {#events-examples}
443443

@@ -603,7 +603,7 @@ jwks_uri
603603
> OPTIONAL. URL of the Transmitter's JSON Web Key Set {{RFC7517}} document.
604604
This contains the signing key(s) the Receiver uses to validate signatures from
605605
the Transmitter. This value MUST be specified if the Transmitter intends to
606-
generate signed JWTs
606+
generate signed JWTs.
607607

608608
delivery_methods_supported
609609

@@ -647,13 +647,13 @@ TODO: consider adding a IANA Registry for metadata, similar to Section 7.1.1 of
647647
{{RFC8414}}. This would allow other specs to add to the metadata.
648648

649649
### Authorization scheme {#authorization-scheme}
650-
SSF is an HTTP based signals sharing framework and is agnostic to the authentication and authorization schemes used to secure stream configuration APIs. It does not provide any SSF-specific authentication and authorization schemes but relies on the cooperating parties' mutual security considerations. The authorization scheme section of the metadata provides discovery information related to the transmitter's stream management APIs.
650+
SSF is an HTTP based signals sharing framework and is agnostic to the authentication and authorization schemes used to secure stream configuration APIs. It does not provide any SSF-specific authentication and authorization schemes but relies on the cooperating parties' mutual security considerations. The authorization scheme section of the metadata provides discovery information related to the Transmitter's stream management APIs.
651651

652652
spec_urn
653653

654654
> REQUIRED. A URN that describes the specification of the protocol being used.
655655

656-
The receiver will call the transmitter APIs by providing appropriate credentials as per the `spec_urn`.
656+
The Receiver will call the Transmitter APIs by providing appropriate credentials as per the `spec_urn`.
657657

658658
The following is a non-normative example of the `spec_urn`
659659

@@ -665,7 +665,7 @@ The following is a non-normative example of the `spec_urn`
665665
{: #figspecurn title="Example: `spec_urn` specifying the OAuth protocol for authorization"}
666666

667667
In this case, the receiver may obtain an access token using the Client
668-
Credential Grant {{CLIENTCRED}}, or any other method suitable for the Receiver and the
668+
Credentials Grant {{CLIENTCRED}}, or any other method suitable for the Receiver and the
669669
Transmitter.
670670

671671
## Obtaining Transmitter Configuration Information
@@ -677,7 +677,7 @@ Transmitters supporting Discovery MUST make a JSON document available at the
677677
path formed by inserting the string "/.well-known/ssf-configuration" into the
678678
Issuer between the host component and the path component, if any. The syntax
679679
and semantics of ".well-known" are defined in {{RFC5785}}. "ssf-configuration"
680-
MUST point to a JSON document compliant with this specification and MUST be
680+
MUST point to a JSON document compliant with this specification, and that document MUST be
681681
returned using the "application/json" content type.
682682

683683
### Transmitter Configuration Request
@@ -986,7 +986,7 @@ Configuration ({{stream-config}}) object:
986986
If the request does not contain the `delivery` property, then the Transmitter
987987
MUST assume that the `method` is "urn:ietf:rfc:8936" (poll). The
988988
Transmitter MUST include a `delivery` property in the response with this
989-
`method` property and a `endpoint_url` property.
989+
`method` property and an `endpoint_url` property.
990990

991991
The following is a non-normative example request to create an Event Stream:
992992

0 commit comments

Comments
 (0)