[rs] Merge #407

407: Build Docs with Nightly r=kvark a=cwfitzgerald

This builds docs with nightly by default. We use intra-doc links which is currently only supported with nightly. docs.rs also uses the latest nightly to build our code, so this will match behavior with docs.rs. I added a fallback to stable in case nightly has issues so we still have working docs.

Co-authored-by: Connor Fitzgerald <connorwadefitzgerald@gmail.com>

.github/workflows/docs.yml

@@ -13,8 +13,20 @@ jobs:
       - name: Checkout the code
         uses: actions/checkout@v2
 
-      - name: Build the docs
-        run: cargo doc --lib --all-features
+      - name: Install latest nightly
+        uses: actions-rs/toolchain@v1
+        with:
+          toolchain: nightly
+          override: true
+        continue-on-error: true
+
+      - name: Build the docs (nightly)
+        run: |
+          cargo +nightly doc --lib --all-features
+
+      - name: Build the docs (stable)
+        run: cargo +stable doc --lib --all-features
+        if: ${{ failure() }}
 
       - name: Deploy the docs
         uses: JamesIves/github-pages-deploy-action@releases/v3