add doc: is_increasing, is_decreasing