initial schema, and corresponding doc update