cosmos / advocates

Cosmos Advocates
5 stars 11 forks source link

Improve IBC docs on ibcprotocol.org #14

Open okwme opened 3 years ago

okwme commented 3 years ago

We need a resource to answer all the most basic questions about using IBC before it comes to deep dives in specs. This website should serve this purpose but currently only has the deep dive spec information.

The website begins doing this with a FAQ section that might need to be more prominent and also needs to have more content in general. @ethanfrey had some concrete requests that maybe could be tracked on this issue.

okwme commented 3 years ago

FAQ that is already answered are folllowing:

ethanfrey commented 3 years ago

User Persona: I am a product owner evaluating cross-chain solutions and how to integrate them into our chain and wallet. I want to understand the pros and cons and how to use a solution.

Example One: I want to move bitcoin to ethereum-based network. I can go to a site like https://tbtc.network/ which (after you scroll down some press statements) gives you a "Build with tBTC" section.

Now, keep does some threshold crypto and multisig custodial solution. It is simpler than IBC/ICS20 but nothing very simple. But they give an overview.

Example Two: I want to integrate ATOM into my Cosmos-Based chain. I look at https://ibcprotocol.org/faq/ and see there is someway to relay packets between blockchains in a trustless manner, but I have no idea how to build apps with it. There is no explanation of ICS20 nor the default implementation. There is no discussion of how to distinguish foreign tokens with the same name sent via different connections/channels. There is no example of some "basic usage".

Handling the TCP/IP protocol to someone is nice if they are a low-level engineer. For others, you can show them a browser and how you can update a web server on one machine and display it on their machine. And explain some needed concepts from that vantage point.