Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[3.2.0] The class Evidence (and Output) #128

Open
jimjyang opened this issue Feb 29, 2024 · 2 comments
Open

[3.2.0] The class Evidence (and Output) #128

jimjyang opened this issue Feb 29, 2024 · 2 comments

Comments

@jimjyang
Copy link

The class Evidence is used to represent a concrete piece of Evidence, not the requirement(s)/specification(s)/etc. to the Evidence, right? See e.g. the example "Entitlement to marry" in CCCEV 2.2.0, where the example instance of the class Evidence is the "ID card of John Doe".

The intension with CPSV-AP is to provide a set of classes and properties to be used when describing public services. How could a service provider be able to provide values for the properties in the class Evidence, in the "design time" so to speak, when the properties in the class are meant to carry values representing a concrete piece of evidence provided by the user of a service, in the "run time" so to speak? Similar question goes for the class Output as well.

Therefore, is it necessary for CPSV-AP to specify the classes Evidence and Output with specific properties? [Note that some of the properties refer to other classes in CPSV-AP]

If we are going to keep the properties in those two classes in CPSV-AP, shouldn't we explain (in usage notes) when those two classes are meant to be used?

Furthermore, if we are going to keep the properties in those wo classes, the definition for the following properties should be rewritten:

  1. is conformant to: better with something like "Evidence type that the piece of Evidence conforms to"?
  2. language: better with something like "The language(s) the piece of Evidence is in"?

and, what is the property related documentation meant for, in a concrete piece of Evidence?

@EmielPwC
Copy link
Member

Hello Jim,

Your main concern regarding the design time and run time issue is covered in issue 95. We understand that this is not clear based on the current usage notes and we will propose clarifying usage notes in the upcoming webinar. Do you have any suggestion which might be included?

Regarding language: we agree that your proposed change in definition would allow it's usage at design and run time therefore we will propose it at the upcoming webinar.

Regarding is conformant to: Could you clarify the impact of your proposed change? we currently don't see how it would impact the meaning.

Regarding related documentation the intention is to allow for further clarifying documentation to be attached. An example for a concrete piece of evidence: when providing an evidence on the energy score of a house related documentation can be used to reference a more extensive audit report of the houses energy usage. As this is not clear from the usage note we will update it to clarify this.

@jimjyang
Copy link
Author

jimjyang commented Apr 5, 2024

Reg. the flexibility of CPSV-AP to cover both the description and execution of a public service: Maybe I didn't read thoroughly enough, but I couldn't find any text about this intention in e.g. Introduction.

Reg. the usage note for the class Evidence: What I miss is something like "Evidence is a concrete piece of proof provided by the user of the service".

Reg. dct:conformsTo: I withdraw my comment.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants