Skip to content

penumbra: v0.82.0-alpha.0 #1678

penumbra: v0.82.0-alpha.0

penumbra: v0.82.0-alpha.0 #1678

Workflow file for this run

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