add a docblock to IFramePage validate function to explain exceptions and return types