validation updates, documentation.