Skip to content

Commit 3cadaef

Browse files
authored
Minor updates for Requirements
1 parent 89dee08 commit 3cadaef

1 file changed

Lines changed: 4 additions & 4 deletions

File tree

policy/README.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -61,7 +61,7 @@ Versioning must be implemented as specified in the [Versioning section][versioni
6161

6262
## Background
6363

64-
The goal of this specification is to enable Agencies to create, revise, and publish machine-readable policies, as sets of rules for individual and collective device behavior exhibited by both _mobility as a service_ Providers and riders / users. [Examples](./examples/README.md) of policies include:
64+
The goal of the Policy API specification is to enable agencies to create, revise, and publish machine-readable policies, as sets of rules for individual and collective device behavior exhibited by both _mobility as a service_ providers and riders / users. [Examples](./examples/README.md) of policies include:
6565

6666
- City-wide and localized caps (e.g. "Minimum 500 and maximum 3000 scooters within city boundaries")
6767
- Exclusion zones (e.g. "No scooters are permitted in this district on weekends")
@@ -70,7 +70,7 @@ The goal of this specification is to enable Agencies to create, revise, and publ
7070
- Idle-time and disabled-time limitations (e.g. "5 days idle while rentable, 12 hours idle while unrentable, per device")
7171
- Trip fees and subsidies (e.g. "A 25 cent fee applied when a trip ends downtown")
7272

73-
The machine-readable format allows Providers to obtain policies and compute compliance where it can be determined entirely by data obtained internally.
73+
The machine-readable format allows Providers to obtain policies and compute compliance where it can be determined entirely by data obtained internally, and know what data is required from them and provided to them.
7474

7575
**See the [Policy Examples](./examples/README.md) for ways these can be implemented.**
7676

@@ -114,7 +114,7 @@ See the [Responses section][responses] for information on valid MDS response cod
114114

115115
### Authorization
116116

117-
Authorization is not required. An agency may decide to make this endpoint unauthenticated and public. See [Optional Authentication](/general-information.md#optional-authentication) for details.
117+
Authorization is not required and agencies are encouraged to make these endpoints unauthenticated and public. See [Optional Authentication](/general-information.md#optional-authentication) for details.
118118

119119
### Policies
120120

@@ -139,7 +139,7 @@ Policies will be returned in order of effective date (see schema below), with pa
139139

140140
### Geographies
141141

142-
**Deprecated:** see the new [Geography API](/geography#transition-from-policy) to understand the transistion away from this endpoint, and how to support both in a MDS 1.x.0 release.
142+
**Deprecated:** see the new [Geography API](/geography#transition-from-policy) to understand the transistion away from this endpoint, and how to support both in MDS 1.x.0 releases.
143143

144144
**Endpoint**: `/geographies/{id}`
145145
**Method**: `GET`

0 commit comments

Comments
 (0)