# Changelog

These release notes describe what's new in each version. OCDS adheres to [Semantic Versioning](https://semver.org/).

## Iterative improvements

Per the [normative and non-normative content and changes policy](https://docs.google.com/document/d/1xjlAneqgewZvHh6_hwuQ98hbjxRcA2IUqOTJiNGcOf8/edit), iterative improvements to non-normative content can be made outside the release cycle.

### Documentation

* Primer:
  * Rewrite the Getting Started section as a Primer [#1298](https://github.com/open-contracting/standard/pull/1298) [#1302](https://github.com/open-contracting/standard/pull/1302) [#1365](https://github.com/open-contracting/standard/pull/1365)[#1387](https://github.com/open-contracting/standard/pull/1387).

* Guidance:
  * [#986](https://github.com/open-contracting/standard/pull/986) Add implementation guidance from OCP website.
  * [#1386](https://github.com/open-contracting/standard/pull/1386) Add link to OCDS Implementation Checklist.
  * Map:
    * Add examples [#1338](https://github.com/open-contracting/standard/pull/1338):
      * Organization references [#947](https://github.com/open-contracting/standard/pull/947)
      * Organization identifiers [#948](https://github.com/open-contracting/standard/pull/948) [#1429](https://github.com/open-contracting/standard/pull/1429)
      * Updates and amendments [#950](https://github.com/open-contracting/standard/pull/950) [#1454](https://github.com/open-contracting/standard/pull/1454)
      * Personal identifiers [#952](https://github.com/open-contracting/standard/pull/952)
      * Organizational units [#961](https://github.com/open-contracting/standard/pull/961)
      * Awards and contracts [#974](https://github.com/open-contracting/standard/pull/974) [#1451](https://github.com/open-contracting/standard/pull/1451).
      * Organization classifications [#990](https://github.com/open-contracting/standard/pull/990)
      * Pre-qualification and pre-selection [#999](https://github.com/open-contracting/standard/pull/999) [#1345](https://github.com/open-contracting/standard/pull/1345)
      * Unsuccessful processes [#1007](https://github.com/open-contracting/standard/pull/1007)
      * Milestones [#1048](https://github.com/open-contracting/standard/pull/1048)
      * Framework agreements [#1123](https://github.com/open-contracting/standard/pull/1123) [#1269](https://github.com/open-contracting/standard/pull/1269) [#1332](https://github.com/open-contracting/standard/pull/1332) [#1461](https://github.com/open-contracting/standard/pull/1461)
      * Electronic catalogs [#1223](https://github.com/open-contracting/standard/pull/1223)
      * Beneficial ownership information [#1305](https://github.com/open-contracting/standard/pull/1305)
      * [#1414](https://github.com/open-contracting/standard/pull/1414) Rephrase planning stage to planning process in worked examples.
    * Add pages:
      * Localizing OCDS [#1043](https://github.com/open-contracting/standard/pull/1043)
      * Linked standards [#1278](https://github.com/open-contracting/standard/pull/1278)
    * [#1016](https://github.com/open-contracting/standard/pull/1016) [#1140](https://github.com/open-contracting/standard/pull/1140) Add links to OCDS profiles and linked standards.
    * [#1193](https://github.com/open-contracting/standard/pull/1193) Removed language distinguishing "core", "community", and "local" extensions.
    * [#1428](https://github.com/open-contracting/standard/pull/1428) Integrate content from [what to do with fields that don't map](https://www.open-contracting.org/2018/01/30/fields-dont-map-first/).
  * Build:
    * Add pages:
      * "Easy" releases [#951](https://github.com/open-contracting/standard/pull/951)
      * Updates and deletions [#985](https://github.com/open-contracting/standard/pull/985)
      * Change history [#997](https://github.com/open-contracting/standard/pull/997) [#1047](https://github.com/open-contracting/standard/pull/1047)
      * System architectures [#997](https://github.com/open-contracting/standard/pull/997)
      * Data collection tools [#1061](https://github.com/open-contracting/standard/pull/1061/files)
    * [#963](https://github.com/open-contracting/standard/pull/963) Remove guidance on web discovery.
    * [#986](https://github.com/open-contracting/standard/pull/986) Merge Registration page into Build page.
    * [#1150](https://github.com/open-contracting/standard/pull/1150) Align language in Build phase with language in Map phase.
    * [#1414](https://github.com/open-contracting/standard/pull/1414) Remove the planning section from Easy releases and Change history.
    * [#1494](https://github.com/open-contracting/standard/pull/1497) Add guidance on preparing test data to Check your data section.
  * Publish:
    * Merge Publication policy and Licensing pages into Publish page [#986](https://github.com/open-contracting/standard/pull/986) [#1012](https://github.com/open-contracting/standard/pull/1012).
    * Replace guidance on publication levels [#980](https://github.com/open-contracting/standard/pull/980) [#1013](https://github.com/open-contracting/standard/pull/1013) [#1045](https://github.com/open-contracting/standard/pull/1045).
  * [#1427](https://github.com/open-contracting/standard/pull/1427) Add guidance about recommended extensions.
  * Various minor improvements [#1051](https://github.com/open-contracting/standard/pull/1051) [#1080](https://github.com/open-contracting/standard/pull/1080) [#1083](https://github.com/open-contracting/standard/pull/1083) [#1085](https://github.com/open-contracting/standard/pull/1085) [#1091](https://github.com/open-contracting/standard/pull/1091) [#1130](https://github.com/open-contracting/standard/pull/1130) [#1227](https://github.com/open-contracting/standard/pull/1227) [#1299](https://github.com/open-contracting/standard/pull/1299) [#1337](https://github.com/open-contracting/standard/pull/1337) [#1384](https://github.com/open-contracting/standard/pull/1384).

* [#908](https://github.com/open-contracting/standard/pull/908) Rename Validator to Data Review Tool.
* [#955](https://github.com/open-contracting/standard/pull/955) Split the Guidance section into sub-sections. Add a new History section, and move the Changelog, Credits, and History and Development pages to it.
* [#958](https://github.com/open-contracting/standard/pull/958) Governance page: Change responsibility for prioritization review to OCP's Head of Data Products & Services. Change "technical team" to "standard development team".
* [#959](https://github.com/open-contracting/standard/pull/959) [#979](https://github.com/open-contracting/standard/pull/979) History section: Merge Credits and History of OCDS pages into Development and Appreciation page. Update history from present perspective.
* [#960](https://github.com/open-contracting/standard/pull/960) Support section: Merge Tools page into Support page.
* Re-organize non-normative content ([milestone](https://github.com/open-contracting/standard/milestone/29?closed=1)).
* Copy-edit non-normative pages and fix broken links ([milestone](https://github.com/open-contracting/standard/milestone/28?closed=1)).
* Change how the documentation is built ([milestone](https://github.com/open-contracting/standard/milestone/26?closed=1)).
* Update translations ([milestone](https://github.com/open-contracting/standard/milestone/27?closed=1))
* Update the changelog [#932](https://github.com/open-contracting/standard/pull/932) [#976](https://github.com/open-contracting/standard/pull/976).
* [#1444](https://github.com/open-contracting/standard/pull/1444) Governance page: OCP is now a 501(c)(3) organization, and FCNY is no longer its fiscal sponsor.

## [1.1.5] - 2020-08-20

* [#1054](https://github.com/open-contracting/standard/pull/1054) The [Translation and localization policy](../governance/index.md#translation-and-localization-policy) is amended to read "normative content will be translated into all core supported languages *as soon as possible*" instead of "*before the release*". A Spanish translation is ready for release, and a French translation will be ready as soon as possible.

### Codelists

* `itemClassificationScheme.csv`:
  * [#998](https://github.com/open-contracting/standard/pull/998) Add 'NAICS', 'PSC' and 'HS' codes.
  * [#967](https://github.com/open-contracting/standard/pull/967) Remove the discouragement of the 'UNSPSC' code.
  * [#1033](https://github.com/open-contracting/standard/pull/1033) Add a `Category` column to indicate the context in which the classification scheme is used.
* `milestoneType.csv`:
  * [#1000](https://github.com/open-contracting/standard/pull/1000) Update description of 'financing' code, and add 'payment' code.

### Schema

* [#969](https://github.com/open-contracting/standard/pull/969) Clarify the instruction for setting the `Unit.id` field.
* [#995](https://github.com/open-contracting/standard/pull/995) Clarify the instruction for setting the `Release.date` field.
* [#996](https://github.com/open-contracting/standard/pull/996) Fix a typo in the `versionedRelease` field.

### Documentation

* [#966](https://github.com/open-contracting/standard/pull/966) Move Governance and Deprecation pages to new Governance section.
* [#968](https://github.com/open-contracting/standard/pull/968) [#1032](https://github.com/open-contracting/standard/pull/1032) Use "field" to refer to OCDS fields and "property" to refer to JSON Schema properties.
* [#970](https://github.com/open-contracting/standard/pull/970) Add links to access the release schema as a CSV spreadsheet and via the Field-Level Mapping Template. Add notes to describe the alternatives for browsing the schemas.
* [#965](https://github.com/open-contracting/standard/pull/965) Release Reference page: Add extensions list for the Transaction object.
* [#970](https://github.com/open-contracting/standard/pull/970) Release Schema page: Correct the description of compiled releases.
* [#996](https://github.com/open-contracting/standard/pull/996) Record Reference page: Rewrite page to improve clarity.
* [#1010](https://github.com/open-contracting/standard/pull/1010) Identifiers page: Add link to organization identifiers example.
* Codelists page:
  * [#978](https://github.com/open-contracting/standard/pull/978) [#1032](https://github.com/open-contracting/standard/pull/1032) Remove the suggestion to use X prefixes, for the reasons expressed by the [IETF](https://tools.ietf.org/html/rfc6648#appendix-B).
  * [#972](https://github.com/open-contracting/standard/pull/972) Clarify the norms around open and closed codelists.
  * [#973](https://github.com/open-contracting/standard/pull/973) Describe the `openCodelist` and `codelist` JSON Schema properties.
  * [#1036](https://github.com/open-contracting/standard/pull/1036) Add instruction for OCDS publishers to contact the Data Support Team to add list codes to org-id.guide.

### Extensions

See the changelogs for:

* [Bid statistics and details](https://extensions.open-contracting.org/en/extensions/bids/master/#changelog)
* [Enquiries](https://extensions.open-contracting.org/en/extensions/enquiries/master/#changelog)
* [Location](https://extensions.open-contracting.org/en/extensions/location/master/#changelog)
* [Lots](https://extensions.open-contracting.org/en/extensions/lots/master/#changelog)
* [Milestone documents](https://extensions.open-contracting.org/en/extensions/milestone_documents/master/#changelog)
* [Participation fees](https://extensions.open-contracting.org/en/extensions/participation_fee/master/#changelog)
* [Process level title and description](https://extensions.open-contracting.org/en/extensions/process_title/master/#changelog)

## [1.1.4] - 2019-06-25

### Advisories

* OCDS 1.0 uses the [whole-list merge](../schema/merging.md#whole-list-merge) strategy for `Award.suppliers`, whereas OCDS 1.1 uses the [identifier merge](../schema/merging.md#identifier-merge) strategy. As a consequence, the OCDS 1.1 versioned release schema is not backward compatible with OCDS 1.0.
  * **Action:** Versioned releases respecting the OCDS 1.0 schema that set `Award.suppliers` will need to be re-created to validate against the OCDS 1.1 schema.
* [#780](https://github.com/open-contracting/standard/pull/780) All extensions authored by the Open Contracting Partnership have been moved to the [open-contracting-extensions](https://github.com/open-contracting-extensions) organization.
  * **Action:** No change is required, but we recommend that publishers update the URLs of these extensions in their release packages and record packages.
* [#738](https://github.com/open-contracting/standard/pull/738) 1.1.3 changed the merging and versioning behaviors of `Item.unit`, such that it could be removed by setting it to `null`, and such that it was versioned as a whole. 1.1.4 restores the behaviors from 1.1.2, such that only its sub-fields can be removed by setting them to `null`, and such that its sub-fields are versioned individually.
  * **Action:** If you had upgraded to OCDS 1.1.3, then compiled releases and versioned releases that set `Item.unit` will likely need to be re-created to validate against the OCDS 1.1.4 schema.
* [#810](https://github.com/open-contracting/standard/pull/810) `buyer.id`, `Tender.procuringEntity.id`, `Contract.implementation.payer.id` `Contract.implementation.payee.id`, `Budget.id`, `Identifier.id`, and `Classification.id` are now versioned, consistent with the documentation.
  * **Action:** Versioned releases that set these fields will likely need to be re-created to validate against the OCDS 1.1.4 schema.
* [#831](https://github.com/open-contracting/standard/pull/831) OCDS now has a [Normative and non-normative content and changes policy](https://docs.google.com/document/d/1xjlAneqgewZvHh6_hwuQ98hbjxRcA2IUqOTJiNGcOf8/edit).
* [#744](https://github.com/open-contracting/standard/pull/744) OCDS now has a [Translation and localization policy](../governance/index.md#translation-and-localization-policy).
* [#717](https://github.com/open-contracting/standard/pull/717) [#734](https://github.com/open-contracting/standard/pull/734) The OCDS documentation website now has a privacy notice.
* The documentation is now available in Italian.

### Codelists

* [#824](https://github.com/open-contracting/standard/pull/824) Canonical codelist files are available at URLs like <https://standard.open-contracting.org/schema/1__1__5/codelists/>, and translations are available at URLs like <https://standard.open-contracting.org/1.1/en/codelists/>, for OCDS 1.1.4 and up.
* [#746](https://github.com/open-contracting/standard/pull/746) [#842](https://github.com/open-contracting/standard/pull/842) Update the currency codelist for ISO4217 amendments [166](https://www.currency-iso.org/dam/downloads/dl_currency_iso_amendment_166.pdf), [167](https://www.currency-iso.org/dam/downloads/dl_currency_iso_amendment_167.pdf), [168](https://www.currency-iso.org/dam/downloads/dl_currency_iso_amendment_168.pdf) and [169](https://www.currency-iso.org/dam/downloads/dl_currency_iso_amendment_169.pdf).
* [#725](https://github.com/open-contracting/standard/pull/725) Add a 'plannedProcurementNotice' code to the `documentType` codelist, 'CUCOP' to `itemClassificationScheme`, 'interestedParty' to `partyRole`.
* [#725](https://github.com/open-contracting/standard/pull/725) Update the descriptions of the 'tenderNotice' and 'technicalSpecifications' codes in the `documentType` codelist to align with the text of the [Agreement on Government Procurement (GPA)](https://www.wto.org/english/tratop_e/gproc_e/gp_gpa_e.htm) of the World Trade Organization (WTO).
* [#725](https://github.com/open-contracting/standard/pull/725) Apply the style guide and OCDS glossary to the 'procuringEntity' and 'supplier' codes in the `partyRole` codelist.
* [#725](https://github.com/open-contracting/standard/pull/725) Add examples to the description of the 'environmentalImpact' code in the `documentType` codelist.
* [#829](https://github.com/open-contracting/standard/pull/829) Use sentence case for code titles and end code descriptions with periods.
* [#852](https://github.com/open-contracting/standard/pull/852) Use the correct normative keywords in code descriptions.

### Schema

* [#712](https://github.com/open-contracting/standard/pull/712) [#715](https://github.com/open-contracting/standard/pull/715) Add missing titles for `publisher` and `url` and description for `record` in the record package schema, and missing description for `releases` in release package schema.
* [#769](https://github.com/open-contracting/standard/pull/769) The versioned release schema now matches the release schema in: having a `minLength` validation property for `OrganizationReference.name`; having `codelist` and `openCodelist` properties for `Tender.awardCriteria`, `Tender.awardCriteriaDetails`, `Document.documentType`, `Item.unit.scheme`, `Classification.scheme`, and `RelatedProcess.scheme`; and having a `deprecated` property for `Budget.source`. All `title` and `description` metadata properties are removed from the versioned release schema.
* [#838](https://github.com/open-contracting/standard/pull/838) Eliminate the conflicting rule that release identifiers must be unique within release packages. Uniqueness within the scope of a release package either implies that release identifiers must be globally unique, or imposes an arbitrary restriction on the contents of release packages, as there is no rule preventing release packages from containing releases from different contracting processes. Release identifiers are only required to be locally unique within the scope of a contracting process. The `ocid` and `id` values of a release can be used together to disambiguate releases within a release package.
* Clarify the uniqueness of release identifiers in the release schema [#838](https://github.com/open-contracting/standard/pull/838) and release package schema [#831](https://github.com/open-contracting/standard/pull/831).
* [#810](https://github.com/open-contracting/standard/pull/810) `tag` is now `omitWhenMerged`, consistent with the reference implementation in OCDS Merge.
* [#810](https://github.com/open-contracting/standard/pull/810) Add a dereferenced release schema to ease the implementation of the merge routine.
* [#810](https://github.com/open-contracting/standard/pull/810) Add `"versionId": true` hint to `Identifier` and `Classification`.
* [#845](https://github.com/open-contracting/standard/pull/845) Remove a reference to a closed issue and a note about a field name.
* [#855](https://github.com/open-contracting/standard/pull/855) Use the correct normative keywords in field descriptions.
* [#855](https://github.com/open-contracting/standard/pull/855) Rephrase field descriptions as definitions rather than instructions.
* [#855](https://github.com/open-contracting/standard/pull/855) Align the descriptions of the `license` fields in the release package schema and record package schema.

### Documentation

* [#772](https://github.com/open-contracting/standard/pull/772) [#810](https://github.com/open-contracting/standard/pull/810) [#831](https://github.com/open-contracting/standard/pull/831) Clarify the merge rules for compiled releases and versioned releases.
* [#797](https://github.com/open-contracting/standard/pull/797) Fix examples of versioned releases.
* [#831](https://github.com/open-contracting/standard/pull/831) Use the correct normative keywords in the documentation.
* [#869](https://github.com/open-contracting/standard/pull/869) Move normative statements into normative sections.
* [#835](https://github.com/open-contracting/standard/pull/835) Display the canonical schema URLs in the documentation.
* [#838](https://github.com/open-contracting/standard/pull/838) Clarify the uniqueness of release, award and contract identifiers.
* [#831](https://github.com/open-contracting/standard/pull/831) Improve the description of iterating the release `id`.
* [#822](https://github.com/open-contracting/standard/pull/822) Integrate the [Extension Explorer](https://extensions.open-contracting.org/en/).
* [#783](https://github.com/open-contracting/standard/pull/783) Add missing email address for the standard governance working group.
* Replace ambiguous or incorrect terms:
  * [#831](https://github.com/open-contracting/standard/pull/831) Use "release `id`" and "release `date`", instead of "`releaseID`" and "`releaseDate`"
  * [#831](https://github.com/open-contracting/standard/pull/831) Use "ocid prefix", instead of "publisher prefix"
  * [#840](https://github.com/open-contracting/standard/pull/840) Use "release package and record package", instead of "data package", to avoid confusion with [Frictionless Data's Data Package specification](https://specs.frictionlessdata.io/data-package/)
  * [#831](https://github.com/open-contracting/standard/pull/831) Use "minor versions", instead of "decimal versions" on deprecation page
  * [#823](https://github.com/open-contracting/standard/pull/823) Fix incorrect uses of "records", "codelists" and "gazetteers" on identifiers and codelists pages
* Fix out-of-date content:
  * [#831](https://github.com/open-contracting/standard/pull/831) Remove sentence implying non-existence of unit classification scheme codelist on release schema reference page
  * [#831](https://github.com/open-contracting/standard/pull/831) Remove sentence using non-existent 'notice' code on release schema reference page
  * [#831](https://github.com/open-contracting/standard/pull/831) Remove reference to closed issue in API section
* Add links to:
  * [#783](https://github.com/open-contracting/standard/pull/783) Community extensions relating to party details
  * [#837](https://github.com/open-contracting/standard/pull/837) OCDS profiles

### Extensions

See the changelogs for:

* [Bid statistics and details](https://extensions.open-contracting.org/en/extensions/bids/master/#changelog)
* [Enquiries](https://extensions.open-contracting.org/en/extensions/enquiries/master/#changelog)
* [Location](https://extensions.open-contracting.org/en/extensions/location/master/#changelog)
* [Lots](https://extensions.open-contracting.org/en/extensions/lots/master/#changelog)
* [Participation fees](https://extensions.open-contracting.org/en/extensions/participation_fee/master/#changelog)
* [Process level title and description](https://extensions.open-contracting.org/en/extensions/process_title/master/#changelog)

## [1.1.3] - 2018-04-16

### Schema

* [#646](https://github.com/open-contracting/standard/pull/646) Disallow use of `null` as an entry in the array for `Tender.additionalProcurementCategories`.
* [#639](https://github.com/open-contracting/standard/issues/639) Make `name` field optional for `OrganizationReference`.
* [#630](https://github.com/open-contracting/standard/issues/630) Allow optional field `Item.unit` to be `null`. **(Reverted in 1.1.4)**
* [#663](https://github.com/open-contracting/standard/pull/663) Add `"type": "object"` to objects in the versioned release schema.
* [a75c1c5](https://github.com/open-contracting/standard/pull/667/commits/a75c1c50379881f618df97ed3b9967297ed2edca) Make `record-package-schema.json` use the `codelist` property to reference `releaseTag.csv`, and update the `enum` accordingly.

### Codelists

* Update the currency codelist for ISO4217 amendment 165 (2017-12-14).

### Schema

* [#603](https://github.com/open-contracting/standard/issues/603), [#645](https://github.com/open-contracting/standard/issues/645) Add definitions to `Release`, `planning.budget`, `Milestone`, `Organization.address`, `Organization.contactPoint`, `Classification`, `Identifier`, `Value` and `Period`.
* [#578](https://github.com/open-contracting/standard/issues/578) Update the definition of the `buyer` field to cover goods, works and services, and multiple buyers.

### Documentation

* [#633](https://github.com/open-contracting/standard/issues/633) Update schema reference page to display `Release.relatedProcesses`, `Planning.documents` and `Contract.relatedProcesses`.
* [#634](https://github.com/open-contracting/standard/issues/634) Clarify definitions of core, community and local extensions.
* Old and unused scripts have been removed from the documentation repository, and a number of script dependencies have been updated.

### Extensions

* [#40](https://github.com/open-contracting/ocds-extensions/issues/40), [#43](https://github.com/open-contracting/ocds-extensions/issues/43), [#47](https://github.com/open-contracting/ocds-extensions/issues/47) Add missing definitions, codelists and enums to core extensions, correct typos in codelist filenames, disallow use of `null` as an item in arrays, disallow required fields from being set to `null`, allow optional fields to be `null`, use `OrganizationReference` instead of `Organization`.

## [1.1.2] - 2017-11-10

### Codelists

* [#609](https://github.com/open-contracting/standard/pull/609) Update the currency codelist for ISO4217 amendment 163 (2017-06-09). XBT (Bitcoin) is removed from the codelist as it is not part of ISO4217.

### Documentation

* [#565](https://github.com/open-contracting/standard/pull/565) Add explanatory text for the schema browser.
* [#590](https://github.com/open-contracting/standard/pull/590) [#591](https://github.com/open-contracting/standard/pull/591) Add 1.0.1 and 1.0.3 to the changelog.

## [1.1.1] - 2017-07-31

### Schema

* [#251](https://github.com/open-contracting/standard/issues/251) Allow optional field `parties.role` to be `null`.
* [#479](https://github.com/open-contracting/standard/issues/479) Remove `releases` as a required field in [`record-package-schema.json`](../schema/record_package).
* [#475](https://github.com/open-contracting/standard/issues/475) Add an `enum` property to every field in the schema with a closed codelist.

### Codelists

* [#422](https://github.com/open-contracting/standard/issues/422) Include a [currency codelist](../schema/codelists.md#currency) in the documentation and schema.
* [#471](https://github.com/open-contracting/standard/issues/471) Update the [milestoneType codelist](../schema/codelists.md#milestone-type), replacing 'planning' with 'preProcurement' and 'adjudication' with 'assessment', and introducing 'approval' and 'financing'. This is an open codelist, so the old codes remain valid, but publishers able to update to the new codes should do so.
* [#473](https://github.com/open-contracting/standard/issues/473) Update the definition of the 'contractSchedule' code in the [documentType codelist](../schema/codelists.md#document-type).

### Documentation

* [#457](https://github.com/open-contracting/standard/pull/457) List all registered extensions.
* [#480](https://github.com/open-contracting/standard/pull/480/commits/c3c41225639a06b0b0552016b32e2fe2e901a8fe) Align the tables and text in the [publication levels](../guidance/publish/quality) guidance.
* [#489](https://github.com/open-contracting/standard/issues/489) Change the milestone documents extension to a core extension. This extension is only needed by publishers with legacy data containing documents within milestones.
* [#612](https://github.com/open-contracting/standard/pull/612) Update the description of the [Organization Identifier Scheme codelist](../schema/codelists.md#organization-identifier-scheme), to reflect that it is now maintained by [org-id.guide](http://org-id.guide).
* [#506](https://github.com/open-contracting/standard/issues/506) Remove `make_field_definitions.py` from the utility scripts, as it is no longer required.

## [1.1.0] - 2017-05-01

### Policy changes

* [#401](https://github.com/open-contracting/standard/issues/401) **[Deprecation policy](../schema/conformance_and_extensions)** - The deprecation policy has been updated to support deprecation in decimal upgrades.

### Changed

#### Structural updates

* [#368](https://github.com/open-contracting/standard/issues/368) **[Updates to organization handling in OCDS](../schema/reference.md#parties)** - We have updated the approach to include organization information in the standard from having embedded blocks of organization information, to using embedded cross-references to a top-level 'parties' array where full organization details are stored. This change reduces duplication of organization information, and enables more flexible disclosure of information on all the parties to a contracting process, including multiple buyers.
* [#357](https://github.com/open-contracting/standard/issues/357) **[Amendment handling](../guidance/map/amendments)** - We have replace amendment with an array of amendments, and have updated schema and guidance to remove the option of providing semi-structured changes in an amendment object. Changes between amendments should now be provided using multiple releases, with the option to explicitly declare how releases relate to an amendment included in the new amendments array.

#### Schema validation updates

* [#329](https://github.com/open-contracting/standard/issues/329) **[Float for Item.quantity](../schema/reference.md#item)** - Item quantities has been updated to 'number' to support decimal values (e.g 10.5 rather than just 10)
* [#253](https://github.com/open-contracting/standard/issues/253) **[Negative amounts](../schema/reference.md#budget)** - We have added support for negative amounts in transactions
* [#323](https://github.com/open-contracting/standard/issues/323) **[Standard should specify use of UTF-8 for encoding JSON](../guidance/build/serialization.md#json)** - We now recommend use of I-JSON and UTF-8 for JSON publication
* [#166](https://github.com/open-contracting/standard/issues/166) **[Indicate encoding for CSV serializations](../guidance/build/serialization.md#multi-table)** - We have added information on CSV encoding to the implementation guidance to recommend UTF-8 or Windows-1252.
* [#336](https://github.com/open-contracting/standard/issues/336) **[Codelist properties in schema](https://github.com/open-contracting/standard/commit/ee1db256d7364ee70e3553f4384d9908bff604a6)** - We have included explicit references to the codelist files (CSV versions) in the schema. This will be used in future versions of the validator to support validation against codelists.
* [#301](https://github.com/open-contracting/standard/issues/301) **[Specifying versions and extensions in package metadata](../schema/records_reference.md#package-metadata)** - We have updated the package schemas to require that version is declared, and to provide a means of declaring extensions in use. This will be used in future versions of the validator to support validation against extensions.
* [#287](https://github.com/open-contracting/standard/issues/287) [#447](https://github.com/open-contracting/standard/pull/447) **[Change how merge strategies are expressed](../schema/merging)** - The `omitWhenMerged` and `wholeListMerge` properties replace the `mergeStrategy` and `mergeOptions` properties, with different semantics.
* [#431](https://github.com/open-contracting/standard/pull/431) **Add `minLength` property to required string fields**.

#### Schema definition updates

* [#372](https://github.com/open-contracting/standard/issues/372) **[Updates to transactions terminology](../schema/reference.md#transaction)** - We have replaced receiverOrganization and providerOrganization with payee and payer, to align with more familiar terminology, and have replaced 'amount' with 'value' for consistency with other areas of the standard.
* [#378](https://github.com/open-contracting/standard/issues/378) **[Updates to core budget block](../schema/reference.md#budget)** - We have updated references to the Fiscal Data Package in the schema.
* [#337](https://github.com/open-contracting/standard/issues/337) **[Definition of "tenderer" to enhance clarity](../schema/reference.md#tender)** - We have updated the definition of tenderer in the tenders block, and cross-referenced the bid extension.
* [#259](https://github.com/open-contracting/standard/issues/259) **[Enquiries](https://extensions.open-contracting.org/en/extensions/enquiries/)** - We have updated the definition of hasEnquiries.
* [#246](https://github.com/open-contracting/standard/issues/246) **[In what scope must a release ID be unique?](../schema/reference.md#release)** - We have updated the definition of release.id to reflect the scope in which it must be unique

#### Closed codelist updates

* [#201](https://github.com/open-contracting/standard/issues/201) **[Tender status](../schema/codelists.md#tender-status)** - New 'planning' and 'withdrawn' codes have been introduced to the tenderStatus codelist.
* [#380](https://github.com/open-contracting/standard/issues/380) **[Procurement method](../schema/codelists.md#method)** - A new code for 'direct' has been added the procurementMethod codelist
* [#373](https://github.com/open-contracting/standard/issues/373) **[Milestone status](../schema/codelists.md#milestone-status)** - We have updated the milestoneStatus codelist with a 'scheduled' entry and revised definitions
* [#297](https://github.com/open-contracting/standard/issues/297) **[Currency codelist external link](../schema/codelists.md#currency)** - We have fixed the external link for currency codelists to refer to the official ISO source.

#### Open codelist updates

* [#386](https://github.com/open-contracting/standard/issues/386) **[Document type](../schema/codelists.md#document-type)** - New codes have been added to the documentType codelist, and definitions of codes updated.
* [#322](https://github.com/open-contracting/standard/issues/322) **[Submission Method Codelist](../schema/codelists.md#submission-method)** - The submissionMethod codelist has been updated
* [#387](https://github.com/open-contracting/standard/issues/387) **[Codelist updates: Item Classification Scheme](../schema/codelists.md#item-classification-scheme)** - New entries have been added to the itemClassificationScheme codelist
* [#385](https://github.com/open-contracting/standard/issues/385) **[Codelist updates: awardCriteria](../schema/codelists.md#award-criteria)** - Revising the awardCriteria codelist, with all existing codes deprecated and a new set of codes introduced.

### Added

* [#371](https://github.com/open-contracting/standard/issues/371) [#439](https://github.com/open-contracting/standard/pull/439) **[Linking related processes](../schema/reference.md#relatedprocess)** - We have introduced a new RelatedProcess block at the release and contract level
* [#374](https://github.com/open-contracting/standard/issues/374) **[Duration in periods](../schema/reference.md#period)** - We have introduced fields for duration in days, and maximum extent, to the period building block
* [#374](https://github.com/open-contracting/standard/issues/374) **[Contract and Award Periods in Tender](../schema/reference.md#tender)** - We have introduced contract period in tender and updated the definition of award period.
* [#376](https://github.com/open-contracting/standard/issues/376) **[Contract type (supplies, works and services)](../schema/codelists.md#procurement-category)** - We have introduced a procurementCategory field to specify whether contracts are for supplies, works, services, consultancyServices or mixed
* [#373](https://github.com/open-contracting/standard/issues/373) **[Milestone types](../schema/codelists.md#milestone-type)** - We have introduced the milestoneType property and codelist
* [#366](https://github.com/open-contracting/standard/issues/366) **[Unit of Measure - additional fields and codelist](../schema/reference.md#unit)** - We have introduced a structured classification for unitOfMeasure on each item, with a recommendation to use UNCEFACT.

### Extensions

* [#335](https://github.com/open-contracting/standard/issues/335) [#411](https://github.com/open-contracting/standard/pull/411) **[Core and community extensions](../guidance/map/extensions)** - We have introduced widespread use of extensions throughout the standard. An extension provides fields and data structures that are optional, either because   (a) they are only relevant in particular contexts or contracting processes; or   (b) they represent a 'stretch goal' for most data publishers, and so are not currently suitable for inclusion in the main standard.   We divide these extensions into 'core extensions' which have wide enough relevance, and technical maturity to be included in the main standard documentation (and which are versioned along with the standard documentation), and 'community extensions' which may have less technical maturity, or which might be versioned independently of the main standard.
* [#259](https://github.com/open-contracting/standard/issues/259) **[Enquiries](https://extensions.open-contracting.org/en/extensions/enquiries/)** - We have introduced a core enquiries extension for providing information on enquiries received during the tender stage.
* [#342](https://github.com/open-contracting/standard/issues/342) **[Overall contracting process description](../schema/reference.md#release)** - We have introduced a new top-level title and description for the contracting process as a core extension.
* [#274](https://github.com/open-contracting/standard/issues/274) **[New property of contract: extendsContractID](../schema/reference.md#contract)** - We have introduced a new field 'extendsContractID' to the Contract block to support contract cross-referencing between contracts.
* [#381](https://github.com/open-contracting/standard/issues/381) **[Lots](https://extensions.open-contracting.org/en/extensions/lots/)** - We have introduced a core extension to provide a model for contracting processes which are divided into lots.
* [#379](https://github.com/open-contracting/standard/issues/379) **[Bids and Bid Statistics](https://extensions.open-contracting.org/en/extensions/bids/)** - We have introduced a core extension which provides a top level Bids section, with BidStatistics and Bid building blocks for detailed information on individual bids. This supersedes the current tender/tenderers section.
* [#250](https://github.com/open-contracting/standard/issues/250) **[Location extension](https://extensions.open-contracting.org/en/extensions/location/)** - We have moved the location extensions to become a core extension
* [#33](https://github.com/open-contracting/standard/issues/33) **[Participation fees (bid document and submission costs)](https://extensions.open-contracting.org/en/extensions/participation_fee/)** - We have introduced a core extension for declaring the participation fees related to a contracting process.
* [#249](https://github.com/open-contracting/standard/issues/249) **[Extend contract with a supplier array](https://extensions.open-contracting.org/en/extensions/contract_suppliers/)** - We have introduced a core extension to allow inclusion of supplier information at the contract level.

### Deprecated

* [#355](https://github.com/open-contracting/standard/issues/355) **[Deprecating milestone documents](../schema/reference.md#milestone)** - We have deprecated milestone documents from core, and added a milestone documents extension for those who wish to continue to use documents at the milestone level.
* [#368](https://github.com/open-contracting/standard/issues/368) **[Updates to organization handling in OCDS](../schema/reference.md#parties)** - We have deprecated use of the full organization block at points other than the parties array.
* [#372](https://github.com/open-contracting/standard/issues/372) **[Updates to transactions terminology](../schema/reference.md#transaction)** - receiverOrganization, providerOrganization and amount properties have been deprecated in favour or other terms.

## [1.0.3] - 2017-07-31

### Schema

* [#329](https://github.com/open-contracting/standard/issues/329) Update `Item.quantity` to allow decimal values.
* [#253](https://github.com/open-contracting/standard/issues/253) Update `Value.amount` to allow negative values.

## [1.0.2] - 2016-11-22

### Schema

* [#362](https://github.com/open-contracting/standard/issues/362) Add a `title` property to all fields.
* [#221](https://github.com/open-contracting/standard/issues/221) Add the missing `procurementMethodDetails` field.
* [#391](https://github.com/open-contracting/standard/issues/391) Fix typo in `description` property of `releaseTag` field.
* [#271](https://github.com/open-contracting/standard/issues/271) Fix link to Fiscal Data Package.
* [#314](https://github.com/open-contracting/standard/issues/314) Add a `description` property to the `numberOfTenderers` field.
* [#244](https://github.com/open-contracting/standard/issues/244) Fix the `description` property of the `changes` field.

### Documentation

* [#228](https://github.com/open-contracting/standard/issues/228) Update the documentation to use "Object" not "Reference" in Format column of field tables.
* [#331](https://github.com/open-contracting/standard/pull/331) Add a Governance page.
* [#332](https://github.com/open-contracting/standard/pull/332) Replace the license.
* [#332](https://github.com/open-contracting/standard/pull/332) Add a Contributor Licence Agreement.
* [#360](https://github.com/open-contracting/standard/pull/360) Clarify the CSV serialization guidance.
* Add CSV download links for registered ocids and publication levels. Update the publication levels spreadsheet accordingly.

## [1.0.1] - 2016-03-14

### Codelists

* [#267](https://github.com/open-contracting/standard/issues/267) Rename codes in the `documentType` codelist: 'Tender notice' to 'tenderNotice', 'Award notice' to 'awardNotice', and 'Contract notice' to 'contractNotice'.
* [#307](https://github.com/open-contracting/standard/pull/307) Remove a reference to a non-existent `statusDescription` field in the `awardStatus` codelist.

### Schema

* [#283](https://github.com/open-contracting/standard/issues/283) Remove `"mergeStrategy": "ocdsVersion"` from the `planning.budget` field.
* [#295](https://github.com/open-contracting/standard/issues/295) Allow the optional fields `Award.status` and `Contract.status` to be `null`.
* [#300](https://github.com/open-contracting/standard/issues/300) Remove `"format": "uri"` from the `publisher.scheme` field.
* [#304](https://github.com/open-contracting/standard/pull/304) Fix the versioning of arrays in the versioned release schema.
* [#305](https://github.com/open-contracting/standard/pull/305) Add `title` and `description` properties and fix typos.

### Documentation

* Restructure the documentation, including: expanding the Getting Started section and adding more examples.

## [1.0.0] - 2015-07-29

### Codelists

* Update `documentType` and `organizationIdentifierRegistrationAgency_iati` codelists.

### Schema

* [#188](https://github.com/open-contracting/standard/pull/188) Add the `tender.numberOfTenderers` and `tender.tenderers` fields.
* [#199](https://github.com/open-contracting/standard/issues/199) Add the `Award.contractPeriod` field, to disclose the anticipated contract period without creating a `Contract` object.
* Update the `description` property of the `Award.date` field.

### Documentation

* Add changelog.

## [1.0.RC] - 2014-11-18

Changes prior to this release are not covered here. Please see the [overview of changes](https://www.open-contracting.org/2014/11/18/release-of-data-standard/) between the beta and 1.0.RC releases.