[naga] Fix cargo doc --document-private-items. Add to CI.

.github/workflows/ci.yml

@@ -237,7 +237,11 @@ jobs:
           set -e
 
           # wgpu_core package
-          cargo +${{ env.DOCS_RUST_VERSION }} doc --target ${{ matrix.target }} --all-features --no-deps --package wgpu-core --package wgpu-hal --document-private-items 
+          cargo +${{ env.DOCS_RUST_VERSION }} doc --target ${{ matrix.target }} \
+                --package wgpu-core \
+                --package wgpu-hal \
+                --package naga \
+                --all-features --no-deps --document-private-items
 
   # We run minimal checks on the MSRV of the core crates, ensuring that
   # its dependency tree does not cause issues for firefox.

naga/src/back/hlsl/help.rs

@@ -1334,7 +1334,7 @@ impl<'a, W: Write> super::Writer<'a, W> {
     /// Parenthesizing the expression like `((float4)0).y` would work... except DXC can't handle
     /// cases like:
     ///
-    /// ```ignore
+    /// ```text
     /// tests\out\hlsl\access.hlsl:183:41: error: cannot compile this l-value expression yet
     ///     t_1.am = (__mat4x2[2])((float4x2[2])0);
     ///                                         ^

naga/src/valid/analyzer.rs

@@ -383,6 +383,10 @@ impl FunctionInfo {
     /// refer to a global variable. Those expressions don't contribute
     /// any usage to the global themselves; that depends on how other
     /// expressions use them.
+    ///
+    /// [`assignable_global`]: ExpressionInfo::assignable_global
+    /// [`Access`]: crate::Expression::Access
+    /// [`AccessIndex`]: crate::Expression::AccessIndex
     #[must_use]
     fn add_assignable_ref(
         &mut self,