document the boundary issues in comment