-
Notifications
You must be signed in to change notification settings - Fork 2
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
Replace tuf roles overview image with text table #73
Replace tuf roles overview image with text table #73
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
So far I only extracted the text from the original pep-0458-1.png
and put it in a text table without changing the contents. Here are two suggestion that we should fix:
| | resulting delegated roles can then provide their own | | ||
| | metadata files. The format of the metadata files provided | | ||
| | by delegated targets roles is the same as that of | | ||
| | targets.json. As with targets.json, the latest version of | |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Might be good to state that the targets role writes to "targets.json", at this point the reader does not know that yet (they might have a suspicion though).
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Go for it :yolo:
pep-0458.txt
Outdated
| | versions of all metadata files on the repository in | | ||
| | snapshot.json. The only metadata file not listed in | | ||
| | snapshot.json is timestamp.json, which is always created | | ||
| | after snapshot.json. | |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This needs to be updated to the latest version of the spec. The current spec does not have root in snapshot either.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
💯
@lukpueh Go for it, do what you think is best |
@trishankatdatadog, let me know what you think of 5b8e5b1. The targets update is not absolutely necessary. But we do need to mention that root is no longer in snapshot. Feel free to suggest alternative wording. |
| | resulting delegated roles can then provide their own | | ||
| | metadata files. The format of the metadata files provided | | ||
| | by delegated targets roles is the same as that of | | ||
| | targets.json. As with targets.json, the latest version of | |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Go for it :yolo:
Requires updating other captions: - Figure 2 --> Figure 1 - Table 1, 2, 4 --> Table 2, 3, 4 This commit also removes a stray "and".
- Update targets row to say that it signs the targets metadata - Update snapshot row to mention that it only lists targets and targets metadata and why it doesn't list root and timestamp. Co-Authored-By: Trishank Karthik Kuppusamy <[email protected]>
0aef6f3
to
1374e1c
Compare
In secure-systems-lab#73 Figure 2 became Figure 1. This change fixes a missed reference update. It also removes a stray "and". Signed-off-by: Lukas Puehringer <[email protected]>
In secure-systems-lab#73 Figure 2 became Figure 1. This change fixes a missed reference update. It also removes a stray "and". Signed-off-by: Lukas Puehringer <[email protected]>
In secure-systems-lab#73 Figure 2 became Figure 1. This change fixes a missed reference update. It also removes a stray "and". Signed-off-by: Lukas Puehringer <[email protected]>
Fixes #66