Real-time Policy Improvements and Clarifications

[schnuerle]

Explain pull request

Updating the MDS spec to make it clearer and easier to use Policy for real-time management of the public right of way.

Currently includes the following changes:

1. Real-time language clarification and examples
2. Noting that agencies may manage their public Policy feeds, for example with an API key
3. Policy uniqueness note to prevent identical policy duplication
4. last_updated parameter to return only the last updated date
5. active_only parameter to return only current, active policies
6. A Policy object relationship diagram.
7. Additional relevant policy examples (moved these to an external document for ease of updates)

To possibly come in the future, in new Pull Requests:

1. A push endpoint option, like using POST in MDS Agency, and related to CDS push Events (PR Creating an option to Push Policies #951)
2. A new Message/Notification/Communication endpoint/API (may come in a separate PR)

Likely not coming based on discussion in meeting:

1. Adding a max_update_interval field like in Requirements to note how frequently the file may update (some discussion in WG that this may not be a good idea)

Is this a breaking change

• No, not breaking

Impacted Spec

Which spec(s) will this pull request impact?

• policy

Additional context

See Issue #906 for more history and context.

[schnuerle]

See detailed notes, recording, slides, discussion from public Working Group meeting on March 13. Leave your ideas and feedback here or inline with the changes as comments.