Docs improvements (#2738) * Consistency in naming * replace go (#1529)

Co-authored-by: chiarapaskulin <chiarapaskulin@users.noreply.github.com> Co-authored-by: mewmba <mewmba@users.noreply.github.com>

Author: mewmba

dart/lib/src/proto/services/trust-registry/v1/trust-registry.pb.dart

@@ -6395,7 +6395,7 @@
  "services.trustregistry.v1.GetMemberAuthorizationStatusRequest": {
  "name": "GetMemberAuthorizationStatusRequest",
  "full_name": "services.trustregistry.v1.GetMemberAuthorizationStatusRequest",
- "description": "Request to fetch member status in governance framework for a specific credential schema.",
+ "description": "Request to fetch member status in Trust Registry for a specific credential schema.",
  "fields": [
  "services.trustregistry.v1.GetMemberAuthorizationStatusRequest.did_uri",
  "services.trustregistry.v1.GetMemberAuthorizationStatusRequest.schema_uri"
@@ -6416,7 +6416,7 @@
  "services.trustregistry.v1.GetMemberRequest": {
  "name": "GetMemberRequest",
  "full_name": "services.trustregistry.v1.GetMemberRequest",
- "description": "Request to get a member of the governance framework",
+ "description": "Request to get a member of the Trust Registry",
  "fields": [
  "services.trustregistry.v1.GetMemberRequest.did_uri",
  "services.trustregistry.v1.GetMemberRequest.wallet_id",
@@ -6484,7 +6484,7 @@
  "services.trustregistry.v1.UnregisterMemberRequest": {
  "name": "UnregisterMemberRequest",
  "full_name": "services.trustregistry.v1.UnregisterMemberRequest",
- "description": "Request to unregister a member as a valid issuer of a specific credential schema.\nOnly one of `did_uri`, `wallet_id`, or `email` may be specified.",
+ "description": "Request to unregister a member as a valid issuer of a specific credential schema.\nOnly one of `did_uri`, `wallet_id`, or `email` may be specified.\nThe URI of the credential schema must be specified.",
  "fields": [
  "services.trustregistry.v1.UnregisterMemberRequest.did_uri",
  "services.trustregistry.v1.UnregisterMemberRequest.wallet_id",
@@ -10333,7 +10333,10 @@
  "label": "LABEL_OPTIONAL",
  "type": "string",
  "full_type": "string",
- "description": "The ID of the item in the wallet that contains the credential offer"
+ "description": "The ID of the credential offer (Parameter ID inside the JSON document)",
+ "options": {
+ "services.options.optional": true
+ }
  },
  "services.verifiablecredentials.v1.AcceptCredentialResponse.document_json": {
  "name": "document_json",
@@ -10373,31 +10376,43 @@
  "label": "LABEL_OPTIONAL",
  "type": "bool",
  "full_type": "bool",
- "description": "If true, a short URL link will be generated that can be used to share the credential offer with the holder.\nThis link will point to the credential offer in the wallet app."
+ "description": "If true, a short URL link will be generated that can be used to share the credential offer with the holder.\nThis link will point to the credential offer in the wallet app.",
+ "options": {
+ "services.options.optional": true
+ }
  },
  "services.verifiablecredentials.v1.CreateCredentialOfferRequest.holder_binding": {
  "name": "holder_binding",
  "full_name": "services.verifiablecredentials.v1.CreateCredentialOfferRequest.holder_binding",
  "label": "LABEL_OPTIONAL",
  "type": "bool",
  "full_type": "bool",
- "description": "If true, the credential will be issued with holder binding by specifying\nthe holder DID in the credential subject"
+ "description": "If true, the credential will be issued with holder binding by specifying\nthe holder DID in the credential subject",
+ "options": {
+ "services.options.optional": true
+ }
  },
  "services.verifiablecredentials.v1.CreateCredentialOfferRequest.include_governance": {
  "name": "include_governance",
  "full_name": "services.verifiablecredentials.v1.CreateCredentialOfferRequest.include_governance",
  "label": "LABEL_OPTIONAL",
  "type": "bool",
  "full_type": "bool",
- "description": "If true, the issued credential will contain an attestation of the issuer's membership in the ecosystem's\ngovernance framework."
+ "description": "If true, the issued credential will contain an attestation of the issuer's membership in the ecosystem's\nTrust Registry.",
+ "options": {
+ "services.options.optional": true
+ }
  },
  "services.verifiablecredentials.v1.CreateCredentialOfferRequest.signature_type": {
  "name": "signature_type",
  "full_name": "services.verifiablecredentials.v1.CreateCredentialOfferRequest.signature_type",
  "label": "LABEL_OPTIONAL",
  "type": "SignatureType",
  "full_type": "services.verifiablecredentials.v1.SignatureType",
- "description": "The type of signature to use when signing the credential. Defaults to `EXPERIMENTAL`."
+ "description": "The type of signature to use when signing the credential. Defaults to `EXPERIMENTAL`.",
+ "options": {
+ "services.options.optional": true
+ }
  },
  "services.verifiablecredentials.v1.CreateCredentialOfferRequest.template_id": {
  "name": "template_id",
@@ -10512,7 +10527,7 @@
  "label": "LABEL_OPTIONAL",
  "type": "bool",
  "full_type": "bool",
- "description": "If true, the issued credential will contain an attestation of the issuer's membership in the ecosystem's\ngovernance framework."
+ "description": "If true, the issued credential will contain an attestation of the issuer's membership in the ecosystem's\nTrust Registry."
  },
  "services.verifiablecredentials.v1.IssueFromTemplateRequest.save_copy": {
  "name": "save_copy",
@@ -10568,7 +10583,10 @@
  "label": "LABEL_OPTIONAL",
  "type": "string",
  "full_type": "string",
- "description": "The ID of the item in the wallet that contains the credential offer"
+ "description": "The ID of the credential offer (Parameter ID inside the JSON document)",
+ "options": {
+ "services.options.optional": true
+ }
  },
  "services.verifiablecredentials.v1.RevealTemplateAttributes.template_attributes": {
  "name": "template_attributes",
@@ -10616,7 +10634,10 @@
  "label": "LABEL_OPTIONAL",
  "type": "bool",
  "full_type": "bool",
- "description": "Send email notification that credential has been sent to a wallet"
+ "description": "Send email notification that credential has been sent to a wallet",
+ "options": {
+ "services.options.optional": true
+ }
  },
  "services.verifiablecredentials.v1.SendRequest.wallet_id": {
  "name": "wallet_id",

dart/lib/src/proto/services/verifiable-credentials/v1/verifiable-credentials.pb.dart

@@ -1064,7 +1064,7 @@ The type of verification to perform
 | Field | Type | Description |
 | ----- | ---- | ----------- |
 | document_json | [string](/reference/proto#string) | The JSON document that contains the credential offer |
-| item_id | [string](/reference/proto#string) | The ID of the item in the wallet that contains the credential offer |
+| item_id | [string](/reference/proto#string) | The ID of the credential offer (Parameter ID inside the JSON document) |
 
 
 
@@ -1128,7 +1128,7 @@ Response to `CheckStatusRequest`
 | template_id | [string](/reference/proto#string) | ID of template to use |
 | values_json | [string](/reference/proto#string) | JSON document string with keys corresponding to the fields of the template referenced by `template_id` |
 | holder_binding | [bool](/reference/proto#bool) | If true, the credential will be issued with holder binding by specifying the holder DID in the credential subject |
-| include_governance | [bool](/reference/proto#bool) | If true, the issued credential will contain an attestation of the issuer's membership in the ecosystem's governance framework. |
+| include_governance | [bool](/reference/proto#bool) | If true, the issued credential will contain an attestation of the issuer's membership in the ecosystem's Trust Registry. |
 | generate_share_url | [bool](/reference/proto#bool) | If true, a short URL link will be generated that can be used to share the credential offer with the holder. This link will point to the credential offer in the wallet app. |
 | signature_type | [SignatureType](/reference/proto#services-verifiablecredentials-v1-SignatureType) | The type of signature to use when signing the credential. Defaults to `EXPERIMENTAL`. |
 
@@ -1202,7 +1202,7 @@ Request to create and sign a JSON-LD Verifiable Credential from a template using
 | values_json | [string](/reference/proto#string) | JSON document string with keys corresponding to the fields of the template referenced by `template_id` |
 | save_copy | [bool](/reference/proto#bool) | Save a copy of the issued credential to this user's wallet. This copy will only contain the credential data, but not the secret proof value. Issuers may use this data to keep track of the details for revocation status. |
 | expiration_date | [string](/reference/proto#string) | The ISO8601 expiration UTC date of the credential. This is a reserved field in the VC specification. If specified, the issued credential will contain an expiration date. https://www.w3.org/TR/vc-data-model/#expiration |
-| include_governance | [bool](/reference/proto#bool) | If true, the issued credential will contain an attestation of the issuer's membership in the ecosystem's governance framework. |
+| include_governance | [bool](/reference/proto#bool) | If true, the issued credential will contain an attestation of the issuer's membership in the ecosystem's Trust Registry. |
 | signature_type | [SignatureType](/reference/proto#services-verifiablecredentials-v1-SignatureType) | The type of signature to use when signing the credential. Defaults to `EXPERIMENTAL`. |
 
 
@@ -1234,7 +1234,7 @@ Response to `IssueFromTemplateRequest`
 | Field | Type | Description |
 | ----- | ---- | ----------- |
 | document_json | [string](/reference/proto#string) | The JSON document that contains the credential offer |
-| item_id | [string](/reference/proto#string) | The ID of the item in the wallet that contains the credential offer |
+| item_id | [string](/reference/proto#string) | The ID of the credential offer (Parameter ID inside the JSON document) |
 
 
 
@@ -2210,7 +2210,7 @@ How to display a URI value when rendering a credential.
 <a name="services-trustregistry-v1-GetMemberAuthorizationStatusRequest"></a>
 
 ### GetMemberAuthorizationStatusRequest
-Request to fetch member status in governance framework for a specific credential schema.
+Request to fetch member status in Trust Registry for a specific credential schema.
 
 
 | Field | Type | Description |
@@ -2241,7 +2241,7 @@ Response to `GetMemberAuthorizationStatusRequest`
 <a name="services-trustregistry-v1-GetMemberRequest"></a>
 
 ### GetMemberRequest
-Request to get a member of the governance framework
+Request to get a member of the Trust Registry
 
 
 | Field | Type | Description |
@@ -2339,6 +2339,7 @@ Response to `RegisterMemberRequest`
 ### UnregisterMemberRequest
 Request to unregister a member as a valid issuer of a specific credential schema.
 Only one of `did_uri`, `wallet_id`, or `email` may be specified.
+The URI of the credential schema must be specified.
 
 
 | Field | Type | Description |