Attempt to improve readability of the document by

[ykarandikar]

-- moving a few sections around and removing redundant information. -- streamline use of general terms throughout the document. -- Cleaner example use cases with more inclusive names -- Removed sequence diagram of CarKey sharing using intermediary -- updated sequence diagram of sharing using intermediary to also cover CarKey case.

[dimmyvi]

As I mentioned in Slack, I suggest we break the PR down to smaller PRs - 1) moving existing text around, 2) editing existing paragraphs 3) adding new text This way it’s easier to review.

[ykarandikar]

As I mentioned in Slack, I suggest we break the PR down to smaller PRs -

1. moving existing text around,
2. editing existing paragraphs
3. adding new text This way it’s easier to review.

As I responded on slack, it's not possible to convert this PR into 3 parts.

It addresses following fundamental issues with the existing document:

• Current document does not clearly identify all the terms used at the start. A reader is left fumbling to figure out what the document is trying to describe.
• current document does not clearly define a "digital credential". Is it necessary and important to add that definition and place it right at the start of the document.
• current document is not generic enough (too many references to wallet, iOS, Android etc). It needed to be cleansed of references that make it too specific.
• current document is neither accurate nor consistent in describing the CarKey flow. That needed addressing in various sections.
• Current document is not consistent in use of terms. E.g. Sender, sender device, sender wallet etc are used interchangeably throughout the document. In order to make sure that terms are used consistently it was important to define all the terms at the start and use them consistently.

These issues can not be fixed with piecemeal PRs.

I can understand that it might be hard to read the diff. But I recommend reading the entire doc instead of trying to read the diff.