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

Global Terminology Overhaul & Some Text Issues #15

Closed
henkbirkholz opened this issue Feb 21, 2023 · 3 comments · Fixed by #16 or #105
Closed

Global Terminology Overhaul & Some Text Issues #15

henkbirkholz opened this issue Feb 21, 2023 · 3 comments · Fixed by #16 or #105

Comments

@henkbirkholz
Copy link
Member

Payload and Statement seem to be used intermixed in the text. I tried to disambiguate the via "Statement payload". If that does not work, please provide a counter proposal.

The term Claim sometimes seem to have meant Signed Statement and sometimes Transparent Statement. Using our interim terminology, that became a selection process for me. Please check, if I made the correct choice in all occurrences (sometimes I had to guess the intent).

Consistent Capitalization was a mess. I hope I fixed most of that. Please check.

There is still no consistent use of "Registry" vs. "log" vs. "ledger" vs. "Transparency Service", I think. Please check.

Please check every use of the term "Evidence" and if an alternative expression could be used.

Please check every occurrence of the term "guarantee" or "proof" and if an alternative expression could be used.

Privacy Considerations and Security Considerations texts require significant improvement.

henkbirkholz added a commit that referenced this issue Feb 21, 2023
Signed-off-by: Henk Birkholz <henk.birkholz@sit.fraunhofer.de>
@rjb4standards
Copy link

rjb4standards commented Feb 27, 2023

Here is my opinion:
Registry refers to the facilities used to store and retrieve "Authenticated Statement Data" that has been submitted to a "Transparency Service" "operator". A Registry contains specific "Statements" which the Transparency service supports, as documented in their registration policies document. A Registry may employ different technologies needed to carry out its function to store and retrieve "Statements" that are permitted in the Registry, per the registration policies defined by the Transparency Service operator. The operator of a Transparency Service serves the role of Gatekeeper to ensure the integrity of the Registry data and services provided to access the Registry data. A Statement is contained in a message "Payload" exchanged between a Transparency Service API function and other parties, i.e. consumer inquiries and Notary submissions.

@nealmcb
Copy link

nealmcb commented Mar 6, 2023

It would help to be able to read the document given the changes proposed here. But due to the make errors documented in #6 I haven't yet succeeded in doing so. Does the build infrastructure automatically build documents for other branches? Or can someone else build and publish the document based on this branch?

@henkbirkholz
Copy link
Member Author

Editor's version build via github actions for #16 is located here: https://ietf-wg-scitt.github.io/draft-ietf-scitt-architecture/core-terms/draft-ietf-scitt-architecture.html

SteveLasker added a commit to SteveLasker/draft-ietf-scitt-architecture that referenced this issue Oct 3, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
4 participants