Update READMEs

README.md

@@ -13,10 +13,11 @@ Define your protocols for webservices, protobuf, Avro, etc., in one place, and a
 - Generate source code for integration with your favorite languages.
 - Example python code for processing messages using the schema definitions.
 
+The main readme for the installable python package is [dist-readme.md](dist-readme.md).
 
 ## Generated Documenation
 
-Basic markdown documentation is generated by the [generate.py](interface_gen/generate.py) script:
+An example of the markdown documentation is generated by the [generate.py](interface_gen/generate.py) script:
 
 [docs/generated](docs/generated/index.md)
 

dist-readme.md

@@ -11,7 +11,42 @@ languages and serialization frameworks, including:
 - SQL DDL (create table)
 - .. and of the other formats supported by [Avrotize](https://github.com/clemensv/avrotize).
 
-For more details see the [code
-repostitory](https://github.com/getditto/interface-gen) and its
-[README.md](https://github.com/getditto/interface-gen/blob/main/README.md)
+## Quick Start
+
+1. Create a virtual environment (optional but recommended), and activate it:
+
+```
+python -m venv venv
+source venv/bin/activate
+
+```
+
+2. Install the package:
+
+```
+python -m pip install interface-gen
+```
+
+3. Set up your protocol definitions and output directory.
+
+```
+mkdir -p my-protocols/v1.0
+mkdir my-output
+```
+
+Place your Avro IDL definition files (.avdl)  in `my-protocols/v1.0`
+
+4. Run the generator:
+
+```
+ifgen -i -p my-protocols -o my-output
+```
+
+## More Details
+
+For more details see the source code docs:
+
+- Python [interface\_gen/README.md](interface_gen/README.md)
+- Main [README.md](https://github.com/getditto/interface-gen/blob/main/README.md)
+- The [code repostitory](https://github.com/getditto/interface-gen)