Promote "Metadata in Table Schema" recipe to the specs.

README.md

@@ -4,7 +4,7 @@ Data Package is a standard consisting of a set of simple yet extensible specific
 
 ## Contributing
 
-One can contribute by clicking on the "Edit Page" button on a site page and create a pull request directly on Github.
+One can contribute to the documentation by clicking on the "Edit Page" button on a site page and create a pull request directly on Github.
 
 Running the project locally:
 

assets/styles.css

@@ -49,3 +49,7 @@ body::-webkit-scrollbar-track {
     text-decoration: underline;
   }
 }
+
+article.card {
+  border-radius: 15px;
+}

astro.config.js

@@ -15,6 +15,8 @@ export default defineConfig({
   integrations: [
     starlight({
       title: "Data Package Standard",
+      description:
+        "Data Package is a standard consisting of a set of simple yet extensible specifications to describe datasets, data files and tabular data. It is a data definition language (DDL) and data API that facilitates findability, accessibility, interoperability, and reusability (FAIR) of data.",
       logo: {
         light: "/assets/logo-light.svg",
         dark: "/assets/logo-dark.svg",
@@ -32,6 +34,7 @@ export default defineConfig({
       customCss: ["/assets/styles.css"],
       tableOfContents: { minHeadingLevel: 2, maxHeadingLevel: 5 },
       components: {
+        MarkdownContent: "./components/MarkdownContent.astro",
         SocialIcons: "./components/SocialIcons.astro",
       },
       plugins: [

components/About.astro

@@ -12,9 +12,8 @@ const { title } = Astro.props
 <article class="sl-flex not-content" aria-labelledby="about-astro-heading">
   <small id="about-astro-heading">
     {title}
-    <span class="sr-only">Astro</span>
   </small>
-  <Image src={funding.okfn} alt="Open Knowledge Foundation" />
+  <div><Image src={funding.okfn} alt="Open Knowledge Foundation" /></div>
   <slot />
 </article>
 
@@ -37,4 +36,13 @@ const { title } = Astro.props
   svg {
     width: 15rem;
   }
+  img {
+    border-radius: 15px;
+  }
+  div {
+    padding: 5px;
+    padding-bottom: 0;
+    border-radius: 15px;
+    border: dashed 1px #ccc;
+  }
 </style>

components/MarkdownContent.astro

@@ -0,0 +1,12 @@
+---
+import type { Props } from "@astrojs/starlight/props"
+import Default from "@astrojs/starlight/components/MarkdownContent.astro"
+---
+
+<Default {...Astro.props}><slot /></Default>
+
+<script>
+  import { addBackToTop } from "vanilla-back-to-top"
+
+  addBackToTop({ backgroundColor: "#3272C2", scrollDuration: 200 })
+</script>

components/SocialIcons.astro

@@ -8,7 +8,6 @@ import Default from "@astrojs/starlight/components/SocialIcons.astro"
 >
 <a href="https://specs.frictionlessdata.io/"><strong>v1</strong></a>
 
-<!-- Render the default social links. -->
 <Default {...Astro.props}><slot /></Default>
 
 <!-- Add styles to mimic the default links appearance. -->

content/docs/blog/2023-11-15-v2-announcement.md

@@ -8,6 +8,10 @@ authors:
   - sapetti9
 ---
 
+:::note
+Originally published on: https://frictionlessdata.io/blog/2023/11/15/frictionless-specs-update/
+:::
+
 We are very pleased to announce that thanks to the generous support of [NLnet](https://nlnet.nl/) we have kickstarted the [Data Package (v2)](https://specs.frictionlessdata.io/) update.
 
 After a first discussion with the community in [the last call](https://frictionlessdata.io/blog/2023/11/06/community-call/), we are setting up a working group to help us with the v2 release.
@@ -70,7 +74,3 @@ This project is funded through [NGI0 Entrust](https://nlnet.nl/entrust), a fund
 
 [<img src="https://nlnet.nl/logo/banner.png" alt="NLnet foundation logo" width="20%" />](https://nlnet.nl)
 [<img src="https://nlnet.nl/image/logos/NGI0_tag.svg" alt="NGI Zero Logo" width="20%" />](https://nlnet.nl/entrust)
-
-:::note
-Originally published on: https://frictionlessdata.io/blog/2023/11/15/frictionless-specs-update/
-:::

content/docs/blog/2024-06-26-v2-release.md

@@ -0,0 +1,52 @@
+---
+title: Data Package (v2) is released!
+date: 2024-06-26
+excerpt: We are very excited to announce the release of the version 2.0 of the Data Package standard (previously known as Frictionless Specs). Thanks to the generous support of NLnet from November last year we were able to focus on reviewing Data Package in order to include features that were often requested throughout the years and improve extensibility for domain-specific implementations.
+tags:
+  - news
+authors:
+  - sapetti9
+---
+
+:::note
+Originally published on: https://frictionlessdata.io/blog/2024/06/26/datapackage-v2-release/
+:::
+
+We are very excited to announce the release of version 2.0 of the Data Package standard (previously known as Frictionless Specs). Thanks to the generous support of [NLnet](https://nlnet.nl/), starting [from November last year](https://frictionlessdata.io/blog/2023/11/15/frictionless-specs-update/#additional-deliverables), we were able to focus on reviewing Data Package in order to include features that were often requested throughout the years and improve extensibility for domain-specific implementations.
+
+Data Package is a standard for data containerisation, which consists of a set of simple yet extensible specifications to describe datasets, data files and tabular data. It is a data definition language (DDL) and data API that enhances data FAIRness (findability, accessibility, interoperability, and reusability). Since its initial release in 2007, the community has suggested many features that could improve or extend the standard for use cases that weren't initially envisioned. Those were sometimes adopted, but there wasn't a versioning or governance process in place to truly evolve the standard.
+
+We started with [the issues that had accumulated in the GitHub repository](https://github.com/frictionlessdata/datapackage/issues) to build our Roadmap for v2. Many of the requested features are now adopted, making Data Package the answer for even more use cases.
+
+In parallel we assembled an outstanding Data Package Working Group composed of experts from the community. We carefully selected a diverse group of people who brought different use-cases, formats, and data types that we would need the Standard to support. Together with them, we crafted [a governance model](https://datapackage.org/overview/governance/) that is explicit, in order to create an environment that adequately supports new contributions and ensures project sustainability.
+
+We would like to thank each one of them for their remarkable contribution and for the incredibly insightful conversations we had during these months. Thank you to my colleague Evgeny Karev, Peter Desmet from the [Research Institute for Nature and Forest (INBO)](https://www.vlaanderen.be/inbo/en-gb/homepage/), Phil Schumm from [CTDS - University of Chicago](https://ctds.uchicago.edu/), Kyle Husmann from the [PennState University](https://www.psu.edu/), Keith Hughitt from the [National Institutes of Health](https://www.nih.gov/), Jakob Voß from the [Verbundzentrale des GBV (VZG)](https://www.gbv.de/), Ethan Welty from the [World Glacier Monitoring Service](https://wgms.ch/), Paul Walsh from [Link Digital](https://linkdigital.com.au/), Pieter Huybrechts from the [Research Institute for Nature and Forest (INBO)](https://www.vlaanderen.be/inbo/en-gb/homepage/), Martin Durant from [Anaconda, inc.](https://www.anaconda.com/), Adam Kariv from [The Public Knowledge Workshop](https://www.hasadna.org.il/), Johan Richer from [Multi](https://www.multi.coop/?locale=fr), and Stephen Diggs from the [University of California Digital Library](https://cdlib.org/).
+
+If you are curious about the conversations we had during the Standard review, they are all captured (and recorded) in [the blog summaries of the community calls](https://frictionlessdata.io/blog/). Alternatively you can also check out the [closed issues on GitHub](https://github.com/frictionlessdata/datapackage/milestone/6?closed=1).
+
+## So what is new in version 2?
+
+During these months we have been working on the core specifications that compose the Standard, namely: [Data Package](https://datapackage.org/standard/data-package/) – a simple container format for describing a coherent collection of data in a single ‘package’, [Data Resource](https://datapackage.org/standard/data-resource/) to describe and package a single data resource, [Table Dialect](https://datapackage.org/standard/table-dialect/) to describe how tabular data is stored in a file, and [Table Schema](https://datapackage.org/standard/table-schema/) to declare a schema for tabular data.
+
+During the update process we tried to be as little disruptive as possible, avoiding breaking changes when possible.
+
+We put a lot of effort into removing ambiguity, cutting or clarifying under-defined features, and promoting some well-oiled recipes into the Standard itself. An example of a recipe (or pattern, as they were called in v1) that has been promoted to the Standard is the [Missing values per field](https://specs.frictionlessdata.io/patterns/#missing-values-per-field). We also added a versioning mechanism, support for categorical data, and changes that make it easier to extend the Standard.
+
+If you would like to know the details about what has changed, see the [Changelog](https://datapackage.org/overview/changelog/) we published.
+
+To increase and facilitate adoption, we published a [metadata mapper written in Python](https://github.com/frictionlessdata/dplib-py). We have also worked on Data Package integrations for the most notable open data portals out there. Many people from the community use Zenodo, so we definitely wanted to target that. They have recently migrated their infrastructure to [Invenio RDM](https://inveniordm.web.cern.ch/) and we proposed a Data Package serializer for better integration with the Standard (more info on this integration will be announced in an upcoming blog!). We also created a pull request that exposes `datapackage.json` as a metadata export target in the [Open Science Framework](https://www.cos.io/) system, and built an extension that adds a `datapackage.json` endpoint to every dataset in [CKAN](https://github.com/frictionlessdata/ckanext-datapackage).
+
+If you want to know more about how to coordinate a standard update, we shared our main takeaways at FOSDEM 2024. The presentation was recorded, and you can watch it [here](https://fosdem.org/2024/schedule/event/fosdem-2024-3109-updating-open-data-standards/).
+
+## And what happens now?
+
+While the work on Data Package 2.0 is done (for now!), we will keep working on the [Data Package website and documentation](https://datapackage.org/) together with the Working Group, to make it as clear and straightforward as possible for newcomers. In parallel, we will also start integrating the version 2 changes in the [software implementations](https://datapackage.org/overview/software/)).
+
+Would you like to contribute? We always welcome new people to the project! Go and have a look at our [Contribution page](https://frictionlessdata.io/work-with-us/contribute/) to understand the general guideline. Please get in touch with us by joining [our community chat on Slack](https://frictionlessdata.io/development/roadmap/) (also accessible via [Matrix](https://matrix.to/#/#frictionlessdata:matrix.okfn.org)), or feel free to jump in any of [the discussions on GitHub](https://github.com/frictionlessdata/datapackage/issues).
+
+## Funding
+
+This project was funded through [NGI0 Entrust](https://nlnet.nl/entrust), a fund established by [NLnet](https://nlnet.nl) with financial support from the European Commission's [Next Generation Internet](https://ngi.eu) program. Learn more at the [NLnet project page](https://nlnet.nl/project/FrictionlessStandards/).
+
+[<img src="https://nlnet.nl/logo/banner.png" alt="NLnet foundation logo" width="20%" />](https://nlnet.nl)
+[<img src="https://nlnet.nl/image/logos/NGI0_tag.svg" alt="NGI Zero Logo" width="20%" />](https://nlnet.nl/entrust)

content/docs/index.mdx

@@ -1,7 +1,5 @@
 ---
 title: Data Package
-description: |
-  Data Package standard.
 template: splash
 editUrl: false
 hero:
@@ -29,8 +27,8 @@ hero:
 banner:
   content: |
     <p>
-      This is a live draft of the <strong>Data Package (v2) standard</strong>.
-      Please read the <a href="/blog/2023-11-15-v2-announcement">announcement</a>.
+      The <strong>Data Package (v2)</strong> standard has been released on June 26, 2024.
+      See the <a href="/blog/2024-06-26-v2-release/">announcement</a> and <a href="/overview/changelog/">changelog</a> for details.
     </p>
 ---
 
@@ -68,9 +66,11 @@ The Data Package standard is a comprehensive set of **specifications** that coll
 
 Data Package is backed by a suite of software tools supporting the standard. From the no-code visual tool **Open Data Editor** to low-level drivers for 10 programming languages -- [EXPLORE THE SOFTWARE](/overview/software)
 
-[![Open Data Editor](../../assets/software/ode.png)](https://opendataeditor.okfn.org)
-
-<div style="margin-bottom: 5em"></div>
+<div style="margin-top: 10px; margin-bottom: 5em; padding: 5px; border: dashed 1px #ccc; border-radius: 15px">
+  <a href="https://opendataeditor.okfn.org/">
+    <img src="/ode.png" style="border-radius: 15px" />
+  </a>
+</div>
 
 <h2>Adoption</h2>
 
@@ -82,7 +82,7 @@ Data Package is used for a wide range of scenarios where this standardized data
 
 <h2>Documentation</h2>
 
-Read the Data Package documentation to learn more about the standard:
+Read the Data Package documentation to learn more about the project:
 
 <CardGrid>
   <LinkCard title="Standard" href="/standard/data-package" />