added doc for short circuiting