penumbra: v0.82.0-alpha.0
#1678
Workflow file for this run
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
name: Docs lint | |
on: pull_request | |
jobs: | |
rustdocs: | |
# We use a custom script to generate the index page for https://rustdoc.penumbra.zone, | |
# and refactors to rust deps can break that generation. Let's ensure this script exits 0 | |
# on PRs, but we'll still only deploy after merge into main. | |
name: rustdoc-lint | |
runs-on: buildjet-8vcpu-ubuntu-2204 | |
steps: | |
- uses: actions/checkout@v4 | |
with: | |
lfs: true | |
- name: Install nightly rust toolchain | |
# The script for rustdoc build requires nightly toolchain. | |
run: rustup toolchain install nightly | |
# Loading cache takes ~15s, but saves us minutes of build. | |
- name: Load rust cache | |
uses: astriaorg/[email protected] | |
# Building with warm cache takes ~40s, depending on changes. | |
- name: Build rustdocs | |
run: ./deployments/scripts/rust-docs | |
# Also validate that the `mdbook` docs (guide & protocol) build correctly. | |
# In particular, links are checked within the docs. | |
mdbook: | |
name: mdbook-lint | |
# Downgrading runner size to 4vcpu, since we're not compiling code. | |
runs-on: buildjet-4vcpu-ubuntu-2204 | |
steps: | |
- uses: actions/checkout@v4 | |
with: | |
lfs: false | |
- name: Load rust cache | |
uses: astriaorg/[email protected] | |
# It's OK to install from crates, building from source, because of cache use | |
# on previous step. Install takes ~5s with warm cache. | |
- name: Install mdbook dependencies | |
run: cargo install mdbook mdbook-katex mdbook-mermaid mdbook-linkcheck | |
- name: Build protocol docs | |
run: cd docs/protocol && mdbook build |