epub3 inbound filter

README.md

@@ -1,3 +1,22 @@
-# repo-seed
+# markitect-filter
 
-A git repository template to bootstrap coulomb projects from.
+`markitect-filter` provides concrete source-format adapters for converting
+external document formats into canonical Markitect Markdown representations.
+
+The first adapter is `source.epub3`, a read-only EPUB3 adapter that implements
+the `markitect-tool` source adapter contract.
+
+## Development
+
+Run tests from this checkout:
+
+```bash
+PYTHONPATH=src:/home/worsch/markitect-tool/src python3 -m pytest
+```
+
+The EPUB3 adapter is registered through:
+
+```toml
+[project.entry-points."markitect_tool.source_adapters"]
+epub3 = "markitect_filter.adapters:epub3_adapter_descriptor"
+```