Skip to content

Commit 7dff1d1

Browse files
bkchrggwpez
authored andcommitted
Format the README.md files (paritytech#4688)
Co-authored-by: Oliver Tale-Yazdi <[email protected]>
1 parent e0254b7 commit 7dff1d1

5 files changed

Lines changed: 38 additions & 22 deletions

File tree

.github/workflows/checks-quick.yml

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -117,6 +117,7 @@ jobs:
117117
CONFIG: .github/.markdownlint.yaml
118118
run: |
119119
echo "Checking markdown formatting. More info: docs/contributor/markdown_linting.md"
120+
echo "To fix potential erros, you can run 'markdownlint --config .github/.markdownlint.yaml -f --ignore target .' locally."
120121
markdownlint --config "$CONFIG" --ignore target .
121122
check-umbrella:
122123
runs-on: ubuntu-latest

templates/minimal/README.md

Lines changed: 16 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -6,24 +6,25 @@
66
<img height="70px" alt="Polkadot SDK Logo" src="https://github.com/paritytech/polkadot-sdk/raw/master/docs/images/Polkadot_Logo_Horizontal_Pink_Black.png#gh-light-mode-only"/>
77

88
> This is a minimal template for creating a blockchain based on Polkadot SDK.
9-
>
9+
>
1010
> This template is automatically updated after releases in the main [Polkadot SDK monorepo](https://github.com/paritytech/polkadot-sdk).
1111
1212
</div>
1313

1414
🤏 This template is a minimal (in terms of complexity and the number of components) template for building a blockchain node.
1515

16-
🔧 Its runtime is configured of a single custom pallet as a starting point, and a handful of ready-made pallets such as a [Balances pallet](https://paritytech.github.io/polkadot-sdk/master/pallet_balances/index.html).
16+
🔧 Its runtime is configured of a single custom pallet as a starting point, and a handful of ready-made pallets
17+
such as a [Balances pallet](https://paritytech.github.io/polkadot-sdk/master/pallet_balances/index.html).
1718

1819
👤 The template has no consensus configured - it is best for experimenting with a single node network.
1920

2021
## Template Structure
2122

2223
A Polkadot SDK based project such as this one consists of:
2324

24-
- 💿 a [Node](./node/README.md) - the binary application.
25-
- 🧮 the [Runtime](./runtime/README.md) - the core logic of the blockchain.
26-
- 🎨 the [Pallets](./pallets/README.md) - from which the runtime is constructed.
25+
* 💿 a [Node](./node/README.md) - the binary application.
26+
* 🧮 the [Runtime](./runtime/README.md) - the core logic of the blockchain.
27+
* 🎨 the [Pallets](./pallets/README.md) - from which the runtime is constructed.
2728

2829
## Getting Started
2930

@@ -62,9 +63,9 @@ docker run --rm polkadot-sdk-minimal-template --dev
6263

6364
Development chains:
6465

65-
- 🧹 Do not persist the state.
66-
- 💰 Are preconfigured with a genesis state that includes several prefunded development accounts.
67-
- 🧑‍⚖️ Development accounts are used as `sudo` accounts.
66+
* 🧹 Do not persist the state.
67+
* 💰 Are preconfigured with a genesis state that includes several prefunded development accounts.
68+
* 🧑‍⚖️ Development accounts are used as `sudo` accounts.
6869

6970
### Connect with the Polkadot-JS Apps Front-End
7071

@@ -84,12 +85,16 @@ available on [IPFS](https://dotapps.io/).
8485

8586
➡️ Any pull requests should be directed to this [source](https://github.com/paritytech/polkadot-sdk/tree/master/templates/minimal).
8687

87-
😇 Please refer to the monorepo's [contribution guidelines](https://github.com/paritytech/polkadot-sdk/blob/master/docs/contributor/CONTRIBUTING.md) and [Code of Conduct](https://github.com/paritytech/polkadot-sdk/blob/master/docs/contributor/CODE_OF_CONDUCT.md).
88+
😇 Please refer to the monorepo's
89+
[contribution guidelines](https://github.com/paritytech/polkadot-sdk/blob/master/docs/contributor/CONTRIBUTING.md) and
90+
[Code of Conduct](https://github.com/paritytech/polkadot-sdk/blob/master/docs/contributor/CODE_OF_CONDUCT.md).
8891

8992
## Getting Help
9093

9194
🧑‍🏫 To learn about Polkadot in general, [Polkadot.network](https://polkadot.network/) website is a good starting point.
9295

93-
🧑‍🔧 For technical introduction, [here](https://github.com/paritytech/polkadot-sdk#-documentation) are the Polkadot SDK documentation resources.
96+
🧑‍🔧 For technical introduction, [here](https://github.com/paritytech/polkadot-sdk#-documentation) are
97+
the Polkadot SDK documentation resources.
9498

95-
👥 Additionally, there are [GitHub issues](https://github.com/paritytech/polkadot-sdk/issues) and [Substrate StackExchange](https://substrate.stackexchange.com/).
99+
👥 Additionally, there are [GitHub issues](https://github.com/paritytech/polkadot-sdk/issues) and
100+
[Substrate StackExchange](https://substrate.stackexchange.com/).

templates/minimal/node/README.md

Lines changed: 8 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2,13 +2,17 @@
22

33
ℹ️ A node - in Polkadot - is a binary executable, whose primary purpose is to execute the [runtime](../runtime/README.md).
44

5-
🔗 It communicates with other nodes in the network, and aims for [consensus](https://wiki.polkadot.network/docs/learn-consensus) among them.
5+
🔗 It communicates with other nodes in the network, and aims for
6+
[consensus](https://wiki.polkadot.network/docs/learn-consensus) among them.
67

78
⚙️ It acts as a remote procedure call (RPC) server, allowing interaction with the blockchain.
89

9-
👉 Learn more about the architecture, and a difference between a node and a runtime [here](https://paritytech.github.io/polkadot-sdk/master/polkadot_sdk_docs/reference_docs/wasm_meta_protocol/index.html).
10+
👉 Learn more about the architecture, and a difference between a node and a runtime
11+
[here](https://paritytech.github.io/polkadot-sdk/master/polkadot_sdk_docs/reference_docs/wasm_meta_protocol/index.html).
1012

1113
👇 Here are the most important files in this node template:
1214

13-
- [`chain_spec.rs`](./src/chain_spec.rs): A chain specification is a source code file that defines the chain's initial (genesis) state.
14-
- [`service.rs`](./src/service.rs): This file defines the node implementation. It's a place to configure consensus-related topics. In favor of minimalism, this template has no consensus configured.
15+
- [`chain_spec.rs`](./src/chain_spec.rs): A chain specification is a source code file that defines the chain's
16+
initial (genesis) state.
17+
- [`service.rs`](./src/service.rs): This file defines the node implementation.
18+
It's a place to configure consensus-related topics. In favor of minimalism, this template has no consensus configured.
Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,13 @@
11
# Pallets
22

3-
ℹ️ A pallet is a unit of encapsulated logic, with a clearly defined responsibility. A pallet is analogous to a module in the runtime.
3+
ℹ️ A pallet is a unit of encapsulated logic, with a clearly defined responsibility. A pallet is analogous to a
4+
module in the runtime.
45

56
💁 In this template, there is a simple custom pallet based on the FRAME framework.
67

7-
👉 Learn more about FRAME [here](https://paritytech.github.io/polkadot-sdk/master/polkadot_sdk_docs/polkadot_sdk/frame_runtime/index.html).
8+
👉 Learn more about FRAME
9+
[here](https://paritytech.github.io/polkadot-sdk/master/polkadot_sdk_docs/polkadot_sdk/frame_runtime/index.html).
810

9-
🧑‍🏫 Please refer to [this guide](https://paritytech.github.io/polkadot-sdk/master/polkadot_sdk_docs/guides/your_first_pallet/index.html) to learn how to write a basic pallet.
11+
🧑‍🏫 Please refer to
12+
[this guide](https://paritytech.github.io/polkadot-sdk/master/polkadot_sdk_docs/guides/your_first_pallet/index.html)
13+
to learn how to write a basic pallet.
Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,10 @@
11
# Runtime
22

3-
ℹ️ The runtime (in other words, a state transition function), refers to the core logic of the blockchain that is responsible for
4-
validating blocks and executing the state changes they define.
3+
ℹ️ The runtime (in other words, a state transition function), refers to the core logic of the blockchain that is
4+
responsible for validating blocks and executing the state changes they define.
55

6-
💁 The runtime in this template is constructed using ready-made FRAME pallets that ship with [Polkadot SDK](https://github.com/paritytech/polkadot-sdk), and a [template for a custom pallet](../pallets/README.md).
6+
💁 The runtime in this template is constructed using ready-made FRAME pallets that ship with
7+
[Polkadot SDK](https://github.com/paritytech/polkadot-sdk), and a [template for a custom pallet](../pallets/README.md).
78

8-
👉 Learn more about FRAME [here](https://paritytech.github.io/polkadot-sdk/master/polkadot_sdk_docs/polkadot_sdk/frame_runtime/index.html).
9+
👉 Learn more about FRAME
10+
[here](https://paritytech.github.io/polkadot-sdk/master/polkadot_sdk_docs/polkadot_sdk/frame_runtime/index.html).

0 commit comments

Comments
 (0)