Skip to content
README.md 3.96 KiB
Newer Older
Kian Paimani's avatar
Kian Paimani committed

<div align="center">

# Polkadot SDK

Kian Paimani's avatar
Kian Paimani committed
<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>

Kian Paimani's avatar
Kian Paimani committed
![GitHub stars](https://img.shields.io/github/stars/paritytech/polkadot-sdk)&nbsp;&nbsp;![GitHub
forks](https://img.shields.io/github/forks/paritytech/polkadot-sdk)
Kian Paimani's avatar
Kian Paimani committed
[![StackExchange](https://img.shields.io/badge/StackExchange-Community%20&%20Support-222222?logo=stackexchange)](https://substrate.stackexchange.com/)&nbsp;&nbsp;![GitHub contributors](https://img.shields.io/github/contributors/paritytech/polkadot-sdk)&nbsp;&nbsp;![GitHub commit activity](https://img.shields.io/github/commit-activity/m/paritytech/polkadot-sdk)
Kian Paimani's avatar
Kian Paimani committed
![GitHub lines of code](https://tokei.rs/b1/github/paritytech/polkadot-sdk)&nbsp;&nbsp;
![GitHub last commit](https://img.shields.io/github/last-commit/paritytech/polkadot-sdk)
Kian Paimani's avatar
Kian Paimani committed
> 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.
Kian Paimani's avatar
Kian Paimani committed
</div>
Kian Paimani's avatar
Kian Paimani committed
## 📚 Documentation
Kian Paimani's avatar
Kian Paimani committed
* [🦀 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)
Kian Paimani's avatar
Kian Paimani committed
## 🚀 Releases
Kian Paimani's avatar
Kian Paimani committed
> [!NOTE] 
> Our release process is still Work-In-Progress and may not yet reflect the aspired outline
> here.
Kian Paimani's avatar
Kian Paimani committed
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).
Kian Paimani's avatar
Kian Paimani committed
### 😌 Stable
Kian Paimani's avatar
Kian Paimani committed
`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.
Kian Paimani's avatar
Kian Paimani committed
### 🤠 Nightly
Kian Paimani's avatar
Kian Paimani committed
`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`.
Kian Paimani's avatar
Kian Paimani committed
## 🔐 Security
Kian Paimani's avatar
Kian Paimani committed
The security policy and procedures can be found in
[docs/contributor/SECURITY.md](./docs/contributor/SECURITY.md).
Kian Paimani's avatar
Kian Paimani committed
## 🤍 Contributing & Code of Conduct
Kian Paimani's avatar
Kian Paimani committed
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).
Kian Paimani's avatar
Kian Paimani committed
### 👾 Ready to Contribute?
Kian Paimani's avatar
Kian Paimani committed
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.
Kian Paimani's avatar
Kian Paimani committed
## Polkadot Fellowship
Kian Paimani's avatar
Kian Paimani committed
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/).
Kian Paimani's avatar
Kian Paimani committed
## History
Kian Paimani's avatar
Kian Paimani committed
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).