From f14945cd8dbc889a66f6d3bd1000a8a2afb0c3bb Mon Sep 17 00:00:00 2001
From: Peter Desmet <600993+peterdesmet@users.noreply.github.com>
Date: Thu, 11 Jun 2026 18:25:59 +0200
Subject: [PATCH 01/12] Use Roxygen 8.0.0

---
 DESCRIPTION                 |  2 +-
 man/add_resource.Rd         |  4 ++--
 man/create_package.Rd       |  4 ++--
 man/create_schema.Rd        |  4 ++--
 man/frictionless-package.Rd | 11 ++++++-----
 man/read_package.Rd         |  4 ++--
 man/read_resource.Rd        |  4 ++--
 man/remove_resource.Rd      |  4 ++--
 man/resource_names.Rd       |  4 ++--
 man/schema.Rd               |  4 ++--
 man/write_package.Rd        |  2 +-
 11 files changed, 24 insertions(+), 23 deletions(-)

diff --git a/DESCRIPTION b/DESCRIPTION
index 146fcb3e..ff833a10 100644
--- a/DESCRIPTION
+++ b/DESCRIPTION
@@ -58,4 +58,4 @@ Config/testthat/edition: 3
 Encoding: UTF-8
 LazyData: true
 Roxygen: list(markdown = TRUE)
-RoxygenNote: 7.3.3
+Config/roxygen2/version: 8.0.0
diff --git a/man/add_resource.Rd b/man/add_resource.Rd
index 2107a7da..e704638d 100644
--- a/man/add_resource.Rd
+++ b/man/add_resource.Rd
@@ -113,7 +113,7 @@ package <- add_resource(
 resource_names(package)
 }
 \seealso{
-Other edit functions: 
-\code{\link{remove_resource}()}
+Other edit functions:
+\code{\link[=remove_resource]{remove_resource()}}
 }
 \concept{edit functions}
diff --git a/man/create_package.Rd b/man/create_package.Rd
index 1b49a50f..b572cea3 100644
--- a/man/create_package.Rd
+++ b/man/create_package.Rd
@@ -42,7 +42,7 @@ package
 str(package)
 }
 \seealso{
-Other create functions: 
-\code{\link{create_schema}()}
+Other create functions:
+\code{\link[=create_schema]{create_schema()}}
 }
 \concept{create functions}
diff --git a/man/create_schema.Rd b/man/create_schema.Rd
index e5fd30ee..d0cfcda0 100644
--- a/man/create_schema.Rd
+++ b/man/create_schema.Rd
@@ -36,7 +36,7 @@ schema <- create_schema(df)
 str(schema)
 }
 \seealso{
-Other create functions: 
-\code{\link{create_package}()}
+Other create functions:
+\code{\link[=create_package]{create_package()}}
 }
 \concept{create functions}
