Add initial specification and example

@apibyexample/owners - drafting the initial spec
Cool, renamed repo accordingly. I've also added an initial sample file, that I plan to use to test the python implementation.