feat(docs): Adds mkdocs for project documentation

.github/workflows/docs.yml

@@ -0,0 +1,20 @@
+name: Publish docs via GitHub Pages
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  build:
+    name: Deploy docs
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout main 
+        uses: actions/checkout@v2
+
+      - name: Deploy docs
+        uses: mhausenblas/mkdocs-deploy-gh-pages@master
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          CONFIG_FILE: ./mkdocs.yml
+          EXTRA_PACKAGES: build-base

README.md

@@ -4,9 +4,11 @@
 
 A Polkadot ecosystem index for investors. A self sustaining auction treasury for parachains.
 
-Organized by the Stateless Money validator, governed by a community that includes Polychain Capital, Hypersphere Ventures, HashKey Capital, Acala, and built by ChainSafe as a StakerDAO product. 
+Organized by the Stateless Money validator, governed by a community that includes Polychain Capital, Hypersphere
+Ventures, HashKey Capital, Acala, and built by ChainSafe as a StakerDAO product.
 
-For more information on the project please visit [Polkadot Index Network Token](https://docs.polkadotindex.com/) documentation.
+For more information on the project please visit [Polkadot Index Network Token](https://docs.polkadotindex.com/)
+documentation.
 
 ❗**Current development should be considered a work in progress.**
 
@@ -21,7 +23,8 @@ Follow these steps to prepare a local Substrate development environment :hammer_
 
 ### Setup
 
-This project currently builds against Rust nightly-2021-01-26. Assuming you have rustup already insatlled set up your local environment:
+This project currently builds against Rust nightly-2021-01-26. Assuming you have rustup already insatlled set up your
+local environment:
 
 ```shell
 rustup install nightly-2021-01-26
@@ -39,15 +42,32 @@ Once the development environment is set up, build the node template. This comman
 cargo build --release
 ```
 
-Note: If the build fails with `(signal: 9, SIGKILL: kill)` it has probably run out of memory. Try freeing some memory or build on another machine.
+Note: If the build fails with `(signal: 9, SIGKILL: kill)` it has probably run out of memory. Try freeing some memory or
+build on another machine.
 
 ## Run
 
+### Development Chain
+
+You can start a standalone development chain with:
+
+```bash
+cargo run -- --dev --instant-sealing
+```
+
+Or if already built
+
+```bash
+./target/release/pint --dev --instant-sealing
+```
+
+This will use the [`node/src/chain_spec/dev.rs`](node/src/chain_spec/dev.rs) chain spec.
+
 ### Local Testnet
 
 Polkadot (release-v0.9.x branch)
 
-```
+```bash
 cargo build --release
 
 ./target/release/polkadot build-spec --chain rococo-local --raw --disable-default-bootnode > rococo_local.json
@@ -59,20 +79,21 @@ cargo build --release
 
 PINT Parachain:
 
-```
+```bash
 # this command assumes the chain spec is in a directory named polkadot that is a sibling of the pint directory
 ./target/release/pint --collator --alice --chain pint-dev --ws-port 9945 --parachain-id 200 --rpc-cors all -- --execution wasm --chain ../polkadot/rococo_local.json --ws-port 9977 --rpc-cors all
 ```
 
 ### Registering on Local Relay Chain
 
-In order to produce blocks you will need to register the parachain as detailed in the [Substrate Cumulus Workshop](https://substrate.dev/cumulus-workshop/#/en/3-parachains/2-register) by going to
+In order to produce blocks you will need to register the parachain as detailed in
+the [Substrate Cumulus Workshop](https://substrate.dev/cumulus-workshop/#/en/3-parachains/2-register) by going to
 
 Developer -> sudo -> paraSudoWrapper -> sudoScheduleParaInitialize(id, genesis)
 
 Ensure you set the `ParaId` to `200` and the `parachain: Bool` to `Yes`.
 
-```
+```bash
 cargo build --release
 # Build the Chain spec
 ./target/release/pint build-spec --disable-default-bootnode > ./pint-local-plain.json
@@ -85,11 +106,18 @@ cargo build --release
 ./target/release/pint export-genesis-wasm > ./para-200.wasm
 ```
 
-
-* [polkadot-launch](https://github.com/paritytech/polkadot-launch) can be run by dropping the proper polkadot binary in the  `./bin` folder and
+* [polkadot-launch](https://github.com/paritytech/polkadot-launch) can be run by dropping the proper polkadot binary in
+  the  `./bin` folder and
     * Run globally
         * `polkadot-launch config.json`
     * Run locally, navigate into polkadot-launch,
         * ``` yarn ```
         * ``` yarn start ```
 
+### Documentation
+
+## Commands
+
+* `mkdocs serve` - Start the live-reloading docs server.
+* `mkdocs build` - Build the documentation site.
+* `mkdocs -h` - Print help message and exit.

docs/.gitignore

@@ -0,0 +1 @@
+_site

docs/404.html

@@ -0,0 +1,25 @@
+---
+layout: default
+permalink: /404.html
+---
+
+<style type="text/css" media="screen">
+  .container {
+    margin: 10px auto;
+    max-width: 600px;
+    text-align: center;
+  }
+  h1 {
+    margin: 30px 0;
+    font-size: 4em;
+    line-height: 1;
+    letter-spacing: -1px;
+  }
+</style>
+
+<div class="container">
+  <h1>404</h1>
+
+  <p><strong>Page not found :(</strong></p>
+  <p>The requested page could not be found.</p>
+</div>

docs/assets/css/style.scss

@@ -0,0 +1,47 @@
+body {
+    color: #BBB !important;
+    font-family: "ubuntu", sans-serif;
+    line-height: 1.75 !important;
+}
+
+header, footer {
+    border: 0 !important;
+    padding: 2% 0 !important;
+}
+
+h1, h2, h3, h4, h5 {
+    color: #CCC;
+    font-weight: 500;
+    padding-top: 2%;
+}
+
+h1.title {
+    font-size: 110%;
+}
+
+b, strong {
+    color: #CCC;
+}
+
+a {
+    color: #e6087b !important;
+}
+
+a:hover {
+    color: #EEE !important;
+    text-decoration: none;
+    transition: 0.1s;
+}
+
+ul, li {
+    padding: 0.5% 0;
+}
+
+code {
+    padding: 4px;
+}
+
+pre {
+    font-size: 17px;
+    padding: 10px 16px;
+}