updated docs strings and added README.md

mail_intake/ingestion/__init__.py

@@ -1,10 +1,8 @@
 """
+# Summary
+
 Mail ingestion orchestration for Mail Intake.
 
----
-
-## Summary
-
 This package contains **high-level ingestion components** responsible for
 coordinating mail retrieval, parsing, normalization, and model construction.
 
@@ -12,19 +10,20 @@ It represents the **top of the ingestion pipeline** and is intended to be the
 primary interaction surface for library consumers.
 
 Components in this package:
-- Are provider-agnostic
-- Depend only on adapter and parser contracts
-- Contain no provider-specific API logic
-- Expose read-only ingestion workflows
+
+- Are provider-agnostic.
+- Depend only on adapter and parser contracts.
+- Contain no provider-specific API logic.
+- Expose read-only ingestion workflows.
 
 Consumers are expected to construct a mail adapter and pass it to the
 ingestion layer to begin processing messages and threads.
 
 ---
 
-## Public API
+# Public API
 
-    MailIntakeReader
+- `MailIntakeReader`
 
 ---
 """