Add docs for declarative schemas

[kiwicopple]

Here is the PR that we need documenting:

#2099