From e7c5faf436429f13dd73838e779536d2d7f761d5 Mon Sep 17 00:00:00 2001
From: Jane Huang <jane.x.huang@gmail.com>
Date: Wed, 1 Apr 2020 20:34:41 -0400
Subject: [PATCH 1/6] Moving proposed policy author changes over from EA fork
 to here.

---
 policy-author/README.md | 131 ++++++++++++++++++++++++++++++++++++++++
 policy/.README.md.swp   | Bin 0 -> 32768 bytes
 policy/README.md        |  19 ++++++
 3 files changed, 150 insertions(+)
 create mode 100644 policy-author/README.md
 create mode 100644 policy/.README.md.swp

diff --git a/policy-author/README.md b/policy-author/README.md
new file mode 100644
index 00000000..6f0a1d16
--- /dev/null
+++ b/policy-author/README.md
@@ -0,0 +1,131 @@
+# Policy-Author API (draft)
+
+## Background
+
+The Policy API specifies a pair of endpoints and a JSON schema for communicating mobility policy and geography to providers. This document describes a companion API to the provider-facing Policy endpoints for creating and editing Policy and Geography objects.
+
+[Policy PR](https://github.com/CityOfLosAngeles/mobility-data-specification/pull/322)
+
+## Endpoints
+
+The agency-facing Policy Author API consists of the following endpoints. The endpoints to list Policy and Geography objects are defined in the Policy API. The only addition is that when calling the GET /policies endpoint, append ?unpublished to get the unpublished ones, separate from the published ones. Adding ?unpublished will have no effect if your access token has a provider_id.
+
+### Policy Endpoints
+
+#### Schema
+
+See Policy API.
+
+Metadata is free-form JSON format.
+
+### POST /policies
+
+Create a new unpublished (mutable) Policy
+
+Payload: a new Policy object, without a `policy_id`
+
+Returns: the Policy object on success, including a `policy_id`; a failure explanation on failure
+
+Response codes:
+
+- 201 - created
+- 400 - Policy does not conform to schema
+- 401 - unauthorized (if any auth issue)
+- 500 - server error (hopefully doesn’t happen)
+
+### PUT /policies/{id}
+
+Update an existing Policy. Must be unpublished.
+
+Payload: a new Policy object
+
+Returns: the Policy object on success, a failure explanation on failure
+
+Response codes:
+
+- 200 - success
+- 400 - Policy does not conform to schema
+- 401 - unauthorized
+- 404 - not found
+- 409 - conflict (if immutable)
+- 500 - server error
+
+### POST /policies/{id}/publish
+
+Publish (make immutable) a Policy. Must be unpublished.
+
+Response codes:
+
+- 200 - success
+- 401 - unauthorized
+- 404 - not found
+- 409 - conflict (if already published)
+- 500 - server error
+
+### GET /policies/meta
+
+Get a list of policy metadata. Search parameters TBD.
+
+### GET /policies/{id}/meta
+
+Get metadata for a specific policy.
+
+### PUT /policies/{id}/meta
+
+Create/Update
+
+### Geography Endpoints
+
+#### Schema
+
+Geographies are GeoJSON.
+
+Metadata is free-form JSON format.
+
+### GET /geographies/meta
+
+Get a list of geography metadata. Search parameters TBD.
+
+### GET /geographies/{id}/meta
+
+Get metadata for a specific geography.
+
+### PUT /geographies/{id}/meta
+
+Create/Update
+
+### POST /geographies
+
+Create a new unpublished (mutable) Geography
+
+Payload: a new Geography object
+
+Returns: the Geography object on success, a failure explanation on failure
+
+Response codes:
+
+- 201 - created
+- 400 - Geography is not conformant GeoJSON
+- 401 - unauthorized (if any auth issue)
+- 409 - conflict (if exists)
+- 500 - server error (hopefully doesn’t happen)
+
+### PUT /geographies/{id}
+
+Update an existing Geography. Must be mutable.
+
+Payload: an updated Geography object
+
+Returns: the Geography object on success, a failure explanation on failure
+
+Response codes:
+
+- 200 - success
+- 400 - Geography does not conform to schema
+- 401 - unauthorized
+- 404 - not found
+- 409 - conflict (if unwritable)
+- 500 - server error
+
+Note that there is no equivalent /publish endpoint for Geography objects. Implementations should treat Geography objects as writable until they are referenced in a published Policy, and unwritable after. Any implementation of a Policy editor UI should keep track of the writability of any referenced Geography object and potentially alert the user.
+
diff --git a/policy/.README.md.swp b/policy/.README.md.swp
new file mode 100644
index 0000000000000000000000000000000000000000..f56652e27bbfd06488663d79e65718793c4ebf7b
GIT binary patch
literal 32768
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
EZ+AB{B>(^b

literal 0
HcmV?d00001

diff --git a/policy/README.md b/policy/README.md
index f95dc17f..573d492d 100644
--- a/policy/README.md
+++ b/policy/README.md
@@ -167,6 +167,25 @@ The optional `end_date` field applies to all policies represented in the file.
 [Top](#table-of-contents)
 
 ## Schema
+<a name="geography-fields"></a>
+
+### Geography Fields
+
+| Name                     | Type                       | R/O | Description                                                                     |
+| ------------------------ | -------------------------- | --- | ------------------------------------------------------------------------------- |
+| `name`                   | String                     | R   | Name of Geography                                                               |
+| `geography_id`           | UUID                       | R   | UUID of Geography                                                               |
+| `geography_json`         | GeoJSON<FeatureCollection> | R   | GeoJSON FeatureCollection representation of geography                           |
+| `description`            | String                     | O   | Description of Geography                                                        |
+| `publish_date`           | timestamp                  | O   | Date Geography was made immutable (if applicable)                               |
+| `effective_date`         | timestamp                  | O   | Date of Geography's first use in an active policy (if applicable)               |
+| `previous_geography_ids` | UUID[]                     | O   | Logically connected previous geographies. e.g. Venice Beach bounds are updated  |
+
+
+<a name="policy-fields"></a>
+ 
+### Policy Fields
+
 
 All response fields must use `lower_case_with_underscores`.
 

From cb6c96f56d730b12f510b9b464d301fe268d2e63 Mon Sep 17 00:00:00 2001
From: Jane Huang <jane.x.huang@gmail.com>
Date: Wed, 1 Apr 2020 22:41:15 -0400
Subject: [PATCH 2/6] Minor updates to Policy and Policy Author.

---
 policy-author/.README.md.swp | Bin 0 -> 16384 bytes
 policy-author/README.md      |  91 ++++++++++++-----------------------
 policy/.README.md.swp        | Bin 32768 -> 36864 bytes
 policy/README.md             |  36 +++++---------
 4 files changed, 43 insertions(+), 84 deletions(-)
 create mode 100644 policy-author/.README.md.swp

diff --git a/policy-author/.README.md.swp b/policy-author/.README.md.swp
new file mode 100644
index 0000000000000000000000000000000000000000..1d1f8cdedc51a4ddd4df868d034373cfd2230337
GIT binary patch
literal 16384
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

literal 0
HcmV?d00001

diff --git a/policy-author/README.md b/policy-author/README.md
index 6f0a1d16..71d56f0c 100644
--- a/policy-author/README.md
+++ b/policy-author/README.md
@@ -2,7 +2,7 @@
 
 ## Background
 
-The Policy API specifies a pair of endpoints and a JSON schema for communicating mobility policy and geography to providers. This document describes a companion API to the provider-facing Policy endpoints for creating and editing Policy and Geography objects.
+The Policy API specifies an endpoint and a JSON schema for communicating mobility policy to providers. This document describes a companion API to the provider-facing Policy endpoints for creating and editing Policy and Geography objects.
 
 [Policy PR](https://github.com/CityOfLosAngeles/mobility-data-specification/pull/322)
 
@@ -24,14 +24,14 @@ Create a new unpublished (mutable) Policy
 
 Payload: a new Policy object, without a `policy_id`
 
-Returns: the Policy object on success, including a `policy_id`; a failure explanation on failure
+; a failure explanation on failure
 
 Response codes:
 
-- 201 - created
+- 201 - Created. Returns: the Policy object on success, including a `policy_id` and a `version` indicating the current API version.
 - 400 - Policy does not conform to schema
-- 401 - unauthorized (if any auth issue)
-- 500 - server error (hopefully doesn’t happen)
+- 401 - Unauthorized (if any auth issue)
+- 500 - Server error (hopefully doesn’t happen)
 
 ### PUT /policies/{id}
 
@@ -39,11 +39,9 @@ Update an existing Policy. Must be unpublished.
 
 Payload: a new Policy object
 
-Returns: the Policy object on success, a failure explanation on failure
-
 Response codes:
 
-- 200 - success
+- 200 - success, returns Policy object
 - 400 - Policy does not conform to schema
 - 401 - unauthorized
 - 404 - not found
@@ -64,68 +62,41 @@ Response codes:
 
 ### GET /policies/meta
 
-Get a list of policy metadata. Search parameters TBD.
-
-### GET /policies/{id}/meta
-
-Get metadata for a specific policy.
-
-### PUT /policies/{id}/meta
-
-Create/Update
-
-### Geography Endpoints
-
-#### Schema
-
-Geographies are GeoJSON.
-
-Metadata is free-form JSON format.
-
-### GET /geographies/meta
-
-Get a list of geography metadata. Search parameters TBD.
-
-### GET /geographies/{id}/meta
-
-Get metadata for a specific geography.
-
-### PUT /geographies/{id}/meta
-
-Create/Update
-
-### POST /geographies
-
-Create a new unpublished (mutable) Geography
-
-Payload: a new Geography object
-
-Returns: the Geography object on success, a failure explanation on failure
+Get a list of policy metadata. 
 
+Parameters:
+| Name         | Type      | R/O | Description                                    |
+| ------------ | --------- | --- | ---------------------------------------------- |
+| `get_published` | string | O   | If set to the string 'true', returns metadata of published policies. |
+| `get_unpublished`   | string | O   | If set to the string 'true', returns metadata of unpublished policies.      |
+ 
 Response codes:
+- 200 - success
+- 400 - cannot return results because both params were set to true
+- 401 - unauthorized
+- 404 - not found
+- 500 - server error
 
-- 201 - created
-- 400 - Geography is not conformant GeoJSON
-- 401 - unauthorized (if any auth issue)
-- 409 - conflict (if exists)
-- 500 - server error (hopefully doesn’t happen)
-
-### PUT /geographies/{id}
-
-Update an existing Geography. Must be mutable.
 
-Payload: an updated Geography object
+### GET /policies/{id}/meta
 
-Returns: the Geography object on success, a failure explanation on failure
+Get metadata for a specific policy.
 
 Response codes:
-
 - 200 - success
-- 400 - Geography does not conform to schema
 - 401 - unauthorized
 - 404 - not found
-- 409 - conflict (if unwritable)
 - 500 - server error
 
-Note that there is no equivalent /publish endpoint for Geography objects. Implementations should treat Geography objects as writable until they are referenced in a published Policy, and unwritable after. Any implementation of a Policy editor UI should keep track of the writability of any referenced Geography object and potentially alert the user.
+
+### PUT /policies/{id}/meta
+Edit metadata for a specific policy. Takes a PolicyMetadata object in the request body.
+
+Response codes:
+ - 200 - success
+ - 401 - unauthorized
+ - 404 - not found
+ - 500 - server error 
+
+
 
diff --git a/policy/.README.md.swp b/policy/.README.md.swp
index f56652e27bbfd06488663d79e65718793c4ebf7b..5acdd28673f98345a0391f2b5ad09c9b9216c9c5 100644
GIT binary patch
delta 2331
zcmZ|Qdu$X%9Ki7@^g(HBiy|*YrqqO@ZMi~0sEGz?G{rz$+8PWgbZ>9&ZsBhC+}$f2
zCAlU_f{BH|DTEjvYGR0qkXi(ci4q_9j}&~xKQxL4OcWE0i7{eOzq5BGfO_etyF0t{
z`ps`=hlVB$9iAY=p(ol`$)!yT1-}|0Iy$$nU;F7rk&{AfG;Fnd<ld3CcdDz)M3x68
z=%@J2&P}PAK7UgFLM$m9XBCb`g=0zKxHi{ZGpDFzw5w)U^&VMV)lw?N2hjb|l6*K@
zStUdTUab_O2UjbEcnu*ez`n^s>_u-m_i={W9~N3^<~oFv4Ce%1DHGylT;Tq<IEfQ@
z77wBoml)bbe1h{OOl_Ex=kOFdFdM%V3vmSrY{D9JVdq34h7m_6O7JC-c@xKR2nVqj
z&tnMvXvI>rU=e;NPH!Vyw0op^bf~tugb+WboS18*;+AP7WW?|d`Cnz5twchGmGpea
zRS{`;(n==Nz7b9+Nee5xJ61PHS4EYpY?BAV8QI(0-qs|$m6Coucqr&5BMm#Es{~is
zj9i}f<Blu6lrlXT<;=4ApEP{Su_b>uSN6=fN*WD8BXMW5Tppu8OL@|8l~h}3#HV-P
zk*2E*Uj@%44a@d%z1QG*M&YTfI}i*nsjGCl&VUtBuGb{nZE478+E3G}s|GAD7)&(Z
zU8X^9Rx*f4M5SD1>W=g<)fUV1EjuRr7kJ7YuuQdqVHsY(RCXlgFp8#IZe_V=rd@*O
zCo;^Ie{tfIU_ync%2nxvZ*@9}OpIXY*o~h%;f>7J%g2I3%go4#W2Tcd=E<ZLi~Ew%
zu_RQX?|gI<4#Q<Op7hdYJgZkS;yS6ut&Xjjc%hx7k<qK2_6Vk46GILduBCj&7-cdP
znM(H~4Krx0L3)m~{CPSpQjY5z+|u=QRDvbS=m4jPEfET4u}P_vv>v~nL}AB|kN19K
zhA<~`vWdjkGt?^=1m4f2bixuZhMBPJO)8Q*UtgacPb{h_&vdO+ey;VZDb^%o%8Baq
z^dv(|FcMCpq_nG)Pcp=U$jz6@v>s!E8PWE5^5k>+hWS`_L`5yz@>L>Jh?}LddU)h>
zn)b*=D{7g#*Zd1czxA<%6Xrcj6(%!3$XmnnShXN+jZ}&`5vw4dY~LaQ3%R5pH5iX=
z#BLo-6Yp#fp-ztOxbMh>(YD6ZbE`Zy3B8%<J#TGpN~f9qnLX<=zQP$C#~~cV0qn#u
zR-zpbU@mI$KKtBz=t3t>v){d2*!N!IxF7qF#Rfct5N4qgmrL36zGfpF!|OPN7qAP%
z(3|BBEW=XFz;slj3cs;Geu0m06o)a01lD62?nf=|!c5$WskllQ{wSW8k4Kug^r8nV
zFv7+-2lt>HlXCmJoQd1E$=r9fcLc}fOJ?NetSQZftmz#4ayMVEd!(*Tb_d&%5bJuJ
zR9}7Fze|FhveAh)nvU(OTkq#qbg!QIf3@nk8$l1+%6LluMptwnEAA7Ga&agm8-o<#
zJy)*lxD>X8S}3#~{Sv0_NKn#DN!m7o-PYQwbm78$-L%Oo;qkdqUW$!DNz>uwX&wFZ
z$?|EB9;g=LEOZ(X%Ha1m*Wcp;#-Q(ij8+`EO^9iDhL7v7d|3N2Rxw&syuBiKZg6*Q
zY;eziIy=~sH6knlYkdv6zwyt!?(Y&V;&Xh4WAt$pi_wBw`jc2se|=bt7L?&FKIo@l
zB8(2KMg=D03LpBjlZ7K*<iti2Kaur6;yliw5*7G?>>tC^=*1!|#BAJ+skj|~k@er;
X6i(m`j3A9=xK>I~s!RC{Pb~ijGPYkj

delta 1627
zcmZY9e@q)y00;2b(sp#Cw2WooF!(4=oY_iYI`;$1CJlxu3`)VMDfHUD(u3>WdDmia
zurhVYqC--i+p;X180R0xKMXcHVvL#pY9ekX#y>O>r^|Fv!JkX~$M2OEH+Jc#ch~ps
z{rJ9jot!mKPMT@N+uzYicYB%%4i_QzoyP{k*&hg}gbWKZ%g)_9=l|I0w2=%dn2lOE
zI(dbw%5Gh`Arao=y2s?mJ?olwW-rkhYH@f`G-<*YnnY#Vnz>m<$UiUx`{CLKLQcWm
zPy;WnC*%c4zz{qM{m^VDqzUFr3AqRt))De1EZPY94(8z^ybLX{53XTkKf)Eb46j--
z`YBv!&<(Y)Y$0R`k|04Z1Yo)Z4}b_gV1utQ@ekmAn1$EjG@OK^AizG@0}sK2a1+!2
z2#gpqrtDmEE>qWJ&3R5-DdFB`OYZCgZ<{Nl8WU1%JJr~zsN*civ0U4ZPuvbavb$ag
zFv2UkqnR5B;b-_1J_HFyAPBwi8^SpYzayMw_}&N!&ciu)1x6taRj?V}LRc4I6I8<A
z$mK8i1#ZBXkb@Z`z?X0#Ll|1Y3vMvM9|-OzxC)E#Eqnu0Z~}~gM<5CUbig*K0W<uG
zkQd+*ya!W|fix(PENNI-kpynKpcC4l9^Bx7GI*Y!=~1{>tm0qP+4!%4J|5mx&d+3=
z-08OSuR@g;8fZMkr*}2*CEs>FJ7C*MA7jdpCa8%q+AcCFreh-sR2Gu#5%*BBXh%F>
z<o2~R3O>TSgF(JO=*so>J#OKxA%AJHB0nD5yRmpPMwQ4gi>7oBZ}M&7@5)yGS)hzx
z4?N7NvXOTV9Nkl_Dl&a9eI`UF!p0_`f~E<0I&O^ZVDF(W8g9o%Noy=zY?9Xv)^5G!
z>BhriY$8l4BEhjbC$yXU_bL14_9J-5J_qBCbl_whvJ<ORPRK!+$B*~HYj`)!U;+YH
z@ysGD<e$%(EXOwRg~QpW3&Eg$4`rSq5AA2N7-jTPCPWi7qNL@Rj%hHOR%6)WF-phD
zI1RIS9D#_VY|!`><1HNHG$kgPo)VHOSC4Et;74g;{wr(Kpwqah=_#7l85NNbKKX{I
zsz_pVjNUKCsi3O379tYc#+OGn)vM`<B<hJZePJlK_tuo}4N(`i!E=I6lR^yrB$Mfs
z(cB%a*ZJ!CajAm8k=V+YCQ7UQOpj`!ni3WHwqf%{-|iX7nklZ-*x<0P$hXeBu)-~c
z1#VL$$w)|%eHdl{@r<u-f;+0<e?!%n&g7I(?0L1LVzT)&_xQ>&jM~-GK{59KAdEix
m`a1mla;Unx(5G>~W+urXe<HD-zmurBt2nYQyd`UE9rzCp|DfUk

diff --git a/policy/README.md b/policy/README.md
index 573d492d..b7ff85a3 100644
--- a/policy/README.md
+++ b/policy/README.md
@@ -12,7 +12,7 @@ This specification describes the digital relationship between _mobility as a ser
 
 ## Background
 
-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 of policies include:
+The goal of this specification is to enable Agencies to 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 of policies include:
 
 - City-wide and localized caps (e.g. "Minimum 500 and maximum 3000 scooters within city boundaries")
 - Exclusion zones (e.g. "No scooters are permitted in this district on weekends")
@@ -22,6 +22,12 @@ The goal of this specification is to enable Agencies to create, revise, and publ
 
 The machine-readable format allows Providers to obtain policies and compute compliance where it can be determined entirely by data obtained internally.
 
+Policies will typically be linked to one or more associated geographies. Geography descriptions (e.g. geofences or lists of street segments) must also be maintained by the Agency indefinitely. Policies without specific geographies (global policies) are assumed to apply to the entire service area managed by the Agency. 
+
+Geographical data will be stored as immutable GeoJSON, referenced by UUID. See the Geography and Geography Author specs for information on the Geography schema, and how Agencies are expected to create and maintain Geographies and serve them to Providers. In a future revision of Agency, we will deprecate the existing `/service_areas` endpoint. `/service_areas` currently only handles GeoJSON MultiPolygon and Polygon objects, and Policy documents might prefer Points for locations such as drop-zones. Policy may be used for a variety of enforcement actions, so it's important for the Agency to persist and keep immutable both Policy and Geography data.
+
+
+
 [Top](#table-of-contents)
 
 ## Distribution
@@ -98,17 +104,13 @@ Policies will be returned in order of effective date (see schema below), with pa
 
 `provider_id` is an implicit parameter and will be encoded in the authentication mechanism, or a complete list of policies should be produced. If the Agency decides that Provider-specific policy documents should not be shared with other Providers (e.g. punitive policy in response to violations), an Agency should filter policy objects before serving them via this endpoint.
 
-#### Geographies
-
-Endpoint: `/geographies/{id}`  
-Method: `GET`  
-`data` Payload: `{ geographies: [] }`, an array of GeoJSON `Feature` objects.
+Response codes:
 
-##### Query Parameters
+- 200 - success
+- 401 - unauthorized
+- 404 - not found
+- 500 - server error
 
-| Name         | Type      | Required / Optional | Description                                    |
-| ------------ | --------- | --- | ---------------------------------------------- |
-| `id`         | UUID      | Optional    | If provided, returns one geography object with the matching UUID; default is to return all geography objects.               |
 
 ### Flat Files
 
@@ -167,20 +169,6 @@ The optional `end_date` field applies to all policies represented in the file.
 [Top](#table-of-contents)
 
 ## Schema
-<a name="geography-fields"></a>
-
-### Geography Fields
-
-| Name                     | Type                       | R/O | Description                                                                     |
-| ------------------------ | -------------------------- | --- | ------------------------------------------------------------------------------- |
-| `name`                   | String                     | R   | Name of Geography                                                               |
-| `geography_id`           | UUID                       | R   | UUID of Geography                                                               |
-| `geography_json`         | GeoJSON<FeatureCollection> | R   | GeoJSON FeatureCollection representation of geography                           |
-| `description`            | String                     | O   | Description of Geography                                                        |
-| `publish_date`           | timestamp                  | O   | Date Geography was made immutable (if applicable)                               |
-| `effective_date`         | timestamp                  | O   | Date of Geography's first use in an active policy (if applicable)               |
-| `previous_geography_ids` | UUID[]                     | O   | Logically connected previous geographies. e.g. Venice Beach bounds are updated  |
-
 
 <a name="policy-fields"></a>
  

From 63cfca18fb03e520cc692ddb010694ecf0097fd3 Mon Sep 17 00:00:00 2001
From: Jane Huang <jane.x.huang@gmail.com>
Date: Wed, 1 Apr 2020 23:16:12 -0400
Subject: [PATCH 3/6] Adding a missing endpoint to Policy Author spec.

---
 .gitignore                   |   3 ++-
 policy-author/.README.md.swp | Bin 16384 -> 0 bytes
 policy-author/README.md      |  21 +++++++++++++++++++++
 policy/.README.md.swp        | Bin 36864 -> 0 bytes
 policy/README.md             |  15 +++------------
 5 files changed, 26 insertions(+), 13 deletions(-)
 delete mode 100644 policy-author/.README.md.swp
 delete mode 100644 policy/.README.md.swp

diff --git a/.gitignore b/.gitignore
index 0cafc1cd..49800733 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1 +1,2 @@
-.venv/
\ No newline at end of file
+.venv/
+*.swp
diff --git a/policy-author/.README.md.swp b/policy-author/.README.md.swp
deleted file mode 100644
index 1d1f8cdedc51a4ddd4df868d034373cfd2230337..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 16384
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

diff --git a/policy-author/README.md b/policy-author/README.md
index 71d56f0c..ca2f195b 100644
--- a/policy-author/README.md
+++ b/policy-author/README.md
@@ -18,6 +18,27 @@ See Policy API.
 
 Metadata is free-form JSON format.
 
+### GET /policies
+
+Get a list of policies.
+
+A note: the `get_published` and `get_unpublished` parameters only make sense in the Policy Author version of this endpoint, because the Policy Author API is intended for use by Agencies and not Providers. Providers should never be able to see unpublished Policies, as those are not yet meant for public consumption.
+
+Parameters:
+| Name         | Type      | R/O | Description                                    |
+| ------------ | --------- | --- | ---------------------------------------------- |
+| `id`         | UUID      | Optional    | If provided, returns one policy object with the matching UUID; default is to return all policy objects.                       |
+| `get_published` | string | O   | If set to the string 'true', returns metadata of published policies. |
+| `get_unpublished`   | string | O   | If set to the string 'true', returns metadata of unpublished policies.      |
+
+Response codes:
+- 200 - success
+- 400 - cannot return results because both params were set to true
+- 401 - unauthorized
+- 404 - not found
+- 500 - server error
+
+
 ### POST /policies
 
 Create a new unpublished (mutable) Policy
diff --git a/policy/.README.md.swp b/policy/.README.md.swp
deleted file mode 100644
index 5acdd28673f98345a0391f2b5ad09c9b9216c9c5..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 36864
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
OJbnn7XKhYbD*p#dmU)W+

diff --git a/policy/README.md b/policy/README.md
index b7ff85a3..a101ef42 100644
--- a/policy/README.md
+++ b/policy/README.md
@@ -86,11 +86,10 @@ The response to a client request must include a valid HTTP status code defined i
 
 #### Policies
 
-Endpoint: `/policies/{id}`  
-Method: `GET`  
-`data` Payload: `{ "policies": [] }`, an array of objects with the structure [outlined below](#policy).
+#### GET `/policies/`  
+`data` Payload: `{ "policies": [] }`, an array of Policy objects.
 
-##### Query Parameters
+Parameters
 
 | Name         | Type      | Required / Optional | Description                                    |
 | ------------ | --------- | --- | ---------------------------------------------- |
@@ -104,14 +103,6 @@ Policies will be returned in order of effective date (see schema below), with pa
 
 `provider_id` is an implicit parameter and will be encoded in the authentication mechanism, or a complete list of policies should be produced. If the Agency decides that Provider-specific policy documents should not be shared with other Providers (e.g. punitive policy in response to violations), an Agency should filter policy objects before serving them via this endpoint.
 
-Response codes:
-
-- 200 - success
-- 401 - unauthorized
-- 404 - not found
-- 500 - server error
-
-
 ### Flat Files
 
 To use flat files, policies shall be represented in two (2) files:

From de084d133e38bff5e460e58d85b90311e4628abe Mon Sep 17 00:00:00 2001
From: Jane Huang <jane.x.huang@gmail.com>
Date: Tue, 14 Apr 2020 21:54:44 -0400
Subject: [PATCH 4/6] Adding minor note for expected response body.

---
 policy-author/README.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/policy-author/README.md b/policy-author/README.md
index ca2f195b..000e1207 100644
--- a/policy-author/README.md
+++ b/policy-author/README.md
@@ -12,6 +12,8 @@ The agency-facing Policy Author API consists of the following endpoints. The end
 
 ### Policy Endpoints
 
+Responses must set the `Content-Type` header, as specified in the [Provider versioning](../provider/README.md#versioning) section. They must also specify the API version in the JSON-formatted response body, under the `version` key.
+
 #### Schema
 
 See Policy API.

From ff70d65f69f1b73715d77d4fd2a9d136ccab1035 Mon Sep 17 00:00:00 2001
From: Jane Huang <jane.x.huang@gmail.com>
Date: Mon, 27 Apr 2020 20:28:38 -0400
Subject: [PATCH 5/6] Removing service_areas reference and changing id to
 policy_id in spec.

---
 .gitignore              |  3 +--
 policy-author/README.md | 12 +++++-------
 policy/README.md        |  4 ++--
 3 files changed, 8 insertions(+), 11 deletions(-)

diff --git a/.gitignore b/.gitignore
index 49800733..0cafc1cd 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,2 +1 @@
-.venv/
-*.swp
+.venv/
\ No newline at end of file
diff --git a/policy-author/README.md b/policy-author/README.md
index 000e1207..b5458399 100644
--- a/policy-author/README.md
+++ b/policy-author/README.md
@@ -29,7 +29,7 @@ A note: the `get_published` and `get_unpublished` parameters only make sense in
 Parameters:
 | Name         | Type      | R/O | Description                                    |
 | ------------ | --------- | --- | ---------------------------------------------- |
-| `id`         | UUID      | Optional    | If provided, returns one policy object with the matching UUID; default is to return all policy objects.                       |
+| `policy_id`         | UUID      | Optional    | If provided, returns one policy object with the matching UUID; default is to return all policy objects.                       |
 | `get_published` | string | O   | If set to the string 'true', returns metadata of published policies. |
 | `get_unpublished`   | string | O   | If set to the string 'true', returns metadata of unpublished policies.      |
 
@@ -47,8 +47,6 @@ Create a new unpublished (mutable) Policy
 
 Payload: a new Policy object, without a `policy_id`
 
-; a failure explanation on failure
-
 Response codes:
 
 - 201 - Created. Returns: the Policy object on success, including a `policy_id` and a `version` indicating the current API version.
@@ -56,7 +54,7 @@ Response codes:
 - 401 - Unauthorized (if any auth issue)
 - 500 - Server error (hopefully doesn’t happen)
 
-### PUT /policies/{id}
+### PUT /policies/{policy_id}
 
 Update an existing Policy. Must be unpublished.
 
@@ -71,7 +69,7 @@ Response codes:
 - 409 - conflict (if immutable)
 - 500 - server error
 
-### POST /policies/{id}/publish
+### POST /policies/{policy_id}/publish
 
 Publish (make immutable) a Policy. Must be unpublished.
 
@@ -101,7 +99,7 @@ Response codes:
 - 500 - server error
 
 
-### GET /policies/{id}/meta
+### GET /policies/{policy_id}/meta
 
 Get metadata for a specific policy.
 
@@ -112,7 +110,7 @@ Response codes:
 - 500 - server error
 
 
-### PUT /policies/{id}/meta
+### PUT /policies/{policy_id}/meta
 Edit metadata for a specific policy. Takes a PolicyMetadata object in the request body.
 
 Response codes:
diff --git a/policy/README.md b/policy/README.md
index a101ef42..8390ef80 100644
--- a/policy/README.md
+++ b/policy/README.md
@@ -22,9 +22,9 @@ The goal of this specification is to enable Agencies to publish machine-readable
 
 The machine-readable format allows Providers to obtain policies and compute compliance where it can be determined entirely by data obtained internally.
 
-Policies will typically be linked to one or more associated geographies. Geography descriptions (e.g. geofences or lists of street segments) must also be maintained by the Agency indefinitely. Policies without specific geographies (global policies) are assumed to apply to the entire service area managed by the Agency. 
+Policies will typically be linked to one or more associated geographies. Geography descriptions (e.g. geofences or lists of street segments) must also be maintained by the Agency indefinitely. Policies without specific geographies (global policies) are assumed to apply to all jurisdictions managed by the Agency. 
 
-Geographical data will be stored as immutable GeoJSON, referenced by UUID. See the Geography and Geography Author specs for information on the Geography schema, and how Agencies are expected to create and maintain Geographies and serve them to Providers. In a future revision of Agency, we will deprecate the existing `/service_areas` endpoint. `/service_areas` currently only handles GeoJSON MultiPolygon and Polygon objects, and Policy documents might prefer Points for locations such as drop-zones. Policy may be used for a variety of enforcement actions, so it's important for the Agency to persist and keep immutable both Policy and Geography data.
+Geographical data will be stored as immutable GeoJSON FeatureCollections (see https://tools.ietf.org/html/rfc7946 for details on what a FeatureCollection is), referenced by UUID. See the Geography and Geography Author specs for information on the Geography schema, and how Agencies are expected to create and maintain Geographies and serve them to Providers. Policies are not confined to describing their effects over a geographic area. They might prefer Points for locations such as drop-zones. Policy may be used for a variety of enforcement actions, so it's important for the Agency to persist and keep immutable both Policy and Geography data.
 
 
 

From b2440a9cc8b2b53177a0fb8e6f10029aa63e3d48 Mon Sep 17 00:00:00 2001
From: Jane Huang <jane.x.huang@gmail.com>
Date: Fri, 1 Apr 2022 13:31:04 -0400
Subject: [PATCH 6/6] updating http verb for publish endpoint

---
 policy-author/README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/policy-author/README.md b/policy-author/README.md
index b5458399..98839edf 100644
--- a/policy-author/README.md
+++ b/policy-author/README.md
@@ -69,7 +69,7 @@ Response codes:
 - 409 - conflict (if immutable)
 - 500 - server error
 
-### POST /policies/{policy_id}/publish
+### PUT /policies/{policy_id}/publish
 
 Publish (make immutable) a Policy. Must be unpublished.