Token differentiation to improve UX / user comprehension / cognitive load. #6
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
This PR has two commits:
The final commit renames the tokens on the principle that anything with "ZEC" anywhere in the name should be reserved for tokens that (by design at least) aim for a 1:1 price PEG to mainnet ZEC. I believe this will be a helpful invariant for users across the Zcash ecosystem. By contrast, tokens with a variable / floating exchange rate like the stake tokens in this design should have a different name, also to help users understand their different monetary nature. AFAIK, this "principle" isn't written down anywhere else.
If there's notable pushback on the renaming, I'd be curious why. (Note: I'm not specifically attached to "ZEAL" it was just a whimsical choice.)
The first commit should be only a clarification of the
main
text and I'd appreciate double checking the token summaries and exchange rate descriptions there are accurate. For my way of thinking having this glossary-style introduction to the token types helps me understand their relationship better later in the text. Not sure if all readers are like me, though. ;-) I consider these changes orthogonal, and I'd be happy with a different flow/outline with the token renaming.Edit 2020-12-18: Fixed the branch name for
main
.