adding Period::isBefore and Period::isAfter documentation