IPBES ICT guide
  • IPBES ICT documentation
  • Data and Knowledge Management
    • Policy
    • Tutorials
    • Organisation of Work
      • A - File naming
      • B - Versioning scheme
      • C - Experts list
    • Technical Guideline Series
      • Part 1 - Conversion to the Robinson Projection
      • Part 2 - Preparing and Mapping Data to IPBES Regions and Sub-regions
      • Part 3 - Cartographic Guidelines
      • Part 4 - Guidelines for Colour
      • Part 5 - File formats
      • Part 6 - How to Upload to and Download from Zenodo
      • Part 7 - How to Cite IPBES Assessment Reports
      • Part 8 - Guidelines for the delivery of figures
      • Part 9 - Considerations When Working with Indigenous and Local Knowledge
      • Part 10 - Contributing Authors Template Email
      • Part 11 - How to Document an Indicator
      • Part 12 - Snowballing for Literature
    • Citations of IPBES Assessments
      • Transformative Change Assessment
      • Nexus Assessment
      • Invasive Alien Species Assessment
      • Sustainable Use Assessment
      • Values Assessment
      • Global Assessment
    • Assessment Directories
      • Underlying bibliographic data and research materials of the IPBES assessment reports
      • Thematic assessment report on Invasive Alien Species and their Control
      • First global assessment report on biodiversity and ecosystem services
  • Linked Open Data
    • IPBES Ontology
  • Repositories
    • GitHub
    • Zenodo
    • ORCID
  • Reference Manager
    • Zotero
      • Zotero administration
  • Literature access
    • Research4Life
    • Open access literature
  • Mailing and messaging
    • Microsoft Outlook
      • Quick Start Guide
    • Mailchimp
    • Slack
  • Collaboration
    • Microsoft Teams
      • Quick Start Guide
      • Joining Teams & Channels
      • Files and documents
      • Meetings
      • Chat
      • Troubleshooting Teams
    • Microsoft SharePoint
      • Quick Start Guide
      • Sign in to SharePoint
      • Collaborate in SharePoint
    • Microsoft OneDrive
      • Quick Start Guide
      • Manage files
      • Sync files
      • Collaborate
      • Work on the go
    • Google Groups
  • Website
    • IPBES Website
    • Navigation
    • Search
    • Forms
    • TRACK
    • TEST
    • Content management
      • Content creation
      • Content administration
Powered by GitBook

Copyright © 2023 Intergovernmental Platform on Biodiversity and Ecosystem Services (IPBES), All rights reserved.

On this page
  • Draft 0
  • Draft 1
  • Draft 2
  • Draft 3
  • Draft 4
  • Final version

Was this helpful?

Export as PDF
  1. Data and Knowledge Management
  2. Organisation of Work

B - Versioning scheme

PreviousA - File namingNextC - Experts list

Last updated 1 year ago

Was this helpful?

Prepared by Renske Gudde - IPBES Technical Support Unit (TSU) for Knowledge and Data and Rainer M. Krug - IPBES Task Force on Knowledge and Data. Reviewed by Aidin Niamir and Yanina V. Sica - IPBES Technical Support Unit for Knowledge and Data and the IPBES Task Force on Knowledge and Data (Hanno Seebens and Xubin Pan)

For any inquires please contact

Version: 1.0 Last Updated: 16 October 2023

DOI:

The IPBES assessment process is a lengthy and complex process, spanning over multiple years and involving many contributors. It is therefore important to track the versions of all files related to the assessment. Here, an IPBES specific versioning scheme for its assessments is being proposed.

There are usually five milestones during an IPBES assessment process; the first, second, and third order drafts, followed by the version submitted to the Plenary and the final approved version. Fast-track assessments have four milestones; they do not have a third order draft.

The suggested versioning scheme builds on the Semantic Versioning 2.0.0 used in software development (), and is adapted for the usage in the context of IPBES.

The IPBES versioning scheme consists of 3 parts separated by a dot (.):

vDRAFT.MAJOR.MINOR.

The DRAFT follows the following scheme:

0.

Drafts 5 - 9 are reserved for any potential versions between the version submitted to the Plenary and the final approved version for production.

10.

The MAJOR version starts with 0, going up one number for each new major revision, for example after the addition or removal of paragraphs, figures and/or data.

The MINOR version starts usually with 0 and is not often used (but needs to be specified). Minor versions are used for small changes in the text and/or data that do not lead to changes in the results, such as the addition of a reference or correcting of a spelling mistake. Similar to the major versions, for each new minor revision the number goes up by one.

Draft 0

Before the final draft of the first order draft:

Description
Version

Very first version of a file

v0.0.0

After making small changes in the text and adding a new reference (minor change)

v0.0.1

After adding another new reference (minor change)

v0.0.2

After adding new figures and more text (major change)

v0.1.0

Draft 1

Final version of the first order draft and every version before the final version of the second order draft:

Description
Version

File submitted for the first order draft

v1.0.0

First version of a file that was created after the FOD was submitted

v1.0.0

After adding another new reference (minor change)

v1.0.1

After adding new figures and more text (major change)

v1.1.0

Draft 2

Final version of the first order draft and every version before the final version of the second order draft:

Description
Version

File submitted for the second order draft

v2.0.0

First version of a file that was created after the SOD was submitted

v2.0.0

After adding another new reference (minor change)

v2.0.1

After adding new figures and more text (major change)

v2.1.0

Draft 3

Final version of the third order draft and every version before the final version submitted for the Plenary:

Description
Version

File submitted for the third order draft

v3.0.0

First version of a file that was created after the TOD was submitted

v3.0.0

After adding another new reference (minor change)

v3.0.1

After adding new figures and more text (major change)

v3.1.0

Draft 4

Final version to be submitted to the Plenary:

Description
Version

File submitted to the Plenary

v4.0.0

Final version

Final version that has been approved by the Plenary and is ready for publication:

Description
Version

File submitted for publication

v10.0.0

aidin.niamir@senckenberg.de
10.5281/zenodo.10004407
https://semver.org
for versions leading up to the first order draft
for final version of FOD and for versions leading up to the SOD
for final version of SOD and for version leading up to the TOD
for final version of TOD and for versions leading up to the Plenary
for final versions as submitted to the Plenary for approval and for requested edits
final approved version for production