aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorRasmus Dahlberg <rasmus@mullvad.net>2022-07-21 15:04:45 +0200
committerRasmus Dahlberg <rasmus@mullvad.net>2022-07-21 15:04:45 +0200
commit54a6e87334dfb93f01820e65ab08233cb932eb4d (patch)
treea806b4e7a72c67a5e4e85114143af36ee8635f7b /doc
parentdf0eb7de5e7b8fdf3760a6a18609a6e016957602 (diff)
add renaming proposal
Diffstat (limited to 'doc')
-rw-r--r--doc/proposals/2022-07-api-renaming.md23
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.