Re: [Rats] FW: New Version Notification for draft-shaw-rats-rear-00.txt

[Thomas Fossati <[e-mail]>]

Hi Michael,

On 02/07/2020, 21:16, "Michael Richardson" <[e-mail]> wrote:
> Hi, thank you for the draft.  (Please expect some pendantry on how to
> say this is a REST based interface.  I don't think it matters what you
> write, someone will say you wrote it wrong)
>
> Some things that jumped out at me:
> > strong authenticity.
>
> I don't know what this means.  I think that we went to some lengths in
> the architecture to say that we were evidence of trustworthiness.  The
> paragraph that follows, which deals with assurance, seems much better.
> Maybe just omit the first paragraph :-)
>
> "are the three RATS actors" <- we never use "actors" in the
> architecture.  Some said we should, but we didn't go there.  We used
> "roles"... which I agree are things that actors portray.
>
> I suggest: The three RATS roles of the attester (A), the relying party
> (RP) and the verifier (V) are protrayed by three principal actors.
>
> I scanned through the rest of the document.  I didn't check your math,
> as I would really need to be in implementation mindset to do that.  I
> feel that there is perhaps some unexplained/implicit knowledge around
> the if= that I might not have understood the first time.

Thanks for the comments, I've made tickets for them with a -01
milestone.

> In this thread you offered to do a tutorial/walkthrough.  I won't say
> no to that, but I want to say that if the document needs a
> tutorial/walkthrough to be understood, then the document needs some
> changes.
> So, do that walkthrough, but with the idea not of explaining
> things, but of getting feedback on the explanation so that you can
> make the document better.

We want to strike a balance between rigour and readability and the
signal we are not making a good job on the latter is loud and clear :)

I've looked into Henk's Reference Interaction Models doc and it looks
like we could take inspiration from that for reshaping the interaction
diagrams.  I'm going to give that a stab.

cheers!



IMPORTANT NOTICE: The contents of this email and any attachments are confidential and may also be privileged. If you are not the intended recipient, please notify the sender immediately and do not disclose the contents to any other person, use it for any purpose, or store or copy the information in any medium. Thank you.