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"

where is https://substrate.dev/recipes/ ？？？

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 👍 (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 😁

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

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

#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

Hey I wanna find something related to Off-chain workers, but can not. How can I find? @lisa-parity

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!

Half the new links in these comments are now broken too

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 ...

@lisa-parity where can I find tutorials/documentation/information about storage migrations? Examples step-by-step? Thanks!

@didiermis, the how-to guide was retired as out-of-date, so currently, the only doc is https://docs.substrate.io/build/upgrade-the-runtime/#storage-migration
and
https://github.com/substrate-developer-hub/substrate-docs/tree/archive/main-mdx/v3/how-to-guides/06-storage-migrations

This is in the queue for an update in the form of a tutorial. Hope to get it out soon.

Thanks! I'll come back later.