diff --git a/src/lib.rs b/src/lib.rs
index 41824950..d241509c 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -19,9 +19,9 @@ mod spec;
 mod reader_spec;
 mod writer_spec;
 mod crc32;
-mod reader;
+pub mod reader;
 mod types;
 pub mod compression;
-mod writer;
+pub mod writer;
 mod cp437;
 pub mod result;
diff --git a/src/reader.rs b/src/reader.rs
index 52bd00df..5bb0f856 100644
--- a/src/reader.rs
+++ b/src/reader.rs
@@ -1,3 +1,5 @@
+//! Structs for reading a ZIP archive
+
 use crc32::Crc32Reader;
 use types::ZipFile;
 use compression::CompressionMethod;
@@ -44,6 +46,7 @@ pub struct ZipReader<T>
     names_map: HashMap<String, usize>,
 }
 
+/// Iterator over the files contained in a zip archive
 pub struct ZipFileIterator<'a>
 {
     inner: ::std::slice::Iter<'a, ZipFile>,
diff --git a/src/writer.rs b/src/writer.rs
index 6a067208..e31775ca 100644
--- a/src/writer.rs
+++ b/src/writer.rs
@@ -1,3 +1,5 @@
+//! Structs for creating a new zip archive
+
 use compression::CompressionMethod;
 use types::ZipFile;
 use spec;