Split crate docs

Author: tuguzT

crates/cargo-gpu-cache/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "cargo-gpu-cache"
-description = "Generates shader .spv files from `rust-gpu` shader crates"
+description = "Builder of `rust-gpu` shader crates"
 readme = "../../README.md"
 version.workspace = true
 edition.workspace = true

crates/cargo-gpu-cache/src/install.rs

@@ -74,8 +74,9 @@ pub struct Install {
     pub shader_crate: PathBuf,
 
     #[expect(
+        rustdoc::bare_urls,
         clippy::doc_markdown,
-        reason = "The URL should appear literally like this. But Clippy wants a markdown clickable link"
+        reason = "The URL should appear literally like this. But Clippy & rustdoc want a markdown clickable link"
     )]
     /// Source of `spirv-builder` dependency
     /// Eg: "https://github.com/Rust-GPU/rust-gpu"

crates/cargo-gpu-cache/src/lib.rs

@@ -2,12 +2,12 @@
 
 //! Rust GPU shader crate builder.
 //!
-//! This program and library allows you to easily compile your rust-gpu shaders,
+//! This library allows you to easily compile your rust-gpu shaders,
 //! without requiring you to fix your entire project to a specific toolchain.
 //!
 //! # How it works
 //!
-//! This program primarily manages installations of `rustc_codegen_spirv`, the
+//! This library primarily manages installations of `rustc_codegen_spirv`, the
 //! codegen backend of rust-gpu to generate SPIR-V shader binaries. The codegen
 //! backend builds on internal, ever-changing interfaces of rustc, which requires
 //! fixing a version of rust-gpu to a specific version of the rustc compiler.
@@ -17,12 +17,12 @@
 //!
 //! We continue to use rust-gpu's `spirv_builder` crate to pass the many additional
 //! parameters required to configure rustc and our codegen backend, but provide you
-//! with a toolchain agnostic version that you may use from stable rustc. And a
-//! `cargo gpu` cmdline utility to simplify shader building even more.
+//! with a toolchain agnostic version that you may use from stable rustc.
+//! And a `cargo gpu` command line utility to simplify shader building even more.
 //!
 //! ## Where the binaries are
 //!
-//! We store our prebuild `rustc_spirv_builder` binaries in the default cache
+//! We store our prebuilt `rustc_spirv_builder` binaries in the default cache
 //! directory of your OS:
 //! * Windows: `C:/users/<user>/AppData/Local/rust-gpu`
 //! * Mac: `~/Library/Caches/rust-gpu`

crates/cargo-gpu/src/main.rs

@@ -1,4 +1,10 @@
-//! main executable of cargo gpu
+//! Command line tool for building Rust shaders using `rust-gpu`.
+//!
+//! This program allows you to easily compile your rust-gpu shaders,
+//! without requiring you to fix your entire project to a specific toolchain.
+//!
+//! For additional information see the [`cargo-gpu-cache`](cargo_gpu_cache) crate documentation.
+
 use cargo_gpu_cache::Cli;
 use clap::Parser as _;