Adoption of Popolo types for the Open Civic Data Person, Organization, Post, and Membership types.
At the core of the Open Civic Data mission is helping people discover who represents them and the structure of their government. People, Posts, Organizations, and Memberships are the means to describing that structure.
Furthermore, we have adopted (with minor differences) the Popolo schemas for these objects in the aim of being interoperable with a wide range of civic software that is being built, and due to the technical merits and completeness of the specification.
To avoid duplicating the entire Popolo specification, this proposal only aims to highlight the differences (omitted or added fields) between Popolo and the Open Civic Data implementation.
The basis for the Open Civic Data Person object is the Popolo Person.
Several fields have been omitted:
The basis for the Open Civic Data Organization object is the Popolo Organization.
The basis for the Open Civic Data Post object is the Popolo Post.
An post may have an associated Division, which is a synonym of Popolo’s Area. (See Areas, Divisions, and Jurisdictions)
These fields are synonymous with area and area_id. It is strongly suggested that both exist for compatibility reasons.
The basis for the Open Civic Data Membership object is the Popolo Membership.
Two main differences have emerged between our handling of political areas and that of Popolo:
The first difference is the use of Division instead of Area on Post. Division in Open Civic Data predates Area‘s inclusion in Popolo, but the two are now essentially synonymous. For compatibility reasons Open Civic Data will continue to use the term Division, but for compatibility with other Popolo-based systems area and area_id should be present in any API.
Additionally, Open Civic Data uses the concept of Jurisdictions, which represent entities with authority over a given area. (For more detail on Jurisdictions see OCDEP 3: Jurisdictions.)
Due to the presence of Jurisdictions, a decision was made to not use area & area_id on Organizations, instead Organization objects are linked instead to a Jurisdiction. A link to Division (a synonym for Area does exist on Jurisdiction so it is still possible to get the Area represented by an Organization).
This document has been placed in the public domain per the Creative Commons CC0 1.0 Universal license (http://creativecommons.org/publicdomain/zero/1.0/deed).