Document our schema (work in progress)

preparing it to be the source of our manual reference