Added some first thoughts on docs (largely to solidify my own thinking).
Created separate interfaces for objects that can be written as complete JSON texts and those that can only be written as JSON values.