search

interledger / interledger.github.io

🙅 Even earlier version of Interledger website
38 stars 38 forks source link

Update ILP Glossary #123

Open pgarg-ripple opened 5 years ago

pgarg-ripple commented 5 years ago

I have used the existing glossary - IL-RFC 19 - and updated it by removing/updating outdated terms and definitions. I have also added some new terms. I plan to publish this glossary on the website. Please review and let me know if any terms are missing or any definition is unclear.

adrianhopebailie commented 5 years ago

General comment/concern:

Why are we providing our own definitions for terms that are not specific to the Interledger domain?

I assume the goal of the glossary is to reduce confusion that stems from members of the community having different interpretations of ILP concepts. However by redefining known terms I'd argue we risk making the situation worse, not better.

pgarg-ripple commented 5 years ago

@adrianhopebailie

General comment/concern:

Why are we providing our own definitions for terms that are not specific to the Interledger domain?

I assume the goal of the glossary is to reduce confusion that stems from members of the community having different interpretations of ILP concepts.

True.

However by redefining known terms I'd argue we risk making the situation worse, not better.

Hence the reason for opening this PR for review by you all. Please let me know if there are any terms and/or definitions that you think are irrelevant or are not specific to Interledger, I will fix them :)

adrianhopebailie commented 5 years ago

For example, an "account" can mean many things in the world, but in Interledger this has a specific meaning that limits the relationship to being between two peers; limits the relationship to a single asset type; etc.

@sappenin this is an example of exactly what worries me. If we co-opt the word account then how do we know when we are talking about the Interledger-defined version or the more general version.

If the answer is context then what should I call the various other accounts that come up in conversations in this community?

For this specific example you'll note that I explicitly called this type of account an "Interledger account" in ILP-RFC 33. That wasn't an accident 😃

Every time we do these things that seem easier we need to realise they are easier for everyone that is already in the community but make it harder for anyone new.

I'll try to compile a list later today of terms I suggest we reconsider or at least contextualise.