From 861fa374ccf2b7c1700feb95b1b165f914b8a0d4 Mon Sep 17 00:00:00 2001
From: fmarino-ipzs <fa.marino@ipzs.it>
Date: Thu, 13 Jul 2023 10:28:55 +0200
Subject: [PATCH] chore: closes #46

---
 docs/en/index.rst          |  2 +-
 docs/en/pid-data-model.rst | 15 ++++++++++++---
 2 files changed, 13 insertions(+), 4 deletions(-)

diff --git a/docs/en/index.rst b/docs/en/index.rst
index ad326c8d7..5e806f649 100644
--- a/docs/en/index.rst
+++ b/docs/en/index.rst
@@ -60,7 +60,7 @@ Index of content
 ----------------
 
 .. toctree:: 
-   :maxdepth: 2
+   :maxdepth: 3
    
    ssi-introduction.rst
    defined-terms.rst
diff --git a/docs/en/pid-data-model.rst b/docs/en/pid-data-model.rst
index 0b9533d55..270bc85ab 100644
--- a/docs/en/pid-data-model.rst
+++ b/docs/en/pid-data-model.rst
@@ -48,7 +48,8 @@ The Disclosures are sent to the Holder together with the SD-JWT in the *Combined
 
 See `[draft-terbu-sd-jwt-vc-latest] <https://vcstuff.github.io/draft-terbu-sd-jwt-vc/draft-terbu-oauth-sd-jwt-vc.html>`_ and `[SD-JWT] <https://datatracker.ietf.org/doc/html/draft-ietf-oauth-selective-disclosure-jwt-04>`__ for more details. 
 
-
+SD-JWT parameters
+-----------------
 
 The JOSE header contains the following mandatory parameters:
 
@@ -114,7 +115,11 @@ The following claims MUST be in the JWT payload and MUST NOT be included in the
             -   **claims**.
       - `[OIDC.IDA. Section 5] <https://openid.net/specs/openid-connect-4-identity-assurance-1_0-13.html#section-5>`_.
 
-The ``verification`` claim contain the information as sub claims regarding the identity proofing evidence during the issuing phase of the PID. The ``claims`` parameter contains the user attributes claims. Some of these additional claims MAY be included in the Disclosures and MAY be selectively disclosed and they are given in the following tables that also specify whether a claim is selectively disclosable (SD) or not (NSD).
+
+Verification field 
+------------------
+
+The ``verification`` claim contain the information as sub claims regarding the identity proofing evidence during the issuing phase of the PID.  Some of these additional claims MAY be included in the Disclosures and MAY be selectively disclosed and they are given in the following tables that also specify whether a claim is selectively disclosable (SD) or not (NSD).
 
 The ``verification`` claim is a JSON structure with all the following mandatory sub-claims.
 
@@ -162,7 +167,11 @@ The ``record`` MUST have at least the following sub parameters:
 .. warning::
   Note that the sub-claims of the **evidence** parameter are not selectively disclosable separately, thus, for example, the User cannot give only the *record type* without disclosure the *record source* (organization name, identifier and country that hendles the User identity proofing). 
 
-Finally, the ``claims`` parameter contains the following mandatory claims:
+Claims field 
+------------
+
+The ``claims`` parameter contains the user attributes claims with the following mandatory fields:
+
 
 .. list-table:: 
     :widths: 20 60 20