diff --git a/packages/check/src/main.rs b/packages/check/src/main.rs
index 57c29c504b..eb8cdf26cb 100644
--- a/packages/check/src/main.rs
+++ b/packages/check/src/main.rs
@@ -1,3 +1,8 @@
+//! CosmWasm is a smart contract platform for the Cosmos ecosystem.
+//! This binary provides a CLI tool for verifying CosmWasm smart contracts before uploading to a blockchain.
+//!
+//! For more information, see: <https://docs.cosmwasm.com>
+
 use std::collections::HashSet;
 use std::fs::File;
 use std::io::Read;
diff --git a/packages/core/src/lib.rs b/packages/core/src/lib.rs
index 75f2e6dc17..f6621a083d 100644
--- a/packages/core/src/lib.rs
+++ b/packages/core/src/lib.rs
@@ -1,3 +1,8 @@
+//! CosmWasm is a smart contract platform for the Cosmos ecosystem.
+//! This crate contains components of cosmwasm-std that can be used in no_std environments.
+//!
+//! For more information, see: <https://docs.cosmwasm.com>
+
 #![no_std]
 
 mod crypto;
diff --git a/packages/crypto/src/lib.rs b/packages/crypto/src/lib.rs
index d03256a615..cc8ae5c292 100644
--- a/packages/crypto/src/lib.rs
+++ b/packages/crypto/src/lib.rs
@@ -1,7 +1,12 @@
-//! The crypto crate is intended to be used in internal crates / utils.
-//! Please don't use any of these types directly, as
-//! they might change frequently, or be removed in the future.
-//! This crate does not adhere to semantic versioning.
+//! CosmWasm is a smart contract platform for the Cosmos ecosystem.
+//! This crate implements cryptography-related functions for CosmWasm contracts and internal crates.
+//!
+//! For more information, see: <https://docs.cosmwasm.com>
+
+// The crypto crate is intended to be used in internal crates / utils.
+// Please don't use any of these types directly, as
+// they might change frequently, or be removed in the future.
+// This crate does not adhere to semantic versioning.
 
 extern crate alloc;
 
diff --git a/packages/cw-schema-derive/src/lib.rs b/packages/cw-schema-derive/src/lib.rs
index 13f3cf46f4..8deba52c04 100644
--- a/packages/cw-schema-derive/src/lib.rs
+++ b/packages/cw-schema-derive/src/lib.rs
@@ -1,3 +1,8 @@
+//! Derive macros for cw-schema. For internal use only.
+//!
+//! CosmWasm is a smart contract platform for the Cosmos ecosystem.
+//! For more information, see: <https://docs.cosmwasm.com>
+
 mod expand;
 
 macro_rules! bail {
diff --git a/packages/cw-schema/src/lib.rs b/packages/cw-schema/src/lib.rs
index 406c6b1d56..83dfdc9a3e 100644
--- a/packages/cw-schema/src/lib.rs
+++ b/packages/cw-schema/src/lib.rs
@@ -1,3 +1,8 @@
+//! CosmWasm is a smart contract platform for the Cosmos ecosystem.
+//! This crate is a dependency for CosmWasm contracts to generate schema files for their messages.
+//!
+//! For more information, see: <https://docs.cosmwasm.com>
+
 #![no_std]
 
 extern crate alloc;
diff --git a/packages/derive/src/lib.rs b/packages/derive/src/lib.rs
index 560e13afdb..661167b769 100644
--- a/packages/derive/src/lib.rs
+++ b/packages/derive/src/lib.rs
@@ -1,3 +1,7 @@
+//! Derive macros for CosmWasm contract development. For internal use only. Do not use directly.
+//!
+//! CosmWasm is a smart contract platform for the Cosmos ecosystem.
+//! For more information, see: <https://docs.cosmwasm.com>
 use proc_macro2::TokenStream;
 use quote::{format_ident, quote, ToTokens};
 use std::env;
diff --git a/packages/schema-derive/src/lib.rs b/packages/schema-derive/src/lib.rs
index 187a67cac3..ae783d1628 100644
--- a/packages/schema-derive/src/lib.rs
+++ b/packages/schema-derive/src/lib.rs
@@ -1,3 +1,7 @@
+//! Derive macros for cosmwasm-schema. For internal use only.
+//!
+//! CosmWasm is a smart contract platform for the Cosmos ecosystem.
+//! For more information, see: <https://docs.cosmwasm.com>
 mod cw_serde;
 mod error;
 mod generate_api;
diff --git a/packages/schema/src/lib.rs b/packages/schema/src/lib.rs
index 36698f8879..e47e4239e5 100644
--- a/packages/schema/src/lib.rs
+++ b/packages/schema/src/lib.rs
@@ -1,3 +1,8 @@
+//! CosmWasm is a smart contract platform for the Cosmos ecosystem.
+//! This crate is a dev-dependency for CosmWasm contracts to generate JSON Schema files.
+//!
+//! For more information, see: <https://docs.cosmwasm.com>
+
 mod casing;
 mod export;
 mod idl;
diff --git a/packages/std/src/lib.rs b/packages/std/src/lib.rs
index a7509507b1..d1a53640e3 100644
--- a/packages/std/src/lib.rs
+++ b/packages/std/src/lib.rs
@@ -1,3 +1,8 @@
+//! CosmWasm is a smart contract platform for the Cosmos ecosystem.
+//! This crate provides the standard library for Wasm-based smart contracts on Cosmos blockchains.
+//!
+//! For more information, see: <https://docs.cosmwasm.com>
+
 #[cfg(not(feature = "std"))]
 core::compile_error!(
     r#"Please enable `cosmwasm-std`'s `std` feature, as we might move existing functionality to that feature in the future.
diff --git a/packages/vm-derive/src/lib.rs b/packages/vm-derive/src/lib.rs
index bdbb93846f..58568a5a64 100644
--- a/packages/vm-derive/src/lib.rs
+++ b/packages/vm-derive/src/lib.rs
@@ -1,3 +1,8 @@
+//! Derive macros for cosmwasm-vm. For internal use only. No stability guarantees.
+//!
+//! CosmWasm is a smart contract platform for the Cosmos ecosystem.
+//! For more information, see: <https://docs.cosmwasm.com>
+
 mod hash_function;
 
 macro_rules! maybe {
diff --git a/packages/vm/src/lib.rs b/packages/vm/src/lib.rs
index df26edbcf4..78386c5a1f 100644
--- a/packages/vm/src/lib.rs
+++ b/packages/vm/src/lib.rs
@@ -1,3 +1,8 @@
+//! CosmWasm is a smart contract platform for the Cosmos ecosystem.
+//! This crate provides VM bindings to run CosmWasm contracts.
+//!
+//! For more information, see: <https://docs.cosmwasm.com>
+
 mod backend;
 mod cache;
 mod calls;