specifications icon indicating copy to clipboard operation
specifications copied to clipboard

Add list of notary annotations

Open SteveLasker opened this issue 2 years ago • 1 comments

Notary adds several annotations. Would it help to have a single markdown file that lists the annotations, and defines the format? For instance, we've followed a camelCase formatting of annotations. To avoid new annotations from diverging or new annotations that are duplicative of existing ones, should we document these?

SteveLasker avatar Jul 11 '22 22:07 SteveLasker

I would recommend adding a section to this https://github.com/notaryproject/notaryproject/blob/main/signature-specification.md#storage with annotations.

Also, it is currently a bit confusing since there are annotations in the Payload and annotations in the manifest https://github.com/notaryproject/notaryproject/blob/main/signature-envelope-jws.md#storage

For all purposes my understanding is that registries aren't expected to look at the payload as currently registries and clients only look at the manifest at the lowest level.

sajayantony avatar Jul 19 '22 00:07 sajayantony