diff --git a/crates_io_cdn_logs/src/cloudfront.rs b/crates_io_cdn_logs/src/cloudfront.rs
index 1876c1a17bc..026c8ac17b5 100644
--- a/crates_io_cdn_logs/src/cloudfront.rs
+++ b/crates_io_cdn_logs/src/cloudfront.rs
@@ -1,3 +1,8 @@
+//! # CloudFront log parsing
+//!
+//! see <https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/AccessLogs.html#LogFileFormat>
+//! and <https://www.w3.org/TR/WD-logfile.html>.
+
 use crate::paths::parse_path;
 use crate::DownloadsMap;
 use chrono::NaiveDate;
diff --git a/crates_io_cdn_logs/src/fastly/mod.rs b/crates_io_cdn_logs/src/fastly/mod.rs
index 8457922d081..0a3c8989eb4 100644
--- a/crates_io_cdn_logs/src/fastly/mod.rs
+++ b/crates_io_cdn_logs/src/fastly/mod.rs
@@ -1,3 +1,7 @@
+//! # Fastly CDN log parsing
+//!
+//! see <https://docs.fastly.com/en/guides/changing-log-line-formats#classic-format>.
+
 mod json;
 
 use crate::paths::parse_path;