Add quote crate documentation

Also adds missing linksubs for cfg-if, extension-trait, rand_chacha,
rand_pcg, and quote docs. Updates task instructions to explain linksubs.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: brson

botdocs/tasks.md

@@ -141,8 +141,15 @@ not documented and document it. Include the docs via lib.rs per previous crates.
 3. **Create documentation file:** `crates/rustmax/doc-src/crate-NAME.md`
   - follow existing conventions to create content
 4. **Update lib.rs:** replace module contents per other crates
-5. **Update linksubs.json5:** Add entries for any cross-references in your documentation
-6. **Test with `just doc-crates`:** Run and check for "unreplaced link" warnings
+5. **Update linksubs.json5:** The crate docs are rendered in two contexts:
+   as rustdoc module docs (where `crate::` links resolve automatically),
+   and as standalone HTML on the crates.html page (where they don't).
+   `src/linksubs.json5` maps `crate::` rustdoc link targets to actual HTML paths
+   so they work on crates.html. Every `crate::` link reference definition
+   in your doc file (the `[`Foo`]: crate::bar::Foo` lines at the bottom)
+   needs a corresponding entry in linksubs.json5 unless one already exists.
+   The value is the relative HTML path, e.g. `"api/some_crate/struct.Foo.html"`.
+6. **Test with `just doc-api`:** Run and check for warnings
 7. **Verify crates.json5:** Usually already has the crate entry, but check it has appropriate metadata
 
 Examples should be runnable. Test with

crates/rustmax/doc-src/crate-quote.md

@@ -0,0 +1,43 @@
+Quasi-quoting for generating Rust source code as tokens.
+
+- Crate [`::quote`].
+- [docs.rs](https://docs.rs/quote)
+- [crates.io](https://crates.io/crates/quote)
+- [GitHub](https://github.com/dtolnay/quote)
+
+---
+
+`quote` provides the [`quote!`] macro,
+which turns Rust syntax into a [`proc_macro2::TokenStream`].
+It is one of the three foundational crates for writing procedural macros,
+alongside [`syn`] for parsing and [`proc_macro2`] for token representation.
+
+The `quote!` macro supports interpolation of variables with `#var`
+and repetition with `#( ... )*`, mirroring the patterns of `macro_rules!`.
+
+## Example
+
+Generating a token stream with interpolation:
+
+```rust
+use quote::quote;
+use proc_macro2::Ident;
+
+let name = Ident::new("Greeter", proc_macro2::Span::call_site());
+let field_name = Ident::new("message", proc_macro2::Span::call_site());
+
+let tokens = quote! {
+    struct #name {
+        #field_name: String,
+    }
+};
+
+let code = tokens.to_string();
+assert!(code.contains("struct Greeter"));
+assert!(code.contains("message : String"));
+```
+
+[`quote!`]: crate::quote::quote
+[`proc_macro2::TokenStream`]: crate::proc_macro2::TokenStream
+[`syn`]: crate::syn
+[`proc_macro2`]: crate::proc_macro2

crates/rustmax/src/lib.rs

@@ -568,9 +568,7 @@ pub mod proptest {
 
 #[cfg(feature = "quote")]
 pub mod quote {
-    //! The `quote!` macro for turning code blocks into source tokens.
-    //!
-    //! See crate [`::quote`].
+    #![doc = include_str!("../doc-src/crate-quote.md")]
 
     pub use ::quote::*;
 }

src/linksubs.json5

@@ -639,6 +639,34 @@
     "crate::std::ffi":
     "api/std/ffi/index.html",
 
+    // cfg-if
+    "crate::cfg_if::cfg_if":
+    "api/cfg_if/macro.cfg_if.html",
+
+    // extension-trait
+    "crate::extension_trait::extension_trait":
+    "api/extension_trait/attr.extension_trait.html",
+
+    // rand_chacha
+    "crate::rand_chacha::ChaCha20Rng":
+    "api/rand_chacha/struct.ChaCha20Rng.html",
+    "crate::rand_chacha::ChaCha8Rng":
+    "api/rand_chacha/struct.ChaCha8Rng.html",
+
+    // rand_pcg
+    "crate::rand_pcg::Pcg32":
+    "api/rand_pcg/type.Pcg32.html",
+
+    // quote
+    "crate::quote::quote":
+    "api/quote/macro.quote.html",
+    "crate::proc_macro2::TokenStream":
+    "api/proc_macro2/struct.TokenStream.html",
+    "crate::syn":
+    "api/rustmax/syn/index.html",
+    "crate::proc_macro2":
+    "api/rustmax/proc_macro2/index.html",
+
     // zip
     "crate::zip::ZipArchive":
     "api/zip/read/struct.ZipArchive.html",