diff --git a/man/frictionless-package.Rd b/man/frictionless-package.Rd
index fb7136f5..81747111 100644
--- a/man/frictionless-package.Rd
+++ b/man/frictionless-package.Rd
@@ -18,18 +18,19 @@ Useful links:
 
 }
 \author{
-\strong{Maintainer}: Peter Desmet \email{peter.desmet@inbo.be} (\href{https://orcid.org/0000-0002-8442-8025}{ORCID}) (Research Institute for Nature and Forest (INBO))
+\strong{Maintainer}: Peter Desmet \email{peter.desmet@inbo.be} (\href{https://orcid.org/0000-0002-8442-8025}{ORCID}) (affiliation: Research Institute for Nature and Forest (INBO))
 
 Authors:
 \itemize{
-  \item Damiano Oldoni \email{damiano.oldoni@inbo.be} (\href{https://orcid.org/0000-0003-3445-7562}{ORCID}) (Research Institute for Nature and Forest (INBO))
-  \item Pieter Huybrechts \email{pieter.huybrechts@inbo.be} (\href{https://orcid.org/0000-0002-6658-6062}{ORCID}) (Research Institute for Nature and Forest (INBO))
-  \item Sanne Govaert \email{sanne.govaert@inbo.be} (\href{https://orcid.org/0000-0002-8939-1305}{ORCID}) (Research Institute for Nature and Forest (INBO))
+  \item Peter Desmet \email{peter.desmet@inbo.be} (\href{https://orcid.org/0000-0002-8442-8025}{ORCID}) (affiliation: Research Institute for Nature and Forest (INBO))
+  \item Damiano Oldoni \email{damiano.oldoni@inbo.be} (\href{https://orcid.org/0000-0003-3445-7562}{ORCID}) (affiliation: Research Institute for Nature and Forest (INBO))
+  \item Pieter Huybrechts \email{pieter.huybrechts@inbo.be} (\href{https://orcid.org/0000-0002-6658-6062}{ORCID}) (affiliation: Research Institute for Nature and Forest (INBO))
+  \item Sanne Govaert \email{sanne.govaert@inbo.be} (\href{https://orcid.org/0000-0002-8939-1305}{ORCID}) (affiliation: Research Institute for Nature and Forest (INBO))
 }
 
 Other contributors:
 \itemize{
-  \item Kyle Husmann \email{kdh38@psu.edu} (\href{https://orcid.org/0000-0001-9875-8976}{ORCID}) (Pennsylvania State University) [contributor]
+  \item Kyle Husmann \email{kdh38@psu.edu} (\href{https://orcid.org/0000-0001-9875-8976}{ORCID}) (affiliation: Pennsylvania State University) [contributor]
   \item Research Institute for Nature and Forest (INBO) (\href{https://ror.org/00j54wy13}{ROR}) [copyright holder]
   \item Research Foundation - Flanders (https://lifewatch.be) [funder]
   \item Beatriz Milz \email{milz.bea@gmail.com} (\href{https://orcid.org/0000-0002-3064-4486}{ORCID}) [reviewer]
diff --git a/man/read_package.Rd b/man/read_package.Rd
index 098c9a3e..2a1f302e 100644
--- a/man/read_package.Rd
+++ b/man/read_package.Rd
@@ -33,7 +33,7 @@ package$name
 package$created
 }
 \seealso{
-Other read functions: 
-\code{\link{read_resource}()}
+Other read functions:
+\code{\link[=read_resource]{read_resource()}}
 }
 \concept{read functions}
diff --git a/man/read_resource.Rd b/man/read_resource.Rd
index 55154003..2ee80c3f 100644
--- a/man/read_resource.Rd
+++ b/man/read_resource.Rd
@@ -58,7 +58,7 @@ purrr::map_chr(package$resources[[2]]$schema$fields, "type")
 read_resource(package, "deployments", col_select = c("latitude", "longitude"))
 }
 \seealso{
-Other read functions: 
-\code{\link{read_package}()}
+Other read functions:
+\code{\link[=read_package]{read_package()}}
 }
 \concept{read functions}
diff --git a/man/remove_resource.Rd b/man/remove_resource.Rd
index 067ae16b..61a020b8 100644
--- a/man/remove_resource.Rd
+++ b/man/remove_resource.Rd
@@ -33,7 +33,7 @@ package <- remove_resource(package, "observations")
 resource_names(package)
 }
 \seealso{
-Other edit functions: 
-\code{\link{add_resource}()}
+Other edit functions:
+\code{\link[=add_resource]{add_resource()}}
 }
 \concept{edit functions}
diff --git a/man/resource_names.Rd b/man/resource_names.Rd
index aa68deac..0335aae9 100644
--- a/man/resource_names.Rd
+++ b/man/resource_names.Rd
@@ -24,7 +24,7 @@ package <- example_package()
 resource_names(package)
 }
 \seealso{
-Other accessor functions: 
-\code{\link{schema}()}
+Other accessor functions:
+\code{\link[=schema]{schema()}}
 }
 \concept{accessor functions}
diff --git a/man/schema.Rd b/man/schema.Rd
index 44d4d059..90e70bf8 100644
--- a/man/schema.Rd
+++ b/man/schema.Rd
@@ -33,7 +33,7 @@ schema <- schema(package, "observations")
 str(schema)
 }
 \seealso{
-Other accessor functions: 
-\code{\link{resource_names}()}
+Other accessor functions:
+\code{\link[=resource_names]{resource_names()}}
 }
 \concept{accessor functions}
diff --git a/man/write_package.Rd b/man/write_package.Rd
index 1e1db593..c5331dc7 100644
--- a/man/write_package.Rd
+++ b/man/write_package.Rd
@@ -31,7 +31,7 @@ location of file(s).
 \item Resource \code{path} has only URL(s): resource stays as is.
 \item Resource has inline \code{data} originally: resource stays as is.
 \item Resource has inline \code{data} as result of adding data with \code{\link[=add_resource]{add_resource()}}:
-data are written to a CSV file using \code{\link[readr:write_delim]{readr::write_csv()}}, \code{path} points to
+data are written to a CSV file using \code{\link[readr:write_csv]{readr::write_csv()}}, \code{path} points to
 location of file, \code{data} property is removed.
 Use \code{compress = TRUE} to gzip those CSV files.
 }

From 554022f657cd126ee371bba0c77e496d186469ef Mon Sep 17 00:00:00 2001
From: Peter Desmet <600993+peterdesmet@users.noreply.github.com>
Date: Thu, 11 Jun 2026 18:26:09 +0200
Subject: [PATCH 02/12] Ignore positai

---
 .Rbuildignore | 2 ++
 .gitignore    | 1 +
 2 files changed, 3 insertions(+)

diff --git a/.Rbuildignore b/.Rbuildignore
index 31748995..824ef7b3 100644
--- a/.Rbuildignore
+++ b/.Rbuildignore
@@ -10,3 +10,5 @@
 ^pkgdown$
 ^README\.Rmd$
 ^CRAN-SUBMISSION$
+^\.positai$
+^\.claude$
diff --git a/.gitignore b/.gitignore
index 88c54407..ea9c1f62 100644
--- a/.gitignore
+++ b/.gitignore
@@ -46,3 +46,4 @@ docs
 
 # Mac OS
 .DS_Store
+.positai

From 9e191fd378b203c1352684eba01bc2d4caf8786e Mon Sep 17 00:00:00 2001
From: Peter Desmet <600993+peterdesmet@users.noreply.github.com>
Date: Thu, 11 Jun 2026 18:43:24 +0200
Subject: [PATCH 03/12] Create version() function

---
 NAMESPACE      |  1 +
 R/version.R    | 41 +++++++++++++++++++++++++++++++++++++++++
 man/version.Rd | 25 +++++++++++++++++++++++++
 3 files changed, 67 insertions(+)
 create mode 100644 R/version.R
 create mode 100644 man/version.Rd

diff --git a/NAMESPACE b/NAMESPACE
index 72e42a33..c68b4ce4 100644
--- a/NAMESPACE
+++ b/NAMESPACE
@@ -14,6 +14,7 @@ export(remove_resource)
 export(resource_names)
 export(resources)
 export(schema)
+export(version)
 export(write_package)
 import(rlang)
 importFrom(readr,problems)
diff --git a/R/version.R b/R/version.R
new file mode 100644
index 00000000..857a3fea
--- /dev/null
+++ b/R/version.R
@@ -0,0 +1,41 @@
+#' Get Data Package version
+#'
+#' Determines what version of the [Data Package standard](
+#' https://datapackage.org/) is used by the Data Package, based on the
+#' `$schema` property. Version `"1.0"` is assumed if `$schema` is missing,
+#' version `"2.x"` is assumed for custom values (e.g. [extensions](
+#' https://datapackage.org/standard/extensions/)).
+#'
+#' @inheritParams read_resource
+#' @return Data Package version number (e.g. `1.0`).
+#' @family version functions
+#' @export
+#' @examples
+#' package <- example_dataset()
+#' version(package)
+version <- function(package) {
+  dollar_schema <- purrr::pluck(package, "$schema")
+
+  if (is.null(dollar_schema)) {
+    return("1.0") # Assume 1.0 if $schema is undefined
+  }
+  if (!is.character(dollar_schema)) {
+    return("2.x") # Assume >=2.0 if $schema is present but invalid
+  }
+
+  # Extract version from e.g.
+  # "https://datapackage.org/profiles/<version>/datapackage.json"
+  pattern = ".*datapackage\\.org/profiles/((?:[0-9A-Za-z]|\\.|-)+)/.*"
+  extracted_version <- sub(
+    pattern,
+    "\\1",
+    dollar_schema,
+    perl = TRUE
+  )
+
+  if (extracted_version == dollar_schema) {
+    return("2.x") # Assume >= 2.0 if $schema is a custom value (e.g. extension)
+  }
+
+  extracted_version
+}
diff --git a/man/version.Rd b/man/version.Rd
new file mode 100644
index 00000000..6e5e4fb3
--- /dev/null
+++ b/man/version.Rd
@@ -0,0 +1,25 @@
+% Generated by roxygen2: do not edit by hand
+% Please edit documentation in R/version.R
+\name{version}
+\alias{version}
+\title{Get Data Package version}
+\usage{
+version(package)
+}
+\arguments{
+\item{package}{Data Package object, as returned by \code{\link[=read_package]{read_package()}} or
+\code{\link[=create_package]{create_package()}}.}
+}
+\value{
+Data Package version number (e.g. \code{1.0}).
+}
+\description{
+Determines what version of the \href{https://datapackage.org/}{Data Package standard} is used by the Data Package, based on the
+\verb{$schema} property. Version \code{"1.0"} is assumed if \verb{$schema} is missing,
+version \code{"2.x"} is assumed for custom values (e.g. \href{https://datapackage.org/standard/extensions/}{extensions}).
+}
+\examples{
+package <- example_dataset()
+version(package)
+}
+\concept{version functions}

From 9cda74c4764697c4d32abe8a86b7451fe1db811f Mon Sep 17 00:00:00 2001
From: Peter Desmet <600993+peterdesmet@users.noreply.github.com>
Date: Thu, 11 Jun 2026 19:06:33 +0200
Subject: [PATCH 04/12] Add test

---
 tests/testthat/test-version.R | 42 +++++++++++++++++++++++++++++++++++
 1 file changed, 42 insertions(+)
 create mode 100644 tests/testthat/test-version.R

diff --git a/tests/testthat/test-version.R b/tests/testthat/test-version.R
new file mode 100644
index 00000000..2e7e940b
--- /dev/null
+++ b/tests/testthat/test-version.R
@@ -0,0 +1,42 @@
+test_that("version() returns version based on $schema", {
+  p <- create_package()
+
+  # Undefined
+  p$`$schema` <- NULL
+  expect_equal(version(p), "1.0")
+
+  # Defined default
+  p$`$schema` <- "https://datapackage.org/profiles/1.0/datapackage.json"
+  expect_equal(version(p), "1.0")
+
+  # 2.0
+  p$`$schema` <- "https://datapackage.org/profiles/2.0/datapackage.json"
+  expect_equal(version(p), "2.0")
+
+  # Future versions
+  p$`$schema` <- "https://datapackage.org/profiles/2.1/datapackage.json"
+  expect_equal(version(p), "2.1")
+  p$`$schema` <- "https://datapackage.org/profiles/2.2-rc.1/datapackage.json"
+  expect_equal(version(p), "2.2-rc.1")
+  p$`$schema` <- "https://datapackage.org/profiles/3.0/datapackage.json"
+  expect_equal(version(p), "3.0")
+
+  # Custom extensions
+  p$`$schema` <- "http://rs.tdwg.org/dwc-dp/1.0/dwc-dp-profile.json"
+  expect_equal(version(p), "2.x")
+})
+
+test_that("version() returns 2.x for invalid $schema", {
+  p <- create_package()
+  p$`$schema` <- list()
+  expect_equal(version(p), "2.x")
+  p$`$schema` <- 3.0
+  expect_equal(version(p), "2.x")
+})
+
+test_that("version() returns correct version for example packages", {
+  p_1.0 <- example_package(version = "1.0")
+  expect_equal(version(p_1.0), "1.0")
+  p_2.0 <- example_package(version = "2.0")
+  expect_equal(version(p_2.0), "2.0")
+})

From ee3a9c66f4abbb0023d53021f6de3db2541c4761 Mon Sep 17 00:00:00 2001
From: Peter Desmet <600993+peterdesmet@users.noreply.github.com>
Date: Thu, 11 Jun 2026 19:06:51 +0200
Subject: [PATCH 05/12] Stricter matching on entire domain

---
 R/version.R                   | 2 +-
 tests/testthat/test-version.R | 2 ++
 2 files changed, 3 insertions(+), 1 deletion(-)

diff --git a/R/version.R b/R/version.R
index 857a3fea..5a5b1d6d 100644
--- a/R/version.R
+++ b/R/version.R
@@ -25,7 +25,7 @@ version <- function(package) {
 
   # Extract version from e.g.
   # "https://datapackage.org/profiles/<version>/datapackage.json"
-  pattern = ".*datapackage\\.org/profiles/((?:[0-9A-Za-z]|\\.|-)+)/.*"
+  pattern = "^https://datapackage\\.org/profiles/((?:[0-9A-Za-z]|\\.|-)+)/.*"
   extracted_version <- sub(
     pattern,
     "\\1",
diff --git a/tests/testthat/test-version.R b/tests/testthat/test-version.R
index 2e7e940b..8ac5d567 100644
--- a/tests/testthat/test-version.R
+++ b/tests/testthat/test-version.R
@@ -22,6 +22,8 @@ test_that("version() returns version based on $schema", {
   expect_equal(version(p), "3.0")
 
   # Custom extensions
+  p$`$schema` <- "https://spatial.datapackage.org/profiles/1.0/datapackage.json"
+  expect_equal(version(p), "2.x")
   p$`$schema` <- "http://rs.tdwg.org/dwc-dp/1.0/dwc-dp-profile.json"
   expect_equal(version(p), "2.x")
 })

From 38c957096b1737e065b43f51b4885c2a290d3ab3 Mon Sep 17 00:00:00 2001
From: Peter Desmet <600993+peterdesmet@users.noreply.github.com>
Date: Thu, 11 Jun 2026 19:15:04 +0200
Subject: [PATCH 06/12] Use correcter >=2.0 rather than 2.x

---
 R/version.R                   |  6 +++---
 man/version.Rd                |  2 +-
 tests/testthat/test-version.R | 10 +++++-----
 3 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/R/version.R b/R/version.R
index 5a5b1d6d..dcca99e7 100644
--- a/R/version.R
+++ b/R/version.R
@@ -3,7 +3,7 @@
 #' Determines what version of the [Data Package standard](
 #' https://datapackage.org/) is used by the Data Package, based on the
 #' `$schema` property. Version `"1.0"` is assumed if `$schema` is missing,
-#' version `"2.x"` is assumed for custom values (e.g. [extensions](
+#' version `">=2.0"` is assumed for custom values (e.g. [extensions](
 #' https://datapackage.org/standard/extensions/)).
 #'
 #' @inheritParams read_resource
@@ -20,7 +20,7 @@ version <- function(package) {
     return("1.0") # Assume 1.0 if $schema is undefined
   }
   if (!is.character(dollar_schema)) {
-    return("2.x") # Assume >=2.0 if $schema is present but invalid
+    return(">=2.0") # Assume 2.0 or higher if $schema is present but invalid
   }
 
   # Extract version from e.g.
@@ -34,7 +34,7 @@ version <- function(package) {
   )
 
   if (extracted_version == dollar_schema) {
-    return("2.x") # Assume >= 2.0 if $schema is a custom value (e.g. extension)
+    return(">=2.0") # Assume 2.0 or higher if $schema is a custom value
   }
 
   extracted_version
diff --git a/man/version.Rd b/man/version.Rd
index 6e5e4fb3..179b2e77 100644
--- a/man/version.Rd
+++ b/man/version.Rd
@@ -16,7 +16,7 @@ Data Package version number (e.g. \code{1.0}).
 \description{
 Determines what version of the \href{https://datapackage.org/}{Data Package standard} is used by the Data Package, based on the
 \verb{$schema} property. Version \code{"1.0"} is assumed if \verb{$schema} is missing,
-version \code{"2.x"} is assumed for custom values (e.g. \href{https://datapackage.org/standard/extensions/}{extensions}).
+version \code{">=2.0"} is assumed for custom values (e.g. \href{https://datapackage.org/standard/extensions/}{extensions}).
 }
 \examples{
 package <- example_dataset()
diff --git a/tests/testthat/test-version.R b/tests/testthat/test-version.R
index 8ac5d567..ad8e619f 100644
--- a/tests/testthat/test-version.R
+++ b/tests/testthat/test-version.R
@@ -23,17 +23,17 @@ test_that("version() returns version based on $schema", {
 
   # Custom extensions
   p$`$schema` <- "https://spatial.datapackage.org/profiles/1.0/datapackage.json"
-  expect_equal(version(p), "2.x")
+  expect_equal(version(p), ">=2.0")
   p$`$schema` <- "http://rs.tdwg.org/dwc-dp/1.0/dwc-dp-profile.json"
-  expect_equal(version(p), "2.x")
+  expect_equal(version(p), ">=2.0")
 })
 
-test_that("version() returns 2.x for invalid $schema", {
+test_that("version() returns >=2.0 for invalid $schema", {
   p <- create_package()
   p$`$schema` <- list()
-  expect_equal(version(p), "2.x")
+  expect_equal(version(p), ">=2.0")
   p$`$schema` <- 3.0
-  expect_equal(version(p), "2.x")
+  expect_equal(version(p), ">=2.0")
 })
 
 test_that("version() returns correct version for example packages", {

From 90e172ec01d0b834f73d1d62940841c34de139f0 Mon Sep 17 00:00:00 2001
From: Peter Desmet <600993+peterdesmet@users.noreply.github.com>
Date: Thu, 11 Jun 2026 19:15:13 +0200
Subject: [PATCH 07/12] Add version family to pkgdown

---
 _pkgdown.yml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/_pkgdown.yml b/_pkgdown.yml
index d82535eb..963b7ca0 100644
--- a/_pkgdown.yml
+++ b/_pkgdown.yml
@@ -31,4 +31,5 @@ reference:
   - has_concept("accessor functions")
   - has_concept("print functions")
   - has_concept("check functions")
+  - has_concept("version functions")
   - has_concept("sample data")

From e251a8fb14e8feebdb581ce48ebf6ff3dcb169ea Mon Sep 17 00:00:00 2001
From: Peter Desmet <600993+peterdesmet@users.noreply.github.com>
Date: Thu, 18 Jun 2026 17:41:52 +0200
Subject: [PATCH 08/12] Link to dollar-schema property

---
 R/version.R    | 8 +++++---
 man/version.Rd | 8 +++++---
 2 files changed, 10 insertions(+), 6 deletions(-)

diff --git a/R/version.R b/R/version.R
index dcca99e7..ac1f6fa8 100644
--- a/R/version.R
+++ b/R/version.R
@@ -1,9 +1,11 @@
 #' Get Data Package version
 #'
 #' Determines what version of the [Data Package standard](
-#' https://datapackage.org/) is used by the Data Package, based on the
-#' `$schema` property. Version `"1.0"` is assumed if `$schema` is missing,
-#' version `">=2.0"` is assumed for custom values (e.g. [extensions](
+#' https://datapackage.org/) is used by a Data Package, based on the
+#' [`$schema`](https://datapackage.org/standard/data-package/#dollar-schema)
+#' property.
+#' Version `"1.0"` is assumed if `$schema` is missing, version `">=2.0"` is
+#' assumed for custom values (e.g. [extensions](
 #' https://datapackage.org/standard/extensions/)).
 #'
 #' @inheritParams read_resource
diff --git a/man/version.Rd b/man/version.Rd
index 179b2e77..7d3193dd 100644
--- a/man/version.Rd
+++ b/man/version.Rd
@@ -14,9 +14,11 @@ version(package)
 Data Package version number (e.g. \code{1.0}).
 }
 \description{
-Determines what version of the \href{https://datapackage.org/}{Data Package standard} is used by the Data Package, based on the
-\verb{$schema} property. Version \code{"1.0"} is assumed if \verb{$schema} is missing,
-version \code{">=2.0"} is assumed for custom values (e.g. \href{https://datapackage.org/standard/extensions/}{extensions}).
+Determines what version of the \href{https://datapackage.org/}{Data Package standard} is used by a Data Package, based on the
+\href{https://datapackage.org/standard/data-package/#dollar-schema}{\verb{$schema}}
+property.
+Version \code{"1.0"} is assumed if \verb{$schema} is missing, version \code{">=2.0"} is
+assumed for custom values (e.g. \href{https://datapackage.org/standard/extensions/}{extensions}).
 }
 \examples{
 package <- example_dataset()

From 0cdb62a300f91cf750f11d24ea5e3456ad3e8407 Mon Sep 17 00:00:00 2001
From: Peter Desmet <600993+peterdesmet@users.noreply.github.com>
Date: Thu, 18 Jun 2026 17:42:12 +0200
Subject: [PATCH 09/12] Describe changes of #299

---
 NEWS.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/NEWS.md b/NEWS.md
index 1614ad18..4524fa98 100644
--- a/NEWS.md
+++ b/NEWS.md
@@ -2,6 +2,7 @@
 
 ## For users
 
+* New `version()` determines what version of the Data Package standard is used by a Data Package (e.g. `"1.0"`, `"2.0"`, `">=2.0"`). This based on the presence and value of the `$schema` property (#299).
 * `read_resource()` now supports reading from remote zip files, thanks to support in `{vroom}` (1.3.0) (#291).
 * `resources()` is soft-deprecated, please use `resource_names()` instead (#282).
 * `get_schema()` is soft-deprecated, please use `schema()` instead (#282).

From e53a47310f8edc13eac067fdb5bc9311a0d3ac00 Mon Sep 17 00:00:00 2001
From: Peter Desmet <600993+peterdesmet@users.noreply.github.com>
Date: Fri, 19 Jun 2026 08:26:37 +0200
Subject: [PATCH 10/12] Fix typo in example

---
 R/version.R    | 2 +-
 man/version.Rd | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/R/version.R b/R/version.R
index ac1f6fa8..68f27e16 100644
--- a/R/version.R
+++ b/R/version.R
@@ -13,7 +13,7 @@
 #' @family version functions
 #' @export
 #' @examples
-#' package <- example_dataset()
+#' package <- example_package()
 #' version(package)
 version <- function(package) {
   dollar_schema <- purrr::pluck(package, "$schema")
diff --git a/man/version.Rd b/man/version.Rd
index 7d3193dd..5108d8cf 100644
--- a/man/version.Rd
+++ b/man/version.Rd
@@ -21,7 +21,7 @@ Version \code{"1.0"} is assumed if \verb{$schema} is missing, version \code{">=2
 assumed for custom values (e.g. \href{https://datapackage.org/standard/extensions/}{extensions}).
 }
 \examples{
-package <- example_dataset()
+package <- example_package()
 version(package)
 }
 \concept{version functions}

From 363216382c2f6a4bf483abbbd3218d9edb5bfe03 Mon Sep 17 00:00:00 2001
From: Peter Desmet <600993+peterdesmet@users.noreply.github.com>
Date: Fri, 26 Jun 2026 10:11:32 +0200
Subject: [PATCH 11/12] Use returns

---
 R/version.R | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/R/version.R b/R/version.R
index 68f27e16..639079c6 100644
--- a/R/version.R
+++ b/R/version.R
@@ -9,7 +9,7 @@
 #' https://datapackage.org/standard/extensions/)).
 #'
 #' @inheritParams read_resource
-#' @return Data Package version number (e.g. `1.0`).
+#' @returns Data Package version number (e.g. `1.0`).
 #' @family version functions
 #' @export
 #' @examples

From f98dfd42e54ed371be45f2d575c801c2e3bc7a83 Mon Sep 17 00:00:00 2001
From: Peter Desmet <600993+peterdesmet@users.noreply.github.com>
Date: Sun, 19 Jul 2026 17:17:54 +0200
Subject: [PATCH 12/12] Use quotes

---
 R/version.R    | 2 +-
 man/version.Rd | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/R/version.R b/R/version.R
index 639079c6..9d1f1038 100644
--- a/R/version.R
+++ b/R/version.R
@@ -9,7 +9,7 @@
 #' https://datapackage.org/standard/extensions/)).
 #'
 #' @inheritParams read_resource
-#' @returns Data Package version number (e.g. `1.0`).
+#' @returns Data Package version number (e.g. `"1.0"`).
 #' @family version functions
 #' @export
 #' @examples
diff --git a/man/version.Rd b/man/version.Rd
index 5108d8cf..611b548f 100644
--- a/man/version.Rd
+++ b/man/version.Rd
@@ -11,7 +11,7 @@ version(package)
 \code{\link[=create_package]{create_package()}}.}
 }
 \value{
-Data Package version number (e.g. \code{1.0}).
+Data Package version number (e.g. \code{"1.0"}).
 }
 \description{
 Determines what version of the \href{https://datapackage.org/}{Data Package standard} is used by a Data Package, based on the