Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Define: "step-by-step protocol" #43

Open
macropin opened this issue Dec 9, 2019 · 6 comments
Open

Define: "step-by-step protocol" #43

macropin opened this issue Dec 9, 2019 · 6 comments

Comments

@macropin
Copy link

macropin commented Dec 9, 2019

Consider updating _docs/overview.md, because

Glacier is a step-by-step protocol for storing bitcoins in a highly secure manner.

"step-by-step protocol" is not defined nor explained. And the introduction does not clarify what glacier is.

@bitcoinhodler
Copy link
Collaborator

How do you interpret that phrase? What would you suggest instead? Perhaps I'm too close to it but I'm having trouble understanding what is unclear about the term "step-by-step protocol" or that sentence.

@macropin
Copy link
Author

macropin commented Dec 9, 2019

Sorry, I'm not sure. I still don't know exactly what Glacier is. I just came visiting from Google and clicked "Learn More" on the home page...

It's unclear if "step-by-step" is domain specific jargon, or a metaphor for the how the protocol works. In any case I suggest the description be reworked to avoid ambiguous terminology.

@bitcoinhodler
Copy link
Collaborator

I'm sorry but I'm still not understanding your confusion. "Step-by-step" is common English, not jargon or a metaphor.

The Glacier Protocol will walk you through, one step at a time ("step-by-step"), a process to securely store your bitcoins.

@macropin
Copy link
Author

Right so what you're really saying is "The Glacier Protocol is a step-by-step methodology for storing bitcoins in a highly secure manner." ?

@bitcoinhodler
Copy link
Collaborator

Ah! I think we're getting somewhere. I'm not sure methodology is the best word; what about process?

"The Glacier Protocol is a step-by-step process for storing bitcoins in a highly secure manner."

What do you think? "Procedure" could also work.

@macropin
Copy link
Author

macropin commented Dec 11, 2019

Yeap, that makes sense to me now! "Procedure" is probably more succinct, but may in this context be confused with computer procedure/function, so perhaps methodology is better.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants