Comments (2)
Thanks for the extensive feedback!
"Landing page" and "Getting started" points are very valid.
As for the "Basic Concepts" page: The problem is I don't want people to think that you are limited to contract-to-contract calls if you choose CosmWasm for your IBC protocol. You can absolutely do contract-to-module too.
I agree that the relayer feels a bit out of place in the list, but it is still important to understand how a relayer fits into the whole system because it is mentioned many times on the following pages. My intention for this page was mostly to be a sort of basic glossary for terms that I don't want to explain in the rest of the docs.
Maybe it makes sense to move the relayer down in the list, so that port, channel and packet are together?
"Using existing protocols" + "Build Your Own Protocol": I agree the page is a bit ICS-20 heavy, but I don't think there is enough to say about the custom contract case to warrant its own sub-page. First of all, it is very much dependent on the specific contract you want to use, so it would not be too helpful to explain how you do it with Nois, since it would look completely different for other projects and is also not really in the scope of our docs to explain some external smart contract project. Second of all, it's not really that complicated to begin with, since the contract you call does all the complex stuff.
Maybe I should just remove the reference to using IBC through another contract completely and focus on ICS-20 on that page.
As for ordering: Yes, I was always very unsure how to order these and I think you convinced me that the other way around is better.
I'll prepare a PR for this next week. Already started working on it.
from docs.
sounds good to me! just to clarify, my intent was just to bring up points for your consideration, however you decide on any of them is 100% fine with me :)
I may have duplicated some of the points in my latest Vercel comments. Heads up @hashedone in case there's overlap
from docs.
Related Issues (20)
- Double Footer
- Entrypoints - Additional Info
- CosmWasm gas - correction
- CosmWasm core - Installation - mention that optimizer isn't suitable for dev/fast iteration
- Make sure all code examples containing an entry point use library feature
- [tracking] Checklist before release HOT 1
- are we consistent with using code tags in section/article titles HOT 1
- Document `MultiIndex`
- Feedback for βIndexβ
- Possibility to highlight relevant code parts HOT 1
- Generic contracts and interfaces in sylvia
- Describe actual usage of CosmWasm
- Update MultiTest links HOT 1
- Explanation of submessage-reply flow in sylvia HOT 1
- Explain Stargate / Grpc query and Stargate / Any message from a contract POV
- Davids comments to be reviewed
- Add Query raw and smart query in wasmd section
- Add `cosmwasm_2_1` feature description
- Documentation about how to correctly use the `library` feature as a consumer
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
π Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. πππ
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google β€οΈ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from docs.