document notes/todos on bag related code