docs: add and fix crate-level documentation for all CosmWasm crates (#2510)

Author: GarmashAlex

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://cosmwasm.cosmos.network>
+
 use std::collections::HashSet;
 use std::fs::File;
 use std::io::Read;

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;

packages/crypto/src/lib.rs

@@ -1,7 +1,11 @@
-//! 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.
+//!
+//! **Note:** This crate is intended to be used in internal crates / utils only.
+//! 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.
+//!
+//! For more information, see: <https://cosmwasm.cosmos.network>
 
 extern crate alloc;
 

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://cosmwasm.cosmos.network>
+
 mod expand;
 
 macro_rules! bail {

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://cosmwasm.cosmos.network>
+
 #![no_std]
 
 extern crate alloc;

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://cosmwasm.cosmos.network>
 use proc_macro2::TokenStream;
 use quote::{format_ident, quote, ToTokens};
 use std::env;

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://cosmwasm.cosmos.network>
 mod cw_serde;
 mod error;
 mod generate_api;

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://cosmwasm.cosmos.network>
+
 mod casing;
 mod export;
 mod idl;

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://cosmwasm.cosmos.network>
+
 #[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.

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://cosmwasm.cosmos.network>
+
 mod hash_function;
 
 macro_rules! maybe {