The Polkadot Wiki is the central source of truth for Polkadot. It is a community-focused initiative led by the Web3 Foundation to keep an up-to-date resource on the best information for building on Polkadot, learning about Polkadot, or maintaining a node on Polkadot.
The Wiki is a community-focused initiative and we will review all pull-requests and issues created in this repository. If you notice typos or grammatical errors, please feel free to directly create pull requests with these corrections. Larger contributions may start as issues to test the waters on the subject with the maintainers. It is generally preferable to create a pull request over an issue to propose a change to the wiki content.
Use the style guide from the Substrate Knowledge Base
Use Prettier to format markdown pages. To run Prettier on the docs folder,
run:
npx prettier --write ./docs/The wiki is automatically deployed to GitHub Pages via the CircleCI job on each new commit to the master branch.
This documentation sometimes makes references to on-chain values that may change over time. For
example, it might reference the current number of validators. A custom script exists to populate
these values post-build. To avoid conflicts in source files, the replacement is done on built
files, not the MD files. The value placeholders are defined in
website/inject-dict.json. The placeholders should be included in text
surrounded by double curly braces, like so: {{ num_validators }}.
To use the replace script:
cd website
node inject.jsThis will read the dictionary and do the replacements.
It is recommended to use the dry run option when adding new values and templates in, to make sure
they resolve to values first and don't throw query errors. To use dry run (no replace, just output
of templates and their resolved potential replacements), use the --dry or -d flag:
node inject.js --dryThe script defaults to the websocket URL wss://kusama-rpc.polkadot.io/. To change to another URL
or to connect to a local node, use the --node/-n flag:
node inject.js -n ws:localhost:9944Note: make sure you're running an archive node if you're querying into the past!
See other available options by using the help command.
node inject.js helpA limitation of Docusaurus is that pages can only be included in one sidebar at any given time. Thus, our Kusama section will either hijack some content it shares with the rest of the wiki, or lack that content.
To solve this, the repo mirrors some pages and includes them in additional sidebars. The website
folder contains a mirror.js script that creates a copy of the pages to duplicate across sidebars.
The new pages are prefixed with mirror, and first need to be declared in mirror.js and added to
the relevant sidebar section. To run the script:
node mirror.jsWe are using Crowdin to manage all different translations. You can go to the
project page and select the language you would like to
translate to start.
All translated content through Crowdin will regularly submit a pull request to this repository.
If you do not see the language you would like to translate, please let us know via Riot.
The Polkadot Wiki is licensed under the GPL-3.0 free software license.