Skip to content
Snippets Groups Projects
Commit 6cc91f91 authored by Marcin S.'s avatar Marcin S. Committed by GitHub
Browse files

Add a `last change` footer to the implementers guide (#6216)

* Add a `last change` footer to the implementers guide

Some of the newcomers were noticing outdated pages in the implementer's guide.
This idea came up as a heuristic for how up-to-date an individual page is.

* Update `build-implementers-guide` CI job
parent fb40925e
No related merge requests found
......@@ -4,13 +4,14 @@ The implementers' guide is compiled from several source files with [`mdBook`](ht
## Hosted build
This is avalible at https://paritytech.github.io/polkadot/book/
This is available [here](https://paritytech.github.io/polkadot/book/).
## Local build
To view it locally from the repo root:
Ensure graphviz is installed:
```sh
brew install graphviz # for macOS
sudo apt-get install graphviz # for Ubuntu/Debian
......@@ -19,11 +20,11 @@ sudo apt-get install graphviz # for Ubuntu/Debian
Then install and build the book:
```sh
cargo install mdbook mdbook-linkcheck mdbook-graphviz mdbook-mermaid
cargo install mdbook mdbook-linkcheck mdbook-graphviz mdbook-mermaid mdbook-last-changed
mdbook serve roadmap/implementers-guide
open http://localhost:3000
```
## Specification
See also the Polkadot specificaton [hosted](https://spec.polkadot.network/), and it's [source](https://github.com/w3f/polkadot-spec)).
See also the Polkadot specification [hosted](https://spec.polkadot.network/), and its [source](https://github.com/w3f/polkadot-spec).
......@@ -9,8 +9,14 @@ title = "The Polkadot Parachain Host Implementers' Guide"
command = "mdbook-graphviz"
[preprocessor.mermaid]
command = "mdbook-mermaid"
[preprocessor.last-changed]
command = "mdbook-last-changed"
renderer = ["html"]
[output.html]
additional-css = ["last-changed.css"]
additional-js = ["mermaid.min.js", "mermaid-init.js"]
# Repository URL used in the last-changed link.
git-repository-url = "https://github.com/paritytech/polkadot"
[output.linkcheck]
footer {
font-size: 0.8em;
text-align: center;
margin-top: 50px;
border-top: 1px solid black;
padding: 5px 0;
}
......@@ -170,7 +170,7 @@ build-implementers-guide:
- .collect-artifacts-short
script:
- apt-get -y update; apt-get install -y graphviz
- cargo install mdbook mdbook-mermaid mdbook-linkcheck mdbook-graphviz
- cargo install mdbook mdbook-mermaid mdbook-linkcheck mdbook-graphviz mdbook-last-changed
- mdbook build ./roadmap/implementers-guide
- mkdir -p artifacts
- mv roadmap/implementers-guide/book artifacts/
......
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment