diff --git a/md5/README.md b/md5/README.md
index 2248d95f4..d0beb244e 100644
--- a/md5/README.md
+++ b/md5/README.md
@@ -22,6 +22,12 @@ Collision attacks against MD5 are both practical and trivial, and
 [RFC 6151] advises no new IETF protocols can be designed MD5-based constructions,
 including HMAC-MD5.
 
+## Library name
+
+Note that this crate is named as `md-5` (the `md5` crate is not part of the RustCrypto project),
+but it renames the library to `md5`. In other words, in your Cargo.toml you should use
+`md_5 = "0.11"`, but in you source code imports from this crate will look like `use md5::Md5;`.
+
 ## Examples
 
 ```rust