add validator script and documentation