diff --git a/crates/composefs/src/repository_format.rs b/crates/composefs/src/repository_format.rs
index 47a8f600..433834ee 100644
--- a/crates/composefs/src/repository_format.rs
+++ b/crates/composefs/src/repository_format.rs
@@ -2,7 +2,8 @@
 //!
 //! This document describes the current on-disk layout of a composefs repository.
 //!
-//! At this time, the composefs-rs repository format is not declared stable.
+//! The composefs-rs repository format is stable as of composefs-rs 0.8, including
+//! the format of splitstreams, the bit-for-bit generated (v1) EROFS images, etc.
 //!
 //! ## Location
 //!