[#1841] fix grammar, add note about __before, __after validation