Explore sharing docs between crates

crates/bitwarden-error/Cargo.toml

@@ -14,14 +14,15 @@ wasm = [
     "bitwarden-error-macro/wasm",
     "dep:js-sys",
     "dep:tsify-next",
-    "dep:wasm-bindgen"
+    "dep:wasm-bindgen",
 ]
 
 [dependencies]
 bitwarden-error-macro = { workspace = true }
 js-sys = { workspace = true, optional = true }
 tsify-next = { workspace = true, optional = true }
 wasm-bindgen = { workspace = true, optional = true }
+documented = "0.9.1"
 
 [lints]
 workspace = true

crates/bitwarden-error/src/lib.rs

@@ -15,6 +15,7 @@ pub use ::tsify_next;
 #[cfg(feature = "wasm")]
 #[doc(hidden)]
 pub use ::wasm_bindgen;
+use documented::docs_const;
 
 pub mod prelude {
     pub use bitwarden_error_macro::*;
@@ -23,3 +24,9 @@ pub mod prelude {
     #[cfg(feature = "wasm")]
     pub use crate::wasm::SdkJsError;
 }
+
+/// A test function.
+#[docs_const]
+pub fn test() {
+    println!("Hello, world!");
+}

crates/bitwarden-wasm-internal/Cargo.toml

@@ -29,5 +29,8 @@ serde_json = ">=1.0.96, <2.0"
 wasm-bindgen = { version = "=0.2.99", features = ["serde-serialize"] }
 wasm-bindgen-futures = "0.4.41"
 
+[build-dependencies]
+bitwarden-error = { version = "1.0.0", path = "../bitwarden-error" }
+
 [lints]
 workspace = true

crates/bitwarden-wasm-internal/build.rs

@@ -1,6 +1,9 @@
 use std::{env, process::Command};
 
 fn main() {
+
+    std::fs::write("doc/test.md", bitwarden_error::TEST_DOCS).unwrap();
+
     // Use the SDK_VERSION environment variable if it is set (e.g. by CI) or get it from Git
     let sdk_version = env::var("SDK_VERSION")
         .or_else(|_| version_from_git_info())

crates/bitwarden-wasm-internal/src/lib.rs

@@ -7,3 +7,8 @@ mod vault;
 pub use client::BitwardenClient;
 pub use crypto::CryptoClient;
 pub use vault::{folders::ClientFolders, VaultClient};
+
+#[doc = include_str!("../doc/test.md")]
+pub fn test2() {
+    println!("Hello, world!");
+}