wrote validation docs