From 1349a1386e6c17a1d968911681656cb28fa03256 Mon Sep 17 00:00:00 2001 From: Shawn Tabrizi Date: Sat, 3 Aug 2024 13:04:49 -0400 Subject: [PATCH] mdBook generated from gitorial --- src/0/source/README.md | 8 ++++---- src/1/source/README.md | 22 ++++++++++++++++++++-- 2 files changed, 24 insertions(+), 6 deletions(-) diff --git a/src/0/source/README.md b/src/0/source/README.md index 228064a7..345ec7a7 100644 --- a/src/0/source/README.md +++ b/src/0/source/README.md @@ -2,7 +2,7 @@ Welcome to the new Substrate Collectables Workshop. -The goal of this tutorial is to **teach by experience** various entry level concepts around Polkadot Pallet development. +The goal of this tutorial is to **teach by experience** various entry level concepts around developing on [Polkadot](https://polkadot.network/). Before we get started writing code, we will need to cover some basics. @@ -43,11 +43,11 @@ cd substrate-collectables-workshop Or access the template directly here: -https://github.com/shawntabrizi/substrate-collectables-workshop/releases/tag/starting-template +[https://github.com/shawntabrizi/substrate-collectables-workshop/releases/tag/starting-template](https://github.com/shawntabrizi/substrate-collectables-workshop/releases/tag/starting-template) -We will go over the starting template in detail throughout this section, but don't be afraid to peek around yourself. +The starting template includes a `README` with instructions to setup your working environment. Follow those instructions. -Make sure your checks pass on this initial template without warning or errors: +Make sure you are able to run the following checks on this starting template without warnings or errors: ```bash cargo +nightly fmt diff --git a/src/1/source/README.md b/src/1/source/README.md index f33f7857..3e1ce591 100644 --- a/src/1/source/README.md +++ b/src/1/source/README.md @@ -4,7 +4,7 @@ Our starting template for this tutorial uses the [Polkadot SDK](https://github.c This is the same technology stack used to build and power the [Polkadot Network](https://polkadot.network/). -To better understand what you will be doing in this tutorial, we need to give you a high level overview of the blockchain ecosystem to make sure we are all on the same page. +To better understand what you will be doing in this tutorial, we need to start with a high level overview of blockchains. ## Blockchain @@ -12,14 +12,20 @@ Blockchains are the foundation of building Web3 technologies. Web3 is a promise toward a world with less trust, and more truth. -Through blockchains, people are able to develop and deploy software that are decentralized, open, permissionless, censorship resistant, and independently verifiable. +Through blockchain technology, we are able to develop and deploy software that are decentralized, open, permissionless, censorship resistant, and independently verifiable. The main purpose of a blockchain node is to come to consensus with other nodes on the decentralized network. +
+ +Deep Dive + If you want to learn more about blockchains, check out the following video from the Polkadot Blockchain Academy: +
+ ## Runtime At the heart of a blockchain is a [state transition function](https://en.wikipedia.org/wiki/Finite-state_machine) (STF). @@ -30,10 +36,16 @@ In the `polkadot-sdk` we refer to this logic as the blockchain's runtime. All nodes on a blockchain network have and use the same runtime, allowing them to come to consensus about changes to a blockchain. +
+ +Deep Dive + To learn more about the runtime, and its role inside of the `polkadot-sdk`, check out this video from the Polkadot Blockchain Academy: +
+ ## Pallets The `polkadot-sdk` provides a developer framework called FRAME. @@ -52,10 +64,16 @@ You can think of different Pallets as different applications or functions that y You can also think of Pallets very similar to traditional blockchain smart contracts, however Pallets are more powerful and execute much faster than smart contracts. +
+ +Deep Dive + To learn more about FRAME and Pallets, check out this video from the Polkadot Blockchain Academy: +
+ ## NFTs Non-Fungible Tokens (NFTs) are a type of token which can be created and traded on a blockchain.