Adding and updating sync from mailing list convo
Adding data format documentation.
Updating docs with current thoughts
Adding repository link
fixing asciidoc error