-
Notifications
You must be signed in to change notification settings - Fork 720
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
..and other high level docs. # Polling Please vote in the reactions of this PR - 👍 I agree to replace the website of this repo to https://paritytech.github.io/polkadot-sdk/master/polkadot_sdk_docs/index.html - 👎 Keep it as polkadot.network - 🤷 Different opinion --------- Co-authored-by: Bastian Köcher <[email protected]>
- Loading branch information
1 parent
8dbe4ee
commit ae864e6
Showing
5 changed files
with
61 additions
and
57 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,81 +1,84 @@ | ||
| > NOTE: We have recently made significant changes to our repository structure. In order to streamline our development | ||
| process and foster better contributions, we have merged three separate repositories Cumulus, Substrate and Polkadot into | ||
| this repository. Read more about the changes [ | ||
| here](https://polkadot-public.notion.site/Polkadot-SDK-FAQ-fbc4cecc2c46443fb37b9eeec2f0d85f). | ||
|
|
||
| <div align="center"> | ||
|
|
||
| # Polkadot SDK | ||
|
|
||
|  | ||
| <picture> | ||
| <source media="(prefers-color-scheme: dark)" srcset="docs/images/Polkadot_Logo_Horizontal_Pink_White.png"> | ||
| <source media="(prefers-color-scheme: light)" srcset="docs/images/Polkadot_Logo_Horizontal_Pink_White.png"> | ||
| </picture> | ||
|
|
||
|
|
||
| [](https://substrate.stackexchange.com/) | ||
|   | ||
|
|
||
| The Polkadot SDK repository provides all the resources needed to start building on the Polkadot network, a multi-chain | ||
| blockchain platform that enables different blockchains to interoperate and share information in a secure and scalable | ||
| way. The Polkadot SDK comprises three main pieces of software: | ||
| [](https://substrate.stackexchange.com/)   | ||
|
|
||
| ## [Polkadot](./polkadot/) | ||
| [](https://forum.polkadot.network/) | ||
| [](./polkadot/LICENSE) | ||
|  | ||
|  | ||
|
|
||
| Implementation of a node for the https://polkadot.network in Rust, using the Substrate framework. This directory | ||
| currently contains runtimes for the Westend and Rococo test networks. Polkadot, Kusama and their system chain runtimes | ||
| are located in the [`runtimes`](https://github.com/polkadot-fellows/runtimes/) repository maintained by | ||
| [the Polkadot Technical Fellowship](https://polkadot-fellows.github.io/dashboard/#/overview). | ||
| > The Polkadot SDK repository provides all the components needed to start building on the | ||
| > [Polkadot](https://polkadot.network) network, a multi-chain blockchain platform that enables | ||
| > different blockchains to interoperate and share information in a secure and scalable way. | ||
| ## [Substrate](./substrate/) | ||
| [](https://paritytech.github.io/polkadot-sdk/master/polkadot_sdk_docs/polkadot_sdk/substrate/index.html) | ||
| [](./substrate/README.md#LICENSE) | ||
| </div> | ||
|
|
||
| Substrate is the primary blockchain SDK used by developers to create the parachains that make up the Polkadot network. | ||
| Additionally, it allows for the development of self-sovereign blockchains that operate completely independently of | ||
| Polkadot. | ||
| ## 📚 Documentation | ||
|
|
||
| ## [Cumulus](./cumulus/) | ||
| [](https://paritytech.github.io/polkadot-sdk/master/polkadot_sdk_docs/polkadot_sdk/cumulus/index.html) | ||
| [](./cumulus/LICENSE) | ||
| * [🦀 rust-docs]([paritytech.github.io/](https://paritytech.github.io/polkadot-sdk/master/polkadot_sdk_docs/index.html)) | ||
| * [Introduction](https://paritytech.github.io/polkadot-sdk/master/polkadot_sdk_docs/polkadot_sdk/index.html) | ||
| to each component of the Polkadot SDK: Substrate, FRAME, Cumulus, and XCM | ||
| * Other Resources: | ||
| * [Polkadot Wiki -> Build](https://wiki.polkadot.network/docs/build-guide) | ||
|
|
||
| Cumulus is a set of tools for writing Substrate-based Polkadot parachains. | ||
| ## 🚀 Releases | ||
|
|
||
| ## Releases | ||
| > [!NOTE] | ||
| > Our release process is still Work-In-Progress and may not yet reflect the aspired outline | ||
| > here. | ||
| > [!NOTE] | ||
| > Our release process is still Work-In-Progress and may not yet reflect the aspired outline here. | ||
| The Polkadot-SDK has two release channels: `stable` and `nightly`. Production software is advised to | ||
| only use `stable`. `nightly` is meant for tinkerers to try out the latest features. The detailed | ||
| release process is described in [RELEASE.md](docs/RELEASE.md). | ||
|
|
||
| The Polkadot-SDK has two release channels: `stable` and `nightly`. Production software is advised to only use `stable`. | ||
| `nightly` is meant for tinkerers to try out the latest features. The detailed release process is described in | ||
| [RELEASE.md](docs/RELEASE.md). | ||
| ### 😌 Stable | ||
|
|
||
| ### Stable | ||
| `stable` releases have a support duration of **three months**. In this period, the release will not | ||
| have any breaking changes. It will receive bug fixes, security fixes, performance fixes and new | ||
| non-breaking features on a **two week** cadence. | ||
|
|
||
| `stable` releases have a support duration of **three months**. In this period, the release will not have any breaking | ||
| changes. It will receive bug fixes, security fixes, performance fixes and new non-breaking features on a **two week** | ||
| cadence. | ||
| ### 🤠 Nightly | ||
|
|
||
| ### Nightly | ||
| `nightly` releases are released every night from the `master` branch, potentially with breaking | ||
| changes. They have pre-release version numbers in the format `major.0.0-nightlyYYMMDD`. | ||
|
|
||
| `nightly` releases are released every night from the `master` branch, potentially with breaking changes. They have | ||
| pre-release version numbers in the format `major.0.0-nightlyYYMMDD`. | ||
| ## 🔐 Security | ||
|
|
||
| ## Upstream Dependencies | ||
| The security policy and procedures can be found in | ||
| [docs/contributor/SECURITY.md](./docs/contributor/SECURITY.md). | ||
|
|
||
| Below are the primary upstream dependencies utilized in this project: | ||
| ## 🤍 Contributing & Code of Conduct | ||
|
|
||
| - [`parity-scale-codec`](https://crates.io/crates/parity-scale-codec) | ||
| - [`parity-db`](https://crates.io/crates/parity-db) | ||
| - [`parity-common`](https://github.com/paritytech/parity-common) | ||
| - [`trie`](https://github.com/paritytech/trie) | ||
| Ensure you follow our [contribution guidelines](./docs/contributor/CONTRIBUTING.md). In every | ||
| interaction and contribution, this project adheres to the [Contributor Covenant Code of | ||
| Conduct](./docs/contributor/CODE_OF_CONDUCT.md). | ||
|
|
||
| ## Security | ||
| ### 👾 Ready to Contribute? | ||
|
|
||
| The security policy and procedures can be found in [docs/contributor/SECURITY.md](./docs/contributor/SECURITY.md). | ||
| Take a look at the issues labeled with [`mentor`](https://github.com/paritytech/polkadot-sdk/labels/C1-mentor) (or alternatively [this](https://mentor.tasty.limo/) page, created by one of | ||
| the maintainers) label to get started! We always recognize valuable contributions by proposing an | ||
| on-chain tip to the Polkadot network as a token of our appreciation. | ||
|
|
||
| ## Contributing & Code of Conduct | ||
| ## Polkadot Fellowship | ||
|
|
||
| Ensure you follow our [contribution guidelines](./docs/contributor/CONTRIBUTING.md). In every interaction and | ||
| contribution, this project adheres to the [Contributor Covenant Code of Conduct](./docs/contributor/CODE_OF_CONDUCT.md). | ||
| Development in this repo usually goes hand in hand with the `fellowship` organization. In short, | ||
| this repository provides all the SDK pieces needed to build both Polkadot and its parachains. But, | ||
| the actual Polkadot runtime lives in the `fellowship/runtimes` repository. Read more about the | ||
| fellowship, this separation, the RFC process | ||
| [here](https://polkadot-fellows.github.io/dashboard/). | ||
|
|
||
| ## Additional Resources | ||
| ## History | ||
|
|
||
| - For monitoring upcoming changes and current proposals related to the technical implementation of the Polkadot network, | ||
| visit the [`Requests for Comment (RFC)`](https://github.com/polkadot-fellows/RFCs) repository. While it's maintained | ||
| by the Polkadot Fellowship, the RFC process welcomes contributions from everyone. | ||
| This repository is the amalgamation of 3 separate repositories that used to make up Polkadot SDK, | ||
| namely Substrate, Polkadot and Cumulus. Read more about the merge and its history | ||
| [here](https://polkadot-public.notion.site/Polkadot-SDK-FAQ-fbc4cecc2c46443fb37b9eeec2f0d85f). |
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters