Document the process to launch your first (omni) node

Cargo.toml

@@ -144,6 +144,8 @@ members = [
 	"cumulus/test/service",
 	"cumulus/xcm/xcm-emulator",
 	"docs/sdk",
+	"docs/sdk/packages/guides/first-pallet",
+	"docs/sdk/packages/guides/first-runtime",
 	"polkadot",
 	"polkadot/cli",
 	"polkadot/core-primitives",

docs/sdk/Cargo.toml

@@ -21,30 +21,25 @@ frame = { package = "polkadot-sdk-frame", path = "../../substrate/frame", featur
 	"experimental",
 	"runtime",
 ] }
-pallet-examples = { path = "../../substrate/frame/examples" }
-pallet-default-config-example = { path = "../../substrate/frame/examples/default-config" }
-pallet-example-offchain-worker = { path = "../../substrate/frame/examples/offchain-worker" }
 
 # How we build docs in rust-docs
 simple-mermaid = "0.1.1"
 docify = "0.2.8"
+assert_cmd = "2.0.14"
 
 # Polkadot SDK deps, typically all should only be in scope such that we can link to their doc item.
 node-cli = { package = "staging-node-cli", path = "../../substrate/bin/node/cli" }
 kitchensink-runtime = { path = "../../substrate/bin/node/runtime" }
 chain-spec-builder = { package = "staging-chain-spec-builder", path = "../../substrate/bin/utils/chain-spec-builder" }
 subkey = { path = "../../substrate/bin/utils/subkey" }
-frame-system = { path = "../../substrate/frame/system", default-features = false }
-frame-support = { path = "../../substrate/frame/support", default-features = false }
-frame-executive = { path = "../../substrate/frame/executive", default-features = false }
-pallet-example-single-block-migrations = { path = "../../substrate/frame/examples/single-block-migrations" }
 
 # Substrate Client
 sc-network = { path = "../../substrate/client/network" }
 sc-rpc-api = { path = "../../substrate/client/rpc-api" }
 sc-rpc = { path = "../../substrate/client/rpc" }
 sc-client-db = { path = "../../substrate/client/db" }
 sc-cli = { path = "../../substrate/client/cli" }
+sc-chain-spec = { path = "../../substrate/client/chain-spec" }
 sc-consensus-aura = { path = "../../substrate/client/consensus/aura" }
 sc-consensus-babe = { path = "../../substrate/client/consensus/babe" }
 sc-consensus-grandpa = { path = "../../substrate/client/consensus/grandpa" }
@@ -60,9 +55,12 @@ cumulus-pallet-parachain-system = { path = "../../cumulus/pallets/parachain-syst
 	"parameterized-consensus-hook",
 ] }
 parachain-info = { package = "staging-parachain-info", path = "../../cumulus/parachains/pallets/parachain-info" }
-pallet-aura = { path = "../../substrate/frame/aura", default-features = false }
+pallet-aura = { path = "../../substrate/frame/aura" }
 
 # Pallets and FRAME internals
+frame-system = { path = "../../substrate/frame/system" }
+frame-support = { path = "../../substrate/frame/support" }
+frame-executive = { path = "../../substrate/frame/executive" }
 pallet-timestamp = { path = "../../substrate/frame/timestamp" }
 pallet-balances = { path = "../../substrate/frame/balances" }
 pallet-assets = { path = "../../substrate/frame/assets" }
@@ -77,6 +75,14 @@ pallet-democracy = { path = "../../substrate/frame/democracy" }
 pallet-uniques = { path = "../../substrate/frame/uniques" }
 pallet-nfts = { path = "../../substrate/frame/nfts" }
 pallet-scheduler = { path = "../../substrate/frame/scheduler" }
+pallet-examples = { path = "../../substrate/frame/examples" }
+pallet-default-config-example = { path = "../../substrate/frame/examples/default-config" }
+pallet-example-offchain-worker = { path = "../../substrate/frame/examples/offchain-worker" }
+pallet-example-single-block-migrations = { path = "../../substrate/frame/examples/single-block-migrations" }
+pallet-referenda = { path = "../../substrate/frame/referenda" }
+pallet-broker = { path = "../../substrate/frame/broker" }
+pallet-babe = { path = "../../substrate/frame/babe" }
+pallet-grandpa = { path = "../../substrate/frame/grandpa" }
 
 # Primitives
 sp-io = { path = "../../substrate/primitives/io" }
@@ -85,14 +91,21 @@ sp-core = { path = "../../substrate/primitives/core" }
 sp-keyring = { path = "../../substrate/primitives/keyring" }
 sp-runtime = { path = "../../substrate/primitives/runtime" }
 sp-arithmetic = { path = "../../substrate/primitives/arithmetic" }
-
-# Misc pallet dependencies
-pallet-referenda = { path = "../../substrate/frame/referenda" }
-pallet-broker = { path = "../../substrate/frame/broker" }
-pallet-babe = { path = "../../substrate/frame/babe" }
-
 sp-offchain = { path = "../../substrate/primitives/offchain" }
 sp-version = { path = "../../substrate/primitives/version" }
 
 # XCM
 xcm = { package = "staging-xcm", path = "../../polkadot/xcm" }
+
+# Templates
+minimal-template-runtime = { path = "../../templates/minimal/runtime" }
+solochain-template-runtime = { path = "../../templates/solochain/runtime" }
+parachain-template-runtime = { path = "../../templates/parachain/runtime" }
+
+
+# Packages defined right here
+polkadot-sdk-docs-packages-guides-first-pallet = { path = "./packages/guides/first-pallet" }
+polkadot-sdk-docs-packages-guides-first-runtime = { path = "./packages/guides/first-runtime" }
+
+[dev-dependencies]
+nix = { version = "0.28.0", features = ["signal"] }

docs/sdk/packages/guides/first-pallet/Cargo.toml

@@ -0,0 +1,34 @@
+[package]
+name = "polkadot-sdk-docs-packages-guides-first-pallet"
+description = "A simple pallet created for the polkadot-sdk-docs guides"
+version = "0.0.0"
+license = "MIT-0"
+authors.workspace = true
+homepage.workspace = true
+repository.workspace = true
+edition.workspace = true
+publish = false
+
+[lints]
+workspace = true
+
+[package.metadata.docs.rs]
+targets = ["x86_64-unknown-linux-gnu"]
+
+[dependencies]
+codec = { package = "parity-scale-codec", version = "3.0.0", features = [
+	"derive",
+], default-features = false }
+scale-info = { version = "2.10.0", default-features = false, features = [
+	"derive",
+] }
+frame = { package = "polkadot-sdk-frame", path = "../../../../../substrate/frame", default-features = false, features = [
+	"experimental",
+	"runtime",
+] }
+docify = "0.2.7"
+
+
+[features]
+default = ["std"]
+std = ["codec/std", "frame/std", "scale-info/std"]