[doc] readme with initial spec
[doc] adjust headers
Merge pull request #1 from mediascience/doc

add readme