diff --git a/src/lib.rs b/src/lib.rs
index 7a2bf2b..96eb92a 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -1,7 +1,12 @@
 #![no_std]
 
-//! https://www.usb.org/sites/default/files/DWG_Smart-Card_CCID_Rev110.pdf
-//! https://www.usb.org/sites/default/files/DWG_Smart-Card_USB-ICC_ICCD_rev10.pdf
+//! CCID descriptor and USB CCID class implementation.
+//!
+//! This crate implements CCID communication to a USB host, and sends the resulting APDUs to an [Interchange](https://docs.rs/interchange)
+//!
+//! [CCID Specification for Integrated Circuit(s) Cards Interface Devices](https://www.usb.org/sites/default/files/DWG_Smart-Card_CCID_Rev110.pdf)
+//!
+//! [CCID SpecificationUSB Integrated Circuit(s) Card Devices](https://www.usb.org/sites/default/files/DWG_Smart-Card_USB-ICC_ICCD_rev10.pdf)
 
 #[macro_use]
 extern crate delog;