From 44c187189c4e5ef36ff2d7930c44b7abef99e998 Mon Sep 17 00:00:00 2001 From: Rasmus Dahlberg Date: Thu, 7 Apr 2022 16:05:05 +0200 Subject: add proposal to simplify ascii names --- doc/proposals/2022-04-simplify-ascii-names.md | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) create mode 100644 doc/proposals/2022-04-simplify-ascii-names.md diff --git a/doc/proposals/2022-04-simplify-ascii-names.md b/doc/proposals/2022-04-simplify-ascii-names.md new file mode 100644 index 0000000..b9c9fbe --- /dev/null +++ b/doc/proposals/2022-04-simplify-ascii-names.md @@ -0,0 +1,21 @@ +# Proposal + +Update the following names in Sigsum's ASCII parsing: + + 1. s/preimage/message/ + 2. s/verification_key/public_key/ + 3. s/Error/error/ + +# Motivation + +In the same order as above: + + 1. Preimage is a mathematical term. When we talk about our design, we use the + term "message" and say that it is usually H(data). The original reason to + call it preimage was that a Sigsum log computes H(H(data)), making the + message that is sent on the wire a "preimage" for the log's hash operation. + This terminology is not helpful. Let's just call this "message" on the + wire. A log uses it to compute checksum<--H(message). Checksum is logged. + 2. Verification key is also a mathematical term. When we talk about our + design, we use the term "public key" because it is more easily relatable. + 3. No other key has any capital letters. -- cgit v1.2.3