add specification subheadings

website/docs/specification/Architecture.md

@@ -9,6 +9,7 @@ import Disclaimer from '../\_disclaimer.mdx';
 
 ## Overview
 
+The architecture is the blueprint for all the components of the specification and how they work together. It defines the **design principles** which underpin the UNTP and shows the components working together from the perspective of a **single actor** and across the **entire value-chain**. The UNTP is a fundamentally **decentralised architecture** with no central store of data.
 
 ## Principles
 

website/docs/specification/Confidentiality.md

@@ -7,4 +7,22 @@ import Disclaimer from '../\_disclaimer.mdx';
 
 <Disclaimer />
 
-# Confidentiality
+# Overview
+
+There is a balance between the demands of transparency (more supply chain visibility means it's harder to hide greenwshing) and confidentiality (share too much data and you risk expososing commercial secrets). A key UNTP principle is that every supply chain actor should be able to choose their own balance between transparency and confidentiality. To achieve this, UNTP defines six data confidentiality patterns with different degrees of data protection so that they can be appropriately combined to meet the confidentiality goals of each party. This includes the ability to selectively redact data from credentials received from upstream suppliers before passing them on to downstream buyers - without affecting the cryptographic integrity of the data. 
+
+## Discoverable Public Data
+
+## Public Data with GUID key
+
+## Encrypted Data with Shared Key
+
+## Encrypted Data with Requestable Key
+
+## Selective Redaction
+
+## Private Data
+
+## Usage Patterns
+
+

website/docs/specification/ConformityCredential.md

@@ -7,9 +7,17 @@ import Disclaimer from '../\_disclaimer.mdx';
 
 <Disclaimer />
 
-# Conformity Credential
+## Overview
+
+Conformity credentials are usually issued by independent third parties and provide a **trusted assessment** of product ESG performance against credible **standards or regulations**. As such the credential provides trusted verification of the ESG claims in the passport. Since the passport may make several independent claims (eg emissions intensity, deforestation free, fair work, etc) there may be many linked conformity credentials referenced by one passport. As an additional trust layer, the conformity credential may reference an **accreditation** credential that attests to the authority of the third party to perform the specific ESG assessments. The conformity credential data model has been developed by a separate UN/CEFACT project on digital conformity that has expert membership from accreditation authorities and conformity assessment bodies.
+
+## Data Model
 
 ![Conformity Credential](ConformityCredential.svg)
 
-[Conformity Credential Documentation](https://jargon.sh/user/unece/ConformityCredential/v/working/artefacts/readme/render
+[Conformity Credential Documentation](https://jargon.sh/user/unece/ConformityCredential/v/working/artefacts/readme/render)
+
+## JSON Schema
+
+
 

website/docs/specification/Counterfeiting.md

@@ -1,10 +1,23 @@
 ---
 sidebar_position: 45
-title: Counterfeiting
+title: Anti-Counterfeiting
 ---
 
 import Disclaimer from '../\_disclaimer.mdx';
 
 <Disclaimer />
 
-# Anti Counterfeiting Measures
+## Overview
+
+As the value of genuinely sustainable goods increases, so do the incentives to sell fake goods as the real thing. UNTP defines a simple and decentralised anti-counterfeiting protocol that can be implemented by any producer at very low cost. It builds upon the W3C DID standard by issuing a unique DID (and corresponding keypair) for every serialised (individual or batch) product. The DID (and therefore the public key) is discoverable from the product serial number using the standard link resolver protocol. The item/batch level DID is cryptographically linked to the product class level DID The private key is discoverable from a QR code hidden inside the product packaging. Scanning the QR provides the necessary key to update the individual serialised product public status to indicate consumption. Attackers that copy genuine serial numbers will find that their products are quickly identifiable as fakes. Attackers that try to create new serial numbers will not be able to create valid links to the genuine product class. The UNTP anti-counterfeiting protocol provides additional value/incentive for UNTP uptake beyond ESG integrity.
+
+## Product Serial DID
+
+## Product Serial VC
+
+## Brand Trust Root
+
+## Public Verification
+
+## Private Acquittal
+

website/docs/specification/DataCarriers.md

@@ -7,4 +7,25 @@ import Disclaimer from '../\_disclaimer.mdx';
 
 <Disclaimer />
 
-# LData Carriers
+## Overview
+
+Digital data needs to be linked to the physical product it describes and should be discoverable through the identifiers printed on that product serial or batch number. For high volume goods and easy / reliable discovery, these identifiers are already typically represented as barcodes, matrix codes, QR codes, or RFID encoded data. UNTP supports the use of these existing data carriers. A basic UNTP principle is that if you have a product then you should be able to find ESG data about that product even when the identifier is not a web link. Therefore, the UNTP defines a generalised protocol (based on [GS1 digital link](https://www.gs1.org/standards/gs1-digital-link)) to allow any identifier scheme (GS1 or otherwise) to be consistently resolvable so that product passports and other data can always be accessed from the identifier of the product. The UNTP also defines a specific QR based data carrier format for use on paper/PDF versions of conformity credentials or other trade documents that provides secure access to credentials in a way that is both human and machine readable.  This provides a simple but powerful mechanism to facilitate uptake of digital solutions alongside existing paper/PDF based frameworks.
+
+## Digital Link Resolvers
+
+
+## Link Vocabulary
+
+
+## 1D Barcodes
+
+
+## 2d Matrix Codes
+
+
+## QR Codes
+
+
+## RFID Codes
+
+

website/docs/specification/DigitalProductPassport.md

@@ -7,6 +7,17 @@ import Disclaimer from '../\_disclaimer.mdx';
 
 <Disclaimer />
 
-# Digitial Product Passport
+## Overview
+
+The digital product passport (DPP) is issued by the shipper of goods and is the carrier of **product and sustainability information** for every serialised product item (or product batch) that is shipped between actors in the value chain. It is deliberately **simple and lightweight** and is designed to carry the minimum necessary data at the **granularity** needed by the receiver of goods - such as the scope 3 emissions in a product shipment. The passport contains links to **conformity credentials** which add trust to the ESG claims in the passport. The passport also contains links to **traceability events** which provide the "glue" to follow the linked-data trail (subject to confidentiality constraints) from finished product back to raw materials. The UNTP DPP does not conflict with national regulations such as the EU DPP.  In fact, it can usefully be conceptualised as the **upstream B2B feedstock** that provides the data and evidence needed for the issuing of high quality national level product passports.
+
+## Data Model
+
+![Digital Product Passport data model](DigitalProductPassport.svg)
+
+[Browsable data model documentation](https://jargon.sh/user/unece/DigitalProductPassport/v/working/artefacts/readme/render)
+
+## JSON Schema 
+
+
 
-[Digital Product passport Schema](https://jargon.sh/user/unece/DigitalProductPassport/v/0.0.1)

website/docs/specification/GS1Binding.md

@@ -7,4 +7,6 @@ import Disclaimer from '../\_disclaimer.mdx';
 
 <Disclaimer />
 
-# Binding GS1 standards to the UNTP
+## Overview
+
+The UNTP is agnostic of any technology or any identifier system. Nevertheless, GS1 is by far the most widely used scheme for product identification, particularly at the downstream / consumer end of the value chain. Billions of unique product/shipment identifiers have been issued and over 5 billion product barcode scans happen around the world every day. UNTP does not require any actor to adopt GS1 standards and identifiers, but it certainly must facilitate existing GS1 users to adopt the UNTP. To this end, the UNTP defines a specific binding that shows how existing GS1 users can leverage their existing investments when implementing the UNTP.

website/docs/specification/Identifiers.md

@@ -7,4 +7,17 @@ import Disclaimer from '../\_disclaimer.mdx';
 
 <Disclaimer />
 
-# Identifiers
+## Overview
+
+Identifiers of **businesses** (eg tax registration numbers), of **locations** (eg google pins or cadastral/lot numbers), and of **products** (eg GS1 GTINs or other schemes) are ubiquitous throughout supply chains and underpin the integrity of the system. UNTP builds upon existing identifier schemes without precluding the use of new schemes so that existing investments and high integrity registers can be leveraged. UNTP requires four key features of the identifiers and, for those that don't already embody these features, provides a framework to uplift the identifier scheme to meet UNTP requirements. Identifiers used in UNTP implementations should be **discoverable** (ie easily read by scanning a barcode, QR code, or RFID), **globally unique** (ie by adding a domain prefix to local schemes), **resolvable** (ie given an identifier, there is a standard way to find more data about the identified thing), and **verifiable** (ie ownership of the identifier can be verified so that actors cannot make claims about identifiers they don't own). 
+
+## Discoverability
+
+
+## Global Uniqueness
+
+
+## Resolvability
+
+
+## Verifiability 

website/docs/specification/MassBalance.md

@@ -7,4 +7,8 @@ import Disclaimer from '../\_disclaimer.mdx';
 
 <Disclaimer />
 
-# Mass Balance 
+## Overview
+
+Mass balance fraud is a particularly challenging greenwashing vector. It happens when a fraudulent actor buys a small quantity of high ESG integrity inputs (eg genuine carbon neutral, organic, deforestation free cotton) and mixes that input with lower quality alternatives and then sells the full volume of manufactures product (eg woven cotton fabric) as sustainable product, re-using the valid credentials from the niche supply. The UNTP solution to this problem involves trusted third parties (certifiers or industry associations) to act as quota managers that issue "guarantee of origin" credentials (a type of conformity credential). In this model, the guarantee of origin certificate for 10 Tons of cotton fabric (for example) can only be issued when the third party has evidence of the purchase of at least 10 Tons sustainable input materials. The third party will also mark the input batch as consumed (in a similar way to the anti-counterfeiting protocol) so that the valid sustainble input cannot be re-presented to a different third party.
+
+

website/docs/specification/Rules.md

@@ -7,4 +7,6 @@ import Disclaimer from '../\_disclaimer.mdx';
 
 <Disclaimer />
 
-# ESG Standards & Regulations
+## Overview
+
+Yet another greenwashing attack vector is to deliberately apply incorrect rules to the determination of criteria such as emissions intensity. The verification question in this case is "yes, but how do I know you calculated it right?". The UNTP proposes an independent calculator service offered either by the standards body or regulator that defined the rules or by an accredited service provider. The Supply chain actor presents raw data to the calculator which returns with a signed credential confirming that the rules were correctly applied. This protocol has an additional benefit for legitimate actors if widely adopted by rules authorities - which is to significantly simplify the assessment of compliance against multiple different rules. By separating observed facts from the assessment of those facts against specific rules then it becomes relatively simple to test compliance against multiple standards and regulations.

website/docs/specification/TraceabilityEvents.md

@@ -7,6 +7,15 @@ import Disclaimer from '../\_disclaimer.mdx';
 
 <Disclaimer />
 
-# Traceability Events
+## Overview
+
+Traceability events are very lightweights collections of identifiers that specify the “what, when, where, why and how” of the products and facilities that constitute a value chain. The UNTP is based on the [GS1 EPCIS](https://www.gs1.org/standards/epcis) standard for this purpose because it is an existing and proven mechanism for supply chain traceability. Note that UNTP supports but does not require the use of GS1 identifiers. The basic idea behind the traceability event structure is that any supply chain of any complexity can always be accurately modelled using a combination of four basic event types. An **object** event describes an action on specific product(s) such as an inspection. A **transaction** event describes the exchange of product(s) between two actors such as sale of goods between seller and buyer. An **aggregation** event describes that consolidation or de-consolidation of products such as stacking bales of cotton on a pallet for transportation. Finally, a **transformation** event describes a manufacturing process that consumes input product(s) to create new output product(s). The UNTP uses these events in a decentralised architecture as the means to traverse the linked-data "graph" that represents the entire value-chain.
+
+## Data Model
+
+![Data Model](TraceabilityEvents.svg)
+
+[Traceability Events Documentation](https://jargon.sh/user/unece/traceabilityEvents/v/working/artefacts/readme/render)
+
+## JSON Schema
 
-[Traceability Events Schema](https://jargon.sh/user/unece/traceabilityEvents/v/0.0.1)

website/docs/specification/TrustAnchors.md

@@ -7,4 +7,16 @@ import Disclaimer from '../\_disclaimer.mdx';
 
 <Disclaimer />
 
-# Trust Anchors
+## Overview
+
+UNTP credentials will include identifiers of products, locations or businesses.  UNTP credentials will also include ESG performance claims like emissions intensity values. But how can a verifier of these identifiers or ESG claims be confident that the claims are true and that they are made by the genuine party at a verifiable location? Trust anchors are national or international authorities that typically run existing business or product registration, certification, accreditation, or other high integrity processes. Examples of trust anchors include national regulators that govern things like land ownership or business registrations. Another example are the national accreditation bodies that audit and accredit certifiers to issue third party assessments. UNTP depends on trust anchors to add digital integrity to ESG claims and identities by linking them to the authority under which they are made. In essence, UNTP defines a protocol for existing trust anchors to continue doing what they have always done, but in a digitally verifiable way.
+
+## VC Representation
+
+## Public Web Representation
+
+## Identity Credentials
+
+## Accreditation Credentials
+
+

website/docs/specification/TrustGraphs.md

@@ -7,4 +7,12 @@ import Disclaimer from '../\_disclaimer.mdx';
 
 <Disclaimer />
 
-# Trust Graphs
+## Overview
+
+The ESG footprint of a finished product is the aggregation of it's components and processes through the value chain. Verification of ESG claims therefore involves assessing a bundle of linked credentials (aka a "trust graph") drawn from all or part of a value chain. Whilst each credential may be valid in it's own right, one challenge is verifying the context of related credentials. For example, a conformity assessment body that is accredited to test strength of structured steel might not be accredited to issue emissions intensity certificates. A technically valid emissions certificate linked to a technically valid accreditation certificate that has a different scope would be fraudulent. To address this problem, the UNTP defines a simple method to verify the contextual scope of linked credentials. Essentially this provides a mechanism to verify a linked graph of data at a layer above individual credential verification.
+
+## Trust Graphs
+
+## JSON-LD Representation 
+
+## SCHACL Graph verification

website/docs/specification/VerifiableCredentials.md

@@ -7,4 +7,17 @@ import Disclaimer from '../\_disclaimer.mdx';
 
 <Disclaimer />
 
-# Verifiable Credential Interoperability Profile
+# Overview
+
+The World-Wide-Web Consortium (W3C) has defined a standard called [Verifiable Credentials (VCs)](https://www.w3.org/TR/vc-data-model/). A VC is a portable digital version of everyday credentials like education certificates, permits, licenses, registrations, and so on. VCs are digitally signed by the issuing party and are tamper proof, privacy preserving, revokable, and digitally verifiable. The UN has previously assessed this standard and has recommended it's use for a variety of cross border trade use cases in a recent [white paper](https://unece.org/trade/documents/2023/10/white-paper-edata-verifiable-credentials-cross-border-trade). VCs are inherently decentralised and so are an excellent fit for UNTP which recommends that passports, credentials, and traceability events are all issued as W3C VCs. A related W3C standard called [Decentralised Identifiers (DIDs)](https://www.w3.org/TR/did-core/) provides a mechanism to manage the cryptographic keys used by verifiable credentials and also to link multiple credentials into verifiable trust graphs. DIDs are not the same as the business / product / location identifiers maintained by authoritative agencies - but can be linked to them. 
+
+## W3C VC Interoperability Profile
+
+
+## W3C DID Interoperability Profile
+
+
+## Hyperledger AnonCreds Interoperability Profile
+
+
+

website/docs/specification/Vocabularies.md

@@ -7,4 +7,13 @@ import Disclaimer from '../\_disclaimer.mdx';
 
 <Disclaimer />
 
-# Sustainability Vocabulary
+## Overview
+
+Web **vocabularies** are a means to bring consistent understanding of **meaning** to ESG claims and assessments throughout transparent value chains based on UNTP. There are hundreds of ESG standards and regulations around the world, each with dozens or hundreds of specific conformity **criteria**. Any given value chain from raw materials to finished product is likely to include dozens of passports and conformity credentials issued against any of thousands of ESG criteria. Without a consistent means to make sense of this data, UNTP would provide a means to discover a lot of data but no easy way to make sense of it. The UNTP defines a standard and extensible topic map (taxonomy) of ESG criteria and provides a mechanism for any standards authority, or national regulator, or industry association to map their specific terminology to the UNTP vocabulary.
+
+## UN ESG Topic Map
+
+
+## ESG Standards Criteria
+
+