Add comments around schema validation and possibly other pkgs

Request from convo with another team - would be nice to have some commenting/docs around schema validation and what exactly is happening without deep-diving code. Probably worthwhile to do likewise with other pkgs as well.