substrate-docs
substrate-docs copied to clipboard
substrate-developer-hub
New Substrate documentation released
The Developer Hub documentation site has gone through a significant transformation. If you have bookmarked pages in the old site, the page you are looking is most likely no longer available at that location. This roadmap provides suggestions to help you navigate to the information you're looking for in the new site.
-
If you have bookmarked pages in the old site, the page you are looking for is no longer available at that location.
-
If you arrived here from a link within the new Substrate Developer Hub content, please open an issue to report the broken link.
-
If content is missing that was on the old docs, or otherwise is something you were looking for, please open an issue to let us know.
-
If you arrived at this page as the content you were looking for from a post on the Substrate and Polkadot Stack Exchange led you here, please suggest an edit on the post directly with the correct link in the new docs. If unable to do so, instead add a comment to notify the author and community that the location has changed. :pray:
-
If you arrived here from an external resource - such as a search engine, blog, example code, or other content that is maintained externally - please inform the authors that they need to update their links to use the new site.
-
If after searching the new docs, you cannot find what you need, please open an issue to request new or edited content and detail what you were looking for and mention if there was an external source that suggested it existed here or in the old docs.
New table of contents
Getting started
Key concepts
Runtime development
Tutorials
- Tutorials
- Build a local blockchain
- Simulate a network (using predefined accounts)
- Add trusted nodes (generate keys for a private network)
How-to guides
Tools
Advanced
:memo: Let us know what you think!
Please provide feedback on you experience with the new docs!
Feel free to comment on this issue with any thoughts, comments for improvements or share what you like about the new docs experience! :grinning:
i studying 05-private-network
https://github.com/substrate-developer-hub/substrate-docs/blob/main/v3/tutorials/05-private-network/index.mdx
but now , it disappear ! where is it ???
It is split into two parts in the new site. Here is the tutorial using generated keys instead of the predefined account: https://docs.substrate.io/tutorials/get-started/trusted-network/ If you want to start with the predefined accounts, you can find the updated tutorial here: https://docs.substrate.io/tutorials/get-started/simulate-network/
I'm looking for the 'Create your first Substrate blockchain' tutorial, where can I find it in the new docs?
You can find the equivalent first blockchain tutorial here: https://docs.substrate.io/tutorials/get-started/build-local-blockchain/
I'm noticing some code differences between the old and new documentation version. Especially in Cargo.toml file and in some macros, like this one. Are you guys updating the Substrate node template too? Because the code in this new doc is slightly different. Thanks.
.
Hey, In previous days I did the first section of tutorials. Yesterday (june 22) I came back to finish the rest but for my surprise, documentation was updated. I'm learning substrate so I've been following the documentation these days. There's issues like:
- Missing images
- A lot of typo's
- Dead links
- Tutorials missing information/snippets/images/node-template versions missmatching.
I think you guys are still working on the site, I'm not complaining. Sorry if I can't link all the issues I found but I have little time to learn Substrate.
There's no coherence between Github/documentation/rust api documentation for the node basic template (as above comment mentioned) differs in various parts.
Tutorial are the ones in the worst state, I've been comparing both actual tutorial links and cache links from old documentation. I've spent a lot of time trying to fix them than learning the topic.
Tutorials from current documentation aren't working as intended, I was unable to complete the following:
- Configure the Contracts pallet: Tutorial adds extra traits.
- Monitor node metrics
- Upgrade a running network
- etc.
On the other hand, I LOVE the new structure of the documentation. The information is better organized. In the previuos version i was kinda lost when looking for a certain topic.
Is there news about the next release?
https://docs.substrate.io/main-docs/fundamentals/runtime-intro/
In "FRAME" and "Composing a runtime with pallets" sections: There is a line in which it is written "Image is missing"
The recipes have been retired and replaced with the how-to quick reference guides. Some recipes were not migrated to how-to guides because they were obsolete and no longer valid with more recent releases. Are you looking for a specific topic? If so I can help.
On Sun, Jun 26, 2022 at 7:30 PM heymeowhero @.***> wrote:
where is https://substrate.dev/recipes/ ？？？
— Reply to this email directly, view it on GitHub https://github.com/substrate-developer-hub/substrate-docs/issues/1132#issuecomment-1166763873, or unsubscribe https://github.com/notifications/unsubscribe-auth/AV7T7PJSPE5ST2MBXHBPCHDVREG4PANCNFSM5Y7RBA5A . You are receiving this because you were assigned.Message ID: @.***>
-- Parity Technologies is a limited company registered in England and Wales with registered number 09760015 and registered office at c/o Ignition Law, 1 Sans Walk, London, England, EC1R 0LT. This message is intended solely for the addressee(s) and may contain confidential information. If you have received this message in error, please notify us, and immediately and permanently delete it. Do not use, copy or disclose the information contained in this message or in any attachment. For information about how we process data and monitor communications please see our Privacy policy (https://www.parity.io/privacy/ https://www.parity.io/privacy/)and for terms of use please see our Terms of Use policy (https://www.parity.io/terms/ https://www.parity.io/terms/).
This link is broken: https://docs.substrate.io/tutorials/connect-other-chains/connect-to-evm/
As previously accessed, this tutorial illustrates how to build an Ethereum-compatible blockchain with Substrate using crates from the Frontier project.
EVM page was explicitly removed temporarily, as it has nothing to do with "connecting to other chains" - once a home for the page is decided, it will come back and appear in the nav as well :+1: (with a pass to polish the page, as it was "long in the tooth" as it stood)
@heymeowhero https://substrate.recipes/ maintained by Joshy here: https://github.com/JoshOrndorff/recipes
I'm noticing some code differences between the old and new documentation version. Especially in Cargo.toml file and in some macros, like this one. Are you guys updating the Substrate node template too? Because the code in this new doc is slightly different. Thanks. !
@rirotho We are maintaining the node template, #1140 updated to the 0.9.24 version and I also updated tehe latest tag on templates to match. Please let us know if there are other issues, there could be discrepancies in code snippets here that were patched in the now archived version of the older site. Please open issues on each of these, or better, a PR to fix :grin:
What happen with the governance section? that displayed how to work with the democracy pallet and submit pre-images ? Is that part removed until new upgrades to the democracy pallet comes?
https://docs.substrate.io/main-docs/fundamentals/offchain-operations/
Image is missing
Hey, where can I find info regarding to the Storage Migration? Previous link isn't working. Ty! https://webcache.googleusercontent.com/search?q=cache:hCC3dgjSPgwJ:https://docs.substrate.io/how-to-guides/storage-migrations/+&cd=1&hl=es-419&ct=clnk&gl=mx&client=ubuntu
Hi, The storage migration how-to guide was intentionally removed because it needs to be updated. You can find some information about storage migration here: https://docs.substrate.io/main-docs/build/upgrade/#storage-migration
We'll try to get a replacement how-to guide up soon.
On Wed, 29 Jun 2022 at 10:12, Didier Mis @.***> wrote:
Hey, where can I find info regarding to the Storage Migration? Previous link isn't working. Ty!
https://webcache.googleusercontent.com/search?q=cache:hCC3dgjSPgwJ:https://docs.substrate.io/how-to-guides/storage-migrations/+&cd=1&hl=es-419&ct=clnk&gl=mx&client=ubuntu
— Reply to this email directly, view it on GitHub https://github.com/substrate-developer-hub/substrate-docs/issues/1132#issuecomment-1170253958, or unsubscribe https://github.com/notifications/unsubscribe-auth/AV7T7PINGN4QCMU7ITVSL4LVRR7W3ANCNFSM5Y7RBA5A . You are receiving this because you were assigned.Message ID: @.***>
-- Parity Technologies is a limited company registered in England and Wales with registered number 09760015 and registered office at c/o Ignition Law, 1 Sans Walk, London, England, EC1R 0LT. This message is intended solely for the addressee(s) and may contain confidential information. If you have received this message in error, please notify us, and immediately and permanently delete it. Do not use, copy or disclose the information contained in this message or in any attachment. For information about how we process data and monitor communications please see our Privacy policy (https://www.parity.io/privacy/ https://www.parity.io/privacy/)and for terms of use please see our Terms of Use policy (https://www.parity.io/terms/ https://www.parity.io/terms/).
Is it possible that a sitemap can be created and submitted to google search console/be refereed to in robots.txt? So that the search engines index the correct sites and avoids dead links. Duckduckgo and other search engines are currently indexing and serving broken links and a sitemap would fix this
https://github.com/substrate-developer-hub/substrate-docs/pull/1193 - the reset is in the works now @flipchan and should remove old SE hits and trigger a crawl of the new content in the next few days.
https://docs.substrate.io/sitemap.xml
I think it's annoying to move these existing tutorials to a new place.
I have written a few documents linking to these tutorials, and all these links are broken. I have to fix them by hand.
Maybe you can use a versioning system for docs.
e.g. https://docs.substrate.io/tutorials/v1 https://docs.substrate.io/tutorials/v2 https://docs.substrate.io/tutorials/v3
Hi Yongjin, I am sorry that our update caused you some annoyance. We are looking into a versioning system, but in the interest of evolving and keeping the doc up to date, links and content will change from time to time.
On Thu, 30 Jun 2022 at 20:02, Yongjin Huang @.***> wrote:
I think it's annoying to move these existing tutorials to a new place.
I have written a few documents linking to these tutorials, and all these links are broken. I have to fix them by hand.
Maybe you can use a versioning system for docs.
e.g. https://docs.substrate.io/tutorials/v1 https://docs.substrate.io/tutorials/v2 https://docs.substrate.io/tutorials/v3
— Reply to this email directly, view it on GitHub https://github.com/substrate-developer-hub/substrate-docs/issues/1132#issuecomment-1171876067, or unsubscribe https://github.com/notifications/unsubscribe-auth/AV7T7PLI3GLFJAUB347S7RLVRZNURANCNFSM5Y7RBA5A . You are receiving this because you were assigned.Message ID: @.***>
-- Parity Technologies is a limited company registered in England and Wales with registered number 09760015 and registered office at c/o Ignition Law, 1 Sans Walk, London, England, EC1R 0LT. This message is intended solely for the addressee(s) and may contain confidential information. If you have received this message in error, please notify us, and immediately and permanently delete it. Do not use, copy or disclose the information contained in this message or in any attachment. For information about how we process data and monitor communications please see our Privacy policy (https://www.parity.io/privacy/ https://www.parity.io/privacy/)and for terms of use please see our Terms of Use policy (https://www.parity.io/terms/ https://www.parity.io/terms/).
Hey I wanna find something related to Off-chain workers, but can not. How can I find? @lisa-parity
Also feel free to use search and let us know if that’s working for u!
On Thu, Jul 7, 2022 at 8:31 PM shyoski @.***> wrote:
Hey I wanna find something related to Off-chain workers, but can not. How can I find? @lisa-parity https://github.com/lisa-parity
— Reply to this email directly, view it on GitHub https://github.com/substrate-developer-hub/substrate-docs/issues/1132#issuecomment-1178504809, or unsubscribe https://github.com/notifications/unsubscribe-auth/AV7T7PLFBPTRLKXZPLCZRL3VS6OKJANCNFSM5Y7RBA5A . You are receiving this because you were mentioned.Message ID: @.***>
-- Parity Technologies is a limited company registered in England and Wales with registered number 09760015 and registered office at c/o Ignition Law, 1 Sans Walk, London, England, EC1R 0LT. This message is intended solely for the addressee(s) and may contain confidential information. If you have received this message in error, please notify us, and immediately and permanently delete it. Do not use, copy or disclose the information contained in this message or in any attachment. For information about how we process data and monitor communications please see our Privacy policy (https://www.parity.io/privacy/ https://www.parity.io/privacy/)and for terms of use please see our Terms of Use policy (https://www.parity.io/terms/ https://www.parity.io/terms/).
Hi,
I am attending a course organized by Polkadot China. One assigned is to implment a 'Proof of Existance' by using substrate-node-template v3.0, and can refer to 'Proof of Existance' tutorial
However, the tutorial is now gone. Can you please help?
Hi @xue35 The tutorial you are looking for is now here: https://docs.substrate.io/tutorials/work-with-pallets/custom-pallet/ (or https://docs.substrate.io/tutorials/work-with-pallets/use-macros-in-a-custom-pallet/ depending on when the PR to change the name gets merged).
Hi, I suggest that some more Structure-Diagrams and Flow-Diagrams or other Diagrams can be added to the docs to explain more clearly .
Hi, I suggest that some more Structure-Diagrams and Flow-Diagrams or other Diagrams can be added to the docs to explain more clearly .
I would agree but what areas do you need more visualizations for?
I would agree but what areas do you need more visualizations for?
IMO , such as:
- The communication process between different types of nodes
- Detailed processing of different types of nodes after receiving different messages
- Diagrams of the different types of Tries and how they work
- In unusual cases, how different types of nodes work
- and so on ...
Thanks very much for the suggestions. We're planning to add more diagrams (opportunistically) throughout the documentation. Appreciate your input on this!
docs.substrate.io continues to evolve. If you are following this thread to locate topics, be forewarned that we have recently removed one level from the site hierarchy. For example: what was "docs.substrate.io/main-docs/fundamentals/blockchain-basics/" is now "docs.substrate.io/fundamentals/blockchain-basics/"
Get started
- Build a local blockchain shows you how to set up and interact with a local node in your development environment.
- Simulate a network helps you simulate a two-node network using predefined accounts.
- Add trusted nodes demonstrates how to generate keys and distribute a chain specification to create a small network of trusted validator nodes.
- Authorize specific nodes illustrates how you can configure a network that has both authorized nodes and nodes with restricted access.
- Monitor node metrics highlights how you can take advantage of the node metrics Substrate exposes.
- Upgrade a running network illustrates forkless upgrades by modifying the runtime for a running Substrate node.
Work with pallets (first two links are the current names but are likely to change in the future)
- Add a pallet to the runtime introduces the common steps for adding a simple predefined pallet to the node template runtime.
- Configure the contracts pallet demonstrates how to configure a complex pallet to work with smart contracts.
- Use macros in a custom pallet illustrates how to create a custom pallet using macros.
- Specify the origin for a call demonstrates how you can specify the account to use as the originator of a function call.
Develop smart contracts (this section name is likely to change and that will change the URLs)
- Prepare your first contract describes how to update your development environment and create a smart contract project using the ink! programming language.
- Develop a smart contract demonstrates how to store, increment, and retrieve simple values using a smart contract.
- Use maps for storing values extends the previous tutorial by illustrating how to use maps to store and retrieve values in a smart contract.
- Build a token contract illustrates how you can build a simple smart contract for transferring ERC-20 tokens.
- Troubleshoot smart contracts describes a few common issues that you might encounter when writing and deploying smart contracts.
Connect relay and parachains
- Prepare a local relay chain helps you prepare a local relay chain to use in testing a local parachain.
- Connect a local parachain highlights the steps necessary to connect your local parachain to a relay chain.
- Acquire a testnet slot summarizes the steps for connecting a parachain to the Rococo test network.
Integrate with tools
- Integrate a light client node describes how you can use the Substrate Connect light client node to synchronize and interact with a Substrate chain from a browser.
- Access EVM accounts illustrates how you can use a customized Substrate node to access to Ethereum-based accounts and contracts.
Substrate Kitties is undergoing a major transformation, so it has not been republished. Stay tuned ...