Spec for decks.

Anything else? 
Is it good to provide the kind of high level introduction and the implementation details? I write it to allow every people to comment on the main ideas of the decks, not only those ones that are familiar with the ooni code.
ciao