(ed) Please number the figures and examples etc.

[Nat Sakimura]

It will make the referencing easier.

[Michael Jones]

We haven’t done this in our other final specs - for example see https://openid.net/specs/openid-connect-registration-1_0.html#RegistrationRequest .

[Nat Sakimura]

Just above 3.2, there are two examples. Without numbering it, it is difficult to refer to which one.

‌

The following is a non-normative example of a trust_marks_issuers claim value:

{
  "https://openid.net/certification/op": ["*"],
  "https://refeds.org/wp-content/uploads/2016/01/Sirtfi-1.0.pdf":
    ["https://swamid.se"]
}

The following is a non-normative example of an Entity Statement before serialization and adding a signature. The example contains a critical extension jti (JWT ID) to the Entity Statement and one critical extension to the policy language regexp (Regular expression).

{
  "iss": "https://feide.no",
  "sub": "https://ntnu.no",
  "iat": 1516239022,
  "exp": 1516298022,
  "crit": ["jti"],
  "jti": "7l2lncFdY6SlhNia",
  "policy_language_crit": ["regexp"],
  "metadata": {
    "openid_provider": {
      "issuer": "https://ntnu.no",
      "organization_name": "NTNU",
    },
    "oauth_client": {
      "organization_name": "NTNU"
    }
  },
  "metadata_policy": {
    "openid_provider": {
      "id_token_signing_alg_values_supported":
        {"subset_of": ["RS256", "RS384", "RS512"]},
      "op_policy_uri": {
        "regexp":
          "^https:\/\/[\\w-]+\\.example\\.com\/[\\w-]+\\.html"}
    },
    "oauth_client": {
      "grant_types": {
        "subset_of": ["authorization_code", "client_credentials"]},
      "scope": {
        "subset_of": ["openid", "profile", "email", "phone"]}
    }
  },
  "constraints": {
    "max_path_length": 2
  },
  "jwks": {
    "keys": [
      {
        "alg": "RS256",
        "e": "AQAB",
        "key_ops": ["verify"],
        "kid": "key1",
        "kty": "RSA",
        "n": "pnXBOusEANuug6ewezb9J_...",
        "use": "sig"
      }
    ]
  }
}

‌

[John Bradley]

We should do this before taking the spec final. We should not do this right now as text and diagrams may still move around in the editing process.

[Giuseppe De Marco]

Resolved by https://bitbucket.org/openid/connect/pull-requests/642

[Michael Jones]

Fixed by https://bitbucket.org/openid/connect/pull-requests/642