From b472d65a588cf850b225ebb9181b0e204e0c589a Mon Sep 17 00:00:00 2001
From: Liu-Cheng Xu <xuliuchengxlc@gmail.com>
Date: Mon, 25 Oct 2021 11:49:31 +0800
Subject: [PATCH] Deploy rustdoc on GitHub Pages

---
 .github/workflows/rustdoc.yml | 45 +++++++++++++++++++++++++++++++++++
 1 file changed, 45 insertions(+)
 create mode 100644 .github/workflows/rustdoc.yml

diff --git a/.github/workflows/rustdoc.yml b/.github/workflows/rustdoc.yml
new file mode 100644
index 0000000000000..ccfc406ce235d
--- /dev/null
+++ b/.github/workflows/rustdoc.yml
@@ -0,0 +1,45 @@
+name: rustdoc
+
+on:
+  push:
+   branches:
+   - main
+
+env:
+  CARGO_INCREMENTAL: 0
+  CARGO_NET_RETRY: 10
+  RUSTFLAGS: "-D warnings -W unreachable-pub"
+  RUSTUP_MAX_RETRIES: 10
+
+jobs:
+  rustdoc:
+    runs-on: ubuntu-latest
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v2
+
+    - name: Install Rust toolchain
+      uses: actions-rs/toolchain@v1
+      with:
+        toolchain: nightly
+        target: wasm32-unknown-unknown
+        profile: minimal
+        override: true
+        components: rustfmt, rust-src
+
+      # Build the rust crate docs
+      # Use `RUSTC_BOOTSTRAP` in order to use the `--enable-index-page` flag of rustdoc
+      # This is needed in order to generate a landing page `index.html` for workspaces
+    - name: Build Documentation
+      run: cargo doc --all --no-deps --lib
+      env:
+          RUSTC_BOOTSTRAP: 1
+          RUSTDOCFLAGS: "-Z unstable-options --enable-index-page"
+
+    - name: Deploy Docs
+      uses: JamesIves/github-pages-deploy-action@releases/v3
+      with:
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        BRANCH: gh-pages
+        FOLDER: target/doc