diff options
author | Linus Nordberg <linus@nordberg.se> | 2022-08-06 20:59:24 +0200 |
---|---|---|
committer | Linus Nordberg <linus@nordberg.se> | 2022-08-06 20:59:24 +0200 |
commit | 63abe7e03795797d0db7d00bc33ddf6e57d9b5b3 (patch) | |
tree | c66cc2dbfdbb60fa3ee66d78c1121bd88cb5059f /doc/proposals/2022-07-api-renaming.md | |
parent | d7a8bc59af07ac539ee809823010226fe4f036b9 (diff) | |
parent | b3ca97dbd0b725b3fd0d5616d0d94984631d33a2 (diff) |
Merge branch 'main' of git.sigsum.org:sigsum
Diffstat (limited to 'doc/proposals/2022-07-api-renaming.md')
-rw-r--r-- | doc/proposals/2022-07-api-renaming.md | 23 |
1 files changed, 23 insertions, 0 deletions
diff --git a/doc/proposals/2022-07-api-renaming.md b/doc/proposals/2022-07-api-renaming.md new file mode 100644 index 0000000..dafa98c --- /dev/null +++ b/doc/proposals/2022-07-api-renaming.md @@ -0,0 +1,23 @@ +# Proposal + +Rename the following endpoints: + + - s/get-tree-head-to-cosign/get-untrusted-tree-head/ + - s/get-tree-head-cosigned/get-tree-head/ + - s/get-leaves/get-entries/ + - s/add-leaf/add-entry/ + +Rename the following ASCII keys: + + - s/start_size/start_index/ + - s/end_size/end_index/ + +(Reminder: specify zero-based index.) + +# Motivation + +Improve readability of api.md, especially for those that skim it quickly. For +example, "untrusted-tree-head" is a very strong signal for what you don't want, +and it should be easier to relate to the term "entry" rather than a "leaf". + +The renamed ASCII keys better reflect the text that describes them. |