more schema documentation and planning added